PlaygroundAPIPricingSign inDEGet API key
Loading…

Compliant e-invoices in one POST request. Generate, validate and parse XRechnung and ZUGFeRD / Factur-X. Made in Germany, hosted in the EU.

ProductPlaygroundPricingSign inGet API key
ResourcesDocumentationInteractive referenceOpenAPI specTypeScript SDK (npm)ChangelogStatusSupport
RechtlichesImpressumDatenschutzAGBAVV
© 2026 VIBOA UG (haftungsbeschränkt) · HannoverDE · EN

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

DocumentationAuthenticationYour first invoiceThe 422 reportQuotas & limitsTest vs. live keys
API referencePOST…/generatePOST…/validatePOST…/parse
ReferenceError codesValidation rulesInteractive referenceOpenAPI spec↗@normbill/xrechnung↗Status

Validation rules

BR-TMP-2

An external document location (BT-124) must be an absolute URL with a valid scheme (announced to become an error in a future XRechnung release).

Rule
BR-TMP-2 — official EN 16931 / XRechnung rule
Severity
warning
Business term
BT-124 — Supporting document location
Field in your JSON
invoice.supporting_documents[*].url

How to fix it

Use an absolute http(s) URL in invoice.supporting_documents[i].url.

BR-TMP-2 auf Deutsch — was bedeutet der Fehler?

Eine externe Dokumentenadresse (BT-124) muss eine absolute URL mit gültigem Schema sein (laut Ankündigung künftig ein Fehler).

So beheben Sie den Fehler

Verwenden Sie eine absolute http(s)-URL in invoice.supporting_documents[i].url.

Official sources

  • XRechnung specification (KoSIT / xeinkauf.de)
  • KoSIT validator on GitHub and the XRechnung validator configuration

Every 422 from the API lists the rule id, the path in your request JSON, a plain-language message and a suggested fix — see the docs overview for the report format.