SFEP Panamá — Facturación electrónica (DGI, Factura Electrónica)

Descripción

Los nodos SFEP conectan tus workflows con la facturación electrónica de Panamá (DGI, Sistema de Factura Electrónica de Panamá). Floogos arma el FE (XML, formato de la DGI), opcionalmente lo firma, y lo envía a un PAC (Proveedor Autorizado Calificado) que valida, asigna el CUFE y transmite a la DGI, devolviendo el CAFE (Constancia de Autorización) con su QR.

Nodo	Qué hace
SFEP: Emitir factura (sfepEmitirFactura)	Factura de Operación Interna (01), Importación (02) o Exportación (03)
SFEP: Nota crédito/débito (sfepEmitirNota)	Nota de Crédito (04) o de Débito (05)
SFEP: Anular FE (sfepAnular)	Anula un FE por su CUFE, vía el PAC
SFEP: Representación / QR (sfepRepresentacion)	Genera el CAFE imprimible con QR

En Panamá se emite vía un PAC

No se emite directo con la DGI: el FE (XML) se envía a un PAC (The Factory HKA, etc.) que valida, asigna el CUFE (código único) y transmite a la DGI, devolviendo el CAFE con su QR. El PAC se configura en la credencial. Si no cargás un certificado propio, el PAC firma por vos. El ITBMS general es 7%.

Credencial

Los nodos usan una credencial de tipo SFEP. Creala en Credenciales → Agregar → Panamá / DGI (SFEP) con:

Campo	Descripción
RUC del emisor + DV	El registro único y su dígito verificador.
PAC + credenciales	El proveedor (thefactoryhka o generic) y su token/usuario.
Razón social / Sucursal	Datos del emisor.
Punto de facturación	Código del punto (001).
Ubicación	Dirección, corregimiento, distrito, provincia, coordenadas.
Ambiente	Pruebas o Producción.
Certificado (.p12)	Opcional: solo si firmás vos.

Emitir una factura

Nodo: SFEP: Emitir factura. Los precioUnitario van sin ITBMS; Floogos calcula el ITBMS (7%, tasa 01) y los totales. El receptor es opcional (omitilo para consumidor final).

{
  "tipo": "01",
  "receptor": { "ruc": "8-888-8888", "dv": "12", "nombre": "Cliente Panamá S.A." },
  "items": [
    { "descripcion": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 100 }
  ]
}

tasaItbms por ítem: 01 7% (por defecto), 02 10%, 03 15%, 00 exento. El nodo devuelve el CUFE, la URL del CAFE y el QR.

Notas de crédito y débito

Nodo: SFEP: Nota crédito/débito. La nota referencia el FE de origen por su CUFE con referencia:

{
  "tipo": "04",
  "referencia": { "cufe": "FE0155...CUFE", "numero": "0000000001", "fecha": "2026-07-29" },
  "receptor": { "ruc": "8-888-8888", "dv": "12" },
  "items": [ { "descripcion": "Devolución", "cantidad": 1, "precioUnitario": 40 } ]
}

Anular un FE

Nodo: SFEP: Anular FE. Anula un FE por su CUFE (con un motivo obligatorio), a través del PAC.

Representación impresa (QR)

Nodo: SFEP: Representación / QR. Genera el CAFE imprimible en HTML (exportable a PDF), con el CUFE y el QR que apunta a la consulta pública de la DGI (o a la URL de CAFE del PAC).

Manejo de errores

Situación	Reintentable	Qué hacer
PAC rechaza	No	El nodo devuelve el error del PAC. Corregí el FE.
Certificado vencido	No	Renová el .p12 y actualizá la credencial.
Credenciales del PAC	No	Revisá el token/usuario del PAC.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Sandbox del PAC

Probá siempre en el ambiente de pruebas de tu PAC antes de producción, y validá la estructura del XML contra el XSD de la DGI (SFEP). La firma XAdES completa debe validarse contra el ambiente de pruebas.

Ver también

• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para servicios no cubiertos por estos nodos.