Willkommen in unserem FAQ-Bereich. Hier finden Sie Antworten auf viele Fragen rund um unsere finaX XRechnung API. Egal, ob Sie inhaltliche oder technische Unterstützung brauchen oder mehr über die Funktionen unserer API erfahren möchten – wir haben hier die passenden Informationen für Sie gesammelt.
Allgemeine Fragen rund um die E-Rechnung
Eine E-Rechnung ist eine elektronische Rechnung in einem strukturierten Format (z.B. XML). XRechnung ist der deutsche Standard zur Umsetzung der europäischen Norm EN 16931, welche Anforderungen an elektronische Rechnungen in Europa definiert.
ZUGFeRD ist ein hybrides Datenformat, das genauso wie XRechnung die Norm EN 16931 erfüllt. Es ist eine Kombination aus einem vom Menschen lesbaren PDF und dem maschinell lesbaren Format XML.
Im Kontext der öffentlichen Verwaltung ist die E-Rechnung (B2G) ist die E-Rechnung schon seit mehreren Jahren verpflichtend.
Ab 2025 erfolgt die schrittweise Einführung der E-Rechnung im B2B Kontext. Mehr dazu erfahren Sie in unserem Blogartikel „XRechnung-Pflicht im B2B-Bereich: Übergangsfristen und Ausnahmeregelungen„.
Fragen zu Feldern der E-Rechnung
Die Leitweg-ID ist insbesondere im B2G Kontext von Bedeutung, um Rechnungen über die Zentrale Rechnungseingangsplattform (ZRE) des Bundes an den richtigen Empfänger senden zu können.
Im B2B Kontext haben die meisten Unternehmen vermutlich keine Leitweg-ID, es sei denn sie möchten elektronische Rechnungen über das Peppol-Netzwerk empfangen.
Die Leitweg-ID muss im Feld BT-10 „Buyer Reference“ eingetragen werden. Dieses Feld ist verpflichtend. Sollte keine Leitweg-ID (im B2B Kontext) vorliegen, kann in diesem Feld stattdessen eine andere Käuferreferenz angegeben werden.
In diesem Feld wird die sogenannte „Leitweg-ID“ eingetragen (insbesondere im B2G Kontext von Bedeutung). Sollte diese nicht vorliegen, kann eine andere Käuferreferenz angegeben werden.
Rabatte auf der Artikel-Ebene werden im Feld invoice_position > price_details > item_price_discount.
Rabatte auf der Ebene der Rechnungspositionen werden in den invoice_lines unter invoice_line_allowances eingetragen.
Rabatte auf Ebene der Gesamtrechnung werden im Feld document_level_allowance eingetragen. Beachten Sie, dass die Summe aller Rabatte auf der Ebene der Gesamtrechnung nochmal in den document_totals angegeben werden muss.
Fragen zur finaX XRechnung API
Eine API (Application Programming Interface) ist eine Schnittstelle über die Programme miteinander kommunizieren können.
APIs sind grundsätzlich mit nahezu allen Anwendungen kompatibel. In unserer Dokumentation finden Sie außerdem eine Postman-Collection mit der Sie die Endpunkte ganz ohne Code einmal ausprobieren können sowie Code-Beispiele zu jedem Endpunkt, die Ihnen demonstrieren, wie Sie die finaX API möglichst schnell und effizient mit Ihrer vertrauten Programmiersprache anbinden können.
Wir haben Endpunkte zur Umwandlung von unserer finaX JSON Struktur zu XML (XRechnung) sowohl für die Syntax CII als auch für die Syntax UBL. Mehr Informationen finden Sie in unserer API Dokumentation: https://docs.finax.dev/#tag/XML-from-JSON
Wir haben Endpunkte zur Umwandlung von XRechnung XML zu JSON sowie zur Extraktion und Umwandlung von ZUGFeRD XML zu JSON. Mehr Informationen finden Sie in unserer API Dokumentation: https://docs.finax.dev/#tag/JSON-from-XML
Ja, laut offizieller ZUGFeRD Spezifikation ist die Nutzung von PDF/A verpflichtend.
Ja, finaX bietet Endpunkte zur Erstellung von ZUGFeRD-konformen PDFs, die aus XRechnungsdaten generiert werden. Mehr dazu können Sie in unserem Blogartikel „XRechnung zu PDF Umwandlung“ und in unserer API-Dokumentation lesen.