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

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 19: 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 tres módulos 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:

2.4 Verificación pública

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

• PDF certificador — descarga el PDF que emite el certificador (INFILE, Megaprint o G4S) con el diseño oficial del proveedor. Si el servicio no devuelve el PDF, con G4S, Odoo imprime en su lugar la factura con la plantilla de la compañía.
• 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 precargados; desde ahí la SAT permite descargar su propia representación del DTE. En un documento emitido en contingencia, el enlace usa el número de acceso.

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.

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

3.2 nit_dpi_multicert_verification — validación del receptor

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.

3.3 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. Si una venta ya certificada no alcanza a guardarse y la caja la reenvía, se reutiliza el mismo DTE en vez de emitir uno nuevo (capítulo 20).

Depende de point_of_sale, account_tax_python y del propio 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. Complete los datos de la empresa: NIT, nombre inscrito, dirección, correo y personería jurídica. Si trabaja con sucursales, créelas como sucursales de la compañía principal y asigne a cada una su código de establecimiento. → capítulo 5
3. Cargue las credenciales del certificador en Ajustes y active la emisión. → capítulo 6
4. Revise las opciones generales: moneda del DTE, redondeo, descripción de línea. → capítulo 7
5. Cree 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 marcado 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. Elija el diseño de la factura impresa y revíselo con Vista previa en PDF. → capítulo 28
11. 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 Campos propios de la FEL

Además de los datos generales, la ficha de la compañía tiene una pestaña Configuración Certificador FEL Guatemala, visible solo para el grupo Encargado Factura Electronica. Repite las opciones de Ajustes (capítulos 6 y 7) y agrega los datos del contribuyente:

5.3 Sucursales

Odoo 19 permite crear sucursales de una compañía (botón Sucursales de la ficha de la compañía principal). Para la FEL, una sucursal es otro establecimiento del mismo contribuyente: emite con el mismo NIT y las mismas credenciales, pero con su propio código de establecimiento y su propia dirección.

• NIT Emisor — solo aparece en las sucursales. Es el NIT de la propia sucursal si tiene uno; si no, el de su compañía madre o el de la raíz. Ese es el NIT que viaja en el DTE, en el enlace de verificación de la SAT y en el ticket del punto de venta.
• Interruptor de emisión, certificador y credenciales — se heredan de la compañía raíz. Si un usuario los cambia desde una sucursal, el módulo escribe el cambio en la raíz, de modo que todas las sucursales firmen siempre con la misma configuración.
• Código Establecimiento y dirección — son lo único que conviene particularizar en cada sucursal.

6.Credenciales del certificador

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

Toda la configuración de FEL vive en Contabilidad › Configuración › Ajustes, en el bloque Facturación Electrónica. El bloque solo aparece si la compañía —o la compañía raíz de la que es sucursal— es de Guatemala. Los mismos datos se ven también en la pestaña Configuración Certificador FEL Guatemala de la ficha 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 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 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 cual Odoo agrega sola la frase de tipo 9, escenario 22, a las notas de crédito emitidas más de dos meses después de la factura de origen. Viene con 29/10/2026, la fecha en que la SAT la hizo exigible; si se deja vacía, la frase no se agrega (capítulo 18).
• Mostrar Columna de Descuento — 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. Dentro de esa pestaña hay dos subpestañas: Configuración y, si el diario tiene adendas activas, Adendas.

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

Los tres campos de contingencia (rango inicial, rango final y número actual) guardan el bloque de números de acceso que la SAT entrega para emitir sin conexión. 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; aparece entonces la subpestaña Adendas, donde se encienden uno por uno 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. En la factura se ven —y se pueden ajustar caso por caso, mientras está en borrador— en la pestaña FEL, grupo Frases FEL. Cualquier usuario interno puede consultar el catálogo; no hace falta un grupo de facturación electrónica para ver las frases de un documento.

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, visible solo en posiciones fiscales de Guatemala: marca la posición como exenta, de modo que los documentos de esos clientes salgan sin IVA y con la frase de exención correspondiente.

11.Tipos de DTE y cómo se eligen

Los nueve 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 tres casos que Odoo fija solo:

• Una rectificativa creada con el botón Nota de crédito de una factura certificada nace como NCRE, con el campo NC Documento origen ya apuntando a esa factura.
• Una rectificativa de cliente creada desde cero (Clientes › Notas de crédito › Nuevo) nace como NABN; cámbiela a NCRE si lo que quiere es una nota de crédito, o use un diario de notas de crédito.
• Una factura de proveedor nace como FESP, que es el único tipo que se emite desde compras.

11.3 Estados de la certificación

Independiente del estado contable (borrador, registrado, cancelado), cada documento tiene su Estado certificación FEL. En las facturas y notas de crédito de cliente de un diario con FEL, se ve como un distintivo de color, Estado FEL, en la cabecera del documento, junto a la Serie y el Número DTE cuando ya existen:

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 del documento.

12.1 Los cuatro tipos de receptor

El tipo se elige en la ficha del contacto, en el campo Tipo de identificación. El módulo crea los tres tipos guatemaltecos al instalarse y les asigna su código de la SAT.

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 de 2026

Las Reglas y Validaciones 2.1 de la SAT endurecieron el tratamiento del receptor CF, y la actualización de octubre de 2026 agregó una frase obligatoria para las notas de crédito tardías. El módulo aplica las cuatro disposiciones y las explica en pantalla:

12.4 Contacto extranjero

La casilla Es Extranjero de la ficha marca al receptor del exterior y habilita los datos del consignatario (nombre, código, dirección y país) 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

• NIT Contacto — permite que un contacto hijo facture con un NIT distinto al de la empresa matriz.
• Moneda de facturación — moneda en que se le factura siempre a ese cliente.
• Plantilla de Factura — diseño de la representación impresa para ese cliente.
• Bloquear Escritura — impide que un usuario sin permiso de encargado cambie 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 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, sustituye el nombre por el que devuelve la SAT y asigna el tipo de identificación correcto según la longitud del número.
2. Sobre un contacto existente: abra la ficha y pulse Verificar Contacto.

Un número de trece dígitos se consulta como DPI; cualquier otro, como 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.

13.3 La bitácora de consultas

Cada consulta al proveedor se guarda en Verificaciones de Contacto con el NIT, el resultado, la URL usada 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. Revise el Tipo de Factura. Aparece junto al cliente cuando el diario permite elegirlo.
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.
9. Compruebe en la cabecera que el distintivo Estado FEL diga Certificada y que aparezcan la Serie y el Número DTE.

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.
• Nombre del receptor.
• Tipo de factura distinto de «Ninguno».
• 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 una nota de abono tenga elegida su naturaleza de la operación, y que ningún otro documento lleve las frases reservadas a 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. Cada grupo se muestra solo cuando tiene algo que decir: los datos de facturación, cuando el documento ya está certificado o anulado; los de contingencia, cuando se emitió sin conexión; los reintentos, cuando hubo algún error.

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 el número de abonos, el monto de cada uno y su fecha de vencimiento, tomados de los términos de pago de la factura.

15.2 Factura de exportación (FEXP)

Para ventas al exterior. Además de los datos normales, la SAT exige identificar al exportador y al consignatario, y el DTE lleva el complemento de exportaciones.

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.

16.1 Requisitos

• Un diario de compra con Generación de Facturación Electrónica activada y Tipo de Factura por Defecto = FESP.
• La frase de tipo 5 («El vendedor o prestador del servicio se negó a emitir la factura correspondiente») en ese diario.
• Las retenciones de IVA e ISR que exige la ley para este documento, que calcula la localización guatemalteca al confirmar.

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. En el asistente, escriba el motivo y elija el diario de notas de crédito con FEL activa.
2. Odoo crea el borrador con el Tipo de Factura NCRE y el campo NC Documento origen ya apuntando a la factura corregida. Compruébelo en la pestaña FEL.
3. Ajuste las líneas a lo que realmente se devuelve o se rebaja.
4. Confirme.

18.2 Nota de crédito fuera de plazo (frase 9-22)

El artículo 17 de la Ley del IVA solo reconoce como crédito fiscal la nota de crédito emitida dentro de los dos meses siguientes a la factura. Desde el 29 de octubre de 2026, la SAT exige que toda NCRE emitida después de esos dos meses lleve la frase de tipo 9, escenario 22: «Documento emitido posterior a los dos meses de la factura, no se reconoce como crédito fiscal, según Art. 17 Ley del IVA».

