Facturación Electrónica en Línea (FEL) de Guatemala en Odoo 20

1.Cómo usar este manual

Qué cubre, para quién está escrito y de dónde salieron las pantallas que ilustran cada paso.

Este manual explica cómo emitir facturación electrónica en línea (FEL) de Guatemala desde Odoo 20: cómo se configura el certificador, cómo se emite cada tipo de documento tributario electrónico, qué hacer cuando la SAT rechaza un documento, cómo se anula y cómo funciona todo esto dentro del punto de venta.

Cubre dos módulos principales y uno complementario, que trabajan juntos:

Está pensado para tres perfiles:

• El cajero o facturador — capítulos 14 a 18 y 22 a 26: emitir, anular y devolver.
• El contador — capítulos 19 a 21 y 27: anulaciones, errores de la SAT, contingencia y monitoreo de los documentos certificados.
• Quien implementa — capítulos 4 a 13: la lista completa de configuración, campo por campo, con las reglas que la SAT valida en cada uno.

1.1 Convenciones

2.Qué es la FEL y cómo funciona

El circuito completo, desde que usted presiona «Confirmar» hasta que el cliente puede verificar su factura en el portal de la SAT.

La Facturación Electrónica en Línea es el régimen con el que la SAT sustituyó las facturas preimpresas. Bajo la FEL, un documento no existe legalmente hasta que un certificador autorizado lo firma y lo registra ante la SAT, y eso ocurre en el momento mismo de emitirlo, no al final del mes.

2.1 Los actores

2.2 El circuito de una factura

Los cinco pasos ocurren en un solo clic y tardan típicamente entre uno y tres segundos. Si algo falla en el paso 3 o 4 —un dato mal capturado, el certificador caído, la conexión perdida— Odoo no deja a medias el documento: lo detiene, lo difiere para reintentarlo o lo pasa a contingencia, según cómo esté configurado. Los capítulos 20 y 21 explican esos tres caminos.

2.3 Los datos que devuelve la SAT

Cuando la certificación tiene éxito, el documento queda marcado con cuatro datos que ya no cambian y que son los que el cliente y la SAT reconocen:

En Odoo 20 los tres primeros datos que importan al día a día —Estado FEL, Serie y Número DTE— aparecen en la cabecera de la factura, junto al diario, sin necesidad de abrir ninguna pestaña.

2.4 Verificación pública

Todo DTE se puede verificar sin contraseña. Una vez certificado, la factura muestra dos botones nuevos en su barra superior:

• PDF certificador — descarga el PDF que emite el certificador (INFILE, Megaprint, Digifact o G4S) con el diseño oficial del proveedor.
• PDF SAT — abre en una pestaña nueva el verificador público de la SAT (felpub.c.sat.gob.gt) con el número de autorización, el NIT emisor, el NIT receptor y el monto ya cargados; desde ahí la SAT entrega su propia representación del documento.

3.Los módulos y su alcance

Qué instala cada uno, de qué depende y qué aparece en pantalla después de instalarlo.

3.1 multicert_felgt — el motor de la FEL

Es el módulo principal. Trabaja sobre las facturas de cliente, las facturas de proveedor (para la factura especial), las notas de crédito y débito y los recibos.

Depende de account, sale, l10n_gt y base_address_extended, y necesita las librerías de Python img2pdf y fpdf instaladas en el servidor.

3.2 pos_multicert_felgt — la FEL en el punto de venta

Certifica cada venta del punto de venta en el momento del cobro, imprime el ticket con los datos del DTE y el código QR de verificación, y agrega a la caja las operaciones que antes obligaban a ir al backend: anular con concepto de la SAT, emitir la nota de crédito de una devolución y trabajar en contingencia cuando no hay Internet.

Depende de point_of_sale, pos_stock, account_tax_python y del propio multicert_felgt.

3.3 nit_dpi_multicert_verification — complementario

Añade la consulta en línea del NIT y del CUI contra el servicio del certificador. Al capturar un contacto, el sistema trae el nombre tal como está inscrito en la SAT, de modo que el DTE no se rechace por un nombre que no coincide. Guarda además una bitácora de consultas para no pagar dos veces por el mismo NIT. No es indispensable para emitir: sin él, Odoo 20 sigue validando el dígito verificador del NIT, pero no consulta el nombre.

4.Puesta en marcha: lista de verificación

El orden en que conviene configurar, con el capítulo donde se explica cada paso.

Una implementación de FEL que sale bien a la primera sigue este orden. Cada línea es un requisito de la siguiente.

