Consulta de registro
Consulta de CPF
Datos registrales oficiales de una persona física a partir del CPF y la fecha de nacimiento.
/openapi/v3/consultas/cpf/{cpf}/{nascimento}token, timestamp y sign, vea Autenticación.Devuelve los datos registrales de un CPF de 11 dígitos más la fecha de nacimiento: nombre, situación registral y fecha de nacimiento. La fuente upstream valida CPF y fecha de nacimiento como un par; un par que no coincide y un CPF inexistente devuelven el mismo código 10016003, deliberadamente indistinguibles (vea Consulta de registro).
Solicitud GET: el cuerpo firmado es la cadena vacía y las dos variables de ruta forman parte de la ruta firmada. La respuesta es un objeto simple, sin sobre de la plataforma.
Parámetros de ruta
cpf* | string | CPF |
nascimento* | string | Fecha de nacimiento |
* Campo obligatorio
ni | string | CPF |
nome | string | Nombre completo |
| object | Situación registral |
nascimento | string | Fecha de nacimiento |
La fuente upstream responde según la franja de edad del titular y la plataforma transmite el código de estado upstream sin cambios. El message de las franjas de bloqueo es el texto legal fijado por la fuente (portugués) y no se traduce con la cabecera Language; ramifique por code.
Facturación: 422, 451 y no encontrado / fecha de nacimiento que no coincide (400 + 10016003) se facturan por llamada; 428 e indisponibilidad upstream (503) no se facturan. La plataforma no almacena nada para las franjas de bloqueo. Los errores de formato y de dígito verificador se rechazan localmente y no se facturan.
Adulto (18 años o más): HTTP 200
Nombre, situación registral y fecha de nacimiento, como de costumbre.
{ "ni": "40710536828", "nome": "DANILO HIDEO CORREA", "situacao": { "codigo": "0", "descricao": "REGULAR" }, "nascimento": "09011997" }
16 a 17 años: HTTP 422
Código 10016005, sin ningún campo personal. No reintente: la edad no cambia con el reintento y cada llamada se factura.
{ "code": 10016005, "message": "LGPD: menor de idade" }
Menor de 16 años: HTTP 451
Código 10016004, sin ningún campo personal. No reintente.
{ "code": 10016004, "message": "LGPD: menor de 16 anos (Lei Felca)" }
Edad no verificable: HTTP 428
Código 10016006, sin ningún campo personal. La base upstream no tiene la fecha de nacimiento del titular; la plataforma ya volvió a verificar una vez con la fecha que usted indicó, dentro de la misma llamada. Un 428 persistente significa que la fuente oficial tampoco pudo verificar; reintentar es inútil.
{ "code": 10016006, "message": "LGPD: idade nao verificavel - informe a data de nascimento para completar a verificacao" }
situacao.codigoSituación registral del CPF
Cuando el código no es 0, le corresponde a usted decidir si el flujo continúa; la plataforma transmite la situación sin juzgarla.
| Valores | Significado |
|---|---|
| 0 | REGULAR: regular |
| 2 | SUSPENSA: suspendida |
| 3 | TITULAR FALECIDO: titular fallecido |
| 4 | PENDENTE DE REGULARIZACAO: pendiente de regularización |
| 5 | CANCELADA POR MULTIPLICIDADE: cancelada por registro duplicado |
| 8 | NULA: nula |
| 9 | CANCELADA DE OFICIO: cancelada de oficio |
| Código | HTTP | |
|---|---|---|
| 10016000 | 400 | Formato de CPF inválido (se requieren 11 dígitos). Compruebe caracteres de formato indebidos o longitud incorrecta. |
| 10016001 | 400 | Dígitos verificadores del CPF inválidos. Valide localmente con el algoritmo mod-11 para evitar llamadas inútiles. |
| 10016002 | 400 | Fecha de nacimiento inválida (se requiere un DDMMYYYY válido). Observe el orden día-mes-año y que la fecha debe existir. |
| 10016003 | 400 | CPF no encontrado: el CPF no existe o el CPF y la fecha de nacimiento no coinciden (deliberadamente indistinguibles). Se factura por llamada. |
| 10016005 | 422 | LGPD: menor de idade: el titular tiene entre 16 y 17 años. Datos legalmente retenidos por la fuente upstream, sin campos personales; no reintente. Se factura por llamada. |
| 10016004 | 451 | LGPD: menor de 16 anos (Lei Felca): el titular es menor de 16 años. Datos legalmente retenidos, sin campos personales; no reintente. Se factura por llamada. |
| 10016006 | 428 | LGPD: idade nao verificavel - informe a data de nascimento para completar a verificacao: no se puede verificar la edad. La plataforma ya volvió a verificar una vez con la fecha de nacimiento indicada; no reintente. No se factura. |
| 10016020 | 503 | Fuente de datos upstream temporalmente no disponible. Reintente con backoff exponencial (empiece en 1 s, duplique hasta 30 s, añada jitter); si persiste, contacte con la plataforma. No se factura. |