# Automatisering van PDF-naar-e-factuurconversie op schaal via API

- Bijgewerkt in mei 2026

Automatiseer PDF-naar-e-factuurconversie via de API, configureer asynchrone statuspolling en verwerk meerdere facturen programmatisch, met één conversieverzoek per factuur.

## Belangrijkste integratiestappen

- Vraag een productie-API-sleutel aan via het ontwikkelaarsdashboard.
- Authenticeer alle verzoeken met de `Authorization`-header met een `Bearer`-token.
- Stuur een `POST`-verzoek naar `/api/v1/invoices:convert` met het PDF-bestand en de parameters voor het nalevingsprofiel.
- Verwerk de asynchrone taakrespons en poll `GET` `/api/v1/tasks/{task_id}` totdat de conversie is voltooid of mislukt.
- Haal de gevalideerde `XRechnung`-, `ZUGFeRD`- of `UBL`-XML-uitvoer op.

## Asynchrone statuspolling

Het integreren van e-facturatienaleving op schaal betekent het automatiseren van indiening en ophalen via de API. Elk verzoek converteert precies één factuur, en geconverteerde resultaten moeten voor randgevallen en brondocumenten van lage kwaliteit nog steeds via uw normale controle- en uitzonderingsproces lopen.

De API is asynchroon: wanneer u een PDF uploadt, retourneert deze onmiddellijk een status 202 Accepted met een uniek taak-ID.

Uw systeem polt het taakstatus-eindpunt op `GET` `/api/v1/tasks/{task_id}` elke 10 tot 15 seconden totdat de taak als voltooid of mislukt wordt gemeld. De API biedt geen webhooks; via polling verneemt uw systeem wanneer een conversie gereed is.

## Best practices voor schaalvergroting

- Geef altijd een expliciet nalevingsprofiel op, zoals `XRechnung` of `ZUGFeRD`, om vertragingen bij automatische detectie te voorkomen.
- Implementeer exponentiële backoff bij het pollen van de taakstatus om onnodige snelheidslimieten (rate limits) te vermijden.
- Sla de geretourneerde taak-UUID's op in uw lokale database voor eenvoudige tracering en auditlogging.
- Stuur per factuur een stabiele `Idempotency-Key`-header, zodat nieuwe pogingen nooit dubbele conversies veroorzaken.