Guatemala

En Guatemala, Fegora emite Documentos Tributarios Electrónicos (DTE) bajo el régimen FEL (Factura Electrónica en Línea) de la SAT (Superintendencia de Administración Tributaria). Un DTE guatemalteco sólo adquiere validez fiscal después de que un certificador autorizado por la SAT lo certifica y la SAT le asigna un número de autorización.

Certificador

La SAT no certifica documentos directamente para la mayoría de contribuyentes: exige que cada emisor acredite un certificador autorizado, una empresa habilitada por la SAT para firmar y transmitir DTE en su nombre. Ejemplos de certificadores autorizados con los que Fegora se integra son Digifact, Infile, Forcon y Megaprint, entre otros.

El certificador es una configuración de la cuenta emisora, no algo que el cliente de la API elija por solicitud. Fegora abstrae esa integración: usted envía el JSON del documento y Fegora se encarga de convertirlo al formato del certificador configurado, enviarlo, y devolverle el documento certificado (XML, PDF y número de autorización). No confunda el certificador con Fegora — Fegora es el intermediario entre su sistema y el certificador.

La SAT publica y mantiene el listado oficial de certificadores autorizados en su portal (https://portal.sat.gob.gt/portal/certificador-de-dte/). Si necesita cambiar el certificador de una cuenta, contacte a soporte de Fegora.

Tipos de documento

Fegora soporta actualmente los siguientes tipos de documento para emisores guatemaltecos, indicados en el campo tipo del cuerpo de POST /dte:

`tipo`	Documento SAT	Uso típico
`factura` (por defecto)	Factura (FACT)	Venta general de bienes o servicios
`facturaCambiaria`	Factura Cambiaria (FCAM)	Venta a crédito con abonos pactados (`abonosPactados[]`)
`facturaEspecial`	Factura Especial (FESP)	El emisor factura en nombre de un proveedor que se negó a emitir factura (Art. 52, Decreto 27-92)
`facturaExportacion` (o `esExportacion: true`)	Factura de Exportación (FACA)	Venta a un receptor en el extranjero
`notaCredito`	Nota de Crédito (NCRE)	Anula o reduce el efecto de una factura previa
`notaDebito`	Nota de Débito (NDEB)	Incrementa el efecto de una factura previa
`notaAbono`	Nota de Abono (NABN)	Registra abonos sobre una factura cambiaria
`recibo`	Recibo (RECI)	Cobros exentos de IVA que no son venta de bienes/servicios (por ejemplo, cuotas o colegiaturas)
`reciboDonacion`	Recibo de Donación (RDON)	Donaciones recibidas, exentas de IVA por ley

Guatemala no admite tipo: "ticket". Ese tipo es un concepto propio de El Salvador y República Dominicana. Si la cuenta emisora está configurada para Guatemala, una solicitud con tipo: "ticket" se rechaza con codigo: "FEG_BUSINESS_RULE_VIOLATION" y el mensaje El tipo de documento 'ticket' no es válido para Guatemala. Vea Manejo de errores.

El catálogo oficial de la SAT define 21 tipos de DTE, incluyendo variantes para pequeño contribuyente, contribuyente agropecuario y regímenes electrónicos especiales (por ejemplo FPEQ, FAGR, CIVA, CAIS) que hoy no están cubiertas por Fegora. Si su operación requiere alguno de estos regímenes, confirme con soporte de Fegora antes de integrar.

Vea el catálogo completo de tipos de documento (compartido entre países) en Tipos de documento.

Identificación del receptor

El campo receptor.id identifica fiscalmente al receptor. A diferencia de El Salvador, en Guatemala no se declara un tipo de identificación explícito: Fegora lo determina automáticamente a partir del valor de receptor.id y de receptor.direccion.pais.

Caso	Cómo se identifica	`receptor.id`
Contribuyente guatemalteco	NIT	El NIT del receptor, sin guiones
Consumidor Final	Se usa el literal `"CF"`	`"CF"`
Receptor extranjero (EXT)	`direccion.pais` distinto de `"GT"`, o cualquier documento de exportación	Pasaporte o identificador provisional del receptor
Persona individual con CUI (DPI)	Un `id` de 13 dígitos dentro de Guatemala	El CUI (DPI) de la persona

Toda factura de exportación marca automáticamente al receptor como extranjero (EXT), sin importar el país declarado en direccion.pais. Para receptores domésticos, envíe direccion.pais: "GT" (o simplemente omita el campo) — un país distinto marca al receptor como extranjero y la SAT rechaza un "CF" marcado como extranjero.

Impuestos

IVA

La tasa general del Impuesto al Valor Agregado (IVA) en Guatemala es 12%. Cada ítem que lleva IVA de forma explícita en items[].impuestos[] debe indicar codigoUnidadGravable (1 = gravado, 2 = exento) — un IVA explícito sin ese campo se rechaza con codigo: "FEG_VALIDATION_ERROR" y el mensaje El impuesto IVA explícito requiere codigoUnidadGravable. Si el documento completo está exento, use esExentoIva: true junto con motivoExencionIva (vea la sección siguiente).

Impuestos específicos de Guatemala

Además del IVA, la ley guatemalteca contempla impuestos adicionales que se declaran igual que cualquier otro impuesto de ítem, con nombreCorto igual al código correspondiente:

`nombreCorto`	Impuesto	Tasa	Aplica sobre	Cuándo se usa
`IDP`	Impuesto a la Distribución de Petróleo	Monto fijo en quetzales por unidad, según el tipo de combustible	Cantidad de unidades gravables (`cantidadUnidadesGravables`)	Venta o distribución de combustibles y derivados del petróleo
`ITH`	Impuesto de Hospedaje (turismo)	10% (0% si está exento)	Monto gravable	Servicios de hospedaje/turismo
`TDP`	Timbre de Prensa	0.5% (cinco al millar)	Monto gravable	Anuncios y publicaciones sujetos al timbre de prensa
`IFB`	Tasa por seguro contra incendio (“Bomberos” en el XML certificado)	2%	Monto gravable	Primas de seguro contra incendio
`IDB`	Impuesto a Bebidas Alcohólicas	Entre 6% y 8.5% según el tipo de bebida	Cantidad de unidades gravables	Venta de cervezas, vinos, bebidas destiladas y similares

Si el ítem no incluye montoImpuesto, Fegora lo calcula automáticamente a la tasa general (IVA 12%, ITH 10%, IFB 2%, TDP 0.5%). Para IDP, el cálculo automático aplica una tasa plana del 2% sobre el monto gravable — no reproduce la tabla oficial de tarifas fijas por tipo de combustible que publica la SAT. Si su operación involucra distribución de combustibles, envíe montoImpuesto ya calculado según la tarifa oficial vigente para el tipo de combustible.

Exención de IVA: motivos y frases SAT

Cuando un documento está exento de IVA, se declara con esExentoIva: true y motivoExencionIva con uno de los códigos reconocidos por Fegora. Cada motivo corresponde a una frase tipo 4 del catálogo oficial de frases de la SAT (exención o no afectación al IVA); Fegora resuelve automáticamente el texto legal correspondiente y lo agrega al documento certificado.

Otras frases del catálogo SAT (retención de ISR, agente de retención de IVA, régimen de pequeño contribuyente, régimen agropecuario) no se declaran por el cliente: Fegora las deriva automáticamente de la afiliación fiscal registrada de la cuenta emisora.

Motivos de exención más comunes (el catálogo completo tiene 32 valores — vea Catálogos de referencia):

`motivoExencionIva`	Frase SAT	Descripción	Notas
`LEY_IVA_ART7_NUM2`	4-1	Exportación de bienes o servicios	Se asigna automáticamente cuando `esExportacion: true`; requiere el complemento `datosExportacion`
`LEY_IVA_ART7_NUM9`	4-4	Donaciones	Se asigna automáticamente en `reciboDonacion`
`DEC_29_89`	4-11	Régimen de Maquila (Decreto 29-89)	—
`DEC_65_89`	4-12	Régimen de Zonas Francas (Decreto 65-89)	—
`LEY_IVA_ART7_NUM15`	4-9	Medicamentos genéricos o alternativos	—
`LEY_IVA_ART7_NUM12`	4-13	Primera venta de vivienda	—
`LEY_IVA_ART8_NUM2`	4-16	Ventas realizadas por universidades autorizadas	—
`LEY_IVA_ART55`	4-10	Venta de vehículos usados (2 años o más de antigüedad)	—
`CONTRIBUYENTE_EXENTO`	4-18	Contribuyente con resolución específica de exención de la SAT	—
`SERVICIOS_NO_AFECTOS`	4-24	Servicios fuera del hecho generador del IVA	—
`FACT_ORIGEN_NO_INC_IVA`	4-22	El documento original no incluía IVA	Se asigna automáticamente en notas de crédito/débito sobre un documento exento
`LEY_IVA_ART7_NUM10`	4-5	Cuotas o membresías de asociaciones/colegios	Sólo funciona con `tipo: "recibo"`
`LEY_IVA_ART8_NUM1`	4-8	Matrículas y colegiaturas de centros educativos	Sólo funciona con `tipo: "recibo"`

Los motivos LEY_IVA_ART7_H_I y LEY_IVA_ART8 (movilidad eléctrica, Decreto 40-2022) están reservados para escenarios muy específicos que hoy no tienen soporte general en una factura común.

Campos específicos del país

Los campos propios de Guatemala viajan como cualquier otro campo del DTE — no requieren un bloque datosAdicionales especial salvo para casos particulares como el Recibo de Donación, que requiere declarar el tipo de personería jurídica del emisor (la entidad que recibe la donación) con el código numérico del catálogo de la SAT — por ejemplo, 719 corresponde a Asociación Civil:

{
  "tipo": "reciboDonacion",
  "moneda": "GTQ",
  "receptor": {
    "id": "CF",
    "nombre": "CONSUMIDOR FINAL"
  },
  "datosAdicionales": [
    { "nombre": "TIPO_PERSONERIA", "valor": "719" }
  ],
  "items": [
    {
      "descripcion": "Donación recibida",
      "precioUnitario": 500.00
    }
  ]
}

Ejemplo de un ítem con un impuesto específico de Guatemala (IDP, combustible). El catálogo oficial de la SAT identifica cada tipo de combustible con su propio codigoUnidadGravable (por ejemplo, 4 = Diésel, con una tarifa fija de Q1.30 por galón):

{
  "descripcion": "Venta de diésel",
  "cantidad": 100,
  "precioUnitario": 6.10,
  "impuestos": [
    {
      "nombreCorto": "IDP",
      "codigoUnidadGravable": "4",
      "cantidadUnidadesGravables": 100,
      "montoGravable": 610.00,
      "montoImpuesto": 130.00
    }
  ]
}

Para emitir en modo contingencia (vea Contingencia y verificación en línea), incluya el número de acceso a nivel raíz del documento:

{
  "tipo": "factura",
  "numeroAcceso": 123456,
  "receptor": { "id": "CF", "nombre": "CONSUMIDOR FINAL" },
  "items": [{ "descripcion": "Venta en contingencia", "precioUnitario": 100.00 }]
}

Reglas de validación específicas

Exportación a Consumidor Final por Q2,500 o más. Por el Acuerdo Gubernativo 12-2023, una factura de exportación (esExportacion: true) con receptor Consumidor Final (receptor.id: "CF") no puede tener un monto total mayor o igual a Q2,500 (o su equivalente en la moneda del documento). Fegora rechaza la solicitud antes de enviarla a la SAT con codigo: "FEG_VALIDATION_ERROR" y el mensaje Acuerdo gubernativo 12-2023: las exportaciones a Consumidor Final no pueden tener monto mayor o igual a Q2,500.

Exportación sin datos de exportación. Toda solicitud con tipo: "facturaExportacion" o esExportacion: true debe incluir el bloque datosExportacion. Si falta, se rechaza con codigo: "FEG_VALIDATION_ERROR" y el mensaje El DTE de exportacion requiere el campo datosExportacion.

El código postal (receptor.direccion.codigoPostal) debe tener exactamente 5 dígitos cuando el país del receptor es Guatemala.

Las notas de crédito y débito (notaCredito, notaDebito) requieren idDteOriginal (el id del documento al que hacen referencia) y motivoAjuste. Si falta alguno, la solicitud se rechaza con codigo: "FEG_VALIDATION_ERROR".

Estas reglas evitan un rechazo evidente antes de llegar a la SAT, pero no cubren todas las validaciones fiscales: la SAT y el certificador aplican verificaciones adicionales (por ejemplo, que la frase de exención declarada corresponda al escenario permitido) que sólo se detectan al certificar, y se devuelven como codigo: "FEG_DTE_CERTIFICATION_ERROR". Vea Errores de certificación.

Contingencia y verificación en línea

Cuando el enlace hacia el certificador o la SAT no está disponible, la ley guatemalteca permite emitir en modo contingencia: el emisor asigna un número de acceso provisional y lo declara en el campo numeroAcceso (numérico) a nivel raíz del documento. Fegora lo incluye en el XML certificado y lo devuelve en la respuesta.

La SAT ofrece un verificador público de documentos donde cualquier persona puede confirmar la autenticidad de un DTE guatemalteco a partir del NIT del emisor, la serie y el número del documento (o escaneando el código QR de su representación impresa): https://portal.sat.gob.gt/portal/verificador-integrado/.

Catálogos de referencia

Certificadores autorizados: listado oficial de la SAT en https://portal.sat.gob.gt/portal/certificador-de-dte/.
Catálogo de frases (incluye los motivos de exención de IVA y otras frases del régimen FEL): catálogo oficial CatalogoFrases publicado por la SAT.
Catálogo de unidades gravables: define, por cada impuesto (IVA, petróleo, turismo, bomberos, bebidas alcohólicas, etc.), las tasas y bases de cálculo vigentes.
Para la estructura general del documento, ítems y datos adicionales compartidos entre los tres países, vea Estructura del DTE, Impuestos y Datos adicionales.

Introducción

Documentos DTE

Guías por país

Certificador

Tipos de documento

Identificación del receptor

Impuestos

IVA

Impuestos específicos de Guatemala

Exención de IVA: motivos y frases SAT

Campos específicos del país

Reglas de validación específicas

Contingencia y verificación en línea

Catálogos de referencia

​Certificador

​Tipos de documento

​Identificación del receptor

​Impuestos

​IVA

​Impuestos específicos de Guatemala

​Exención de IVA: motivos y frases SAT

​Campos específicos del país

​Reglas de validación específicas

​Contingencia y verificación en línea

​Catálogos de referencia

Certificador

Tipos de documento

Identificación del receptor

Impuestos

IVA

Impuestos específicos de Guatemala

Exención de IVA: motivos y frases SAT

Campos específicos del país

Reglas de validación específicas

Contingencia y verificación en línea

Catálogos de referencia