Manual de usuario · Facturación electrónica
Facturación Electrónica de Panamá en Odoo 19
Del RUC al CUFE: configuración del PAC, catálogos de la DGI, emisión de facturas, notas de crédito y débito, anulaciones, contingencia y punto de venta con el Sistema de Facturación Electrónica de Panamá.
1.Cómo usar este manual
Qué encontrará aquí, cómo está organizado y qué se asume que ya funciona.
Este manual cubre la facturación electrónica de Panamá dentro de Odoo 19, implementada por
el módulo multipac_felpa y su extensión para el punto de venta
pos_multipac_felpa. Está escrito para tres perfiles distintos:
Quien configura
Capítulos 4 a 15. Todo lo que hay que dejar listo antes de emitir el primer documento: datos de la empresa, credenciales del PAC, diarios, catálogos, contactos y productos.
Quien factura
Capítulos 16 a 27. La operación diaria: emitir, anular, corregir con notas de crédito y débito, consultar el estado en la DGI y entregar el CAFE al cliente.
Quien atiende la caja
Capítulos 28 a 31. El punto de venta: cómo se timbra cada ticket, cómo se anula y qué revisa Odoo al cerrar la sesión.
Convenciones
- Las rutas de menú se escriben así: Contabilidad → Clientes → Facturas.
- Los nombres de campo aparecen tal como se leen en la pantalla en español: Tipo de Emisión FEL de Panamá.
- Los nombres técnicos, cuando hacen falta, van en monoespaciado:
fel_pa_cufe. - Los estados FEL se muestran como etiquetas: Borrador Aceptada Rechazado Cancelado.
Que Odoo 19 ya está instalado, que la empresa tiene su plan de cuentas de Panamá cargado
(l10n_pa) y que la empresa ya está afiliada al Sistema de Facturación Electrónica
de Panamá y tiene contrato con un PAC. La afiliación ante la DGI y la contratación del PAC son
trámites externos a Odoo.
La base de demostración de las capturas
Todas las capturas de este manual provienen de una base de demostración creada específicamente
para documentarlo. La empresa emisora se llama GRUPO CMW, S.A., tiene RUC
155653692-2-2017 con DV 48 y opera con el PAC The Factory HKA en su
ambiente de pruebas.
Las facturas, notas de crédito, notas de débito y anulaciones que verá en las capturas fueron certificadas de verdad contra el ambiente de pruebas de la DGI: los CUFE, los protocolos de autorización y los códigos QR son auténticos y provienen de la respuesta real del PAC. Por tratarse del ambiente de pruebas, ninguno de esos documentos tiene efecto comercial ni fiscal.
2.La facturación electrónica en Panamá
Los cinco conceptos que hay que tener claros antes de tocar Odoo.
En Panamá la factura electrónica se rige por el Sistema de Facturación Electrónica de Panamá (SFEP) de la Dirección General de Ingresos (DGI). La lógica de fondo es sencilla: usted no emite una factura y la manda al cliente sin más; primero la certifica, y sólo cuando la DGI la autoriza el documento existe legalmente.
Los conceptos
| Término | Qué significa |
|---|---|
| DGI | Dirección General de Ingresos. Es la autoridad tributaria panameña, equivalente a la SAT guatemalteca o al SAT mexicano. |
| PAC | Proveedor Autorizado Calificado. Es la empresa privada certificada por la DGI que recibe el documento, lo firma electrónicamente y lo transmite a la DGI. Odoo nunca habla directamente con la DGI: siempre habla con el PAC. |
| FE | Factura Electrónica. El documento fiscal propiamente dicho, en formato XML/JSON, que vive en los servidores de la DGI. |
| CUFE | Código Único de Factura Electrónica. Es la «matrícula» del documento: una cadena larga que identifica de forma única esa factura ante la DGI. Sin CUFE, el documento no está certificado. |
| CAFE | Comprobante Auxiliar de Factura Electrónica. Es la representación impresa o en PDF que se entrega al cliente. El CAFE no es la factura: es un comprobante de que existe una FE, y por eso lleva impreso el CUFE y un código QR para consultarla. |
| RUC / DV | Registro Único de Contribuyente y su Dígito Verificador. En Panamá el DV se maneja como un dato aparte del RUC y siempre viaja junto con él. |
| Folios | La cantidad de documentos que su licencia con el PAC le permite certificar. Se consumen uno por documento aceptado. |
A lo largo de todo el manual verá que la pregunta clave siempre es la misma: ¿el documento tiene CUFE? Si lo tiene, está certificado ante la DGI y ya no se puede modificar: sólo se puede anular o corregir con una nota. Si no lo tiene, todavía es un borrador interno de Odoo, por más que esté publicado contablemente.
Los cinco PAC soportados
El módulo trae integración con cinco proveedores. Cada uno usa una tecnología distinta y expone funciones distintas, y eso cambia lo que usted verá en la pantalla:
| PAC | Protocolo | Qué funciones ofrece en Odoo |
|---|---|---|
| The Factory HKA | SOAP | El más completo: enviar, consultar estado, descargar PDF y XML, anular, consultar RUC/DV, folios restantes, enviar el documento por correo desde el PAC y rastrear esos correos. Además soporta la utilidad offline. |
| EBI | SOAP | Mismo conjunto de funciones que HKA (comparten la estructura del mensaje). |
| eFacturapty | SOAP | Igual que los anteriores, con una diferencia de formato en la lista de ítems y formas de pago. No expone la consulta de estado del documento. |
| Digifact | REST | Requiere generar un token con usuario y contraseña, que caduca. Enviar, consultar RUC/DV, descargar PDF y XML, consultar estado. No soporta folios restantes ni el envío de correo por el PAC, ni contingencia offline. |
| PanaFacturas | REST | También trabaja con token. Enviar, consultar RUC/DV y anular. No soporta descargas de PDF/XML, consulta de estado, folios ni correo. |
Odoo esconde automáticamente los botones que su PAC no soporta. Si no ve Folios restantes o Descargar PDF FEL, no es un error: es que ese proveedor no ofrece esa función. En el capítulo 25 hay una tabla que resume qué botón aparece con qué PAC.
Para seguir leyendo, crea tu cuenta
Quedan 31 capítulos más en este manual. Crea tu cuenta y solicita el acceso: lo aprobamos a mano, normalmente el mismo día.