Consulta DNI
Devuelve nombres y apellidos de un DNI registrado como contribuyente en SUNAT: primero en el padrón reducido y, si no está, en SUNAT en línea.
Solicitud
Encabezados: Authorization: Bearer TU_TOKEN y Content-Type: application/json.
{ "dni": "12345678" }
El campo dni es obligatorio, debe tener 8 caracteres y pasar una validación de dígitos.
Respuesta
Toda respuesta trae success, code, retryable y time, más data si hubo éxito o message si hubo error.
{
"success": true,
"code": "found",
"retryable": false,
"data": {
"numero": "…",
"nombre_completo": "…",
"nombres": "…",
"apellido_paterno": "…",
"apellido_materno": "…",
"codigo_verificacion": 0
},
"time": 0.12
}
La API separa el nombre completo usando la primera palabra como apellido paterno, la segunda como apellido materno y las restantes como nombres. codigo_verificacion es el último dígito del RUC 10 de la persona.
Códigos: 200 encontrado; 404 no figura en SUNAT (not_found) o SUNAT no respondió (retryable: true); 422 si no son 8 dígitos (code: invalid_dni).