Consultas e Historial de Documentos

Inspección de estado, respuesta SUNAT y descarga de archivos firmados.

GET/v1/documents

GET/v1/documents/:id

GET/v1/documents/export

Puedes consultar en cualquier momento el estado de procesamiento de tus comprobantes de pago mediante peticiones GET HTTP.

Descarga Directa de Artefactos

Cada documento procesado genera enlaces permanentes para su consumo e impresión directa:

PDF Representation: GET /v1/documents/:id/pdf?format=a4&template=modern — dos parámetros independientes: format (a4, ticket_80, ticket_58, default a4) y template (default, modern, classic, solo aplica con format=a4).
XML Firmado: GET /v1/documents/:id/xml (UBL 2.1 firmado con firma criptográfica XAdES-BES).
Constancia CDR: GET /v1/documents/:id/cdr (Constancia de Recepción oficial devuelta por SUNAT en formato ZIP).

Eres libre de generar tu propia representación impresa: nuestro endpoint de PDF es una comodidad, no una obligación. El XML Firmado ya trae todo lo necesario para armar tu propio PDF — incluido el ds:DigestValue de la firma digital, el mismo dato que usamos nosotros para construir la cadena oficial del código QR de SUNAT (RUC, tipo de comprobante, serie-número, IGV, total, fecha de emisión, tipo y número de documento del receptor, y el hash). Si necesitas mostrar datos que nuestras plantillas no cubren hoy — por ejemplo tus propias cuentas bancarias, un diseño de marca específico, u otro idioma — puedes renderizar el PDF tú mismo a partir del XML sin perder validez legal ni depender de nuestro diseño.

Export Masivo (ZIP)

GET /v1/documents/export?from=YYYY-MM-DD&to=YYYY-MM-DD descarga en un único ZIP el XML de todos los comprobantes del rango (agrega &include_cdr=true para incluir también el CDR de cada uno). Útil para entregarle todo a tu contador o para una auditoría SUNAT sin descargar archivo por archivo. Acepta los mismos filtros que el listado (status, series, type, issuer_id, ruc) y está limitado a 500 comprobantes por exportación — para volúmenes mayores, exporta en tramos de fechas más chicos.