⚠ France mandate: Sept 2026·Germany issuing phases: 2027–28·ViDA EU-wide
PlaygroundAPIPricingSign inGet API key
Loading…

A developer-first e-invoicing API. Generate and validate XRechnung and ZUGFeRD / Factur-X invoices with a simple JSON API.

PlaygroundAPIPricingSign in

Not legal or tax advice. XRechnung® is a standard of KoSIT; ZUGFeRD® of FeRD. Names used for format identification only.

Live — instant API keys, no sales call

Compliant e-invoices in one POST request.

Generate and validate XRechnung and ZUGFeRD / Factur-X invoices with a simple JSON API. Instant API key. Real documentation. No sales call, no €495/month minimum.

Get your API key→Try the live demo
✓No sales call✓No €495/month minimum
API pipeline
POST /v1/invoices/generate
jsonxml·pdf
{ }your JSON
APIvalidate + render
RECHNUNG
Summe1.428,00 €
✓
XRechnung · ZUGFeRD
curl https://api.normbill.com/v1/invoices/generate \ -H "Authorization: Bearer sk_live_..." \ -d '{ "format": "xrechnung-3.0", "invoice": { "number": "RE-2026-0042", "seller": { "name": "Acme GmbH", "vat_id": "DE123456789" }, "buyer": { "name": "Kunde AG", "country": "DE" }, "lines": [{ "name": "Consulting", "qty": 10, "unit_price": 120.00, "vat": 19 }] } }'
# pip install normbill import normbill client = normbill.Client("sk_live_...") inv = client.invoices.generate( format="xrechnung-3.0", invoice={ "number": "RE-2026-0042", "seller": {"name": "Acme GmbH", "vat_id": "DE123456789"}, "buyer": {"name": "Kunde AG", "country": "DE"}, "lines": [{"name": "Consulting", "qty": 10, "unit_price": 120.00}], }, ) inv.validation.valid # True
// npm install normbill import Normbill from "normbill"; const client = new Normbill("sk_live_..."); const inv = await client.invoices.generate({ format: "xrechnung-3.0", invoice: { number: "RE-2026-0042", seller: { name: "Acme GmbH", vatId: "DE123456789" }, buyer: { name: "Kunde AG", country: "DE" }, lines: [{ name: "Consulting", qty: 10, unitPrice: 120.0 }], }, }); console.log(inv.validation.valid); // true
sending request…
● 200 OK142 ms· { "xml": "<ubl:Invoice>…", "validation": { "valid": true } }
RECHNUNGRE-2026-0042
Gesamtbetrag1.428,00 €
✓ XRechnung 3.0✓ EN 16931PDF/A-3 + XML
XRechnung 3.0·ZUGFeRD 2.x·Factur-X 1.07·EN 16931·UBL 2.1·CII D16B·PDF/A-3·KoSIT Schematron·Peppol BIS 3.0·XRechnung 3.0·ZUGFeRD 2.x·Factur-X 1.07·EN 16931·UBL 2.1·CII D16B·PDF/A-3·KoSIT Schematron·Peppol BIS 3.0·
Why now

The deadline wave is the demand engine

EU e-invoicing mandates are rolling out country by country. Every business — and every SaaS that issues invoices for its users — needs structured, schema-valid e-invoices. Most don't want to read 200 pages of EN 16931.

Jan 2025

Germany: receive

All businesses must be able to receive e-invoices (B2B).

Sept 2026

France: issuing begins

Mandatory e-invoicing for large & mid-size enterprises; all businesses must receive.

Jan 2027

Germany: issuing, phase 1

Businesses > €800k turnover must issue e-invoices.

Jan 2028

Germany: all businesses

Issuing mandatory for everyone. ViDA digital reporting follows EU-wide.

Playground

Live demo — runs entirely in your browser

This playground generates a real XRechnung 3.0 (UBL) document and runs structural EN 16931 checks on it — client-side, no backend. The production API adds full KoSIT Schematron validation, ZUGFeRD / Factur-X hybrid PDFs, and Peppol delivery.

Invoice

Seller · BG-4Acme GmbH · Berlin
Buyer · BG-7Kunde AG · München
Line items · BG-25
output.xml — waiting
// Fill the form and press Generate.
// You get a real UBL 2.1 / XRechnung 3.0 document.
Structural EN 16931 checks

Generate a document to see the validation report.

Runs entirely in your browser — nothing you type leaves this page. The API adds full KoSIT Schematron validation.

Get your API key→
API

API surface — small on purpose

Three endpoints. Stripe-quality docs. Client libraries for Python, Node, PHP, Go. That's the product.

