Actualización Forzada de Perfiles

Este endpoint permite forzar la actualización de uno o más perfiles que ya se encuentran activos en tu corporación. Al forzar la actualización, el sistema reprocesa completamente la información del perfil obteniendo datos actualizados de todas las fuentes disponibles.

Perfil Activo Requerido

Solo se pueden actualizar perfiles que ya estén activos en tu corporación. Si un perfil no existe o no está activo, será omitido y reportado en los resultados.

Tipo de Documento Automático

A diferencia de la carga de perfiles, no es necesario especificar el tipo de documento (RUC, DNI o CE). El sistema lo determina automáticamente a partir del perfil existente.

Endpoint

POST /v1/perfiles/forzar-actualizacion

Límite de Actualización

La actualización forzada está limitada a un máximo de 100 perfiles por solicitud. Si necesitas actualizar más perfiles, divide tu lista en múltiples solicitudes.

Parámetros del Body

Parámetro	Tipo	Requerido	Descripción
taxIds	string[]	Sí	Una lista de documentos activos a actualizar (máximo 100)

Ejemplo de Solicitud

curl -X POST https://api-public.thesheriff.pe/v1/perfiles/forzar-actualizacion \
  -H "Authorization: Bearer <TU_TOKEN_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
        "taxIds": ["201XXX8056", "1045XXX654"]
      }'

Ejemplo de Respuesta

Una respuesta exitosa (200 OK) indica que la actualización forzada ha sido completada.

{
  "statusCode": 200,
  "data": {
    "message": "Actualización forzada completada: 2 perfiles actualizados correctamente.",
    "results": {
      "successful": 2,
      "failed": 0,
      "skipped": 0,
      "errors": []
    }
  }
}

Respuesta con perfiles omitidos

Si alguno de los perfiles no existe o no está activo en tu corporación, será omitido:

{
  "statusCode": 200,
  "data": {
    "message": "Actualización forzada completada: 1 perfil actualizado correctamente, 1 perfil omitido por no tener perfil activo.",
    "results": {
      "successful": 1,
      "failed": 0,
      "skipped": 1,
      "errors": [
        {
          "taxId": "1045XXX654",
          "reason": "No existe un perfil activo con el número de identificación 1045XXX654 en tu corporación."
        }
      ]
    }
  }
}