# XRechnungen aus einer CSV- oder JSON-Datei erstellen

- 2026-11-17

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

| Datei | Aufbau |
| --- | --- |
| CSV | UTF-8 mit Kopfzeile. Trennzeichen `,` `;` Tabulator oder `|`, Anführungszeichen nach RFC 4180. Eine Byte-Order-Markierung ist erlaubt. |
| Flache JSON-Datensätze | Ein Array von Objekten mit Text- oder Zahlenwerten. Jedes Objekt ist eine Zeile, seine Schlüssel sind die Spalten. |
| Kanonisches JSON | Ein 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

| Wert | Regel |
| --- | --- |
| Dezimaltrennzeichen | `.` oder `,`. Bei `,` gruppiert `.` die Tausender. JSON-Zahlen nutzen immer `.`. |
| Datumsformat | `2026-11-13` (ISO) oder `13.11.2026` |
| Beträge in CSV | Höchstens zwei Nachkommastellen |
| Mengen und Preise | Höchstens zehn Nachkommastellen |
| Jede Zahl | Höchstens 15 Stellen vor dem Dezimaltrennzeichen |
| Kennungen wie Postleitzahlen | Fü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

| Grenze | Wert |
| --- | --- |
| Dateigröße | 2 MB |
| Rechnungen pro Datei | 500 |
| Zeilen | 10.000 |
| Spalten | 100 |
| JSON-Tiefe | 32 |

## 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.

- [CSV-Beispiel herunterladen](/examples/structured-invoices.csv)

## Nächste Schritte

Die Stapelverarbeitung braucht ein aktives Enterprise-Abo.

- [Anleitung zur Stapelverarbeitung lesen](/developer-api/bulk-runs)
- [Enterprise starten](/pricing)
- [Dokumentation der External API V1 ansehen](/developer-api)