1. Contrate al certificador y pida las credenciales del ambiente de pruebas y las de producción. Pida también el código de establecimiento de cada sucursal (lo asigna la SAT, no el certificador).
2. Complete los datos de la empresa: NIT, razón social inscrita, dirección, correo y tipo de personería. → capítulo 5
3. Active la emisión y cargue las credenciales del certificador. → capítulo 6
4. Revise las opciones generales: moneda del DTE, redondeo, descripción de línea, errores y anulaciones. → capítulo 7
5. Configure un diario por cada tipo de documento que vaya a emitir y actívele la generación de FEL. → capítulo 8
6. Asigne las frases que correspondan a su régimen tributario en cada diario. → capítulo 9
7. Verifique impuestos y posiciones fiscales: el IVA debe estar clasificado como impuesto FEL. → capítulo 10
8. Configure la validación de NIT/DPI si la contrató. → capítulo 13
9. Dé permisos a los usuarios que facturan y a los que pueden anular. → capítulo 29
10. Emita una factura de prueba contra el ambiente de pruebas y verifíquela en el portal del certificador antes de cambiar a producción. → capítulo 14

5.Datos de la empresa emisora

Los campos de la compañía que viajan dentro del XML y que la SAT valida uno por uno.

La SAT compara los datos del emisor con su registro. Si el nombre o la dirección no coinciden con lo inscrito, rechaza el documento. Estos campos se llenan en Ajustes › Usuarios y empresas › Empresas.

5.1 Campos obligatorios

Odoo los revisa antes de enviar nada al certificador y detiene la confirmación si falta alguno:

5.2 La pestaña Configuración Certificador FEL Guatemala

La ficha de la compañía de Odoo 20 trae tres pestañas propias de Guatemala: Configuración Validador NIT/DPI FEL Guatemala (la instala el módulo complementario), Diseño de Factura FEL Guatemala (capítulo 28) y Configuración Certificador FEL Guatemala, que repite las opciones de Ajustes y agrega las propias del contribuyente. Solo las ve el grupo Encargado Factura Electronica.

6.Credenciales del certificador

Los cinco certificadores soportados y qué dato pide cada uno.

La configuración de FEL de uso diario vive en Contabilidad › Configuración › Ajustes, en el bloque Facturación Electrónica, que en Odoo 20 aparece al principio de la sección Contabilidad. El bloque solo se muestra si la compañía es de Guatemala.

6.1 Elegir el certificador

El desplegable Certificador a utilizar define contra qué proveedor se firma. Al elegirlo, Odoo muestra únicamente el bloque de credenciales de ese proveedor y oculta los demás.

6.2 INFILE paso a paso

Es el certificador más usado en Guatemala, y el que ilustra este manual.

7.Opciones generales de FEL

Cómo se arma el contenido del DTE: moneda, decimales, descripción de las líneas, qué hacer cuando algo falla y las reglas de anulación.

Estas opciones están en el mismo bloque Facturación Electrónica y afectan a todos los documentos de la compañía.

7.1 Moneda del documento

Un contacto puede tener su propia preferencia: en la ficha del cliente, Moneda de facturación en base al documento hace que sus DTE salgan siempre en la moneda del documento aunque la compañía convierta.

7.2 Descripción y unidad de medida de las líneas

7.3 Qué hacer cuando la certificación falla

7.4 Anulaciones y notas fuera de plazo

• Nombre del Documento Establecido por FEL — renombra el asiento contable como DTE- en vez de la secuencia de Odoo.
• Código Establecimiento — el de la compañía, usado cuando el diario no define el suyo.
• Permitir anulación extemporánea — envía la anulación de un DTE a Consumidor Final aunque haya pasado el plazo en línea (capítulo 19).
• Vigencia frase de NCRE fuera de plazo — fecha desde la que el sistema agrega sola la frase tipo 9, escenario 22 a las notas de crédito emitidas más de dos meses después de la factura de origen. La SAT la exige desde el 29 de octubre de 2026 y la rechaza en cualquier otro tipo de DTE, incluida la nota de débito. Si se deja vacía, la frase no se agrega.
• Mostrar Columna de Descuento (bloque Configuración Factura) — agrega la columna de descuento a la factura impresa.

8.Los diarios FEL

Un diario por tipo de documento: dónde se activa la FEL, qué establecimiento usa y qué frases lleva.

En Odoo, el diario es lo que decide si una factura se certifica o no. La configuración está en Contabilidad › Configuración › Diarios, pestaña Configuración FEL Guatemala, que aparece únicamente en diarios de venta y de compra de una compañía guatemalteca.

8.1 Un diario por tipo de documento

La forma recomendada de trabajar es un diario por cada tipo de DTE. Así el usuario elige el diario y el tipo de documento sale correcto sin pensar:

8.2 Los campos de la pestaña

Todos los campos de esta pestaña llevan el sufijo - FEL GT en su etiqueta, para distinguirlos de los campos estándar del diario.

8.3 Contingencia

