# API voor factuurconversie: eenvoudige integratie

- Date: 2026-07-29
- Modified: 2026-08-29
- Gecontroleerd: 29 augustus 2026
- Reading time: 1 min leestijd

Integreer factuurconversie via API: verkrijg toegang, upload met idempotency key, poll de taak en download het resultaat.

> Gecontroleerd aan de hand van Invoice Converter developer-API, OASIS UBL 2.1-specificatie.

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](/nl/blog/invoice-conversion-by-email).

> **Converteren, opvragen, downloaden**
>
> 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.

## FAQ

### 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.

## Officiële bronnen

- [Invoice Converter developer-API](https://www.invoice-converter.com/en/developer-api)
- [OASIS UBL 2.1-specificatie](https://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html)