Carga Masiva de Perfiles

Este endpoint permite cargar múltiples perfiles en una única solicitud, facilitando la carga de lotes de documentos. Todos estos serán cargados como consulta o monitoreo, según se especifique.

Carga de Perfiles

Si los documentos no se encuentran previamente cargados en la plataforma, se aplicará un cobro conforme a los términos establecidos en el acuerdo comercial vigente.

Monitoreo/Consulta

El modo Monitoreo garantiza la actualización automática y constante del perfil con información relevante, mientras que el modo Consulta permite el acceso temporal al mismo por un periodo de 48 horas para realizar una revisión puntual.

Endpoint

POST /v1/perfiles/cargar-masivo

Límite de Carga Masiva

La carga masiva está limitada a un máximo de 100 perfiles por solicitud. Si necesitas cargar más perfiles, divide tu lista en múltiples solicitudes.

Restricción Carga Masiva

La lista de documentos a cargar debe ser homogénea: todos deben ser del mismo tipo. Es decir, una solicitud puede contener solo DNIs, solo RUCs o solo Carnets de Extranjería, pero nunca una mezcla de distintos tipos. El docType que envíes aplica a todos los documentos de la lista.

Parámetros del Body

Parámetro	Tipo	Requerido	Por Defecto	Descripción
taxIds	string[]	Sí	-	Una lista de documentos a cargar, todos del mismo tipo (máximo 100)
docType	string	Sí	-	Tipo de documento para todos los perfiles de la lista. Puede ser RUC, DNI o CE
isMonitoring	boolean	No	true	Indica si los perfiles deben ser monitoreados

Tipos de documento soportados

docType	Documento	Formato del taxId
RUC	Registro Único de Contribuyentes	11 dígitos (prefijo 10, 15, 17 o 20) + dígito verificador
DNI	Documento Nacional de Identidad	8 dígitos
CE	Carnet de Extranjería	Alfanumérico, 9 a 12 caracteres

Ejemplo de Solicitud

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

Ejemplo de Respuesta

{
  "statusCode": 200,
  "message": "Carga masiva completada: 2 perfiles cargados correctamente.",
  "results": {
    "successful": 2,
    "failed": 0,
    "skipped": 0,
    "errors": []
  }
}