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

Automatiseer PDF-naar-e-factuurconversie met hoge doorvoer, configureer asynchrone polling, beheer webhook-events en verwerk meerdere bestanden programmatisch.

## 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/convert` met het PDF-bestand en de parameters voor het nalevingsprofiel.
- Verwerk de asynchrone taakrespons en poll voor de status of luister naar webhooks.
- Haal de gevalideerde `XRechnung`-, `ZUGFeRD`- of `UBL`-XML-uitvoer op.

## Asynchrone polling en webhooks

Het integreren van e-facturatienaleving op schaal vereist een migratie van handmatige bestandsuploads naar volledig geautomatiseerde, asynchrone API-workflows. Invoice Converter biedt een krachtige backend die is geoptimaliseerd voor batchverwerking met hoge doorvoer.

Voor omgevingen met een hoge doorvoer raden we een asynchrone integratie aan. Wanneer u een PDF uploadt, retourneert de API onmiddellijk een status 202 Accepted met een uniek taak-ID.

Uw systeem kan elke paar seconden het taakstatus-eindpunt op `GET` `/api/v1/tasks/{id}` opvragen of een webhook-URL registreren om een automatische `POST`-melding te ontvangen zodra de 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.
- Schakel verificatie van webhook-handtekeningen in om er zeker van te zijn dat inkomende gebeurtenissen afkomstig zijn van Invoice Converter.