| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Lines of code | 1516 |
| Technical Name |
l10n_pa_dgi_fe_inbound |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Lines of code | 1516 |
| Technical Name |
l10n_pa_dgi_fe_inbound |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
FE de entrada Panama
Valida los documentos de Factura Electronica (FE) de tus proveedores y concilialos con tus facturas de proveedor — CUFE, RUC y estado DGI verificados.
Que hace este modulo
El Sistema de Factura Electronica de Panama (SFEP), operado por la Direccion General de Ingresos (DGI), exige a los proveedores emitir documentos electronicos firmados (el XML rFE), cada uno con un CUFE (Codigo Unico de Factura Electronica) unico y un estado de autorizacion de la DGI. Este modulo toma esos documentos de entrada, los analiza, valida el CUFE y el RUC, comprueba de forma cruzada el ITBMS y los totales, y concilia cada uno con la factura de proveedor coincidente en tu Contabilidad de Odoo — convirtiendo una tarea manual y propensa a errores en un flujo controlado y auditable.
Validacion del CUFE
Descomposicion estructural completa del CUFE de 50 caracteres:
prefijo inicial FE, codigo de tipo de documento
(FE01-FE08), y recalculo del digito verificador
modulo-11 para detectar un codigo corrupto o manipulado antes
de contabilizarlo.
Analizador del XML rFE
Analizador agnostico de espacios de nombres para el sobre
rFE de la DGI: datos generales, grupos de RUC del
emisor/receptor, lineas de articulo con codigos de tasa ITBMS, totales
y el bloque de autorizacion ProtocoloAutorizacion.
Digito verificador del RUC
El digito verificador (DV) del RUC de Panama recalculado con el algoritmo oficial modulo-11 de la DGI, tanto en los registros de la compania como del proveedor, de modo que un identificador incorrecto se detecta de inmediato.
Emparejamiento automatico
Un emparejador con puntuacion de confianza enlaza cada documento FE con la factura de proveedor correcta — por CUFE, luego RUC del emisor + numero de documento, luego RUC + importe + fecha cercana.
Conciliacion de ITBMS y totales
El neto, el ITBMS (IVA de Panama) y el total declarados en la FE se comparan con la factura emparejada dentro de una tolerancia configurable, y se verifica la coherencia interna de lineas frente a totales.
Seguimiento del estado DGI
Cada documento lleva su estado de autorizacion de la DGI — Pendiente, Autorizado o Rechazado. Los documentos rechazados se enrutan a una excepcion para que nunca se contabilicen en silencio como deducibles.
Codigos de tasa ITBMS reconocidos
| Codigo | Tasa | Uso tipico |
|---|---|---|
| 00 | 0% / Exento | Bienes y servicios exentos |
| 01 | 7% | Tasa general de ITBMS |
| 02 | 10% | Bebidas alcoholicas, hospedaje |
| 03 | 15% | Productos de tabaco |
Tasas segun la Ficha Tecnica de Factura Electronica de la DGI. El modulo las lee del documento de entrada; no configura tu propia configuracion fiscal.
Resumen de funciones
| Importar XML rFE (subida de archivo o pegado) | Si |
| Extraer documentos de tu propio feed FE / PAC (BYOK) | Si |
| Validacion estructural + digito verificador del CUFE | Si |
| Catalogo de tipos de documento (FE01-FE08) | Si |
| Validacion RUC + DV modulo-11 | Si |
| Emparejamiento de facturas de proveedor con puntuacion de confianza | Si |
| Conciliacion de ITBMS y totales con tolerancia | Si |
| Estado de autorizacion DGI + actualizacion planificada | Si |
| Proteccion contra duplicados / reimportacion (CUFE por compania) | Si |
| Enlace publico de consulta del CUFE en la DGI | Si |
| Chatter, actividades y seguimiento de excepciones | Si |
Trae tus propias credenciales (BYOK)
Este modulo genera y valida el formato FE y, opcionalmente, recupera documentos de entrada y el estado de autorizacion usando tus propias credenciales de feed o PAC, almacenadas unicamente en tu base de datos. No es un PAC certificado y no suplanta ninguna acreditacion de la DGI: tu mantienes tu propia relacion con tu proveedor autorizado y la DGI. Ningun dato de factura se envia a ningun lugar distinto del punto final que configures.
Tecnico
- Odoo 18.0 y 19.0, Community y Enterprise.
- Depende solo de
accountymail— sin modulos exclusivos de Enterprise. - Nucleo de analisis / validacion / conciliacion en Python puro, con pruebas unitarias completas.
- Funciona totalmente sin conexion a partir del XML subido; el feed en vivo es opcional.
English version
Panama FE Inbound
Panama's SFEP (operated by the DGI) requires suppliers to issue signed rFE XML documents, each with a unique CUFE and a DGI authorization status. This module parses those inbound documents, validates the CUFE and RUC, cross-checks the ITBMS and totals, and reconciles each one to the matching vendor bill in your Odoo Accounting.
- 50-char CUFE structural decomposition with modulo-11 verifying-digit recomputation.
- Namespace-agnostic rFE XML parser (general data, parties, lines, totals, ProtocoloAutorizacion).
- Panama RUC DV recomputed with the official DGI modulo-11 algorithm.
- Confidence-scored matching: CUFE, then RUC + number, then RUC + amount + near date.
- ITBMS & totals reconciliation with tolerance; DGI status tracking (Pending/Authorised/Rejected).
- BYOK feed/PAC retrieval, stored only in your DB; not a certified PAC. Odoo 18 and 19, depends on
accountandmail.
Screenshots
Pull From Feed
Import Fe Document
Inbound Fe Documents
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module