El grupo Contingencia FEL GT tiene la casilla Activar contingencia manualmente y los tres números del bloque de números de acceso que la SAT entrega para emitir sin conexión (rango inicial, rango final y número actual). Deben estar entre 100000000 y 999999999. El capítulo 21 explica cómo se usan.

8.4 Adendas

Una adenda es información adicional que viaja en el DTE sin efecto tributario, pensada para que el receptor la procese automáticamente. Se activa con Adenda Activa y luego se eligen, con interruptores, los datos a incluir:

9.Las frases FEL

Qué son, cuáles le tocan a su empresa y qué pasa si faltan.

Las frases son leyendas normadas por la SAT que declaran el régimen tributario del emisor y las exenciones que aplican al documento. Van dentro del XML como un código de tipo y un código de escenario, y se imprimen al pie de la factura y del ticket. Si falta una frase obligatoria para su régimen, la SAT rechaza el DTE: el capítulo 20 muestra un rechazo real por esa causa.

9.1 Los nueve tipos

9.2 Cómo se asignan

Las frases se configuran en el diario y de ahí se copian a cada factura nueva. En la factura se ven —y se pueden ajustar caso por caso mientras está en borrador— en la pestaña FEL, grupo Frases FEL. Tres frases las pone o las quita el propio sistema:

• Tipo 9, escenarios 16 y 17: solo en la nota de abono, según la naturaleza de la operación (capítulo 18). Si alguna de ellas aparece en otro tipo de documento, Odoo no deja confirmar.
• Tipo 9, escenario 22: solo en la nota de crédito emitida más de dos meses después de su factura de origen, a partir de la vigencia configurada (capítulo 7).

10.Impuestos y posiciones fiscales

Cómo se traducen los impuestos de Odoo a los impuestos que entiende la SAT.

El XML del DTE no lleva «IVA por ventas 12%»: lleva un nombre de impuesto del catálogo de la SAT y su monto. La traducción se define en cada impuesto, en Contabilidad › Configuración › Impuestos.

10.1 Campos FEL del impuesto

Los tres campos aparecen en la ficha del impuesto solo cuando su país es Guatemala. Si una línea lleva un impuesto sin clasificación FEL, Odoo detiene la confirmación con el mensaje «El impuesto … no tiene clasificación del Impuesto».

10.2 Posiciones fiscales

Una posición fiscal cambia los impuestos según el tipo de cliente. Para la FEL, lo relevante es la casilla Exención De IVA, que aparece en las posiciones de compañías guatemaltecas y marca la posición como exenta.

11.Tipos de DTE y cómo se eligen

Los tipos de documento que emite el módulo y las tres cosas que deciden cuál sale.

11.1 El catálogo

11.2 Quién decide el tipo

El campo Tipo de Factura de la factura es el que manda en el XML, pero su valor se calcula en cascada:

Hay dos excepciones que Odoo fija solo:

• Una rectificativa de cliente (la nota de crédito estándar de Odoo) nace como NABN; cámbiela a NCRE si lo que quiere es una nota de crédito, o emítala desde un diario con tipo NCRE.
• Una factura de proveedor nace como FESP, que es el único tipo que se emite desde compras. En un diario de compra sin FEL, el documento queda como interno.

11.3 Estados de la certificación

Independiente del estado contable (borrador, registrado, cancelado), cada documento tiene su Estado certificación FEL, que en la cabecera de la factura se rotula Estado FEL:

12.Contactos: NIT, CUI, pasaporte y CF

Cómo se identifica al receptor en Odoo 20 y qué reglas de la SAT dependen de esa identificación.

El receptor es el dato que más rechazos provoca. La SAT valida que exista, que el nombre coincida con su registro y que el tipo de identificación sea coherente con el monto y el tipo de documento.

12.1 Cómo identifica Odoo 20 al receptor

Odoo 20 trae de serie los identificadores del contacto: además del NIT, la localización guatemalteca agrega el campo CUI (el número del DPI) y, con el botón + junto al NIT, se pueden registrar otros identificadores, entre ellos el pasaporte. El módulo FEL lee esos datos en este orden:

Un contacto hijo (por ejemplo, la sucursal de un cliente) puede facturar con otro número: el campo NIT Contacto, que aparece solo en contactos con empresa matriz, tiene prioridad sobre todo lo anterior.

12.2 Consumidor Final

Cuando el cliente no se identifica, el DTE se emite a Consumidor Final: el NIT viaja como CF y el nombre como «Consumidor Final».

12.3 Disposiciones de la SAT para Consumidor Final

Las Reglas y Validaciones de la SAT vigentes en 2026 endurecieron el tratamiento del receptor CF. El módulo las aplica y las explica en pantalla:

12.4 Contacto extranjero

