Datos necesarios para consultar un CPE
La entrada incluye ruc_emisor, codigo_tipo_documento, serie_documento, numero_documento, fecha_de_emision y total. Utiliza exactamente los nombres definidos en OpenAPI. Los campos se transmiten como cadenas, incluido el importe.
La fecha de esta operación sigue DD/MM/AAAA, a diferencia de la consulta de tipo de cambio, que usa AAAA-MM-DD. Mantén la serie con sus letras y ceros y comprueba el importe antes de enviar la solicitud. Un ejemplo de código no sustituye los datos del comprobante que estás autorizado a revisar.
Interpretar la respuesta en tu proceso
Una respuesta HTTP 200 indica que la consulta se completó; revisa el contenido devuelto antes de decidir cómo registrar el comprobante. Distingue ese resultado de un error de autenticación, una entrada rechazada o la ausencia de información en la fuente.
La API CPE de DatosPerú es una operación de consulta. No emite una factura, no firma un XML y no envía una declaración tributaria. Para descargar o convertir archivos, revisa las otras rutas del catálogo y sus requisitos específicos.
Controles de integración
Guarda el token en tu servidor. Registra el identificador técnico de solicitud cuando necesites soporte, sin copiar el cuerpo completo del comprobante a los logs. Los reintentos automáticos pueden repetir consultas exitosas y consumir créditos adicionales: aplica límites y distingue fallos temporales de errores de entrada.
El contrato OpenAPI, la colección Postman y las referencias en Markdown permiten comprobar la estructura antes de escribir código. También puedes importar el ejemplo de n8n y adaptar su cuerpo al esquema CPE.
Preguntas frecuentes
¿Consultar CPE y consultar RUC son lo mismo?
No. RUC consulta datos del contribuyente; CPE recibe datos de un comprobante concreto.
¿La API emite comprobantes?
No. El catálogo actual ofrece consultas y operaciones sobre archivos.