Panamá

En Panamá, Floogos se conecta a la DGI (Dirección General de Ingresos) bajo el modelo SFEP (Sistema de Factura Electrónica de Panamá) a través de un PAC (Proveedor Autorizado de Certificación, por ejemplo The Factory HKA u otro adaptador genérico). El motor arma el XML de la Factura Electrónica (FE) y es el PAC quien la autoriza ante la DGI, asignándole el CUFE (Código Único de Factura Electrónica).

Modelo de integración

• Vía PAC obligatorio: el XML de la FE se arma con el estándar SFEP y se envía al PAC configurado en la credencial, que la autoriza ante la DGI.
• Firma opcional del emisor: si la credencial tiene cargado un certificado propio (.p12), la FE se firma localmente antes de enviarla. Si no hay certificado, el PAC firma por vos como parte del servicio de autorización.
• CUFE: cada FE autorizada recibe un CUFE único que la DGI usa para identificarla. Ese CUFE es el que hay que guardar para emitir notas de crédito/débito, anular el documento o generar su representación.
• CAFE/QR: junto con el CUFE, el PAC genera el CAFE (Comprobante Auxiliar de Factura Electrónica), la representación gráfica con su código QR de verificación.
• ITBMS 7%: el Impuesto de Transferencia de Bienes Muebles y Servicios se calcula al 7% sobre el valor de cada ítem.

Cuándo queda válido un documento

Una FE no tiene validez fiscal por el solo hecho de armarla o firmarla: recién queda válida cuando el PAC la autoriza ante la DGI y devuelve el CUFE. Si el PAC rechaza el envío, la FE no existe fiscalmente y hay que corregir los datos y reenviarla.

Nodos disponibles

Nodo	Descripción
SfepEmitirFactura	Arma la FE (Interna, Importación o Exportación), opcionalmente la firma y la envía al PAC; devuelve el CUFE
SfepEmitirNota	Emite Nota de Crédito (04) o Débito (05) referenciando el CUFE del documento de origen
SfepAnular	Anula una FE autorizada por su CUFE, indicando el motivo
SfepRepresentacion	Genera la representación impresa (CAFE) con el QR de verificación, recuperando el FE por su CUFE

Flujo típico

1. SfepEmitirFactura — arma y autoriza la FE vía el PAC; se obtiene el CUFE.
2. SfepEmitirNota — (si corresponde) emite una nota de crédito o débito referenciando el CUFE de la factura.
3. SfepAnular — (si hubo un error) anula la FE por su CUFE, dentro del plazo permitido por la DGI.
4. SfepRepresentacion — genera el CAFE con el QR de verificación para entregarle al cliente su comprobante impreso o en PDF.

Notas

• La credencial de tipo sfep guarda el RUC y razón social del emisor, el proveedor del PAC, sus credenciales de acceso, el certificado (.p12) opcional y el ambiente (test o producción).
• Floogos valida que el certificado digital no esté vencido antes de intentar firmar y enviar una FE.
• No todos los PAC soportan anulación en el mismo adaptador; conviene confirmar esa capacidad con el proveedor configurado.