Checklist técnico para elegir un PAC de facturación electrónica en Panamá

Integrar facturación electrónica en Panamá tiene una peculiaridad que diferencia el mercado del resto de la región: el PAC (Proveedor Autorizado de Certificación) es una figura regulada por la DGI con obligaciones legales propias. No es solo un proveedor de API — es un intermediario certificado que tiene responsabilidad ante la DGI por los documentos que tramita. Elegir mal el PAC no solo genera problemas técnicos; puede tener consecuencias regulatorias para el emisor.

Este checklist cubre 8 criterios técnicos y regulatorios para evaluar cualquier PAC de facturación electrónica en Panamá antes de iniciar la integración. Cada criterio incluye una prueba o verificación concreta.

Criterio 1 — Certificación DGI como PAC activo

La DGI Panamá publica el listado de PACs certificados. Es el primer punto de verificación antes de cualquier evaluación técnica. Un PAC cuya certificación esté vencida o que haya sido descertificado por la DGI no puede tramitar facturas electrónicas válidas bajo el Sistema de Facturación Electrónica de Panamá (SFEP). El ISV que integra a través de ese PAC asume el riesgo de documentos inválidos.

Verificación de certificación activa

Antes de evaluar el sandbox:
☐ PAC aparece en el listado DGI de PACs certificados activos
☐ La certificación tiene vigencia actual (no vencida)
☐ El PAC tiene capacidad de operación multi-cliente (no solo para sus propias empresas)
☐ El PAC cubre los tipos de documentos del SFEP requeridos por el ISV
☐ El PAC tiene RUC propio de PAC, no opera bajo un intermediario no certificado

Criterio 2 — Sandbox con validación real del SFEP y generación de CAFE

El CAFE (Código de Autorización de Factura Electrónica) es el identificador único que la DGI asigna a cada factura electrónica válida en Panamá. Un sandbox real debe generar CAFEs de prueba siguiendo el mismo flujo que producción: el documento se envía al PAC, el PAC lo transmite a la DGI y la DGI devuelve el CAFE. Un sandbox que genera códigos locales sin pasar por la DGI no prepara al equipo para el comportamiento real del sistema.

Prueba de generación de CAFE en sandbox

// Emisión de factura electrónica en Panamá
POST /v1/invoices
{
  "type": "01",  // Factura de Operación Interna
  "issuer": { "ruc": "8-123-456" },
  "items": [...]
}

// Respuesta esperada:
{
  "invoiceId": "FE-2024-001",
  "cafe": "<código CAFE de prueba>",
  "status": "accepted",
  "dgiResponse": {
    "code": "00",
    "message": "Documento autorizado por la DGI"
  },
  "qrUrl": "https://..."  // URL del código QR con el CAFE
}
// Red flag: cafe ausente en la respuesta, o cafe generado localmente sin validación DGI

Criterio 3 — Cobertura de tipos de documentos SFEP

El SFEP contempla varios tipos de documentos electrónicos: Factura de Operación Interna (01), Factura de Exportación (02), Factura de Importación (03), Nota de Débito (04), Nota de Crédito (05) y Factura de Zona Franca (06). Mapear antes de integrar cuáles tipos necesita el ISV y verificar si el PAC los soporta todos o solo los más comunes.

Criterio 4 — Gestión del RUC y validación de contribuyente

El RUC (Registro Único de Contribuyentes) de Panamá tiene un formato específico que varía según el tipo de persona (natural o jurídica). El PAC debe validar el RUC del emisor y, en facturas B2B, el RUC del receptor. Un PAC que no valida el RUC del receptor en facturas de operación interna puede generar documentos que la DGI rechaza durante la conciliación.

Qué verificar sobre la gestión de RUC

Prueba de RUC inválido:
POST /v1/invoices
{ "issuer": { "ruc": "0-000-0000" } }  // RUC inválido
// Esperado: rechazo con mensaje que identifica el campo ruc como inválido
// Red flag: documento aceptado o error genérico 400

Prueba de receptor sin RUC en B2B:
{ "receiver": { "ruc": null }, "type": "01" }  // B2B sin RUC receptor
// Esperado: error indicando que RUC del receptor es obligatorio en tipo 01
// Red flag: documento aceptado sin RUC de receptor

Criterio 5 — Mensajes de error granulares y accionables

La DGI Panamá devuelve códigos de error cuando rechaza un documento. Los PACs maduros traducen esos códigos a mensajes con el campo afectado identificado; los PACs menos desarrollados reenvían la respuesta DGI sin procesar. La diferencia impacta directamente el tiempo de diagnóstico del equipo de desarrollo cuando hay rechazos en producción.

