Ga naar de hoofdinhoud
API voor factuurconversie: eenvoudige integratie
Blog

API voor factuurconversie: eenvoudige integratie

1 min leestijdGecontroleerd: 29 augustus 2026
Markdown-export

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.

API- en automatiseringsfoutmeldingen

Veelvoorkomende integratiefoutcodes uitgelegd voor niet-technische gebruikers.

Validatiegidsen voor ERP-exports

Praktische gidsen voor het valideren van factuurexports uit DATEV, Lexware, SAP Business One, Odoo en Microsoft Dynamics.

E-factuur codelijsten

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

Interactieve flow

Druk op afspelen of klik op een stap om één factuur door dit kanaal te volgen.

Uitvoer:XRechnungZUGFeRDEN 16931UBLCII

Verwerkingsfase

Stap 1 van 6UEenmalige inrichting

Maak een API-sleutel

Met een actief Enterprise-abonnement maakt u een sleutel in uw profiel. Bewaar hem op uw server.

De External API is asynchroon: uw systeem maakt een taak aan, vraagt de status op en downloadt het gevalideerde resultaat. 1. Maak een API-sleutel: Met een actief Enterprise-abonnement maakt u een sleutel in uw profiel. Bewaar hem op uw server. 2. Verstuur de bron: Upload een PDF, DOCX of TXT met het doelformaat en een idempotentiesleutel. Er is ook een route voor gestructureerde invoer. 3. Bewaar de taak-ID: De API antwoordt meteen met een taak-ID. De factuur wordt op de achtergrond geconverteerd. 4. Opvragen met backoff: Vraag de status op met oplopende tussenpozen tot hij voltooid of mislukt is. Een taak is pas voltooid als het bestand de validatie voor het gevraagde profiel heeft doorstaan. 5. Bestand en rapport downloaden: Haal het resultaat en het validatierapport op. 6. Fouten naar een mens sturen: Stuur validatiefouten naar correctie in plaats van ze ongewijzigd opnieuw te proberen. Uitvoer: XRechnung, ZUGFeRD, EN 16931, UBL, CII. Stappen zoals beschreven in deze gids en de specificatie van de External API V1. Stand: oktober 2026.
  1. Maak met een actief Enterprise-abonnement een API-sleutel in uw profiel.
  2. Stuur de bron met doelformaat en idempotency key naar POST /api/v1/invoices:convert.
  3. Bewaar het teruggegeven taak-ID.
  4. Poll GET /api/v1/tasks/{task_id} met oplopende wachttijd tot een eindstatus.
  5. 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.

Veelgestelde vragen

Geeft de API de factuur direct terug?

Nee. De API geeft een taak-ID. Uw integratie pollt de taak en downloadt het resultaat.

Biedt de API webhooks?

De huidige partnerflow gebruikt polling met backoff en geen partnerwebhooks.

Bekijk de developer-API

Bekijk authenticatie, endpoints, voorbeelden, limieten en fouten.

E-factuur-API

Gerelateerde artikelen