# Automatisation de la conversion de PDF en facture électronique à grande échelle via l'API

- Mis à jour en mai 2026

Automatisez la conversion de PDF en facture électronique via l'API, configurez le polling asynchrone du statut et traitez plusieurs factures de manière programmatique, à raison d'une requête de conversion par facture.

## Étapes clés de l'intégration

- Obtenez une clé API de production depuis le tableau de bord développeur.
- Authentifiez toutes les requêtes en utilisant l'en-tête `Authorization` avec un jeton `Bearer`.
- Envoyez une requête `POST` à `/api/v1/invoices:convert` avec le fichier PDF et les paramètres du profil de conformité.
- Gérez la réponse de la tâche asynchrone et interrogez `GET` `/api/v1/tasks/{task_id}` jusqu'à ce que la conversion aboutisse ou échoue.
- Récupérez le flux XML validé au format `XRechnung`, `ZUGFeRD` ou `UBL`.

## Polling asynchrone du statut

Intégrer la conformité de la facturation électronique à grande échelle consiste à automatiser l'envoi et la récupération via l'API. Chaque requête convertit exactement une facture, et les résultats convertis doivent continuer à passer par votre processus habituel de révision et de gestion des exceptions pour les cas limites et les documents sources de faible qualité.

L'API est asynchrone : lorsque vous téléversez un PDF, elle renvoie immédiatement un statut 202 Accepted avec un identifiant de tâche unique.

Votre système interroge le point de terminaison du statut de la tâche via `GET` `/api/v1/tasks/{task_id}` toutes les 10 à 15 secondes, jusqu'à ce que la tâche soit signalée comme terminée ou échouée. L'API ne propose pas de webhooks : c'est par le polling que votre système apprend qu'une conversion est prête.

## Bonnes pratiques pour la mise à l'échelle

- Spécifiez toujours un profil de conformité explicite, tel que `XRechnung` ou `ZUGFeRD`, pour éviter les délais de détection automatique.
- Implémentez un backoff exponentiel lors du polling du statut de la tâche afin d'éviter les limites de débit (rate limits) inutiles.
- Stockez les UUID de tâche renvoyés dans votre base de données locale pour faciliter le traçage et la journalisation d'audit.
- Envoyez un en-tête `Idempotency-Key` stable par facture afin que les relances ne créent jamais de conversions en double.