La casilla Es Extranjero de la ficha marca al receptor del exterior y vuelve obligatorios los datos del consignatario de la pestaña Información Exportación, que exige la factura de exportación. Estos datos se heredan a los contactos hijos de la misma empresa.

12.5 Otros campos FEL del contacto

• Moneda de facturación en base al documento y Moneda de facturación — la moneda en que se le factura a ese cliente (capítulo 7).
• No Validar NIT con Certificador y Bloquear Escritura — los agrega el módulo complementario (capítulo 13). El segundo impide que un usuario sin permiso de encargado cambie el NIT, el CUI, el nombre o la dirección de un contacto ya validado.

13.Validación de NIT y DPI con el certificador

Módulo complementario: cómo traer el nombre inscrito del contribuyente antes de facturarle, y cómo evitar pagar dos veces por la misma consulta.

El módulo nit_dpi_multicert_verification consulta el NIT o el CUI contra el servicio del certificador y reemplaza el nombre capturado por el nombre inscrito ante la SAT. Es la forma más eficaz de evitar rechazos por diferencias de nombre.

13.1 Configuración

Está en el mismo Ajustes de contabilidad, bloque Validación de Contactos por medio de NIT o DPI, y se repite en la pestaña Configuración Validador NIT/DPI FEL Guatemala de la compañía. Es una configuración independiente de la del certificador de emisión: puede firmar con un proveedor y consultar NIT con otro.

13.2 Cómo se usa

Hay dos caminos, y ambos escriben el nombre oficial en el contacto:

1. Al crear el contacto: escriba el NIT (o el DPI) en el campo del nombre o en el del NIT y guarde. El sistema consulta y sustituye el nombre por el que devuelve la SAT. Un número de trece dígitos se trata como DPI y se guarda en el campo CUI, no en el NIT.
2. Sobre un contacto existente: abra la ficha y pulse Verificar Contacto. Consulta el NIT, o el CUI si el contacto no tiene NIT.

Si el número no existe, el sistema lo dice con claridad —«El NIT 99999999 que ingresó no es válido»— y no permite guardar. Si se escribe un DPI de trece dígitos en el campo NIT de un contacto ya creado, el aviso es «El DPI no es un NIT: regístrelo en el contacto como identificador CUI».

13.3 La bitácora de consultas

Cada consulta al proveedor se guarda en Contactos › Verificaciónes de Contactos con el NIT, el nombre devuelto, el certificador usado y dos contadores: consultas hechas al API y consultas resueltas desde la base local.

14.Emitir una factura electrónica

El procedimiento completo, qué revisar antes de confirmar y qué queda guardado después.

14.1 Paso a paso

1. Vaya a Contabilidad › Clientes › Facturas y pulse Nuevo.
2. Elija el cliente. Si es nuevo, capture el NIT primero para que la validación traiga el nombre inscrito (capítulo 13).
3. Confirme el diario. Es lo que decide si el documento se certifica y con qué código de establecimiento.
4. Verifique la fecha de vencimiento: es obligatoria para la FEL y Odoo detiene la confirmación si falta.
5. Capture las líneas con su producto, cantidad, precio e impuestos.
6. Abra la pestaña FEL y revise el Tipo de Factura y las frases.
7. Si quiere un diseño impreso distinto del de la compañía, elíjalo en Plantilla Factura (capítulo 28).
8. Pulse Confirmar. La certificación ocurre en ese momento.

14.2 Qué revisa Odoo antes de enviar

Si algo falta, la confirmación se detiene con un mensaje concreto y no se envía nada al certificador:

• Registro fiscal, correo, NIT y dirección de la empresa emisora.
• Fecha de vencimiento de la factura y nombre del receptor.
• Tipo de factura distinto de «Ninguno».
• Que cada línea lleve impuesto y que cada impuesto tenga su clasificación FEL.
• Límite de Q2,500.00 cuando el receptor es CF.
• Que el tipo de documento sea válido para el receptor (nada de notas a CF).
• Que las frases de la nota de abono estén solo en la nota de abono.

14.3 La pestaña FEL

Es el expediente electrónico del documento. Aparece en facturas de cliente, facturas de proveedor y rectificativas, siempre que el diario tenga la FEL activa.

14.4 Facturas históricas sin certificar

Al migrar de otro sistema hay que cargar facturas que ya fueron certificadas antes. Para eso se usa un diario con la generación de FEL desactivada: las facturas se registran normalmente, quedan Sin certificar y nunca se envían a la SAT. Como el diario no tiene FEL, la factura tampoco muestra la pestaña FEL ni el estado en la cabecera.

15.Factura cambiaria y de exportación

Dos variantes de la factura con requisitos propios de la SAT.

15.1 Factura cambiaria (FCAM)

