# XRechnung-facturen maken uit een CSV- of JSON-bestand

- 2026-11-17

Deze pilot maakt XRechnung-facturen uit factuurgegevens in plaats van pdf’s. Upload in een bulkverwerking één CSV- of JSON-bestand, wijs de kolommen toe, controleer de facturen in een voorbeeld en start de verwerking. De dienst leest het bestand zonder AI, dus elk gegeven moet in het bestand staan.

## Factuurgegevens in plaats van pdf’s

Eén bestand met tot 500 facturen wordt één bulkverwerking van XRechnung-bestanden.

In een bulkverwerking voor XRechnung kunt u in plaats van pdf’s één CSV- of JSON-bestand uploaden. De dienst leest het bestand zonder AI. Elk gegeven komt uit het bestand: niets wordt afgeleid, aangevuld of afgerond. Land, valuta, btw, datums en alle totalen moeten in het bestand staan.

Een verwerking bevat óf pdf’s óf geïmporteerde facturen, niet allebei. De pilot maakt alleen XRechnung (UBL). Bulkverwerking vraagt een actief Enterprise-abonnement.

> **Pilot**: De import is een pilot. Excel-bestanden worden niet rechtstreeks gelezen: exporteer het werkblad eerst als UTF-8-CSV.

## Een bestand importeren

1. Open Profiel en daarna Bulkverwerking, en kies CSV of JSON importeren.
2. Kies het bestand. Stel het decimaalteken en de datumnotatie van het bestand in.
3. Wijs de kolommen toe. Een kolom waarvan de naam overeenkomt met een factuurveld, het BT-nummer of de omschrijving ervan, krijgt een voorstel. Elke kolom met waarden moet worden toegewezen of genegeerd.
4. Controleer de facturen in het voorbeeld. Een factuur met bevindingen kan niet worden geïmporteerd: corrigeer het bestand, kies het gecorrigeerde bestand en werk het voorbeeld bij.
5. Bevestig de controle en kies Facturen aan de batch toevoegen.
6. Lees de kostencontrole en start de verwerking, net als bij pdf’s.

## Bestandstypen

| Bestand | Opbouw |
| --- | --- |
| CSV | UTF-8 met een kopregel. Scheidingsteken `,` `;` tab of `|`, aanhalingstekens volgens RFC 4180. Een byte-order-markering is toegestaan. |
| Platte JSON-records | Een array van objecten met tekst of getallen als waarden. Elk object is één rij, en de sleutels zijn de kolommen. |
| Canonieke JSON | Een array van gestructureerde factuurobjecten, of `{"invoices": [...]}`. Er is geen kolomtoewijzing nodig. |

## Hoe rijen facturen worden

- Een CSV-rij of een plat JSON-record is één factuurregel.
- Rijen met hetzelfde factuurnummer (BT-1) vormen één factuur. Ze moeten overeenkomen in de factuurgegevens, bijvoorbeeld de naam van de koper.
- Een factuur uit CSV of platte JSON heeft één btw-uitsplitsing. Stuur facturen met meerdere btw-categorieën of tarieven als canonieke JSON.

## Getallen en datums

| Waarde | Regel |
| --- | --- |
| Decimaalteken | `.` of `,`. Bij `,` groepeert `.` de duizendtallen. JSON-getallen gebruiken altijd `.`. |
| Datumnotatie | `2026-11-13` (ISO) of `13.11.2026` |
| Bedragen in CSV | Hoogstens twee decimalen |
| Aantallen en prijzen | Hoogstens tien decimalen |
| Elk getal | Hoogstens 15 cijfers vóór het decimaalteken |
| Kenmerken zoals postcodes | Voorloopnullen blijven staan |

## Wanneer een factuur wacht

Een factuur heeft een bevinding, en de import wacht, als:

- de rijen verschillen in een factuurgegeven, bijvoorbeeld twee namen van de koper;
- een verplicht veld leeg is of een waarde niet te lezen is;
- de totalen niet kloppen (EN 16931-regels BR-CO-10, BR-CO-13, BR-CO-14, BR-CO-15 en BR-CO-16);
- een regelbedrag (BT-131) meer dan één cent afwijkt van aantal × eenheidsprijs ÷ basishoeveelheid van de prijs, op een regel zonder kortingen of toeslagen;
- een btw-categorie anders dan `O` geen tarief heeft (BT-119, BT-152);
- de gegevens niet aan het canonieke factuurschema voldoen.

## Bestanden die de dienst weigert

De dienst weigert een bestand dat hij op meer dan één manier zou kunnen lezen:

- lege of dubbele kolomnamen;
- rijen met meer of minder cellen dan de kopregel;
- dubbele JSON-sleutels;
- `NaN`, `Infinity` en getallen met een exponent;
- geneste waarden in platte records, en onbekende velden in canonieke JSON.

## Grenzen

| Grens | Waarde |
| --- | --- |
| Bestandsgrootte | 2 MB |
| Facturen per bestand | 500 |
| Rijen | 10.000 |
| Kolommen | 100 |
| JSON-diepte | 32 |

## Facturering

Elke geïmporteerde factuur wordt net als een pdf-factuur in een bulkverwerking omgezet, gevalideerd, afgerekend en afgeleverd: één conversie per afgegeven factuur, eerst uit uw inbegrepen conversies, daarna uit API-credits. U ziet de kosten vóór de start.

Vóór de import wordt niets opgeslagen. Herhaalt u een ongewijzigde import, dan worden dezelfde facturen hergebruikt.

## Voorbeeldbestand

Het synthetische voorbeeld bevat drie facturen met verzonnen gegevens. Het gebruikt puntkomma’s, decimale komma’s en datums zoals 13.11.2026. Factuur SYNTH-0002 heeft twee regels.

- [CSV-voorbeeld downloaden](/examples/structured-invoices.csv)

## Volgende stappen

Bulkverwerking vraagt een actief Enterprise-abonnement.

- [Lees de handleiding voor bulkverwerking](/developer-api/bulk-runs)
- [Enterprise starten](/pricing)
- [Documentatie van de External API V1 bekijken](/developer-api)
