Guías

Tu primera factura en producción

Cinco pasos desde el signup hasta tener el CDR firmado por SUNAT en tu base de datos. Pre-requisito: ya hiciste el quickstart sandbox.

Antes de empezar

  • Tu certificado .pfx SUNAT vigente.
  • Tu password SOL.
  • Tu RUC y el RUC de un receptor real.
  • Plan Pay-as-you-go o Volumen activado en /app/billing.

Sube tu .pfx

  1. Ve a /app/credentials.
  2. Click "Subir certificado" → selecciona tu .pfx → escribe el password.
  3. (Opcional pero recomendado) sube también tu credencial SOL — algunos endpoints SUNAT la requieren.

El .pfx se cifra en el navegador antes de viajar por la red, y se persiste cifrado en Storage con AES-GCM. Nadie del operador lo ve en plano.

Tu primera emisión real

Crea (o reutiliza) una fwk_live_* en /app/keys. Cambia el header Authorization en tu código y emite — el resto del flujo es idéntico al sandbox.

Recomendación: empieza con un test interno (factura por S/0.10 a un receptor de tu propia empresa). Si todo va bien, escala.

Verificar el CDR

Cuando recibas el webhook document.accepted, guarda data.cdr.code y data.cdr.description en tu DB. El XML del CDR firmado lo puedes descargar desde GET /v1/documents/:id/cdr y archivarlo por 5 años (requisito tributario peruano).