Documenta una venta al crédito como título de crédito. Se emite igual que una factura normal, pero con el tipo FCAM, que se elige en la pestaña FEL cuando el diario está en «Usuario». El módulo agrega al XML el complemento cambiario con el abono, su monto y la fecha de vencimiento de la factura.

15.2 Factura de exportación (FEXP)

Para ventas al exterior. Además de los datos normales, el DTE lleva el complemento de exportación, que Odoo arma con estos datos:

16.Factura especial

El documento que emite el comprador cuando el vendedor no puede facturar.

La factura especial (FESP) la emite quien compra, por cuenta de quien vende, cuando este último no está inscrito o se niega a facturar. Contablemente es una compra, y por eso en Odoo se registra desde Contabilidad › Proveedores › Facturas, en un diario de compra con FEL activa. Una factura de proveedor nace ya con el tipo FESP.

16.1 Requisitos

• Un diario de compra con Generación de Facturación Electrónica activada y Tipo de Factura por Defecto = Factura Especial.
• La frase de tipo 5 en ese diario.
• El vendedor identificado, normalmente con su CUI.
• El IVA de compras en las líneas.

17.Recibos electrónicos

Recibo, recibo por donación y recibo por anticipo.

El recibo documenta un cobro que no constituye factura. Se emite desde un diario de venta con la casilla ¿Es recibo? activada.

Dentro del recibo, el campo Tipo de Documento de la pestaña FEL distingue las tres variantes:

18.Notas de crédito, débito y abono

Cómo corregir un DTE ya certificado sin anularlo.

18.1 Nota de crédito (NCRE)

Rebaja un documento anterior: devoluciones, descuentos posteriores, correcciones de precio. Se crea con el botón Nota de crédito de la factura original, que abre el asistente estándar de Odoo. Después:

1. Elija el diario de notas de crédito con FEL activa.
2. En la pestaña FEL, confirme que el Tipo de Factura sea Nota de Crédito y que el campo NC Documento origen apunte a la factura corregida.
3. Ajuste las líneas a lo que realmente se devuelve.
4. Confirme.

18.2 Nota de débito (NDEB)

Aumenta un documento anterior: intereses, fletes cobrados después, ajustes al alza. Se genera con el botón Nota de débito que el módulo agrega a las facturas registradas. El botón abre una factura nueva ya enlazada al documento de origen —campo ND Documento origen— y con el tipo Nota de Débito.

18.3 Nota de abono (NABN)

Es un documento que no genera crédito fiscal. Se crea como rectificativa de cliente —que en Odoo nace ya con el tipo NABN— y en la pestaña FEL pide la Naturaleza de la operación:

• Vendedor intermediario de productos agropecuarios, artesanales y productos reciclados (frase tipo 9, escenario 16).
• Documento de rebaja de inventarios (frase tipo 9, escenario 17).

Al elegirla, el sistema coloca la frase correspondiente; sin ella no deja confirmar. Si la compañía tiene configurado un Impuesto NABO, las líneas de la nota de abono se envían con ese impuesto.

19.Anulación de un DTE ante la SAT

El concepto de anulación, los plazos por tipo de receptor y la anulación extemporánea.

Anular un DTE no es borrarlo: es enviar a la SAT una solicitud de anulación que queda registrada junto al documento original. Un DTE anulado sigue existiendo, con estado «anulado».

19.1 Cómo se anula

1. Abra el documento certificado.
2. Pulse Cancelar FEL en la barra de botones. Solo aparece en documentos registrados y certificados, y solo para usuarios de facturación electrónica.
3. Elija el Concepto de anulación del catálogo de la SAT.
4. Escriba el Detalle (obligatorio si el concepto es «Otros»).
5. Pulse Anular DTE.

19.2 El catálogo de conceptos

El texto que viaja a la SAT como motivo se arma con código, concepto y detalle: 008 Datos incorrectos del receptor - NIT del receptor capturado con error, hasta 250 caracteres.

19.3 Qué pasa al anular

Odoo envía la solicitud, espera la confirmación del certificador y solo entonces marca el documento: queda Cancelado en contabilidad, Anulada FEL en su estado FEL y con la cinta ANULADA FEL. Si el certificador no confirma, el documento no se marca como anulado y se avisa del error: es deliberado, para que nunca queden desalineados Odoo y la SAT. Un documento anulado ante la SAT ya no se puede regresar a borrador; hay que crear uno nuevo.

19.4 Los plazos

En los documentos a Consumidor Final, la pestaña FEL muestra el campo Límite de anulación con la fecha exacta. Pasado ese día, Odoo bloquea el envío con un mensaje que explica la regla.

19.5 Anulación extemporánea

