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.
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.
De API-flow in vijf stappen
- Maak met een actief Enterprise-abonnement een API-sleutel in uw profiel.
- 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.
Klaar om uw facturen te converteren?
Converteer PDF-facturen naar XRechnung, ZUGFeRD en andere formaten. Abonnementen vanaf € 10/maand bij jaarlijkse facturering (excl. belastingen), met een proefperiode van 3 dagen bij uw eerste abonnement. Of zonder abonnement: € 5 per conversie (excl. belastingen).