Integrar DGI Panamá con tu sistema de facturación en línea exige tres piezas que no son negociables: un PAC autorizado por la Dirección General de Ingresos, un certificado digital vigente para firma electrónica y un middleware con cola de reintentos que garantice idempotencia. El error más común en Panamá es enviar facturas directas a la DGI sin patrón outbox: a la primera caída de red duplicas folios y pasas el resto del mes reconciliando. Aquí va el blueprint técnico completo.
¿Cómo funciona la facturación electrónica panameña?
El modelo panameño tiene cuatro actores y un flujo deterministico que vale la pena dibujar antes de escribir una sola línea de código.
- Emisor (tu empresa o tu cliente) genera el XML de factura según esquema DGI
- PAC autorizado recibe el XML, valida, lo firma con su certificado y lo envía a DGI
- DGI valida fiscalmente y devuelve un CUFE (Código Único de Factura Electrónica)
- PAC retorna el CUFE más QR al emisor, que entrega la representación PDF al receptor
Cada paso tiene latencia variable. Un sistema bien diseñado nunca asume éxito inmediato.
El stack mínimo de integración
Estas son las capas que toda integración seria implementa, sin atajos.
| Capa | Función | Tecnología típica |
|---|---|---|
| Generador XML | Construye documento según schema DGI | Python lxml o Java JAXB |
| Firmador | Aplica firma electrónica con certificado | OpenSSL más librería XMLDSig |
| Cliente PAC | Envío a API REST o SOAP del PAC | Cliente HTTP con timeout y retry |
| Cola outbox | Persistencia idempotente de envíos | PostgreSQL más worker async |
| Audit log | Trazabilidad inmutable cada estado | Tabla append only con hash chain |
La trampa del retry sin idempotencia
El bug clásico: el sistema envía la factura al PAC, el PAC la procesa, la red corta antes de recibir el acuse y tu sistema reintenta. Resultado: dos folios consumidos, dos CUFEs, una conciliación manual de horas. La solución es el patrón outbox con clave de idempotencia.
En un caso real con distribuidora multinacional, implementamos write-back queue en una tabla outbox.cierres_venta con idempotency_key UUID generado en la transacción origen. Si el worker reintenta, el PAC reconoce el folio previo y devuelve el CUFE existente sin duplicar. Resultado: cero folios duplicados en producción tras seis semanas operando.
- Outbox queue pattern con clave única por documento
- Retry exponencial 1s, 2s, 4s respetando Retry-After del PAC
- Audit log inmutable de cada intento con timestamp y respuesta
- Trigger SQL que persiste el evento antes de devolver al usuario
¿Qué PAC elegir en 2026?
Panamá tiene una docena de PACs autorizados. Los que vemos en producción cumpliendo SLA son tres: Edicom, The Factory HKA y Facture. Los criterios duros que importan al elegir:
- SLA documentado mayor a 99.5% de uptime mensual
- Tarifa por documento clara, sin escalones ocultos por volumen
- API REST moderna, no sólo SOAP legacy de 2009
- Sandbox usable sin firmar contrato, para probar la integración
- Soporte técnico en español con respuesta menor a 24 horas
Evita PACs que sólo ofrecen portal web manual: para más de cien facturas mensuales necesitas API o el costo operativo te come.
La capa de hardening para producción
Antes de cortar listón con tu primera factura productiva, valida estas siete cosas. Las tres primeras son las que rompen más sistemas en LATAM.
- Certificado digital con vencimiento mayor a 90 días y alerta a 30 días antes
- Pruebas de carga con mil facturas por hora en ambiente PAC sandbox
- Reconciliación nocturna que compara folios emitidos en tu sistema vs. CUFEs entregados
- Rotación de credenciales API hacia el PAC, nunca hardcodeadas
- Backups del audit log inmutable separados del backup transaccional
- Plan de contingencia para caída prolongada del PAC (más de cuatro horas)
- Documentación operativa con runbook paso a paso para soporte
Costos reales año 1 en Panamá
Una pyme panameña con quinientas facturas mensuales debería presupuestar así.
| Concepto | Costo año 1 | Detalle |
|---|---|---|
| PAC mensualidad | 600 a 2,400 USD | Según plan elegido |
| PAC por documento | 360 USD | 6,000 facturas año a 0.06 USD |
| Certificado digital | 80 USD | Renovable anual |
| Desarrollo middleware | 8,000 a 25,000 USD | Una sola vez, depende complejidad |
| Mantenimiento | 1,200 USD | Actualizaciones esquema DGI |
El gran ahorro está en hacer el middleware una sola vez con código propio. Cada año que el sistema sigue corriendo, el costo marginal tiende a cero. Lo opuesto a un SaaS que cobra por usuario y por documento de forma indefinida.
¿Conviene comprar SaaS o construir a medida?
Para volumen menor a 200 facturas mensuales con flujo estándar, un SaaS panameño cubre. Para volumen mayor, integración con ERP existente o lógica fiscal específica (descuentos por línea, retenciones cruzadas, exportación), el cálculo a tres años favorece código propio.
Cuando los datos se unifican, los problemas se anuncian solos. Una integración a medida bien arquitecturada te da visibilidad fila por fila de cada documento, cada retry, cada rechazo. SaaS típico te muestra agregados.
Próximos pasos
Si tu empresa factura más de 200 documentos al mes en Panamá y quieres integración robusta con tu ERP existente, una sesión técnica de descubrimiento te ahorra meses de error. MAGIA Forge entrega software a medida en 12 semanas con CI/CD activo, pruebas automatizadas y código 100% propiedad del cliente. MAGIA Core cubre cuando además necesitas dashboards por rol y data lake unificado.
Llamada técnica con el equipo que construye, no con un SDR. Sin pitch deck. Sólo conversación real sobre tu operación.