Twee manieren om uit de XML te komen
Een UBL-factuur is diep geneste XML met namespaces zoals cac: en cbc:. Deze omzetter leest ze in uw browser en geeft u gegevens die u meteen in code of een spreadsheet kunt gebruiken:
- Factuurmodel-JSON: een stabiele structuur met
supplier,customer,lines,taxTotals,totalsenpaymentMeans. Bedragen zijn getallen met hun munt; prefixen zijn weg; ingesloten pdf’s worden samengevat (naam, type, grootte) in plaats van als base64 uitgeschreven. - Algemene XML naar JSON: elk element, voor velden die het model niet bevat.
- CSV: één rij per factuurlijn, met de factuurhoofding op elke rij herhaald.
Voorbeeld van de CSV
invoice_id,type,issue_date,due_date,currency,supplier,supplier_vat,customer,customer_vat,
line_id,item,sellers_item_id,quantity,unit,price,line_net,vat_category,vat_percent
INV-2026-0042,Invoice,2026-10-01,2026-10-31,EUR,Voorbeeld BV,BE0417497106,Klant NV,BE0xxxxxxxxx,
1,Advies,CONS-01,8,HUR,95.00,760.00,S,21
INV-2026-0042,Invoice,2026-10-01,2026-10-31,EUR,Voorbeeld BV,BE0417497106,Klant NV,BE0xxxxxxxxx,
2,Verplaatsing,TRV,1,C62,40.00,40.00,S,21
Omdat de hoofdingkolommen herhaald worden, kan een draaitabel lijnbedragen optellen per leverancier, per btw-tarief of per maand zonder opzoekingen.
Randgevallen
- Creditnota’s houden
type=CreditNote; de bedragen blijven positief zoals in de XML, dus trek ze zelf af als u ze met facturen combineert. - Kortingen en toeslagen op documentniveau staan in de JSON-totalen maar niet in de lijnrijen; de som van de lijnen kan dus verschillen van het factuurtotaal.
- Eenheidscodes blijven UN/ECE-codes (
C62stuk,HURuur). - Getallen in spreadsheets. Bedragen gebruiken een punt als decimaalteken; stel de importlandinstelling in Excel daarop in.
Wie gebruikt het
Boekhouders die e-factuurlijnen in een spreadsheet willen, ontwikkelaars die een nette JSON-vorm nodig hebben voor een importscript of een API, en controllers die aankopen per leverancier of btw-tarief analyseren, gebruiken de omzetter in plaats van zelf een XML-parser te schrijven. Omdat elke factuurlijn één rij wordt, is de CSV klaar voor draaitabellen, en omdat de JSON bedragen als getallen met munt bewaart, kunnen totalen in code gecontroleerd worden zonder tekstbewerking.
Om een factuur als mens te lezen gebruikt u de UBL-factuurviewer; om ze te controleren de Peppol-validator; om er veel tegelijk te verwerken de batchcontrole. De gids over Peppol en UBL legt het formaat uit.
Veelgestelde vragen
Hoe zet ik een Peppol-XML-factuur om naar Excel?
Sleep de XML hierheen en download de CSV. Die heeft één rij per factuurlijn met de factuurhoofding herhaald en opent meteen in Excel of elke spreadsheet.
Wat staat er in de JSON?
Leverancier, klant, lijnen, btw-totalen, documenttotalen en betaalwijze, met bedragen als getallen en zonder namespaces. Ingesloten bijlagen worden samengevat in plaats van als base64 opgenomen.
Kan ik creditnota’s omzetten?
Ja. Creditnota’s worden op dezelfde manier omgezet en krijgen type CreditNote, zodat u ze apart kunt behandelen.
Waarom is de som van de lijnen niet gelijk aan het factuurtotaal?
Kortingen en toeslagen op documentniveau en de btw zitten niet in de lijnrijen. Ze staan in de JSON-totalen.
Wordt mijn factuur geüpload?
Nee. De omzetting gebeurt in uw browser en het bestand verlaat uw toestel niet.