Formatmodelle

Auf dieser Seite wird die Bedeutung der wichtigsten Felder erläutert, die in Dokumentmodellen (Rechnungen, Gutschriften) in verschiedenen Formaten verwendet werden. Das hilft beim Ausfüllen des Webformulars oder beim Aufbau der API-Request-Bodies. Siehe Formate, Dokumentenmodell und Dokumente erstellen. Eine detaillierte Referenz nach Abschnitten und Feldern mit JSON/XML-Beispielen finden Sie unter Rechnungsmodell verstehen. Beispiele finden Sie unter Basis-Beispiel Rechnungsmodell.

Wo dies gilt

• Web — Das einheitliche Formular (Stammdaten, Positionen, Summen, Zusatz) ordnet jedes Steuerelement einem oder mehreren Modellfeldern zu.
• API — Die Request-Bodies für upload/model, update/model und die Format-API (transform, validate) verwenden dieselben logischen Felder. Siehe Dokumente erstellen und Validierung und Konvertierung.

Hauptfeldgruppen (nach Bedeutung)

Kopf / Dokumentidentifikation

• Rechnungsnummer (ID) — Eindeutiger Bezeichner der Rechnung (z. B. INV-2024-001). In den meisten Formaten Pflichtfeld.
• Ausstellungsdatum — Datum der Rechnungsstellung. Üblicherweise YYYY-MM-DD.
• Dokumenttyp — Rechnung oder Gutschrift (und ggf. Untertyp, z. B. self-billing). Oft ein Code (z. B. 380 für Handelsrechnung).
• Customisation ID / Profil — Formatkennung (z. B. Peppol BIS, XRechnung). Wird in der Regel vom System aus dem gewählten Format gesetzt.

Parteien (Verkäufer / Käufer)

• Verkäufer (Lieferant) — Name, Adresse (Straße, Ort, PLZ, Land), USt-IdNr., elektronischer Kontakt. Wer die Rechnung ausstellt.
• Käufer (Auftraggeber) — Gleiche Struktur. Wer die Rechnung erhält. Für Peppol ist die Peppol-ID des Käufers (Schema + Wert) für die Zustellung erforderlich.
• Zahlungsempfänger / Steuervertreter des Verkäufers — Optional; bei Bedarf.

Positionen (line items)

• Zeilen-ID — Reihenfolge der Zeile (Ganzzahl oder Zeichenkette).
• Menge / Einheit — Menge (z. B. 10) und Maßeinheit (z. B. C62 = Stück).
• Beschreibung — Textbeschreibung der Ware oder Leistung.
• Preis pro Einheit / Preis — Preis pro Einheit (ohne Steuer).
• Zeilen-Nettobetrag — Menge × Einheitspreis (Netto der Zeile).
• Steuer (pro Zeile) — Steuerkategorie, Satz (%), Steuerbetrag. Erlässe/Zuschläge — Rabatte oder Zuschläge pro Zeile bei Bedarf.

Summen (Dokumentebene)

• Summe der Zeilen-Nettobeträge — Summe aller Zeilen-Netto.
• Erlässe / Zuschläge (Dokumentebene) — Rabatt oder Zuschlag auf die gesamte Rechnung (Betrag oder Prozent).
• Steuer-Zwischensummen — Pro Steuerkategorie: besteueter Betrag, Satz, Steuerbetrag.
• Gesamtsteuerbetrag — Summe aller Steuern.
• Zu zahlender Betrag (Gesamtsumme) — Fälliger Betrag. Vorauszahlung — Falls im Voraus gezahlt. Restbetrag — Zu zahlen minus Vorauszahlung.

Zahlung und Lieferung (bei Bedarf)

• Zahlungsbedingungen — Fälligkeitsdatum, Beschreibung (z. B. „Zahlung innerhalb von 30 Tagen“).
• Zahlungsmittel — Bankkonto (IBAN, BIC), Zahlungsreferenz.
• Lieferung — Lieferdatum, Adresse (falls abweichend vom Käufer).

Zusätzlich (formatabhängig)

Weitere Felder können in einzelnen Formaten vorkommen (Notizen, Käuferreferenz, Vertrag, Projekt, Buchungsreferenz). Für exakte Eigenschaftsnamen und Struktur siehe die OpenAPI-Schema (Scalar oder Swagger) für das von Ihnen genutzte Format. Siehe API-Referenz.