Guatemala FEL Inbound
Parse inbound SAT FEL DTE documents, validate the certifier authorisation and reconcile to vendor bills
FEL de entrada Guatemala
Recibe, valida y concilia los documentos DTE de la SAT de tus proveedores en Odoo 18, 19 y 20
Carga los archivos XML del DTE (Documento Tributario Electronico) que tus proveedores emiten a traves del regimen FEL (Factura Electronica en Linea) de la SAT de Guatemala, verifica que fueron realmente certificados por un certificador autorizado (GFACE), y convierte cada uno en una factura de proveedor — o concilialo con una factura que ya contabilizaste. Trae tu propio acceso SAT/certificador (BYOK).
Analizador real de DTE FEL de la SAT
Analiza el esquema GTDocumento 0.2.0 de la SAT:
DatosGenerales, Emisor,
Receptor, Items, Totales y
el bloque Certificacion. Tolerante a espacios de
nombres — lee el documento tanto si el espacio de nombres FEL
esta declarado, se usa un espacio de nombres por defecto, o el
archivo viene envuelto en un sobre SOAP o llega por lotes:
un archivo con varios GTDocumento crea un documento
por cada DTE, no solamente el primero.
Verificacion de la autorizacion del certificador
Un documento FEL legalmente valido lleva un
NumeroAutorizacion UUID de la SAT estampado por el
certificador. El modulo expone ese UUID, el NIT y nombre del
certificador, valida que el UUID sea un GUID bien formado, y
se niega a contabilizar un documento no certificado.
Validacion modulo-11 del NIT
El algoritmo real de digito verificador modulo-11 de la SAT
(incluyendo el caracter de control K), aceptacion del
CUI de 13 digitos y los centinelas de consumidor final
CF / extranjero EXT — aplicado al
NIT del emisor, identificacion del receptor, contactos y NIT de la
compania.
Conciliacion inteligente de facturas de proveedor
Cuando un DTE coincide con una factura de proveedor que ya introdujiste, el modulo las enlaza automaticamente usando una puntuacion de confianza construida a partir del UUID de autorizacion, el numero de documento, el importe y la fecha. Sin coincidencia? Crea una factura de proveedor nueva a partir de las lineas del DTE.
Que hace este modulo
| Capacidad | Detalle |
|---|---|
| Importar | Sube uno o varios archivos XML de DTE de proveedor a traves del asistente de importacion; cada uno se convierte en un documento de entrada. |
| Analizar | Cabecera, partes, lineas de articulo (Bien / Servicio), base e importe de IVA por linea, y totales del documento. |
| Validar | UUID de autorizacion del certificador, NIT modulo-11 del emisor / receptor, tarifa de IVA (12%) — la tarifa derivada se ajusta a la tarifa legal cuando el redondeo al centimo la desvia, y una linea que declara IVA para la que no existe un impuesto de compras equivalente bloquea la contabilizacion en lugar de perder el IVA en silencio — y coherencia aritmetica de lineas frente a totales declarados con la tolerancia absoluta en quetzales que configuras. |
| Conciliar | Puntua y enlaza el DTE con una factura de proveedor existente sin conciliar del mismo proveedor, o crea una nueva factura / nota de credito. |
| Tipos de documento | FACT, FCAM, FPEQ, FESP, NDEB, NCRE, NABN y las variantes agropecuarias; los documentos de credito se mapean a reembolsos de proveedor. |
| Automatizacion | Accion planificada opcional para validar en lote los documentos recien recibidos. |
Informe de validacion
Cada documento conserva un informe estructurado y etiquetado por gravedad (los errores bloquean la facturacion; las advertencias se muestran). Los errores incluyen una autorizacion de la SAT ausente o malformada, un NIT de emisor incorrecto, o la falta de lineas de articulo. Las advertencias cubren el redondeo de totales, un XML sin firma, o una tarifa de IVA no estandar.
Limite BYOK
Este modulo analiza, valida y concilia los documentos que tienes derecho a recibir usando tus propias credenciales SAT / certificador. No es un certificador (GFACE) y no almacena acreditacion de terceros — tus tokens permanecen en tu base de datos.
Tecnico
- Odoo 18.0, 19.0 y 20.0, compatible con Community (depende de
account,mail). - Servicios de analizador / validador / NIT / conciliacion en Python puro, con pruebas unitarias completas.
- Anade
l10n_gt_nita los contactos y campos de autorizacion FEL a las facturas de proveedor, ambos buscables. - Configuracion por compania: diario, cuenta de gasto, tolerancia, umbral de conciliacion, auto-crear proveedor.
- Compatible con multi-compania: reglas de registro globales limitan cada documento, cada linea y cada configuracion a las companias del usuario. Acceso dividido en grupos Usuario FEL y Administrador FEL.
- Consulta SAT: consulta el servicio del SAT / certificador que configuraste (endpoint y token propios) para saber si un DTE recibido sigue vigente o fue anulado por el emisor.
- Conciliacion: solo se consideran facturas de proveedor en borrador o contabilizadas — nunca canceladas — dentro de una ventana de 90 dias alrededor de la fecha de emision.
English version
Guatemala FEL Inbound
Load the supplier DTE XML files issued through the Guatemala SAT FEL regime, verify they were truly certified by an authorised certificador (GFACE), and turn each one into a vendor bill or reconcile it to a bill you already booked. BYOK.
- Real SAT
GTDocumento0.2.0 DTE parser, namespace-tolerant and batch aware: everyGTDocumentoin a batch file becomes its own record. - SAT consulta against your own endpoint and token, so an annulled DTE is detected after delivery.
- Global multi-company record rules on documents, lines and configuration.
- Certifier authorisation check: surfaces the
NumeroAutorizacionUUID and refuses un-certified documents. - Real SAT modulo-11 NIT validation (K char, CUI, CF/EXT sentinels).
- Confidence-scored vendor-bill reconciliation or auto-create from DTE lines.
- Document types FACT, FCAM, FPEQ, FESP, NDEB, NCRE, NABN and agro variants; credit docs map to refunds.
- Severity-tagged validation report; optional scheduled bulk validation.
BYOK boundary: parses, validates and reconciles using your own
SAT / certificador credentials, stored only in your database. Not a
certificador (GFACE). Odoo 18.0, 19.0 and 20.0, depends on
account and mail.
Screenshots
Configuration
Inbound Documents
Import Fel Dte Xml
Update date: 2026-10-01
User guides (PDF)
Related modules
Advanced Financial Analytics
Cash-flow forecast records computed from posted invoices
US BAI2 Statement Split
Split multi-account US BAI2 cash-management statements and route each account to its matching Odoo bank journal
US BAI2 File Writer
Write US BAI2 cash-management statement files from Odoo bank-transaction data - balances, transactions, control totals