Integration · 2026-11-17
Markdown exportCreate XRechnung invoices from a CSV or JSON file
This pilot creates XRechnung invoices from invoice data instead of PDFs. Upload one CSV or JSON file in a bulk run, assign the columns, check the invoices in a preview, and start the run. The service reads the file without AI, so every fact must be in the file.
Invoice data instead of PDFs
One file with up to 500 invoices becomes one bulk run of XRechnung files.
In a bulk run for XRechnung, you can upload one CSV or JSON file instead of PDFs. The service reads the file without AI. Every fact comes from the file: nothing is derived, filled in or rounded. Country, currency, VAT, dates and all totals must be in the file.
A run holds either PDFs or imported invoices, not both. The pilot creates XRechnung (UBL) only. Bulk runs need an active Enterprise subscription.
Pilot
The import is a pilot. Excel files are not read directly: export the worksheet as UTF-8 CSV first.
Import a file
- Open Profile, then Bulk run, and choose Import CSV or JSON.
- Choose the file. Set the decimal separator and the date format that the file uses.
- Assign the columns. A column whose name matches an invoice field, its BT number or its label gets a suggestion. Every column that holds values must be assigned or ignored.
- Check the invoices in the preview. An invoice with findings cannot be imported: correct the file, choose the corrected file, and update the preview.
- Confirm the check and choose Add invoices to the run.
- Read the cost check and start the run, as for PDFs.
File types
| File | Shape |
|---|---|
| CSV | UTF-8 with a header row. Delimiter , ; tab or |, quotes as in RFC 4180. A byte order mark is allowed. |
| Flat JSON records | An array of objects with text or number values. Each object is one row, and its keys are the columns. |
| Canonical JSON | An array of structured invoice objects, or {"invoices": [...]}. It needs no column assignment. |
How rows become invoices
- A CSV row or a flat JSON record is one invoice line.
- Rows with the same invoice number (BT-1) form one invoice. They must agree on the invoice facts, for example the buyer name.
- A CSV or flat JSON invoice holds one VAT breakdown. Send invoices with several VAT categories or rates as canonical JSON.
Numbers and dates
| Value | Rule |
|---|---|
| Decimal separator | . or ,. With , a . groups thousands. JSON numbers always use .. |
| Date format | 2026-11-13 (ISO) or 13.11.2026 |
| Amounts in CSV | At most two decimal places |
| Quantities and prices | At most ten decimal places |
| Every number | At most 15 digits before the decimal separator |
| Identifiers such as post codes | Leading zeros stay |
When an invoice waits
An invoice has a finding, and the import waits, when:
- its rows disagree on an invoice fact, for example two buyer names;
- a required field is empty, or a value does not parse;
- its totals do not add up (EN 16931 rules BR-CO-10, BR-CO-13, BR-CO-14, BR-CO-15 and BR-CO-16);
- a line amount (BT-131) differs from quantity × unit price ÷ price base quantity by more than one cent, on a line without line allowances or charges;
- a VAT category other than
Ohas no rate (BT-119, BT-152); - the data fails the canonical invoice schema.
Files the service refuses
The service refuses a file that it could read in more than one way:
- blank or repeated column names;
- rows with more or fewer cells than the header;
- repeated JSON keys;
NaN,Infinityand numbers with an exponent;- nested values in flat records, and unknown fields in canonical JSON.
Limits
| Limit | Value |
|---|---|
| File size | 2 MB |
| Invoices per file | 500 |
| Rows | 10,000 |
| Columns | 100 |
| JSON depth | 32 |
Billing
Each imported invoice is converted, validated, charged and delivered like a PDF invoice in a bulk run: one conversion per issued invoice, first from your included conversions, then from API credits. You see the cost before you start.
Nothing is stored before the import. Repeating an unchanged import reuses the same invoices.
Example file
The synthetic example holds three invoices with made-up data. It uses semicolons, decimal commas and dates such as 13.11.2026. Invoice SYNTH-0002 has two lines.
Next steps
Bulk runs need an active Enterprise subscription.