Guías

Migrar desde Nubefact

Misma SUNAT, distinta API. Esta guía te ayuda a portar tu integración existente sin pelearte con la documentación de ambos productos.

Diferencias clave

• Auth: Nubefact usa user+token en body; nosotros usamos Authorization: Bearer.
• Idempotencia: Nubefact no la expone; nosotros la requerimos para POSTs.
• Webhooks: Nubefact los tiene básicos; nosotros firmamos con HMAC-SHA256 y retry-policy de 8 intentos.
• Sandbox: ambos tienen, pero nuestro test mode NO consume cuota.

Mapeo de campos

• operacion Nubefact → kind ("invoice", "receipt", "credit_note", "debit_note").
• tipo_de_comprobante Nubefact → derivado de kind + serie.
• cliente_tipo_de_documento + cliente_numero_de_documento → receiver.id_kind + receiver.id_value.
• items[] → mismo concepto, pero precios y cantidades son strings (decimal seguro).

Pasos sugeridos

1. Crea cuenta Fiscal-Web. Sube tu .pfx (en sandbox primero).
2. Implementa el mapeo de payloads en una capa de adaptador, no en tu modelo de datos directamente.
3. Corre tu pipeline contra fwk_test_* durante una semana en paralelo a tu integración Nubefact.
4. Cuando estés cómodo, switchea producción en horario de bajo tráfico (sábado madrugada).
5. Mantén Nubefact como fallback durante 1-2 ciclos de cierre mensual.