FelEmitirFactura

Descripción

Emite una factura electrónica (DTE, Documento Tributario Electrónico) en Guatemala bajo el régimen FEL (Factura Electrónica en Línea) de la SAT (Superintendencia de Administración Tributaria). El nodo arma el DTE a partir de los datos de la factura, opcionalmente lo firma con el certificado del emisor y lo envía al certificador habilitado configurado en la credencial, que lo certifica ante el SAT.

Si la credencial no tiene cargado un certificado propio, el certificador firma el documento por vos. La respuesta incluye el UUID (Número de Autorización) que identifica al DTE de forma única ante el SAT.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial FEL (certificador + NIT)
dte	json	No	Factura (JSON): receptor (nit, nombre), items (con precioUnitario IVA incluido, bienOServicio B/S). El emisor sale de la credencial. IVA 12%. Si se omite, se toma del data de entrada

Credenciales

Este módulo requiere una credencial de tipo fel con los siguientes campos:

• NIT del emisor: NIT del contribuyente que emite el DTE.
• Certificador: proveedor certificador habilitado (por ejemplo INFILE u otro genérico).
• Usuario/contraseña o llave del certificador: credenciales de acceso al servicio del certificador.
• Certificado (.p12) (opcional): si se carga, el DTE se firma localmente antes de enviarlo; si no, firma el certificador.
• Ambiente: pruebas o producción.

Salida

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "estado": "certified",
  "serie": "A",
  "numero": "1042",
  "fechaCertificacion": "2026-08-05T15:30:00-06:00",
  "total": 1120.5,
  "iva": 120.05,
  "xml": "<...>",
  "certificador": "infile"
}

Ejemplo de Uso

{
  "credentials_id": "cred-fel-prod",
  "dte": {
    "receptor": {
      "nit": "CF",
      "nombre": "Consumidor Final"
    },
    "items": [
      {
        "cantidad": 1,
        "descripcion": "Servicio de automatización",
        "precioUnitario": 1120.5,
        "bienOServicio": "S"
      }
    ]
  }
}

Notas

• Si dte no se envía en la configuración, el nodo toma el objeto completo recibido en data como factura.
• El nodo rechaza el envío si la factura no incluye al menos un ítem (dte.items).
• Si el certificado (.p12) cargado en la credencial está vencido, el nodo corta la ejecución antes de intentar certificar.
• El uuid devuelto (Número de Autorización) es el que hay que guardar para anular el documento o generar su representación impresa.

Nodos Relacionados

• FelEmitirNota - Emitir nota de crédito/débito referenciando esta factura
• FelAnular - Anular un DTE ya certificado
• FelRepresentación - Generar la representación impresa con QR