Zum Hauptinhalt springen

Integration · 2026-11-17

Markdown-Export

XRechnungen aus einer CSV- oder JSON-Datei erstellen

Dieser Pilot erstellt XRechnungen aus Rechnungsdaten statt aus PDFs. Laden Sie in der Stapelverarbeitung eine CSV- oder JSON-Datei hoch, ordnen Sie die Spalten zu, prüfen Sie die Rechnungen in einer Vorschau und starten Sie den Lauf. Der Dienst liest die Datei ohne KI, darum muss jede Angabe in der Datei stehen.

Rechnungsdaten statt PDFs

Eine Datei mit bis zu 500 Rechnungen wird zu einem Stapel von XRechnung-Dateien.

In einer Stapelverarbeitung für XRechnung können Sie statt PDFs eine CSV- oder JSON-Datei hochladen. Der Dienst liest die Datei ohne KI. Jede Angabe stammt aus der Datei: Nichts wird abgeleitet, ergänzt oder gerundet. Land, Währung, Umsatzsteuer, Datumsangaben und alle Summen müssen in der Datei stehen.

Ein Lauf enthält entweder PDFs oder importierte Rechnungen, nicht beides. Der Pilot erstellt nur XRechnung (UBL). Die Stapelverarbeitung braucht ein aktives Enterprise-Abo.

Pilot

Der Import ist ein Pilot. Excel-Dateien werden nicht direkt gelesen: Exportieren Sie das Tabellenblatt vorher als UTF-8-CSV.

Eine Datei importieren

  1. Öffnen Sie Profil und dann Stapelverarbeitung, und wählen Sie CSV oder JSON importieren.
  2. Wählen Sie die Datei. Stellen Sie das Dezimaltrennzeichen und das Datumsformat der Datei ein.
  3. Ordnen Sie die Spalten zu. Eine Spalte, deren Name einem Rechnungsfeld, seiner BT-Nummer oder seiner Bezeichnung entspricht, erhält einen Vorschlag. Jede Spalte mit Werten muss zugeordnet oder ignoriert werden.
  4. Prüfen Sie die Rechnungen in der Vorschau. Eine Rechnung mit Befunden kann nicht importiert werden: Korrigieren Sie die Datei, wählen Sie die korrigierte Datei und aktualisieren Sie die Vorschau.
  5. Bestätigen Sie die Prüfung und wählen Sie Rechnungen zum Stapel hinzufügen.
  6. Lesen Sie die Kostenprüfung und starten Sie den Lauf wie bei PDFs.

Dateiarten

DateiAufbau
CSVUTF-8 mit Kopfzeile. Trennzeichen , ; Tabulator oder |, Anführungszeichen nach RFC 4180. Eine Byte-Order-Markierung ist erlaubt.
Flache JSON-DatensätzeEin Array von Objekten mit Text- oder Zahlenwerten. Jedes Objekt ist eine Zeile, seine Schlüssel sind die Spalten.
Kanonisches JSONEin Array strukturierter Rechnungsobjekte oder {"invoices": [...]}. Es braucht keine Spaltenzuordnung.

Wie aus Zeilen Rechnungen werden

  • Eine CSV-Zeile oder ein flacher JSON-Datensatz ist eine Rechnungsposition.
  • Zeilen mit derselben Rechnungsnummer (BT-1) bilden eine Rechnung. Sie müssen bei den Rechnungsangaben übereinstimmen, zum Beispiel beim Namen des Käufers.
  • Eine Rechnung aus CSV oder flachem JSON hat eine Umsatzsteueraufschlüsselung. Senden Sie Rechnungen mit mehreren Steuerkategorien oder Steuersätzen als kanonisches JSON.

Zahlen und Datumsangaben

WertRegel
Dezimaltrennzeichen. oder ,. Bei , gruppiert . die Tausender. JSON-Zahlen nutzen immer ..
Datumsformat2026-11-13 (ISO) oder 13.11.2026
Beträge in CSVHöchstens zwei Nachkommastellen
Mengen und PreiseHöchstens zehn Nachkommastellen
Jede ZahlHöchstens 15 Stellen vor dem Dezimaltrennzeichen
Kennungen wie PostleitzahlenFührende Nullen bleiben erhalten

Wann eine Rechnung wartet

Eine Rechnung hat einen Befund, und der Import wartet, wenn:

  • ihre Zeilen bei einer Rechnungsangabe voneinander abweichen, zum Beispiel zwei Käufernamen;
  • ein Pflichtfeld leer ist oder ein Wert sich nicht lesen lässt;
  • ihre Summen nicht aufgehen (EN-16931-Regeln BR-CO-10, BR-CO-13, BR-CO-14, BR-CO-15 und BR-CO-16);
  • ein Positionsbetrag (BT-131) um mehr als einen Cent von Menge × Einzelpreis ÷ Preisbasismenge abweicht, bei einer Position ohne Zu- oder Abschläge;
  • eine Steuerkategorie außer O keinen Steuersatz hat (BT-119, BT-152);
  • die Daten das kanonische Rechnungsschema nicht erfüllen.

Dateien, die der Dienst ablehnt

Der Dienst lehnt eine Datei ab, die er auf mehr als eine Weise lesen könnte:

  • leere oder doppelte Spaltennamen;
  • Zeilen mit mehr oder weniger Zellen als die Kopfzeile;
  • doppelte JSON-Schlüssel;
  • NaN, Infinity und Zahlen mit Exponent;
  • verschachtelte Werte in flachen Datensätzen und unbekannte Felder in kanonischem JSON.

Grenzen

GrenzeWert
Dateigröße2 MB
Rechnungen pro Datei500
Zeilen10.000
Spalten100
JSON-Tiefe32

Abrechnung

Jede importierte Rechnung wird wie eine PDF-Rechnung in der Stapelverarbeitung umgewandelt, validiert, abgerechnet und ausgegeben: eine Umwandlung pro ausgegebener Rechnung, zuerst aus Ihren enthaltenen Umwandlungen, dann aus API-Credits. Sie sehen die Kosten vor dem Start.

Vor dem Import wird nichts gespeichert. Wenn Sie einen unveränderten Import wiederholen, werden dieselben Rechnungen wiederverwendet.

Beispieldatei

Das synthetische Beispiel enthält drei Rechnungen mit erfundenen Daten. Es nutzt Semikolons, Dezimalkommas und Datumsangaben wie 13.11.2026. Die Rechnung SYNTH-0002 hat zwei Positionen.

Nächste Schritte

Die Stapelverarbeitung braucht ein aktives Enterprise-Abo.