Guías

Checklist de producción

Lista para revisar antes de procesar tu primera factura real. Si algo no aplica a tu caso, márcalo como "N/A" y documenta el porqué.

Técnicas

• Idempotency-Key implementado en cada POST.
• Retry con backoff exponencial en 5xx y 429.
• Verificación HMAC de webhooks usando body crudo + comparación timing-safe.
• Manejo de webhooks como idempotentes (puedes recibir el mismo evento dos veces).
• Logs estructurados con trace_id de cada respuesta de error 4xx/5xx.
• Test de end-to-end contra fwk_test_* en CI.

Fiscales

• Tu .pfx vigente subido en /app/credentials.
• Tu password SOL guardado.
• Series con códigos válidos ("F001" para facturas, "B001" para boletas, "FC01" para NC, "FD01" para ND).
• Numeración correlativa garantizada en tu lado (no saltos).
• Archivado de XML + CDR + PDF por 5 años.

Operacionales

• Plan Pay-as-you-go o Volumen activado.
• Método de pago (Culqi PEN o Stripe USD) configurado.
• Endpoint de webhook con TLS y un health-check propio.
• Pager / Slack alert si tu endpoint de webhook devuelve 5xx más de 1% del tiempo.
• Plan de qué hacer si SUNAT cae (los CDR llegan minutos / horas después; tu DB debe tolerar el estado pending).