Introducción a KipuDev API
Guía de inicio rápido para integrar la API de consultas SUNAT en tu aplicación.
Introducción
KipuDev API te permite consultar información de contribuyentes SUNAT, obtener tipos de cambio del día y validar comprobantes electrónicos (CPE) de forma rápida y confiable.
🚀 KipuDev Suite - Próximamente
Estamos expandiendo nuestras capacidades. Próximamente: Endpoints para emisión de CPE (boletas y facturas), gestión de archivos XML/CDR y panel de control fiscal. Ver roadmap →
¿Qué puedes hacer?
- Consulta RUC: Obtén información detallada de cualquier contribuyente por su número de RUC.
- Búsqueda por razón social: Encuentra contribuyentes buscando por nombre o razón social.
- Tipo de cambio: Consulta el tipo de cambio USD/PEN oficial de la SBS.
- Validación CPE: Verifica el estado de facturas, boletas y notas de crédito/débito en SUNAT.
Quickstart
1. Obtén tu API Key
Regístrate en kipudev.com para obtener tu API Key gratuita con 100 consultas diarias.
Tu API Key es secreta. No la compartas ni la expongas en código del lado del cliente.
2. Haz tu primera consulta
curl -X GET "https://api.kipudev.com/api/contribuyentes/20131312955" \
-H "X-API-KEY: tu-api-key"
3. Recibe la respuesta
{
"ruc": "20131312955",
"razonSocial": "SUNAT - SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA",
"estado": "ACTIVO",
"condicion": "HABIDO",
"direccion": "AV. GARCILASO DE LA VEGA NRO. 1472 LIMA - LIMA - LIMA",
"ubigeo": "150101",
"tipo": "GOBIERNO CENTRAL",
"actividadEconomica": "ADMINISTRACION PUBLICA EN GENERAL"
}
Prueba la API directamente desde nuestro Playground interactivo más abajo.
Playground Interactivo
API Playground
GET
https://api.kipudev.com/api/contribuyentes/20131312955curl -X GET "https://api.kipudev.com/api/contribuyentes/20131312955" \ -H "X-API-KEY: tu-api-key"
Planes disponibles
| Plan | Consultas/día | Precio |
|---|---|---|
| Free | 100 | Gratis |
| Basic | 2,000 | $29/mes |
| Pro | 10,000 | $99/mes |
| Enterprise | Ilimitado | Contactar |
Próximos pasos
- Autenticación - Aprende a usar tu API Key correctamente.
- Consulta RUC - Referencia completa del endpoint de consulta.
- Manejo de errores - Códigos de error y cómo manejarlos.