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.
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.
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 /v2/perfiles/forzar-actualizacion
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) |
months | number | No | Solo en planes de pago único y sobre perfiles en monitoreo: meses de duración del monitoreo que queda tras el reproceso (1 a 12). Si se omite, cada perfil recupera los meses que le quedaban más uno, con lo que su vencimiento no cambia |
Reproceso y cupo en planes de pago único
Reprocesar un perfil en monitoreo de un plan de pago único cancela su monitoreo vigente y activa uno nuevo desde hoy. Al cancelar, los meses que todavía no habían empezado vuelven a tu cupo; el mes en curso no vuelve. Después se descuentan los meses del monitoreo nuevo — los que mandes en months, o los que te quedaban más uno si no lo mandas.
Con el default, el vencimiento del perfil no se mueve y la operación te cuesta un mes-monitoreo.
El monitoreo nunca pasa del fin de tu contrato: si el contrato termina a mitad de mes, el último mes queda recortado a esa fecha y consume un mes-monitoreo completo igual.
Los perfiles en consulta no consumen meses al reprocesarse, y en planes mensuales nada de esto aplica: ahí el monitoreo no vence ni descuenta meses.
Un monitoreo vencido no se reprocesa: primero hay que volver a activarlo. El perfil se reporta con error en results.errors y el resto del lote sigue.
Ejemplo de Solicitud
curl -X POST https://api-public.thesheriff.pe/v2/perfiles/forzar-actualizacion \
-H "Authorization: Bearer <TU_TOKEN_JWT>" \
-H "Content-Type: application/json" \
-d '{
"taxIds": ["201XXX8056", "1045XXX654"],
"months": 6
}'
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."
}
]
}
}
}
Respuesta con perfiles que no se pudieron reprocesar
En un plan de pago único, un perfil cuyo reproceso no cabe en el cupo —o cuyo monitoreo ya venció— se reporta en results.failed y el resto del lote continúa:
{
"statusCode": 200,
"data": {
"message": "Actualización forzada completada: 1 perfil actualizado correctamente, 1 perfil con errores.",
"results": {
"successful": 1,
"failed": 1,
"skipped": 0,
"errors": [
{
"taxId": "1045XXX654",
"reason": "Cupo insuficiente: te quedan 3 meses-monitoreo (incluyendo 2 que se devuelven al reprocesar) y reprocesar este perfil necesita 6. Reduce los meses o contacta a tu ejecutivo comercial."
}
]
}
}
}
Si no se puede validar el cupo contra el sistema de facturación, el reproceso no procede: el perfil se reporta con error en vez de actualizarse sin cobrar. Reintenta en unos minutos.