Gids · Bijgewerkt in mei 2026
Markdown-exportAutomatisering van PDF-naar-e-factuurconversie op schaal via API
Automatiseer PDF-naar-e-factuurconversie via de API, configureer asynchrone statuspolling en verwerk meerdere facturen programmatisch, met één conversieverzoek per factuur.
Belangrijkste integratiestappen
Gebruik deze punten als praktische controles voor deze sectie.
- Vraag een productie-API-sleutel aan via het ontwikkelaarsdashboard.
- Authenticeer alle verzoeken met de
Authorization-header met eenBearer-token. - Stuur een
POST-verzoek naar/api/v1/invoices:convertmet 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- ofUBL-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
Gebruik deze punten als praktische controles voor deze sectie.
- Geef altijd een expliciet nalevingsprofiel op, zoals
XRechnungofZUGFeRD, 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.