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
iden 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).
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)
| Valor | Tipo | Es requerido | Descripción |
|---|---|---|---|
id | number | Sí | Identificador del perfil (entero positivo), obtenido en Listar perfiles. |
Parámetros del body
| Valor | Tipo | Es requerido | Descripción |
|---|---|---|---|
pais | string | No | Paí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:
| Campo | Tipo | Descripción |
|---|---|---|
investigacion | object | Investigación solicitada o en curso, con los mismos campos de Listar investigaciones; puede ser null. |
mensaje | string | "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:
- Consulta Investigaciones con Marshal con el
iddel perfil. - Consulta Detalle de una investigación con el
investigacion.idde la respuesta.
- Consulta Investigaciones con Marshal con el
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 ocurre | Mensaje en error |
|---|---|
id no es un entero positivo | El id del perfil no es válido. |
pais no es un país válido | El país no es válido. |
pais vacío | El 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ódigo | Cuándo ocurre | Mensaje en error |
|---|---|---|
400 | No quedan investigaciones en la bolsa | Has consumido el total de investigaciones Marshal disponibles en tu plan. Escribe al área comercial para solicitar más investigaciones Marshal. |
403 | El plan no incluye investigaciones Marshal | Tu plan no incluye investigaciones Marshal. Si necesitas esta función, contacta a tu ejecutivo comercial. |
403 | El plan venció | Tu plan venció. Para renovarlo, contacta a tu ejecutivo comercial. |
403 | El plan no está vigente | Tu plan ya no está vigente. Contacta a tu ejecutivo comercial para reactivarlo. |
503 | No se pudo consultar el saldo del plan | No 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 ocurre | Mensaje en error |
|---|---|
| Tu plan no incluye el módulo de compliance | El plan no cuenta con el módulo de compliance. |
| Tu plan no cuenta con Marshal | El 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."
}