Guías

Manejo del CDR

El CDR (Constancia de Recepción) es la respuesta de SUNAT firmada que prueba que tu factura fue aceptada. Es el documento legalmente relevante.

¿Qué es el CDR?

Un XML firmado por SUNAT que contiene:

  • code — "0" = aceptado, otros = rechazado u observado.
  • description — texto human-readable.
  • hash — hash del XML emitido (para auditoría).

Estados posibles

  • 0 — Aceptado. Factura válida.
  • 1xxx — Rechazado (estructura, schema). Tienes que corregir y reemitir.
  • 2xxx — Excepcional. Reintenta más tarde.
  • 4xxx — Observación (warning). La factura es válida pero SUNAT pide revisar algo.

Cómo archivarlo

Tributariamente debes guardar el XML del comprobante y el XML del CDR por 5 años. Endpoints relevantes:

  • GET /v1/documents/:id/xml — XML UBL firmado.
  • GET /v1/documents/:id/cdr — XML CDR firmado por SUNAT.
  • GET /v1/documents/:id/pdf — PDF formato A4.

Mostrarlo al cliente

El cliente final espera el PDF, no el XML. Genera un email con el PDF adjunto y un link al portal donde puede descargar el XML si lo necesita. La spec recomienda el formato A4 + QR para SUNAT-móvil.