Welche BT-Felder unterstützt die faktoora-API?
Übersicht der EN-16931-Business-Terms (BT-Felder), die die faktoora-Rechnungs-API abbildet, mit API-Feld und Pflichtstatus.
Die faktoora-API erzeugt elektronische Rechnungen (XRechnung, ZUGFeRD, Peppol) nach dem europäischen Standard EN 16931. Dieser Standard beschreibt jede mögliche Rechnungsangabe als sogenanntes "Business Term", kurz BT, mit einer festen Nummer — zum Beispiel BT-1 für die Rechnungsnummer. In der API-Referenz von faktoora ist bei jedem Feld, das einem solchen Business Term entspricht, die passende BT-Nummer in der Feldbeschreibung vermerkt.
Wo die BT-Felder in der API stehen
Beim Erstellen einer Rechnung über POST /invoices senden Sie ein Invoice-Objekt. Darin sind die BT-Felder auf mehrere Bereiche verteilt:
- Rechnungskopf — direkt auf dem
Invoice-Objekt (Rechnungsnummer, Datum, Rechnungstyp, Währung, Referenzen) seller— Verkäuferangaben (Name, Adresse, USt-ID)buyer— Käuferangaben (Name, Adresse, USt-ID, Referenzen)invoiceItems— Rechnungspositionen, jeweils mit einemproduct-Objekt (Bezeichnung, Menge, Einzelpreis, Steuersatz)
Häufig benötigte BT-Felder
Diese Auswahl deckt die Felder ab, die für eine vollständige Rechnung typischerweise nötig sind. "Pflicht" bezieht sich auf das jeweilige API-Objekt, sofern Sie es mitschicken — beim Invoice-Objekt selbst sind laut Schema nur format, issueDate, invoiceNumber, invoiceTypeCode, invoiceItems und buyer grundsätzlich verpflichtend.
| BT-Nummer | Bedeutung | API-Feld | Pflicht |
|---|---|---|---|
| BT-1 | Rechnungsnummer | invoiceNumber | Ja |
| BT-2 | Rechnungsdatum | issueDate | Ja |
| BT-3 | Rechnungstyp (z. B. 380 = Handelsrechnung) | invoiceTypeCode | Ja |
| BT-5 | Währung | currency | Nein |
| BT-9 | Fälligkeitsdatum | dueDateTime (in specifiedTradePaymentTerms) | Nein |
| BT-10 | Käuferreferenz / Leitweg-ID | buyerReference.buyerReferenceId | Nein |
| BT-13 | Bestellreferenz des Käufers | buyerReference.IssuerAssignedID | Nein |
| BT-14 | Referenz auf die Bestellung | orderNumber | Nein |
| BT-27 | Name des Verkäufers | seller.name | Ja, innerhalb von seller |
| BT-31 | USt-ID des Verkäufers | seller.vatId | Nein |
| BT-35 / BT-37 / BT-38 / BT-40 | Straße, Ort, PLZ, Land des Verkäufers | seller.street / seller.city / seller.postcode / seller.country | Ja, innerhalb von seller |
| BT-46 | Kundennummer beim Verkäufer | buyer.id | Nein |
| BT-47 | Name des Käufers | buyer.name | Ja, innerhalb von buyer |
| BT-48 | USt-ID des Käufers | buyer.vatId | Nein |
| BT-50 / BT-52 / BT-53 / BT-55 | Straße, Ort, PLZ, Land des Käufers | buyer.street / buyer.city / buyer.postcode / buyer.country | Ja, innerhalb von buyer |
| BT-72 | Lieferdatum | deliveryDate | Nein |
| BT-126 | Positionsnummer | invoiceItems[].id | Ja, innerhalb der Position |
| BT-129 | Menge | invoiceItems[].product.quantity | Ja, innerhalb von product |
| BT-130 | Mengeneinheit (z. B. HUR, C62, KGM) | invoiceItems[].product.unitCode | Ja, innerhalb von product |
| BT-146 | Einzelpreis | invoiceItems[].product.price | Ja, innerhalb von product |
| BT-153 | Bezeichnung der Position | invoiceItems[].product.name | Ja, innerhalb von product |
| BT-155 | Artikelnummer (vom Verkäufer vergeben) | invoiceItems[].product.productId | Nein |
Jede Rechnungsposition benötigt außerdem eine Steuerangabe (taxes) mit Steuerart, Steuerkategorie (z. B. S für den Standardsatz oder Z für den Nullsatz) und Steuersatz — diese drei Angaben sind bei jeder Position Pflicht.
Vollständige Referenz
Die vorstehende Tabelle zeigt eine Auswahl der am häufigsten benötigten Felder. Insgesamt weist die API-Dokumentation deutlich mehr BT-Felder aus, unter anderem für Zahlungsbedingungen, Rabatte/Zuschläge, Lieferadressen, Vertrags- und Projektreferenzen sowie global eindeutige Identifikatoren (GLN/GTIN). Die vollständige, verbindliche Liste mit allen Feldbeschreibungen und Beispielen finden Sie in der API-Referenz Ihres faktoora-Accounts.
Was this helpful?