Saltar al contenido principal

Actualizar el análisis Marshal de un perfil de compliance

Este endpoint solicita un nuevo análisis Marshal para un perfil de compliance buscado por nombre. Marshal complementa el compliance del perfil con hallazgos en medios de prensa y detección de Personas Expuestas Políticamente (PEP).

  • Requiere que tu plan incluya el módulo de compliance y cuente con Marshal.
  • El perfil debe existir en tu cuenta: obtén su id en Listar perfiles. Para un RUT cargado, usa Actualizar Marshal.
  • El cobro se aplica conforme a tu acuerdo comercial. Si el perfil está en monitoreo y todavía no tiene Marshal, el análisis es su entrada al monitoreo de Marshal y no se valida el cupo de investigaciones. En los demás casos, se valida antes el cupo de investigaciones Marshal de tu plan.
  • La solicitud es asíncrona: la respuesta confirma que se recibió y el análisis se procesa en los minutos siguientes (ver Cómo funciona).
Qué cambia respecto a la v2

Endpoint nuevo en la v3: la v2 no permite solicitar análisis Marshal. Ver la Guía de Migración.

Detalle de API​

Request​

  • URL: /compliance/perfiles/{id}/actualizarMarshal
  • Método: POST

Parámetros de ruta (path)​

ValorTipoEs requeridoDescripción
idnumberSíIdentificador del perfil (entero positivo), obtenido en Listar perfiles.

Parámetros del body​

ValorTipoEs requeridoDescripción
paisstringNoPaís del análisis, como código (ej: CL) o nombre (ej: Chile). Si no lo envías, se usa el país de la búsqueda del perfil. Con null, el análisis es global, sin país.

Ejemplo request con curl​

curl -X 'POST' \
'https://prod.api.thesheriff.cl/api/clients/v3/compliance/perfiles/7/actualizarMarshal' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
-d '{ "pais": "CL" }'

Response​

Success (análisis solicitado)

  • Status code: 200

  • Example response body:

    {
    "success": true,
    "data": {
    "investigacion": {
    "id": "0b6c1d9e-7a7f-4a2b-9c55-3f1e2d4a5b6c",
    "entidad": "JUAN PEREZ SOTO",
    "rut": null,
    "pais": "Chile",
    "estado": "EN_CURSO",
    "motivo": null,
    "detalleMotivo": null,
    "riesgo": null,
    "indicadorPep": null,
    "totalHallazgos": null,
    "canal": "API",
    "fechaCreacion": "22-10-2026 14:00:00",
    "fechaTermino": null,
    "tieneReporte": false
    },
    "mensaje": "Se solicitó un nuevo análisis Marshal."
    }
    }

Success (análisis en curso)

Si el perfil ya tiene un análisis Marshal en curso en tu cuenta, no se solicita otro y la respuesta es 200 con esa investigación y este mensaje:

{
"success": true,
"data": {
"investigacion": {
"id": "0b6c1d9e-7a7f-4a2b-9c55-3f1e2d4a5b6c",
"entidad": "JUAN PEREZ SOTO",
"rut": null,
"pais": "Chile",
"estado": "EN_CURSO",
"motivo": null,
"detalleMotivo": null,
"riesgo": null,
"indicadorPep": null,
"totalHallazgos": null,
"canal": "API",
"fechaCreacion": "22-10-2026 13:58:10",
"fechaTermino": null,
"tieneReporte": false
},
"mensaje": "Ya hay un análisis Marshal en curso para este perfil."
}
}

Campos dentro de data:

CampoTipoDescripción
investigacionobjectInvestigación solicitada o en curso, con los mismos campos de Listar investigaciones; puede ser null.
mensajestring"Se solicitó un nuevo análisis Marshal." o "Ya hay un análisis Marshal en curso para este perfil.".

En investigacion, rut siempre viaja en null porque la búsqueda es por nombre, y pais es el país del análisis o "Global" si es sin país. La respuesta es la misma para personas naturales y jurídicas.

