Los datos salen del padrón de SUNAT en el momento de la consulta, no de una copia intermedia: razón social, tipo de contribuyente, estado y condición de domicilio, fechas de inscripción y de emisor electrónico, y las actividades económicas con su código CIIU. El DNI devuelve nombres y apellidos.
Una dirección, como «Jr. Pedro Caballero y Lira 175», devuelve los distritos del Perú donde existe esa calle, cada uno con su ubigeo. Si la dirección nombra el distrito, la provincia o la ciudad, esos van primero. Sale de un índice propio armado con OpenStreetMap: sugiere, no valida. Que una calle no aparezca no quiere decir que la dirección esté mal.
| Endpoint | Devuelve | Acceso |
|---|---|---|
| GET/api/v1/ruc/{ruc} | Ficha completa del contribuyente | token |
| GET/api/v1/dni/{dni} | Nombres y apellidos | token |
| GET/api/v1/direccion?q= | Distritos donde existe la calle, con ubigeo. cerca acepta un ubigeo de referencia |
token |
| GET/api/v1/health | Estado del servicio y del navegador | abierto |
| POST/api/v1/cache/clear | Vacía la caché en memoria | token |
Cada token identifica a un cliente. Se envía en la cabecera Authorization
como Bearer, o en X-API-Key si su cliente HTTP lo tiene más a
mano. Sin token, o con uno revocado, la respuesta es 401 y no se consulta
nada a SUNAT.
Authorization: Bearer <su-token>
X-API-Key: <su-token> # equivalente