POST/v1/invoices/generateInvoice JSON → XRechnung 3.0 XML or ZUGFeRD 2.x / Factur-X hybrid PDF (PDF/A-3 with embedded CII XML)MVP
POST/v1/invoices/validateXML/PDF in → full Schematron + schema report with line-level errors, human-readable fixesMVP
POST/v1/invoices/parseInbound e-invoice (XML or hybrid PDF) → clean JSON. For the receiving side of the mandate.v1.1 soon
POST/v1/peppol/sendDeliver via Peppol network (partner access point)v2 roadmap
key

Instant API key

Sign up, get a key, first call in under 5 minutes. The exact opposite of "book a demo".

422

Honest validation

Full KoSIT Schematron + EN 16931 schema. Errors come back as humans-can-fix-this messages, not rule codes.

eu

Format roadmap

XRechnung & ZUGFeRD first (Germany), Factur-X (France, Sept 2026), then FatturaPA, Peppol BIS as ViDA lands.

Error messages

Validation errors a human can fix

Every other validator hands you a Schematron rule code and wishes you luck. We return the rule, the path in your JSON, what's wrong, and how to fix it.

THE USUAL EXPERIENCE

[error] BR-DE-15 | XRechnung_3.0 | severity=fatal
cvc-complex-type.2.4.b: The content of element
'cac:PartyIdentification' is not complete. One of
'{urn:oasis:names:specification:ubl:schema:xsd:
CommonBasicComponents-2}ID' is expected.

(line 47, col 28)

NORMBILL 422

{
  "valid": false,
  "format": "xrechnung-3.0",
  "profile": "XRechnung 3.0.2 (UBL 2.1)",
  "tier": "schematron",
  "counts": {
    "errors": 1,
    "warnings": 0
  },
  "issues": [
    {
      "severity": "error",
      "rule": "BR-DE-15",
      "path": "invoice.buyer_reference",
      "message": "Leitweg-ID is missing. Public-sector buyers in Germany require one (BT-10).",
      "fix": "Ask the buyer for their Leitweg-ID. Format: 04011000-1234512345-06",
      "docs_url": "https://docs.normbill.com/rules/BR-DE-15",
      "location": "/ubl:Invoice/cbc:BuyerReference"
    }
  ]
}
Pricing

Pricing — no sales call, ever

Incumbents start around €495/month with annual contracts. We start free.

Hacker

€0
  • 50 invoices / month
  • Generate + validate
  • Community support
  • Test & live keys
Start free
MOST POPULAR

Startup

€29/mo
  • 500 invoices / month
  • €0.10 per extra invoice
  • Email support, 99.9% SLA
  • Test & live keys
Choose Startup

Scale

€99/mo
  • 5,000 invoices / month
  • €0.05 per extra invoice
  • Priority support
  • Everything in Startup
Choose Scale
The incumbent experience
normbill
First API call
Days — after the demo call
Under 5 minutes
Entry price
~€495/month, annual contract
€0, no contract
Documentation
PDF, on request
Public, with runnable examples
Validation errors
Schematron rule codes
Plain-language fixes
FAQ

Questions developers actually ask

Is the generated XML actually legally compliant?
The API produces schema-valid XRechnung 3.0 (UBL 2.1) and ZUGFeRD 2.x / Factur-X documents and validates them against the EN 16931 rule set plus the German KoSIT Schematron before returning. Compliance of the content (correct VAT treatment, mandatory references for your buyer) still depends on the data you send — which is exactly what the validation report tells you about.
Do you store our invoice data?
No. Invoices are processed in memory and returned; nothing is persisted by default. EU-hosted infrastructure, GDPR-first. An optional 30-day retention mode exists for debugging, off by default.
We're a SaaS that issues invoices for our users — can we embed this?
That's the core use case. One API key, per-tenant metadata on every invoice, and webhooks for validation results. Your users never see normbill — they just get compliant invoices out of your product.
What about France and Factur-X?
Factur-X 1.07 output is on the MVP path and ships well before the September 2026 issuing mandate. A practical guide to the French model (PDP / PPF, who needs what, when) lives in the public docs.
Can you deliver invoices over Peppol?
POST /v1/peppol/send is on the v2 roadmap via a certified partner access point. Generation and validation come first — that's the part every team needs on day one.
What happens when validation fails?
You get a 422 with line-level errors: the rule that fired, the path in your JSON that caused it, a plain-language message, and a suggested fix. The API never silently returns an invalid document.
Get started

Start free. First invoice in 5 minutes.

The Free plan includes 50 invoices per month — generate and validate XRechnung documents with test and live keys. No sales call, no contract, no credit card.

Get your API key→
✓EU-hosted✓No invoice data stored by default✓GDPR-first