Consultas RUC & DNI
Endpoints de utilidad para validar la identidad de tus adquirentes y emisores.
YoEmito incluye servicios integrados de búsqueda de identidad para facilitar la emisión de comprobantes electrónicos en el Perú, permitiendo validar la información de tus clientes y proveedores directamente desde la API.
Nuestra API cuenta con mecanismos de optimización y redundancia que garantizan respuestas en milisegundos y una validación segura contra fuentes oficiales, asegurando la máxima consistencia y fiabilidad de la información.
En entorno Sandbox (claves ye_test_...) dispones de un cupo de cortesía de 10 consultas gratuitas de DNI/RUC por día por organización para validar tu integración. En Producción (claves ye_live_...) las consultas se realizan de forma ilimitada contra tu saldo disponible o paquete activo (S/ 0.03 por consulta o cupos gratis de recarga).
Consulta DNI
Permite validar y obtener el nombre completo de personas naturales para la correcta emisión de Boletas de Venta Electrónicas.
- Ruta:
POST /v1/catalogs/dni - Body: JSON con la propiedad
"dni"de 8 dígitos numéricos.
Consulta RUC
Permite buscar y verificar la razón social y estado de contribuyentes registrados ante la SUNAT. Es ideal para validar clientes en Facturas Electrónicas y previsualizar emisores antes de registrarlos en YoEmito.
- Ruta:
POST /v1/catalogs/ruc - Body: JSON con la propiedad
"ruc"de 11 dígitos numéricos.
Catálogos estáticos SUNAT
Además de las consultas de identidad, la API expone los catálogos oficiales de SUNAT usados para armar tus comprobantes (todos GET, sin autenticación de Idempotency-Key, algunos aceptan ?q= para buscar por código o nombre).
| Ruta | Catálogo SUNAT | Búsqueda ?q= |
|---|---|---|
| GET /v1/catalogs/units | 03 — Unidades de medida | Sí |
| GET /v1/catalogs/igv-affectations | 07 — Afectación al IGV | No |
| GET /v1/catalogs/currencies | 02 — Monedas | No |
| GET /v1/catalogs/identity-docs | 06 — Documentos de identidad | No |
| GET /v1/catalogs/operation-types | 51 — Tipos de operación | No |
| GET /v1/catalogs/detraction-codes | 25 — Bienes/servicios sujetos a detracción (incluye rate) | No |
| GET /v1/catalogs/payment-means | 59 — Medios de pago | No |
| GET /v1/catalogs/unspsc | Productos UNSPSC/SUNAT | Sí |