Odoo la maneja solo, al momento de certificar:

• Compara la fecha de la nota con la fecha de la factura de origen. Si la nota es posterior a la fecha de origen más dos meses, agrega la frase; si no, la quita si alguien la había puesto.
• Solo lo hace en notas de crédito (NCRE). La SAT rechaza la frase en cualquier otro tipo de DTE, incluida la nota de débito, así que Odoo nunca la agrega ahí.
• Solo lo hace para notas con fecha igual o posterior a la Vigencia frase de NCRE fuera de plazo de los ajustes (capítulo 7), que viene en 29/10/2026.

18.3 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 NDEB.

18.4 Nota de abono (NABN)

Es un abono a favor del receptor que no corrige una factura concreta. Se emite como rectificativa de cliente desde un diario con FEL cuyo tipo por defecto sea NABN —en la base de demostración, Notas de Abono (FEL)—, o desde una rectificativa nueva, que nace con ese tipo.

La SAT exige que toda nota de abono declare la naturaleza de la operación con una de dos frases de tipo 9. En la pestaña FEL, el campo Naturaleza de la operación es obligatorio y ofrece las dos opciones:

Al elegirla, Odoo agrega la frase correspondiente a las Frases FEL del documento y quita la otra si estaba. No hace falta agregarla a mano, y no se puede emitir la nota sin elegir una.

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. El botón solo aparece si el documento está registrado y su estado FEL es Certificada.
2. Pulse Cancelar FEL en la barra de botones.
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.

19.3 Qué pasa al anular

Odoo envía la solicitud, espera la confirmación del certificador y solo entonces marca el documento. 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.

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, y el asistente lo repite. Pasado ese día, Odoo bloquea el envío con un mensaje que explica la regla. Las fechas se calculan con la hora de Guatemala.

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. Nada queda a medias: la factura sigue en borrador, lista para corregirse.

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.

20.3 Volver a certificar

Cuando se agotan los reintentos, el documento pasa a Error en datos FEL y se crea una actividad para el comercial de la factura o para el Responsable de alertas FEL. Corrija el dato y pulse Certificar FEL: el contador de intentos se reinicia y se envía de nuevo.

20.4 La bitácora de envíos

FE-SAT › Solicitudes de API › Solicitudes API FEL guarda cada llamada al certificador con su contenido y el documento al que corresponde. Es la evidencia para reclamar a un proveedor.

20.5 DTE certificados que no llegaron a guardarse

Puede ocurrir que el certificador emita el DTE y, un instante después, algo falle en Odoo antes de guardar la factura: un corte de red, un error al registrar el pago, un pedido del punto de venta que la caja vuelve a enviar. Ese documento ya existe ante la SAT, pero en Odoo la factura sigue en borrador. Si se volviera a confirmar sin más, se emitiría un segundo DTE por la misma venta.

Para evitarlo, Odoo guarda cada DTE recién certificado en un resguardo independiente y lo borra en cuanto la factura queda guardada. Si la factura no llega a guardarse, el resguardo queda pendiente y:

• La factura en borrador muestra un aviso amarillo: «Esta factura ya se certificó en SAT en un intento anterior que no llegó a guardarse. Al confirmarla se reutilizará ese DTE y no se emitirá uno nuevo, siempre que su contenido no haya cambiado.»
• Al confirmarla, Odoo reutiliza ese DTE —mismo número de autorización, serie y número— y lo deja anotado en el chatter: «Se reutilizó el DTE Serie … Número …, certificado en un intento anterior que no llegó a guardarse. No se emitió un documento nuevo.»
• Si entretanto alguien cambió el contenido de la factura (cliente, líneas, montos), Odoo no lo reutiliza y detiene la confirmación: ese DTE ya no corresponde y hay que anularlo con el certificador antes de seguir.
• En el punto de venta, el reenvío de un pedido ya certificado se reconoce aunque llegue como una factura nueva, y también reutiliza el DTE (capítulo 25).

Cada registro de esta bandeja tiene dos botones: Abrir factura, si el borrador todavía existe, y Marcar como descartado, reservado al Encargado Factura Electronica, para cuando el DTE ya se anuló con el certificador. Al descartarlo, si la factura vuelve a confirmarse, se emitirá un DTE nuevo.

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:

