Description

n8n-nodes-invoice-api-xhub


This is the official invoice-api.xhub community node for n8n. Generate, parse, and validate e-invoices across 28 European countries and 18+ formats — including XRechnung, ZUGFeRD, Factur-X, FatturaPA, and Peppol — directly from your n8n workflows.

Full documentation | API Playground | OpenAPI Reference | YouTube

Why invoice-api.xhub?

• 28 countries, 18+ formats — one unified JSON schema for XRechnung, ZUGFeRD, Factur-X, FatturaPA, UBL, Peppol, and more
• Compliance built in — validation against country-specific rules (EN 16931, B2G/B2B mandates)
• No-code automation — drag-and-drop n8n node with auto-detect parsing, binary file support, and batch processing
• Free sandbox — test with sktest* keys, no credit card required

See the full feature overview and n8n workflow templates.

Table of Contents

• Why invoice-api.xhub?
• Installation
• Operations
• Credentials
• Compatibility
• Usage
• Troubleshooting
• Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

The package name is n8n-nodes-invoice-api-xhub.

For a step-by-step walkthrough, see the n8n Integration Guide or watch the video walkthrough on YouTube.

Operations

Generate

• Create e-invoice from JSON data (XRechnung, ZUGFeRD, Factur-X, FatturaPA, and more)

Parse

• Extract structured invoice data from XML or PDF documents

Parse (Auto-Detect)

• Parse an invoice with automatic country and format detection — no configuration needed

Validate

• Validate invoice JSON against country-specific rules and return errors/warnings

Get Formats

• Retrieve all supported countries and formats, or formats for a specific country

Credentials

This node requires an API key from invoice-api.xhub.io.

1. Register at invoice-api.xhub.io and navigate to Dashboard → API Keys
2. Create a new API key — keys follow the format sklive... (production) or sktest... (sandbox)
3. In n8n, go to Credentials → New Credential, search for “invoice-api.xhub API”, and enter your key

The credential test automatically verifies the connection by calling GET /api/v1/invoice/formats.

Compatibility

Tested with n8n 1.94.0 and later.

Requires Node.js ≥ 22.0.

Usage

Supported Countries (28)

| Region | Countries |
|——–|———–|
| DACH | Germany (DE), Austria (AT), Switzerland (CH) |
| Western Europe | France (FR), Belgium (BE), Netherlands (NL), Luxembourg (LU), Ireland (IE), United Kingdom (GB) |
| Southern Europe | Italy (IT), Spain (ES), Portugal (PT), Greece (GR), Cyprus (CY), Malta (MT) |
| Northern Europe | Denmark (DK), Sweden (SE), Finland (FI), Norway (NO) |
| Baltics | Estonia (EE), Latvia (LV), Lithuania (LT) |
| Central & Eastern Europe | Poland (PL), Czech Republic (CZ), Hungary (HU), Slovenia (SI), Romania (RO), Bulgaria (BG) |

Supported Formats

pdf · ubl · peppol-ubl · zugferd · xrechnung · ebinterface · qr-bill · facturx · fatturapa · facturae · isdoc · nav · mydata · cii · ksef · efactura · saft

For format details and country-specific requirements, see the API documentation.

Minimal Example: Generate a German XRechnung

{
  "operation": "generate",
  "countryCode": "DE",
  "format": "xrechnung",
  "invoiceData": {
    "type": "invoice",
    "invoiceNumber": "INV-2025-001",
    "issueDate": "2025-01-15",
    "dueDate": "2025-02-14",
    "currency": "EUR",
    "seller": { "name": "ACME GmbH", "street": "Hauptstraße 1", "city": "Berlin", "postalCode": "10115", "countryCode": "DE", "vatId": "DE123456789" },
    "buyer": { "name": "Customer AG", "street": "Nebenstraße 2", "city": "München", "postalCode": "80331", "countryCode": "DE" },
    "countrySpecific": { "buyerReference": "BUYER-REF-001" },
    "items": [{ "position": 1, "description": "Consulting", "quantity": 10, "unit": "HUR", "unitPrice": 150.00, "netAmount": 1500.00, "taxRate": 19, "taxAmount": 285.00, "grossAmount": 1785.00 }],
    "taxSummary": [{ "taxRate": 19, "netAmount": 1500.00, "taxAmount": 285.00 }],
    "subtotal": 1500.00,
    "total": 1785.00,
    "paymentTerms": { "dueDays": 30 }
  }
}

For the full invoice data schema, all parameters, and workflow examples see the API Reference and n8n workflow templates.

Troubleshooting

| Issue | Solution |
|——-|———-|
| 401 Unauthorized | Check your API key format (sklive or sktest) and that it’s entered in the credential |
| Invalid VAT ID | Ensure VAT IDs include the country prefix (e.g., DE123456789) |
| Binary output is empty | Set “Output Binary” to true and check the binary property name (default: data) |
| Request timeout | For large batches, increase the n8n node timeout or process invoices in smaller chunks |
| Format not found | Use the “Get Formats” operation to list available formats for a country |

For more help, see the full troubleshooting guide or contact support@xhub.io.

Resources

• invoice-api.xhub Website — pricing, features, and documentation
• n8n Integration Guide — setup, workflow templates, and FAQ
• API Playground — test API calls in your browser
• OpenAPI Documentation — full endpoint reference
• API Reference (this repo)
• YouTube Channel — video tutorials and product updates
• Video Tutorial — automate e-invoicing with n8n (XRechnung & ZUGFeRD)
• n8n Community Nodes — how to install community nodes
• GitHub Repository
• Support: support@xhub.io

Version History

See Releases for the full changelog.

License

MIT