Cómo funciona​

  • Solicita un análisis nuevo aunque el perfil tenga uno completado recientemente. Tu integración decide con qué frecuencia actualizarlo.
  • Si ya hay un análisis en curso, una nueva llamada a este endpoint no solicita otro ni valida cupo: recibes esa investigación. Un análisis está en curso mientras está en cola o en proceso (estado EN_CURSO, ver Estados).
  • La investigación queda con canal: "API".
  • El análisis se procesa en segundo plano y Sheriff no envía un aviso cuando termina. Para conocer el resultado:

Errores​

Además de los errores comunes, este endpoint puede responder:

400 - Parámetros inválidos​

El id de la ruta o el pais del body no son válidos. Corrige el valor indicado en el mensaje y vuelve a enviar la solicitud.

Cuándo ocurreMensaje en error
id no es un entero positivoEl id del perfil no es válido.
pais no es un país válidoEl país no es válido.
pais vacíoEl campo 'pais' no puede estar vacío.
{
"success": false,
"code": 400,
"error": "El id del perfil no es válido."
}

400 / 403 / 503 - Cupo de Marshal​

Tu plan no permite un nuevo análisis Marshal. Aplica a los planes prepago con bolsa de investigaciones Marshal. No se valida si ya hay un análisis en curso ni si el análisis incorpora el perfil al monitoreo de Marshal. El mensaje en error indica el motivo y qué hacer:

CódigoCuándo ocurreMensaje en error
400No quedan investigaciones en la bolsaHas consumido el total de investigaciones Marshal disponibles en tu plan. Escribe al área comercial para solicitar más investigaciones Marshal.
403El plan no incluye investigaciones MarshalTu plan no incluye investigaciones Marshal. Si necesitas esta función, contacta a tu ejecutivo comercial.
403El plan vencióTu plan venció. Para renovarlo, contacta a tu ejecutivo comercial.
403El plan no está vigenteTu plan ya no está vigente. Contacta a tu ejecutivo comercial para reactivarlo.
503No se pudo consultar el saldo del planNo pudimos validar el saldo de tu plan en este momento. Intenta nuevamente en unos minutos.
{
"success": false,
"code": 400,
"error": "Has consumido el total de investigaciones Marshal disponibles en tu plan. Escribe al área comercial para solicitar más investigaciones Marshal."
}

401 - No autorizado​

El token no se envió, expiró o no es válido (ver Errores de autenticación). Si expiró, solicita uno nuevo en Obtener Token.

{
"success": false,
"code": 401,
"error": "El token de autenticación no es válido."
}

403 - Rol observador​

Tu usuario tiene rol observador, que no puede solicitar análisis Marshal.

{
"success": false,
"code": 403,
"error": "El rol observador no puede solicitar análisis Marshal."
}

403 - Plan sin el módulo de compliance o sin Marshal​

Tu plan no incluye el módulo de compliance o no cuenta con Marshal. El mensaje indica cuál de los dos falta:

Cuándo ocurreMensaje en error
Tu plan no incluye el módulo de complianceEl plan no cuenta con el módulo de compliance.
Tu plan no cuenta con MarshalEl plan no cuenta con Marshal.
{
"success": false,
"code": 403,
"error": "El plan no cuenta con Marshal."
}

404 - Perfil no encontrado​

No se encontró un perfil de compliance con el id indicado en tu cuenta.

{
"success": false,
"code": 404,
"error": "Perfil de compliance no encontrado."
}

422 - Sin nombre válido​

El perfil no tiene un nombre válido para el análisis Marshal.

{
"success": false,
"code": 422,
"error": "El perfil no tiene un nombre válido para el análisis Marshal."
}

429 - Demasiadas solicitudes​

Superaste el límite de solicitudes (ver Rate Limits). Espera los segundos que indica el header Retry-After antes de reintentar.

{
"success": false,
"code": 429,
"error": "Demasiadas solicitudes desde esta API externa, intente más tarde."
}

500 - Error interno del servidor​

Ocurrió un error inesperado. Intenta nuevamente más tarde.

{
"success": false,
"code": 500,
"error": "Ocurrió un error interno. Intenta nuevamente más tarde."
}

503 - Solicitud no disponible​

No fue posible solicitar el análisis Marshal en ese momento. Vuelve a intentarlo en unos minutos.

{
"success": false,
"code": 503,
"error": "No se pudo solicitar el análisis Marshal. Intenta nuevamente en unos minutos."
}