FEL Guatemala — Facturación electrónica (SAT, DTE)

Descripción

Los nodos FEL conectan tus workflows con la facturación electrónica de Guatemala (SAT, Factura Electrónica en Línea). Floogos arma el DTE, opcionalmente lo firma y lo envía a un certificador que lo certifica ante el SAT, devolviendo el Número de Autorización (UUID).

Nodo	Qué hace
FEL: Emitir factura (felEmitirFactura)	Emite una factura (DTE FACT) → certificación
FEL: Nota de crédito/débito (felEmitirNota)	Emite NCRE o NDEB referenciando el original
FEL: Anular DTE (felAnular)	Anula un DTE certificado por su UUID
FEL: Representación / QR (felRepresentacion)	Genera la representación impresa con QR

En Guatemala se certifica vía un Certificador

No se certifica directo con el SAT: el DTE se envía a un Certificador (INFILE, Guatefacturas, Digifact…) que valida, certifica ante el SAT y devuelve el DTE certificado con el Número de Autorización (UUID). El certificador se configura en la credencial. Si no cargás un certificado propio, el certificador firma por vos. El IVA general es 12%.

Credencial

Los nodos usan una credencial de tipo FEL. Creala en Credenciales → Agregar → Guatemala SAT / FEL con:

Campo	Descripción
Certificador + usuario/llave	El proveedor de certificación y sus credenciales.
NIT del emisor	La identificación tributaria.
Nombre / Nombre comercial	Datos del emisor.
Afiliación IVA	General (GEN) o Pequeño contribuyente (PEQ).
Establecimiento y ubicación	Código de establecimiento, dirección, municipio, departamento.
Ambiente	Pruebas o Producción.
Certificado (.p12)	Opcional: solo si firmás vos.

Emitir una factura

Nodo: FEL: Emitir factura. Ejemplo:

{
  "receptor": { "nit": "CF", "nombre": "Consumidor Final" },
  "items": [
    { "descripcion": "Producto", "cantidad": 1, "precioUnitario": 112, "bienOServicio": "B" }
  ]
}

El precioUnitario va con IVA incluido; Floogos calcula el gravable (precio/1.12) y el IVA (12%). El NIT del receptor CF = consumidor final. bienOServicio: B bien, S servicio.

Notas de crédito y débito

Nota de crédito/débito emite una NCRE o NDEB que referencia el documento de origen con referencia (el UUID del documento original, serie/número y el motivo):

{
  "tipo": "NCRE",
  "referencia": { "uuid": "ABCD1234-...", "serie": "A1B2", "numero": "123", "fecha": "2026-07-20", "motivo": "Devolución" },
  "receptor": { "nit": "CF" },
  "items": [ { "descripcion": "Producto", "cantidad": 1, "precioUnitario": 112 } ]
}

Anular un DTE

Anular DTE anula un comprobante certificado por su UUID (con un motivo obligatorio), a través del certificador.

Representación impresa (QR)

Representación / QR genera la representación imprimible en HTML (exportable a PDF), con el Número de Autorización y el QR que apunta al verificador público del SAT.

Manejo de errores

Situación	Reintentable	Qué hacer
Certificador rechaza	No	El nodo devuelve el error del certificador. Corregí el DTE.
Certificado vencido	No	Renová el .p12 y actualizá la credencial.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Sandbox del certificador

Probá siempre en el ambiente de pruebas de tu certificador antes de producción, y validá la estructura del DTE contra el XSD del SAT-GT.

Ver también

• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para servicios no cubiertos por estos nodos.