Welche Angaben braucht eine XRechnung mindestens?

Das Format xrechnung erzeugt über die faktoora-API eine Rechnung, die dem europäischen Standard EN 16931 entspricht — wahlweise als reine XML-Datei oder als ZUGFeRD-Profil. Damit die Rechnung erstellt werden kann, müssen bestimmte Angaben im Request vorhanden sein.

Pflichtfelder auf Rechnungsebene

Beim Invoice-Objekt selbst sind laut API-Schema folgende Felder verpflichtend:

• format (hier: xrechnung)
• issueDate — Rechnungsdatum
• invoiceNumber — Rechnungsnummer
• invoiceTypeCode — Rechnungstyp, z. B. 380 für eine reguläre Handelsrechnung
• invoiceItems — mindestens eine Rechnungsposition
• buyer — der Käufer

Pflichtfelder beim Verkäufer

Schicken Sie einen seller-Block mit, sind darin folgende Felder Pflicht:

• name — Name des Unternehmens
• street — Straße
• postcode — Postleitzahl
• city — Ort
• country — Land als ISO-3166-1-alpha-2-Code (z. B. DE)

Pflichtfelder beim Käufer

Der buyer-Block ist auf Rechnungsebene ohnehin verpflichtend; innerhalb davon sind Pflicht:

• name — Name des Käufers
• street — Straße
• postcode — Postleitzahl
• city — Ort
• country — Land als ISO-3166-1-alpha-2-Code

Pflichtfelder je Rechnungsposition

Jede Position in invoiceItems benötigt eine id und ein product-Objekt. Innerhalb von product sind Pflicht:

• name — Bezeichnung der Ware oder Leistung
• quantity — Menge
• unitCode — Mengeneinheit (z. B. HUR für Stunden, C62 für Stück, KGM für Kilogramm)
• price — Einzelpreis
• taxes — mindestens ein Steuereintrag mit typeCode, categoryCode und rate

Leitweg-ID für öffentliche Auftraggeber

Rechnungen an öffentliche Auftraggeber tragen zusätzlich eine Leitweg-ID. In der API wird diese im Feld buyerReference.buyerReferenceId übermittelt. Sie erhalten die Leitweg-ID vom Rechnungsempfänger. Richten sich Ihre Rechnungen an Unternehmen statt an öffentliche Auftraggeber, liegt in der Regel keine Leitweg-ID vor.

Eine über die faktoora-Oberfläche erstellte XRechnung fragt dieselben Angaben Schritt für Schritt ab; die Klickanleitung dazu finden Sie im Artikel Erstellung einer XRechnung/ZUGFeRD oder PDF Rechnung.