Vista general de la API del Gateway G-Force para facturación electrónica en Panamá (DGI/SFEP).

API del Gateway G-Force

La API del Gateway G-Force permite la facturación electrónica en Panamá a través del sistema DGI/SFEP. Actúa como intermediario entre tu aplicación y los PAC (Proveedor Autorizado Calificado).

Obtener credenciales

Para usar la API necesitas credenciales de G-Force (nivel plataforma) y credenciales del PAC (nivel contribuyente). Por ahora, la única forma de obtenerlas es contactando directamente a G-Force Consulting. Más detalles en la guía de Autenticación.

Cómo funciona

Tu Sistema (JSON) → Gateway G-Force → XML + firma → PAC → DGI → CUFE + QR

Envías JSON estructurado al Gateway de G-Force
G-Force lo convierte a XML firmado (nunca manejas XML ni firmas criptográficas)
G-Force lo enruta al PAC correcto según el Id_Pac
El PAC valida con la DGI (modelo de pre-autorización)
La DGI devuelve un CUFE (código único de factura) + QR + autorización
Llamas a DownloadPDF para obtener el CAFE oficial (PDF) generado por el PAC

Generación del CAFE (PDF)

El PAC genera el CAFE oficial (Comprobante Auxiliar de Factura Electrónica). No puedes generar ni personalizar el PDF de la factura por tu cuenta. Solo los PAC pueden diseñar el formato del CAFE, con aprobación previa de la DGI.

Después de cada llamada exitosa a SendDocument, debes llamar a DownloadPDF para obtener el CAFE y almacenarlo. Este es el único documento de factura legalmente válido en Panamá.