API voor factuurconversie: eenvoudige integratie
Officiële bronnen
Gebruik deze bronnen om datums, formaten en officiële regelwijzigingen te controleren.
Gerelateerde technische wiki
Ontdek diepgaande ontwikkelaarsdocumentatie en regelgevende richtlijnen die bij dit artikel horen.
Veelvoorkomende integratiefoutcodes uitgelegd voor niet-technische gebruikers.
Praktische gidsen voor het valideren van factuurexports uit DATEV, Lexware, SAP Business One, Odoo en Microsoft Dynamics.
Veelgebruikte codelijsten: BTW-categorieën, betaalmiddelcodes, eenheidscodes en factuurtypecodes.
Artikeloverzicht
Dit artikel legt API voor factuurconversie: eenvoudige integratie uit als praktische referentie voor Europese e-facturatie. Het definieert het onderwerp in duidelijke taal, plaatst het in de compliancecontext en verbindt de uitleg met factuurformaten zoals XRechnung, ZUGFeRD/Factur-X, UBL en CII.
De API voor factuurconversie koppelt een ERP, boekhoudsysteem of eigen toepassing. De verwerking is asynchroon: uw systeem maakt een taak, controleert de status en downloadt het resultaat.
Zo gebruik je deze gids
Gebruik het artikel als startpunt voordat je een finance- of ERP-workflow wijzigt: bepaal de toepasselijke landregel of standaard, kies het verwachte gestructureerde formaat, valideer de gegenereerde XML en leg een uitzonderingsproces vast voor facturen die handmatige controle nodig hebben.
De API-flow in vijf stappen
Voor De API-flow in vijf stappen is dit de praktische volgorde van werken.
- Vraag API-toegang aan en maak een sleutel met goedgekeurde facturatie of prepaid credits.
- Stuur de bron met doelformaat en idempotency key naar POST /api/v1/invoices:convert.
- Bewaar het teruggegeven taak-ID.
- Poll GET /api/v1/tasks/{task_id} met oplopende wachttijd tot een eindstatus.
- Download resultaat en validatierapport. Stuur validatiefouten naar correctie en probeer ze niet ongewijzigd opnieuw.
Invoer en formaten
De uploadroute accepteert PDF, DOCX en TXT. Er is een aparte route voor gestructureerde invoer. Doelen zijn onder meer XRechnung, ZUGFeRD, EN 16931, UBL en CII. ZUGFeRD vereist een PDF-bron.
Wanneer gebruikt u de API?
Gebruik de API voor herhaalbare systeemkoppelingen met taak-ID’s, idempotentie en expliciete downloads. Gebruik voor een gecontroleerde mailbox met laag volume de e-mailroute.
Bekijk de developer-API
Bekijk authenticatie, endpoints, voorbeelden, fouten en het actuele contract.
Open API-documentatieKlaar om je facturen te converteren?
Begin vandaag met het converteren van PDF-facturen naar XRechnung, ZUGFeRD en andere formaten met credits of een betaald plan.