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

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 17: 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:

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 17 los tres primeros quedan a la vista en el encabezado de la factura, junto al Estado FEL, sin necesidad de abrir ninguna pestaña.

2.4 Verificación pública

Todo DTE se puede verificar sin contraseña. Odoo deja los dos accesos a un clic en la barra de botones de la factura certificada:

• VER DOCUMENTO ELECTRÓNICO — descarga el PDF que genera el certificador (INFILE, Megaprint, Digifact o G4S) con el diseño oficial del proveedor y lo adjunta a la factura.
• PDF SAT — abre el verificador público de la SAT con el número de autorización, el NIT emisor, el NIT receptor y el monto precargados.

3.Los tres 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.

En Odoo 17 depende de account, sale, base_setup y web; se usa junto con el plan contable guatemalteco (l10n_gt). Necesita las librerías de Python img2pdf y fpdf 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 la factura, emitir la nota de crédito de una devolución y trabajar en contingencia cuando el servidor no responde.

Depende de point_of_sale, account_tax_python y del propio multicert_felgt.

3.3 nit_dpi_multicert_verification — validación del receptor (complementario)

Añade la consulta en línea del NIT y del DPI (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. Depende de account, contacts, base_vat y multicert_felgt.

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. Dé permisos de facturación electrónica a los usuarios que configuran, facturan y anulan. Sin el grupo de encargado no se ven las credenciales. → capítulo 29
3. Complete los datos de la empresa: NIT, nombre inscrito, dirección, correo y los datos propios de la FEL. → capítulo 5
4. Cargue las credenciales del certificador en Ajustes y active la emisión. → capítulo 6
5. Revise las opciones generales: moneda del DTE, redondeo, descripción de línea. → capítulo 7
6. Cree un diario por cada tipo de documento que vaya a emitir y actívele la generación de FEL y su rango de contingencia. → capítulo 8
7. Asigne las frases que correspondan a su régimen tributario en cada diario. → capítulo 9
8. Verifique impuestos y posiciones fiscales: cada impuesto debe tener su tipo de impuesto FEL. → capítulo 10
9. Configure la validación de NIT/DPI si la contrató. → capítulo 13
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 compañías › Compañías.

5.1 Campos obligatorios

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

5.2 Pestaña Configuración Certificador FEL Guatemala

Además de las credenciales del certificador (capítulo 6), esta pestaña de la compañía reúne los datos del contribuyente que se envían en el DTE. Solo la 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. El bloque solo aparece si la compañía es de Guatemala. Los mismos datos se pueden editar en la pestaña Configuración Certificador FEL Guatemala de la compañía (capítulo 5).

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 y qué hacer cuando algo falla.

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 en la moneda del documento aunque la compañía convierta, y Moneda de facturación fija la moneda que Odoo propone al elegirlo en una factura.

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

7.3 Qué hacer cuando la certificación falla

7.4 Otras opciones

• 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 — capítulo 19.
• Vigencia frase de NCRE fuera de plazo — fecha desde la que se agrega sola la frase de tipo 9 escenario 22 a las notas de crédito tardías (capítulo 18). Viene con el 29/10/2026; vacía, la frase no se agrega.
• Mostrar Columna de Descuento — en el 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

8.3 Contingencia

El grupo Contingencia FEL GT guarda el bloque de números de acceso que la SAT entrega para emitir sin conexión: Número de Contingencia Actual Rango Inicial, Rango Final y Número de Contingencia Actual, todos de nueve dígitos (entre 100000000 y 999999999). La casilla Activar contingencia manualmente manda todo el diario a contingencia. Conviene darle un rango propio a cada diario FEL: un diario sin rango no tiene número que asignar cuando el certificador falla. 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 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. Si falta una frase obligatoria para su régimen, la SAT rechaza el DTE.

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 al elegir el diario. 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 maneja Odoo solo:

• Tipo 9, escenarios 16 y 17: se agregan a la nota de abono según la Naturaleza de la operación que se elija (capítulo 18). Odoo impide dejarlas en cualquier otro documento.
• Tipo 9, escenario 22 («NCRE posterior a dos meses de la factura»): desde el 29/10/2026 la SAT la exige en las notas de crédito emitidas más de dos meses después de la factura de origen, y la rechaza en cualquier otro tipo de DTE. Odoo la agrega o la quita sola al certificar una nota de crédito, a partir de la fecha configurada en Vigencia frase de NCRE fuera de plazo.

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

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 marca la posición como exenta. En la base de demostración, la posición Exportaciones (exento de IVA) sustituye el IVA de ventas por el IVA exento y está asignada al cliente del exterior.

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:

El tipo por defecto del usuario está en Ajustes › Usuarios, pestaña FEL (capítulo 26). Ese mismo valor decide dónde se ve el campo en la factura: si el usuario tiene «Ninguno», el Tipo de Factura aparece en el encabezado, debajo del cliente, para elegirlo documento por documento; si tiene un tipo fijo, el campo solo se ve en la pestaña FEL, grupo Adicionales FEL.

Hay excepciones que Odoo fija solo:

• Una nota de crédito creada con el botón Nota de crédito de la factura nace como NCRE y ya enlazada a la factura de origen.
• Una rectificativa de cliente creada desde cero nace como NABN; cámbiela a NCRE si lo que quiere es una nota de crédito.
• Una factura de proveedor en una compañía con FEL nace como FESP, que es el único tipo que se emite desde compras.
• El botón Nota de débito crea el documento ya como NDEB.

11.3 Estados de la certificación

Independiente del estado contable (borrador, registrado, cancelado), cada documento tiene su Estado certificación FEL, que en Odoo 17 se ve también como insignia Estado FEL en el encabezado:

12.Contactos: NIT, DPI, pasaporte y CF

Cómo se identifica al receptor 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 Los campos de identificación en Odoo 17

En esta versión el receptor se identifica con tres campos de la ficha del contacto:

La regla que aplica Odoo al armar el DTE es simple: si el NIT es CF y hay pasaporte, viaja el pasaporte; si no, y hay DPI, viaja el DPI; si no, viaja CF.

12.2 Consumidor Final

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

12.3 Reglas de la SAT para Consumidor Final

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

12.4 Contacto extranjero

La casilla Es Extranjero marca al receptor del exterior y vuelve obligatorios, en la pestaña Información Exportación, el nombre y la dirección del consignatario; además se capturan el código de consignatario, el código de comprador y el país del consignatario. En los contactos hijos estos datos se toman de la empresa y se muestran como solo lectura.

12.5 Otros campos FEL del contacto

• NIT Contacto — en los contactos hijos (direcciones de una empresa), permite que ese contacto facture con un NIT distinto al de la empresa.
• Moneda de facturación en base al documento y Moneda de facturación — capítulo 7.
• Bloquear Escritura — solo visible para el encargado de facturación electrónica; impide que los demás usuarios cambien el NIT, el nombre o la dirección de un contacto ya validado.

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

Cómo traer el nombre real del contribuyente antes de facturarle, y cómo evitar pagar dos veces por la misma consulta.

El módulo complementario nit_dpi_multicert_verification consulta el NIT o el DPI 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. 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 consulta como DPI y se guarda en el campo DPI, con el NIT en CF; cualquier otro, como NIT. Si escribe CF, el contacto se llama «Consumidor Final».
2. Sobre un contacto existente: abra la ficha y pulse Verificar Contacto.

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. Tampoco deja crear dos contactos con el mismo NIT, DPI o pasaporte («El NIT ya existe»), salvo CF cuando no está activo el bloqueo.

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 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, con qué código de establecimiento y con qué frases.
4. Revise el Tipo de Factura: bajo el cliente o en la pestaña FEL, según la configuración del usuario (capítulo 11).
5. Verifique la fecha de vencimiento: es obligatoria para la FEL y Odoo detiene la confirmación si falta.
6. Capture las líneas con su producto, cantidad, precio e impuestos.
7. Abra la pestaña FEL y revise las frases.
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:

• Tipo de factura distinto de «Ninguno».
• ID de la empresa (nombre inscrito), correo, NIT y dirección de la empresa emisora.
• Código de establecimiento, en el diario o en la compañía.
• Fecha de vencimiento de la factura.
• Nombre del receptor.
• Límite de Q2,500.00 cuando el receptor es CF sin DPI ni pasaporte.
• Que el tipo de documento sea válido para el receptor (nada de notas a CF).
• Que cada línea lleve un impuesto con tipo FEL (capítulo 10).
• Que las frases de la nota de abono estén donde corresponden (capítulo 18).

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 en estado Sin certificar y nunca se envían a la SAT.

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. El módulo agrega al XML el complemento cambiario con un abono por el total de la factura y la fecha de vencimiento de la factura, que sale de los términos de pago.

15.2 Factura de exportación (FEXP)

Para ventas al exterior. El DTE viaja como factura con la marca de exportación y el complemento de exportaciones. Estos son los datos y de dónde los toma Odoo:

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. Si se intenta desde una factura de cliente, Odoo lo impide.

16.1 Requisitos y retenciones

• Un diario de compra con Generación de Facturación Electrónica activada y Tipo de Factura por Defecto «Factura Especial».
• El vendedor identificado: normalmente una persona con NIT CF y su DPI.
• Las frases que correspondan; el catálogo trae la de tipo 5 («El vendedor o prestador del servicio se negó a emitir la factura correspondiente») para cuando aplique.

Las retenciones las calcula el propio módulo al armar el XML y las envía en el complemento RetencionesFacturaEspecial: retención de ISR del 5 % sobre la base sin IVA, retención del IVA por el total del IVA del documento, y el total menos retenciones.

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 (visible cuando el tipo de factura es «Recibo») distingue las tres variantes:

En los recibos Odoo envía además el Tipo de Personería de la compañía, y si el recibo no lleva impuestos lo declara con afiliación exenta.

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. En Odoo 17 el módulo deja la nota ya como NCRE y enlazada a la factura de origen. Después:

1. En el asistente, escriba el motivo y elija el diario de notas de crédito con FEL activa.
2. En la pestaña FEL, confirme que el Tipo de Factura sea NCRE y que 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 en el mismo diario, ya enlazada al documento de origen (ND Documento origen) y con el tipo NDEB.

18.3 Nota de abono (NABN)

La nota de abono no da crédito fiscal y la SAT la reserva para dos operaciones. Se crea como rectificativa de cliente —que nace con el tipo NABN— y en la pestaña FEL se elige la Naturaleza de la operación:

• 16 — Vendedor intermediario de productos agropecuarios, artesanales y productos reciclados.
• 17 — Documento de rebaja de inventarios.

Al elegirla, Odoo agrega la frase de tipo 9 correspondiente (escenario 16 o 17) y no permite confirmar sin ella. Si en la compañía se configuró un Impuesto NABO, las líneas viajan con ese impuesto en lugar del IVA.

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 (requiere el grupo de usuario de factura 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 se arma como 008 Datos incorrectos del receptor - NIT del receptor capturado con error, es decir código, etiqueta y detalle, hasta 250 caracteres.

19.3 Qué pasa al anular

Odoo envía la solicitud y espera la confirmación del certificador. Si el certificador no confirma, el documento no se marca como anulado y se avisa con «No fue posible anular el documento FEL con el certificador; intente nuevamente»: es deliberado, para que nunca queden desalineados Odoo y la SAT. Con la confirmación, Odoo:

• marca el documento Anulada FEL y lo pasa a Cancelado;
• rompe las conciliaciones y cancela los pagos aplicados a la factura;
• si la factura nació en el punto de venta, cancela también la orden de la caja;
• deja en el chatter la serie y el número anulados.

Un documento anulado ante la SAT no se puede restablecer a borrador: Odoo responde «La factura ya ha sido anulada en SAT, por lo que no puede ser restablecida a borrador, deberá crear una nueva».

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 y cómo volver a certificar.

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: «La factura no pudo ser validada en la SAT». Nada queda a medias. Si está activa Publicar asiento con errores SAT, el asiento queda publicado, el documento en Error en datos FEL y el error en el chatter.

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, el documento pasa a Error en datos FEL y se crea una actividad «Certificación FEL pendiente de corrección» para el comercial de la factura o para el Responsable de alertas FEL.

20.3 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 en estado Pendiente de certificar o Error en datos FEL.

20.4 La bitácora de envíos

FE-SAT › Solicitudes de API › Solicitudes API FEL guarda cada XML enviado al certificador con el NIT del receptor, el certificador, el usuario y la fecha. Es la evidencia para reclamar a un proveedor.

20.5 DTE certificados que no llegaron a guardarse

Puede pasar que el certificador emita el DTE pero Odoo no alcance a guardar la factura, por ejemplo por un error posterior o un corte. Para que ese DTE no se pierda ni se duplique, el módulo lo guarda aparte en FE-SAT › Documentos Electrónicos › DTE sin registrar:

• Si la factura sigue en borrador, la ficha lo advierte con un aviso amarillo y, al confirmarla, Odoo reutiliza ese DTE en vez de emitir otro, siempre que el contenido no haya cambiado.
• Si la factura ya no existe o cambió, anule el DTE con el certificador y pulse Marcar como descartado (solo el encargado).

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 de cada diario:

21.2 Qué ocurre en contingencia

1. El documento entra en contingencia de dos maneras: porque el diario la tiene activada manualmente, o automáticamente cuando el certificador no responde (sin conexión, tiempo de espera agotado). En el segundo caso el chatter lo dice: «La factura no pudo ser enviada a la SAT y se ha colocado en contingencia».
2. Se publica con estado Contingencia FEL, la cinta Contingencia FEL y un número de acceso del rango del diario.
3. Si está activa Nombre del Documento Establecido por FEL, el asiento se llama DTE-.
4. El ticket muestra DOCUMENTO EN CONTINGENCIA con su NÚMERO DE ACCESO, y el QR apunta al verificador de la SAT en modo contingencia (capítulo 25).
5. Una tarea programada reintenta certificar. Al lograrlo, el documento pasa a Certificada y obtiene su número de autorización definitivo.

21.3 Reintentos con espera creciente

La tarea Procesamiento de facturas en contingencia corre cada diez minutos, pero no reenvía todo cada vez: los certificadores bloquean a los emisores que repiten muchas veces una solicitud fallida. Por eso, tras cada fallo, el siguiente intento se aleja (10 minutos, luego 20, 40, 80… hasta un máximo de 12 horas), y el grupo Datos Contingencia muestra los Reintentos de contingencia FEL y el Próximo reintento.

• Después de 8 intentos automáticos el documento queda para proceso manual: el chatter lo indica y hay que usar Procesar Contingencia FEL cuando el servicio vuelva.
• Al llegar a Avisar contingencia tras N intentos (5 por defecto), Odoo deja el mensaje «Contingencia FEL sin resolver» y una actividad para el comercial o el Responsable de alertas FEL.

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. El bloque solo aparece si el diario de facturación tiene la FEL activa.

22.3 Contingencia, anulaciones y caja registradora

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: el cliente por defecto se asigna al pagar. Cuando el cliente pide factura con NIT, se busca en la lista de contactos 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 y reserva el número de contingencia vigente; si la hay, envía la orden, el servidor crea la factura, la certifica y la caja trae de vuelta el número de autorización, la serie, el número y el tipo de DTE para imprimirlos en el ticket. Si un error de la SAT impide certificar, la caja lo muestra en un aviso ERROR DE FEL con el mensaje recibido. Un segundo clic en Validar mientras se procesa el primero se ignora, para no emitir dos DTE de la misma venta.

23.5 El ticket como representación del DTE

23.6 Consultar ventas ya certificadas

Desde el menú de la caja (☰) › Órdenes, con el filtro Pagado:

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 deje el filtro en Pagado.
2. En la fila de la venta, pulse el botón de la columna Anular Factura.
3. Si el cajero tiene activado Motivo de Cancelación en Punto de Venta, escriba el motivo y pulse Agregar; si no, confirme «¿Esta seguro de Anular la Factura?».

Al confirmar, el sistema anula el DTE ante la SAT y, según la configuración del capítulo 22, cancela el albarán, revierte el pago y deja la orden cancelada. Las órdenes anuladas se consultan con el filtro Cancelada, que agrega este módulo.

24.2 Devolución con nota de crédito

Para una devolución, seleccione la venta en Órdenes, toque la línea, indique en el teclado la cantidad que regresa y pulse Reembolso. Con Forzar Devolución hacia Pago activado, la caja salta directo a la pantalla de pago con el monto negativo.

Al validar, la caja avisa que el documento no será una factura:

Con Emitir como Nota de Crédito, el servidor crea la nota de crédito electrónica enlazada al DTE original y la certifica.

24.3 Cómo se ve en el backend

25.Punto de venta: contingencia

Vender sin conexión 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. En Odoo 17 el módulo cubre dos situaciones.

25.1 La caja no alcanza al servidor

Al validar una venta, el punto de venta intenta contactar al servidor de Odoo. Si no lo consigue y Habilitar Contingencia está activo, toma el siguiente número de acceso del rango, cierra la venta e imprime el ticket con ese número. La orden se envía al servidor en cuanto vuelve la conexión (por ejemplo, al recargar la caja), y ahí se crea su factura en contingencia.

• Si la contingencia no está habilitada, la venta no se cierra: «Debe estar en línea para poder continuar, ya que no tiene la contingencia activa».
• Si se agotó el rango: «Llegó al límite de números habilitados, por favor contacte al administrador del sistema».

25.2 El servidor responde, pero el certificador no

Si la caja sí llega al servidor pero el certificador no responde, la factura pasa a contingencia en el servidor (capítulo 21) y la caja imprime el ticket con el número de acceso que le asignó el diario.

25.3 Qué pasa después

Las ventas quedan en el backend con estado Contingencia FEL y su número de acceso. 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é tipo de documento emite cada usuario.

Los módulos agregan a la ficha de cada usuario (Ajustes › Usuarios) la pestaña FEL:

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 y usar Procesar Contingencia FEL.
3. Abrir DTE sin registrar y resolver lo pendiente.
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 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, Odoo imprime la plantilla FEL con los datos fiscales: serie, número DTE, número de autorización, fecha de certificación, certificador con su NIT, las frases del régimen, el total en letras y el código QR de verificación. Mientras no está certificado, imprime la factura estándar de Odoo.

El diseño se configura en la compañía, pestaña Diseño de Factura FEL Guatemala:

• Plantilla: 18 diseños (Bold, Clásico, Corporativo, Moderno, Pulido, Vintage, Infile Clásico, Odoo, Minimalista, Banda, Lateral, Compacto, Tarjetas, Panorama, Lienzo, Columna, Geométrico y Ticket FEL GT), con Usar como Plantilla Predeterminada, Vista previa en PDF y Contenido extra.
• Estilo: estilo de tabla, densidad, esquinas redondeadas, posición del QR, fuente y su tamaño, pie de página.
• Colores del tema, de la compañía y del cliente.
• Columnas de la Tabla y Bloques del Documento: qué columnas y qué datos mostrar (numeración, código, unidad, descuento, impuestos, imagen del producto, emisor, contacto, pedido de origen, vencimiento, moneda, comercial, total en letras, pagos, notas, QR y logo FEL).
• Textos Adicionales (datos de pago y nota de cierre), Marca de Agua y Firma.

La plantilla también se puede cambiar por documento, en el campo Plantilla Factura de la factura.

28.2 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 de tercero.

Se habilita en la compañía, pestaña Configuración Certificador FEL Guatemala, grupo Configuración Cuenta Ajena: la casilla Cuenta Ajena, el Producto de Cuenta Ajena y, opcionalmente, un NIT y una descripción por defecto. En las facturas de cliente aparece entonces el botón Cuenta Ajena, que abre un asistente donde se captura, por cada documento de tercero, el NIT, el número, la fecha, la descripción y la base imponible.

Al Confirmar, los documentos quedan en la pestaña Cuenta Ajena de la factura. Al certificar, Odoo envía el complemento CobroXCuentaAjena con cada documento (IVA calculado al 12 % sobre la base) y agrega a la factura una línea «Cobros por Cuenta Ajena» sin impuestos por el total de las bases. Si la factura se restablece 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

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 Campos técnicos más consultados

31.6 Glosario

31.7 Enlaces útiles

• Verificador público de DTE de la SAT — comprobar un documento por su número de autorización.
• 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.