Guide · Mis à jour en mai 2026
Export MarkdownAutomatisation de la conversion de PDF en facture électronique à grande échelle via l'API
Automatisez la conversion de PDF en facture électronique à haut débit, configurez le polling asynchrone, gérez les événements de webhook et traitez plusieurs fichiers de manière programmatique.
Étapes clés de l'intégration
Utilisez ces points comme contrôles pratiques pour cette section.
- Obtenez une clé API de production depuis le tableau de bord développeur.
- Authentifiez toutes les requêtes en utilisant l'en-tête
Authorizationavec un jetonBearer. - Envoyez une requête
POSTà/api/v1/convertavec le fichier PDF et les paramètres du profil de conformité. - Gerez la réponse de la tâche asynchrone et effectuez un polling pour obtenir le statut ou écoutez les webhooks.
- Récupérez le flux XML validé au format
XRechnung,ZUGFeRDouUBL.
Polling asynchrone et webhooks
L'intégration de la conformité de la facturation électronique à grande échelle nécessite de migrer des téléchargements de fichiers manuels vers des flux de travail API asynchrones et entièrement automatisés. Invoice Converter fournit un backend haute performance optimisé pour le traitement par lots à haut débit.
Pour les environnements à haut débit, nous recommandons une intégration asynchrone. Lorsque vous téléchargez un PDF, l'API renvoie immédiatement un statut 202 Accepted avec un identifiant de tâche unique.
Votre système peut soit interroger le point de terminaison du statut de la tâche via GET /api/v1/tasks/{id} toutes les quelques secondes, soit enregistrer une URL de webhook pour recevoir une notification POST automatique dès que la conversion est prête.
Bonnes pratiques pour la mise à l'échelle
Utilisez ces points comme contrôles pratiques pour cette section.
- Spécifiez toujours un profil de conformité explicite, tel que
XRechnungouZUGFeRD, 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.
- Activez la vérification des signatures de webhook pour vous assurer que les événements entrants proviennent d'Invoice Converter.