Package Information
Available Nodes
Documentation generating…
Documentation
@invoicexml/n8n-nodes-invoicexml
This is an n8n community node for InvoiceXML, the e-invoicing API for Europe. It creates, validates and converts EN 16931 e-invoices in XRechnung, ZUGFeRD, Factur-X, UBL / Peppol BIS and CII, right inside your n8n workflows. Every invoice is validated against the official rules before it is returned.
n8n is a fair-code licensed workflow automation platform.
Installation ·
Operations ·
Credentials ·
Usage ·
Compatibility ·
Resources ·
Version history
Installation
Follow the installation guide in the n8n community nodes documentation. The package name is @invoicexml/n8n-nodes-invoicexml.
Operations
The InvoiceXML node has one resource, Invoice, with five operations:
| Operation | What it does |
|---|---|
| Create | Builds a validated e-invoice file from invoice JSON with the e-invoice creation API. Choose XRechnung, ZUGFeRD, Factur-X, UBL / Peppol BIS or CII. The file is returned as binary data. |
| Validate | Checks an e-invoice file with the e-invoice validation API and returns valid, the error and warning counts and every finding with its rule and message. |
| Convert | Converts an e-invoice file to another format with the e-invoice conversion API, for example UBL to ZUGFeRD or Factur-X to CII. |
| Extract Data | Reads the invoice data embedded in a ZUGFeRD or Factur-X PDF with the invoice data extraction API and returns it as JSON. |
| Render as PDF | Turns an XRechnung, UBL or CII invoice XML into a readable PDF in English, German or French (render API reference). |
Validate, Convert, Extract Data and Render as PDF read the invoice file from a binary field of the incoming item (data by default). Create, Convert and Render as PDF return the new file in the data binary field.
Credentials
You need an InvoiceXML API key:
- Sign up or log in at www.invoicexml.com.
- Open Account > Authentication and copy your API key.
- In n8n, create an InvoiceXML API credential and paste the key.
n8n checks the key when you save the credential.
Usage
Create an XRechnung from your order data. Put a Code or Set node before the InvoiceXML node that builds the invoice JSON, then map it into the Invoice field of the Create operation. The node's default value is a complete example to start from. All invoice fields are described in the InvoiceXML API documentation.
Check incoming invoices. Use an email or cloud storage trigger that delivers the invoice file as binary data, then the Validate operation. Route on the valid field with an If node.
Book a received ZUGFeRD PDF. Use Extract Data on the PDF and map the returned seller, totals and lines into your accounting system.
When the API rejects an invoice, the node error shows the API message and every validation finding, so you can see which field to fix.
Compatibility
Built with the @n8n/node-cli tooling (n8n nodes API version 1). Works with current n8n versions, on n8n Cloud and self-hosted.
Resources
Version history
See CHANGELOG.md.