FelRepresentacion

Description

Generates the printable representation of a Guatemala (FEL) DTE, including the QR code that lets it be verified on the SAT’s portal. The node can work in two ways: retrieving an already certified DTE by its UUID (querying Floogos’s database), or previewing a DTE in JSON that has not been certified yet.

It returns HTML ready to print or convert to PDF, along with the QR code’s URL and image.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	FEL credential
uuid	text	No	UUID of the certified DTE (fetches data from the database)
dte	json	No	DTE JSON to preview (if no UUID is provided)

Credentials

This module requires a fel credential type (used to complete the issuer’s data: NIT, name, address, municipality).

Output

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

Usage Example

Retrieving an already certified DTE by its UUID:

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

Previewing a DTE that has not been certified yet:

{
  "credentials_id": "cred-fel-prod",
  "dte": {
    "receptor": {
      "nit": "CF",
      "nombre": "Consumidor Final"
    },
    "items": [
      {
        "cantidad": 1,
        "descripcion": "Automation service",
        "precioUnitario": 1120.5,
        "bienOServicio": "S"
      }
    ]
  }
}

Notes

• If uuid is passed, the node prioritizes the data stored in the database over any other field sent in dte.
• If no DTE is found with the given UUID, the node returns an error instead of generating an empty representation.
• The returned HTML is meant to be rendered in the browser or converted to PDF from another node in the workflow.
• The QR code points to the certifying provider’s/SAT’s verification service, it is not just a decorative link.

Related Nodes

• FelEmitirFactura - Issue the origin invoice
• FelEmitirNota - Issue a credit/debit note
• FelAnular - Cancel an already certified DTE