eliDocs
/
Integrations

n8n

Add Beliq to your n8n workflows with the community node. Generate, validate, parse, and convert compliant e-invoices without code.

Available

The n8n-nodes-beliq community node lets you generate and validate compliant e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS) inside an n8n workflow. Map fields from a previous step, run a Beliq operation, and pass the result to the next node.

Install

In n8n, go to Settings → Community Nodes → Install and enter the package name:

n8n-nodes-beliq

For a self-hosted instance you can also install it into your n8n custom-extensions directory:

npm install n8n-nodes-beliq

Requires n8n with n8nNodesApiVersion: 1 and Node.js 20.15 or newer.

Authentication

Create an API key in the Beliq dashboard under Integration → API Keys, then add a beliq API credential in n8n:

  • API Key: your Beliq key.
  • Base URL: defaults to https://api.beliq.eu. Override only for a self-hosted deployment.

The credential test calls GET /v1/me, a no-quota check that confirms the key works without consuming your monthly quota.

Operations

  • Generate: build a compliant document from an EN 16931 invoice object. Returns the XML, or a hybrid PDF/A-3 with the XML embedded, as binary data plus the Schematron version used.
  • Validate: check an XML or PDF invoice against the authority-pinned rules. Returns the verdict (valid flag, errors, warnings, rule and ruleset versions).
  • Parse: extract a structured invoice object from an XML or PDF document.
  • Convert: convert a document between formats (for example CII to UBL, or UBL to ZUGFeRD). Returns the converted document as binary plus conversion metadata.

Each operation reads input from a binary field (the output of a previous node, or an HTTP download) or from pasted text, and writes document output to a binary field you name.

The Advanced (JSON) field is an escape hatch: its JSON is deep-merged into the request body (Generate) or query (Validate, Parse, Convert), so any API option not surfaced as a control stays reachable.

Starter template

The repo ships a flagship template, templates/order-to-xrechnung-zugferd-validate.json: a sample order is mapped to an EN 16931 invoice, Beliq generates an XRechnung and a hybrid ZUGFeRD, validates the result, and a compliance gate blocks the workflow’s downstream send step if validation fails. Beliq generates and validates; sending stays with you. Import it from the n8n canvas and run it.

See also