FelRepresentación

Descripción

Genera la representación impresa de un DTE de Guatemala (FEL), incluyendo el código QR que permite verificar el documento en el portal del SAT. El nodo puede trabajar de dos formas: recuperando un DTE ya certificado a partir de su UUID (consultando la base de datos de Floogos), o previsualizando un DTE en JSON que todavía no fue certificado.

Devuelve HTML listo para imprimir o convertir a PDF, junto con la URL y la imagen del código QR.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial FEL
uuid	text	No	UUID del DTE certificado (recupera datos de la base)
dte	json	No	DTE en JSON para previsualizar (si no se pasa UUID)

Credenciales

Este módulo requiere una credencial de tipo fel (se usa para completar los datos del emisor: NIT, nombre, dirección, municipio).

Salida

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "html": "<html>...</html>",
  "qrUrl": "https://certificador.gt.example/consulta?uuid=a1b2c3d4...",
  "qrImage": "data:image/png;base64,..."
}

Ejemplo de Uso

Recuperando un DTE ya certificado por su UUID:

{
  "credentials_id": "cred-fel-prod",
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Previsualizando un DTE que aún no se certificó:

{
  "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 se pasa uuid, el nodo prioriza los datos guardados en la base sobre cualquier otro campo enviado en dte.
• Si no se encuentra un DTE con el UUID indicado, el nodo devuelve error en lugar de generar una representación vacía.
• El HTML devuelto está pensado para renderizarse en el navegador o convertirse a PDF desde otro nodo del workflow.
• El QR apunta al servicio de verificación del certificador/SAT correspondiente, no es solo un enlace decorativo.

Nodos Relacionados

• FelEmitirFactura - Emitir la factura de origen
• FelEmitirNota - Emitir una nota de crédito/débito
• FelAnular - Anular un DTE ya certificado