Qué significa integrar una API SUNAT
La búsqueda «API SUNAT» puede referirse a consultar datos, validar comprobantes, emitir facturas o trabajar con servicios tributarios específicos. Son necesidades distintas. En DatosPerú publicamos los contratos de nuestras operaciones de consulta para que puedas comprobar si cubren tu caso antes de integrarlas.
El servicio es privado e independiente de SUNAT. Las consultas se canalizan a través de JSON.pe. No atribuimos a DatosPerú la condición de entidad oficial, OSE o PSE, y el catálogo no ofrece emisión de comprobantes ni integración SIRE.
RUC y datos empresariales
La consulta básica de RUC devuelve razón social, estado, condición y datos de dirección disponibles. Para obtener representantes, establecimientos o información adicional, utiliza las rutas empresariales específicas. La documentación distingue los campos de cada operación y evita que tu cliente dependa de una respuesta no definida.
Consultar un contribuyente no equivale a verificar un comprobante. Un flujo de compras puede consultar primero el RUC y después comprobar un CPE; son dos solicitudes independientes con entradas diferentes y consumo de créditos separado cuando tienen éxito.
Validación de comprobantes electrónicos
La consulta CPE recibe el RUC emisor, el tipo de documento, la serie, el número, la fecha de emisión y el total. El esquema indica el nombre exacto y el formato de cada campo. Conserva la serie completa y usa el importe del documento que quieres comprobar.
No interpretes el resultado sin atender a la información que devuelve la fuente. La respuesta de validación ayuda a tu proceso de revisión; el servicio no emite una nueva factura ni reemplaza el documento del emisor. La API también incluye operaciones para archivos y conversión de XML a PDF con requisitos propios.
Guías, archivos y credenciales
Las rutas de guía XML y guía JSON usan GET con parámetros de consulta. La respuesta XML se entrega como content_base64 y mime_type. La conversión XML a PDF recibe un archivo codificado; consulta la referencia para distinguir el formato del contenido retornado.
Algunas operaciones requieren información o credenciales del titular del documento. Envíalas desde tu servidor solo cuando tengas autorización, evita incluirlas en registros y usa exclusivamente HTTPS. El token de DatosPerú sigue siendo necesario para autenticar la solicitud.
Un contrato que puedes importar
Descarga OpenAPI 3.1 o la colección Postman para revisar las 25 operaciones. Encontrarás los tipos de entrada, las respuestas normalizadas y los errores comunes. También hay documentación en Markdown para asistentes de programación y un flujo importable para n8n.
Preguntas frecuentes
¿Esta API emite facturas electrónicas?
No. El catálogo actual se centra en consultas, validación y tratamiento de archivos.
¿Necesito clave SOL para todas las consultas?
No. Revisa los parámetros de cada operación; las consultas básicas de DNI y RUC no incluyen credenciales SOL.
¿Dónde está el schema de la API?
El contrato público está en /openapi.json y puede importarse en herramientas compatibles con OpenAPI 3.1.