Si necesita anular fuera de plazo, active Permitir anulación extemporánea en los ajustes. Con esa opción, Odoo envía la solicitud igual, deja constancia en el chatter y marca el documento como Anulación extemporánea pendiente: la SAT traslada la petición a su proceso de autorización, que resuelve la Administración Tributaria.

20.Cuando la certificación falla

Errores de la SAT, reintentos automáticos, cómo volver a certificar y qué pasa con un DTE que la SAT registró pero Odoo no alcanzó a guardar.

Hay dos familias de fallo, y se tratan distinto:

20.1 Comportamiento por defecto

En una factura normal, si la SAT rechaza el documento la confirmación se detiene y se muestra el error tal como lo devolvió el servicio. Nada queda a medias: la factura sigue en borrador. Solo si está activa Publicar asiento con errores SAT el asiento se publica y el documento queda en Error en datos FEL.

20.2 Certificación diferida

Para las ventas del sitio web —donde interrumpir el pedido es peor que retrasar la factura— la opción Diferir certificación FEL en ecommerce cambia esa conducta: el asiento se publica, el documento queda Pendiente de certificar y una tarea programada reintenta cada 15 minutos hasta agotar los intentos configurados. Cada intento se registra en la pestaña FEL y en el chatter, con el número de intento y el texto del error.

Al agotarse los intentos, el documento pasa a Error en datos FEL y se crea la actividad Certificación FEL pendiente de corrección para el comercial de la factura o, si no tiene, para el Responsable de alertas FEL.

20.3 Cómo leer un error de la SAT

El rechazo de las figuras anteriores es una respuesta real del certificador y trae tres errores del validador de la SAT, cada uno con su numeral de las Reglas y Validaciones:

20.4 Volver a certificar

Corrija el dato y pulse Certificar FEL: el contador de intentos se reinicia y el documento se envía de nuevo. El botón aparece en documentos registrados que están Pendiente de certificar o Error en datos FEL.

20.5 La bitácora de envíos

FE-SAT › Solicitudes de API › Solicitudes API FEL (la pantalla se titula FEL Logger) guarda cada llamada al certificador con el documento al que corresponde, el certificador y la fecha. Es la evidencia para reclamar a un proveedor.

20.6 DTE certificados que no llegaron a guardarse

Puede ocurrir que el certificador registre el documento ante la SAT y que, justo después, algo impida a Odoo guardar la factura: un corte de luz, un reinicio del servidor, un error en un paso posterior. Antes, al volver a intentarlo salía un segundo DTE por la misma venta. Odoo 20 lo evita así:

1. Apenas el certificador responde, Odoo guarda un resguardo del DTE aparte de la factura.
2. Si la factura llega a guardarse, el resguardo se borra solo.
3. Si no, el resguardo queda en FE-SAT › Documentos Electrónicos › DTE sin registrar y la factura en borrador muestra un aviso: «Esta factura ya se certificó en SAT en un intento anterior que no llegó a guardarse».
4. Al confirmarla de nuevo, Odoo reutiliza ese DTE en lugar de emitir otro, siempre que el contenido no haya cambiado. El chatter lo deja dicho. El punto de venta hace lo mismo cuando reenvía una venta.

21.Contingencia FEL

Seguir facturando cuando no hay Internet o el certificador está caído.

La SAT contempla que el emisor pueda quedarse sin servicio. Para eso entrega bloques de números de acceso: correlativos de nueve dígitos que identifican provisionalmente al documento mientras no se puede certificar. El cliente se lleva su comprobante con ese número, y el DTE se certifica después.

21.1 Configuración

En la pestaña FEL del diario, grupo Contingencia FEL GT:

21.2 Qué ocurre en contingencia

1. Si el certificador no responde al confirmar, o si el diario está en contingencia manual, el documento se publica con estado Contingencia FEL y toma un número de acceso del rango. El chatter explica por qué.
2. Si está activa Nombre del Documento Establecido por FEL, el asiento se llama DTE-.
3. El ticket muestra NUMERO DE ACCESO en lugar del número de autorización, y el botón PDF SAT y el QR apuntan al verificador de la SAT en modo contingencia.
4. Cada diez minutos, una tarea programada intenta certificar todos los documentos en contingencia. Al lograrlo, el documento pasa a Certificada y obtiene su número de autorización definitivo.

22.Punto de venta: configuración

Qué hay que dejar listo para que cada cobro salga certificado y el ticket sirva como factura electrónica.

En el punto de venta, la FEL no es un paso aparte: cada venta se certifica al cobrar y el ticket que imprime la caja es la representación impresa del DTE. Para que eso ocurra hacen falta tres cosas.

22.1 Lo que decide que un punto de venta emita FEL

22.2 Opciones de facturación electrónica