21.2 Qué ocurre en contingencia

1. El documento se publica con estado Contingencia FEL y toma un número de acceso del rango.
2. Si está activa la opción Nombre del Documento Establecido por FEL, el asiento se llama DTE-.
3. El comprobante impreso o el ticket muestran NUMERO DE ACCESO en lugar del número de autorización, y el QR apunta 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. El bloque solo aparece si el diario de facturación tiene la FEL activa.

22.3 Contingencia y anulaciones

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 entrar a la pantalla de pago. 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; si la hay, crea la factura, la certifica y trae de vuelta el número de autorización, la serie y el número del DTE para imprimirlos en el ticket. Todo eso ocurre antes de que aparezca la pantalla del recibo.

23.5 El ticket como representación del DTE

23.6 Consultar ventas ya certificadas

Al seleccionar una venta pagada aparecen los botones Reimprimir factura (el PDF de la factura) e Imprimir recibo (el ticket con los datos del DTE), útiles cuando el cliente regresa por una copia.

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 en el popup Concepto de anulación (SAT).
4. Si el cajero tiene activado el motivo, o si eligió «Otros», escriba el motivo y pulse Aplicar; si no, confirme la pregunta «¿Está 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; la caja muestra «Documento FEL anulado correctamente». Las órdenes anuladas se consultan con el filtro Canceladas, que agrega este módulo. Si la venta fue a Consumidor Final, rige el mismo plazo de anulación del capítulo 19: el día de emisión y el siguiente.

24.2 Devolución con nota de crédito

Para una devolución, seleccione la venta en Órdenes, marque las líneas y la cantidad que regresa y pulse Reembolso. Se crea una orden de devolución que, al cobrarse, 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, 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.

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 dos situaciones.

25.1 Contingencia automática

Al validar una venta, el punto de venta intenta contactar al servidor. Si no lo consigue y la contingencia está habilitada, toma automáticamente el siguiente número de acceso del rango, cierra la venta e imprime el ticket con ese número. Nadie tiene que hacer nada.

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 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 salgan directamente en contingencia. Es una marca que se guarda en la configuración del punto de venta, de modo que sobrevive a un cierre del navegador.

25.3 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. Si un documento acumula demasiados intentos sin éxito, se avisa al responsable (capítulo 21).

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) 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 pendiente, confirmar la factura para que reutilice el DTE, o anularlo con el certificador y marcarlo como descartado.
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, el botón Imprimir de la factura agrega automáticamente 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 y el código QR de verificación.

Hay dos maneras de imprimir, y las decide la casilla Usar como Plantilla Predeterminada de la compañía:

• Desactivada — se usa la factura estándar de Odoo, con el bloque FEL agregado al pie. Respeta el formato de papel y el diseño de documentos de la compañía.
• Activada — se usa el diseño FEL elegido (sección 28.2), con su propio encabezado, tabla, totales y pie.

28.2 Los diseños FEL

El módulo trae 18 diseños de factura: Vintage, Bold, Moderno, Pulido, Corporativo, Clásico, Infile Clásico, Odoo, Minimalista, Banda, Lateral, Compacto, Tarjetas, Panorama, Lienzo, Columna, Geométrico y Ticket FEL GT (formato angosto). Todos comparten los mismos bloques de datos —cliente, emisor, líneas, totales, frases, autorización y QR—; cambia la composición. En Panorama, Lienzo, Columna y Geométrico la autorización y el QR van en una franja al pie de la página.

Todo se configura en la pestaña Diseño de Factura FEL Guatemala de la compañía (Ajustes › Usuarios y compañías › Compañías), visible para el grupo Encargado Factura Electronica:

El diseño se puede fijar además por cliente, desde el campo Plantilla de Factura de la ficha del contacto, y por documento, desde el campo Plantilla Factura de la factura. El orden de prioridad es: el de la factura, luego el del cliente y por último el de la compañía.

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

Se habilita en los ajustes de la compañía (Cuenta Ajena) indicando el producto que representa el cobro. En la factura 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. Al confirmar, el módulo agrega a la factura una línea sin impuestos con el total y envía el detalle dentro del DTE.

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.