Criterio 6 — Webhooks y notificación de estado

Aunque Panamá usa un modelo predominantemente síncrono para la asignación del CAFE, algunos flujos de conciliación y documentos especiales pueden tener estados intermedios. Los ISVs con alto volumen necesitan notificaciones de estado sin implementar polling. Verificar si el PAC ofrece webhooks nativos y si incluyen firma para verificar la autenticidad de la notificación.

Criterio 7 — Actualizaciones del SFEP y tiempo de implementación

La DGI Panamá ha publicado actualizaciones al SFEP que modifican requisitos técnicos y documentales. Un PAC que tarda semanas en implementar esos cambios deja a sus clientes emitiendo documentos que eventualmente serán rechazados. Preguntar explícitamente: ¿en cuántos días implementó el PAC el último cambio de la DGI? ¿Hay changelog público con fechas? ¿Los clientes son notificados antes o después de que entre en vigor el cambio?

Criterio 8 — Documentación y DX del PAC

El SFEP tiene requisitos técnicos específicos que no siempre son fáciles de encontrar en la documentación oficial de la DGI. Un PAC con buena DX debe tener una referencia de API clara, ejemplos funcionales para los tipos de documento más comunes, una guía de onboarding que cubra el ciclo completo y acceso al sandbox sin pasar por el equipo comercial. La prueba definitiva: medir el tiempo desde que se obtienen las credenciales de sandbox hasta el primer CAFE de prueba generado.

Para ver cómo se comparan estos criterios con otros mercados de la región, consultar la guía 5 criterios técnicos para elegir una API de facturación en LATAM.

Preguntas frecuentes

¿Cuál es la diferencia entre un PAC certificado y un proveedor de software de facturación en Panamá?

Un PAC certificado por la DGI tiene la autorización legal para tramitar documentos fiscales electrónicos en nombre de los emisores, incluyendo la transmisión a la DGI y la gestión del CAFE. Un proveedor de software de facturación que no esté certificado como PAC puede ofrecer la interfaz o el flujo, pero debe apoyarse en un PAC certificado para la transmisión oficial. Para un ISV que integra vía API, lo relevante es confirmar que la cadena termina en un PAC certificado activo, independientemente de cuántos intermediarios haya.

¿Cómo puedo verificar que el CAFE generado en el sandbox es válido para la DGI?

El CAFE de prueba generado en el sandbox no es un CAFE oficial de la DGI — es un identificador de ambiente de pruebas que sigue el mismo formato pero no está registrado en los sistemas productivos de la DGI. La validación real es que el flujo end-to-end en el sandbox sea idéntico al productivo: el documento se envía al PAC, el PAC lo transmite al ambiente de pruebas de la DGI, y la DGI de pruebas devuelve un código de éxito. Si el sandbox no conecta con el ambiente de pruebas de la DGI, los errores de producción aparecerán como sorpresa.

¿Qué diferencia hay entre una Nota de Crédito y una anulación de factura en el SFEP?

En el SFEP, una factura electrónica con CAFE asignado no puede anularse directamente — debe emitirse una Nota de Crédito (tipo 05) referenciando el CAFE de la factura original para revertir parcial o totalmente el valor. La anulación directa solo es posible en un período muy corto posterior a la emisión y con condiciones específicas definidas por la DGI. Verificar que el PAC soporte la emisión de Nota de Crédito con referencia de CAFE en el sandbox antes de asumir que la funcionalidad está disponible.

¿Es posible integrar el SFEP sin un PAC, conectando directamente a la API de la DGI?

No para la mayoría de los emisores. La DGI Panamá exige que los emisores transmitan sus documentos a través de un PAC certificado, salvo en el caso de grandes contribuyentes con capacidad técnica para certificarse directamente como Emisores Electrónicos. Para ISVs que integran facturación a nombre de sus clientes, la ruta obligatoria es un PAC certificado. Verificar si el ISV o sus clientes califican para la excepción de Emisor Electrónico Directo antes de descartar la figura del PAC.

Este checklist es la aplicación Panamá de los 5 criterios técnicos generales para LATAM. El listado oficial de PACs certificados está disponible en el portal de la DGI Panamá.

Los PACs certificados DGI en Panamá incluyen: The Factory HKA, EBI PAC, Gosocket, Factura Fácil, Edicom y Alanube. Algunos de estos PACs como Edicom y Gosocket operan también en otras jurisdicciones LATAM — factor relevante para ISVs con operación multi-país.