Están en Punto de venta › Configuración › Ajustes, bloque Opciones Facturación Electrónica. Arriba de la página se elige a qué punto de venta se aplican los cambios. El bloque solo aparece si el diario de facturación tiene la FEL activa y solo lo ve el Administrador del punto de venta.

22.3 Contingencia, anulaciones y caja

El bloque de contingencia trae Habilitar Contigencia y los tres números del rango, que son los mismos del diario de facturación y se pueden editar desde aquí.

23.Punto de venta: la venta diaria

De abrir la caja a entregar el ticket con el número de autorización.

23.1 Abrir la caja

23.2 Capturar la venta

23.3 Elegir el cliente

Si la venta es a Consumidor Final no hay que hacer nada. Cuando el cliente pide factura con NIT, se pulsa el botón del cliente y se busca en la lista, o se crea en el momento.

23.4 Cobrar y certificar

Al pulsar Validar, el punto de venta comprueba primero que hay conexión con el servidor; si la hay, crea la factura, la certifica y guarda el número de autorización, la serie y el número del DTE. Todo eso ocurre antes de que aparezca la pantalla Importe pagado.

23.5 El ticket como representación del DTE

Odoo 20 genera el ticket en el servidor, así que el documento impreso, el que se reimprime desde Órdenes y el que se envía por correo son idénticos.

23.6 Consultar ventas ya certificadas

En Órdenes, cambie el filtro de Activo a Pagado. La lista agrega dos columnas propias y el buscador permite localizar una venta por Número FEL, Serie FEL o Número de Autorización FEL.

24.Punto de venta: anulaciones y devoluciones

Las dos formas de deshacer una venta y cuál corresponde en cada caso.

24.1 Anular desde la caja

1. Entre a Órdenes y cambie el filtro a Pagado.
2. Seleccione la venta. A la derecha aparece el detalle y el botón rojo Anular FEL.
3. Elija el Concepto de anulación (SAT).
4. Escriba el motivo si se le pide y pulse Aplicar; si no se le pide, confirme.

Al confirmar, la caja avisa «Documento FEL anulado correctamente» y vuelve a la pantalla de productos. Según la configuración del capítulo 22, el sistema cancela la salida de inventario, revierte el pago y deja la orden cancelada. Las órdenes anuladas se consultan con el filtro Cancelado, donde siguen mostrando la serie y el número del DTE.

24.2 Devolución con nota de crédito

Para una devolución, seleccione la venta en Órdenes, toque la línea que regresa, indique la cantidad con el teclado y pulse Reembolso. Con Forzar Devolución hacia Pago Directamente, la caja pasa de inmediato a la pantalla de pago; al validar, se genera la nota de crédito electrónica enlazada al DTE original.

También se puede generar desde el backend: en Punto de venta › Órdenes › Órdenes, el botón Nota de Crédito crea la devolución completa, la cobra y la certifica en un solo paso. El sistema impide emitirla dos veces sobre la misma orden y, como en la caja, la rechaza si el receptor es Consumidor Final.

24.3 Cómo se ve en el backend

25.Punto de venta: contingencia

Vender sin Internet y certificar después, sin detener la caja.

La caja es donde la contingencia importa de verdad: una tienda no puede dejar de vender porque se cayó el enlace. El módulo cubre tres situaciones.

25.1 Sin conexión con el servidor

Al validar una venta, el punto de venta intenta contactar al servidor. Si no lo consigue y Habilitar Contigencia está activa, toma el siguiente número de acceso del rango, cierra la venta e imprime el ticket con ese número. Si se acabó el rango, avisa «Llegó al límite de números habilitados». Si la contingencia no está habilitada, la venta no se cierra y el sistema avisa que debe estar en línea para continuar.

25.2 Certificador caído

Si el servidor responde pero el certificador no, la factura se publica en Contingencia FEL con su número de acceso, igual que en contabilidad (capítulo 21), y la venta se cierra normalmente.

25.3 Contingencia global

Cuando ya se sabe que el certificador está caído, no tiene sentido que cada venta intente conectarse y espere el fallo. El modo de contingencia global hace que todas las ventas del punto de venta salgan directamente en contingencia. Se guarda en la configuración del punto de venta, de modo que sobrevive a un cierre del navegador. En esta versión no tiene un interruptor en pantalla: lo activa y lo desactiva su implementador.

25.4 Qué pasa después

Las ventas quedan en el backend con estado Contingencia FEL. La tarea programada las certifica cuando el servicio vuelve, y entonces obtienen su número de autorización definitivo.

26.Punto de venta: permisos del cajero

Quién puede anular, quién debe justificar y qué caja ve cada usuario.

El módulo agrega a la ficha de cada usuario (Ajustes › Usuarios y empresas › Usuarios) una pestaña FEL con los permisos propios de la caja:

27.Monitoreo: el menú FE-SAT

El tablero desde el que se controla, todos los días, qué se certificó y qué quedó pendiente.

La aplicación FE-SAT agrupa todos los documentos electrónicos, sin importar el diario ni el tipo. Está reservada al grupo Encargado Factura Electronica.

27.1 Documentos electrónicos

27.2 Rutina diaria sugerida

1. Abrir Documentos con Error. Si hay algo, corregirlo y pulsar Certificar FEL.
2. Abrir Documentos en Contingencia. Si hay documentos de días anteriores, revisar el servicio del certificador.
3. Abrir DTE sin registrar. Si hay algo, confirmar de nuevo la factura correspondiente para que reutilice el DTE, o anularlo ante la SAT si ya no corresponde.
4. Al cierre del mes, contrastar Documentos Certificados contra el libro de ventas y contra lo que muestra la Agencia Virtual de la SAT.

27.3 Sesiones y órdenes del punto de venta

28.La factura impresa y la cuenta ajena

La representación gráfica del DTE, sus diseños y el cobro por cuenta de terceros.

28.1 La representación impresa

El DTE legalmente es el XML; lo que se le entrega al cliente es su representación gráfica. Cuando el documento está certificado, el botón Imprimir de la factura usa el diseño FEL con los datos fiscales: número de autorización, fecha de certificación en hora de Guatemala, certificador con su NIT, las frases del régimen, el distintivo FEL y el código QR de verificación. Un documento en contingencia imprime su número de acceso.

28.2 Diseños y opciones

La pestaña Diseño de Factura FEL Guatemala de la compañía concentra la apariencia:

• 18 diseños: Vintage, Bold, Moderno, Pulido, Corporativo, Clásico, Infile Clásico, Odoo, Minimalista, Banda, Lateral, Compacto, Tarjetas, Ticket FEL GT y los cuatro de página completa (Panorama, Lienzo, Columna y Geométrico), que llevan la autorización y el QR en una franja al pie.
• Estilo: estilo de tabla, densidad, esquinas redondeadas, posición del QR, fuente y tamaño, tipo de pie de página.
• Colores del tema, del texto, de las filas alternas, de la compañía y del cliente.
• Columnas de la tabla y bloques del documento: numeración, código, unidad de medida, descuento, impuestos, imagen del producto, emisor, contacto del cliente, referencias, vencimiento, moneda, vendedor, total en letras, desglose de impuestos, pagos, notas, QR y logotipo FEL.
• Textos adicionales (información de pago y mensaje de cierre), marca de agua de texto o de imagen y firma.
• Vista previa en PDF genera el resultado sin tener que imprimir una factura real.

La plantilla se puede fijar además por documento, desde el campo Plantilla Factura de la factura.

28.3 Cobros por cuenta ajena

Algunas empresas cobran, dentro de su factura, montos que no son ingreso propio: derechos arancelarios, tasas de terceros, cobros por cuenta de otro contribuyente. La SAT lo contempla como cuenta ajena y exige detallar cada documento del tercero.

Se habilita en la pestaña Configuración Certificador FEL Guatemala de la compañía, grupo Configuración Cuenta Ajena, indicando el producto que representa el cobro y, si se desea, un NIT y una descripción por defecto. En las facturas aparece entonces el botón Cuenta Ajena, que abre un asistente donde se captura, por cada documento del tercero, el NIT, el número, la fecha, la descripción y la base. Al confirmar, el módulo agrega a la factura una línea sin impuestos con el total, guarda el detalle en la pestaña Cuenta Ajena y lo envía dentro del DTE. Si la factura vuelve a borrador, esa línea se elimina.

29.Usuarios, permisos y automatizaciones

Quién puede hacer qué, y qué hace el sistema solo.

29.1 Los grupos de seguridad

En la ficha del usuario, sección de permisos de Contabilidad, aparecen dos privilegios nuevos: Facturación Electrónica y Validador NIT/DPI.

29.2 Tareas programadas

30.Problemas frecuentes

Los avisos que más aparecen y qué hacer con cada uno.

31.Anexos

Referencia rápida para consultar sin leer el capítulo completo.

31.1 Tipos de DTE

31.2 Estados de certificación

31.3 Conceptos de anulación (catálogo SAT)

31.4 Tipos de frase

31.5 Disposiciones de la SAT vigentes (noviembre de 2026)

31.6 Campos técnicos más consultados

31.7 Glosario

31.8 Enlaces útiles

• Verificador público de DTE de la SAT — comprobar un documento por su número de autorización (el botón PDF SAT lo abre ya cargado).
• Agencia Virtual de la SAT — consulta de documentos emitidos y recibidos.
• Portal de su certificador — consumo de créditos, estado del servicio y descarga de XML.