API de conversion de factures : guide simple
Sources officielles
Utilisez ces sources pour vérifier dates, formats et changements de règles officiels.
Wiki technique associé
Explorez la documentation développeur approfondie et les directives réglementaires correspondant à cet article.
Codes d’erreur d’intégration courants expliqués pour les utilisateurs non techniques.
Guides pratiques pour valider les exports de factures DATEV, Lexware, SAP Business One, Odoo et Microsoft Dynamics.
Listes de codes courantes : catégories TVA, moyens de paiement, unités et types de facture.
L’API de conversion relie un ERP, un logiciel comptable ou une application. Elle est asynchrone : votre système crée une tâche, suit son état et télécharge le résultat.
Le flux API en cinq étapes
Parcours interactif
Convertir, interroger, télécharger
Lancez la lecture ou cliquez sur une étape pour suivre une facture à travers ce canal.
Étape du traitement
Créer une clé API
Avec un abonnement Enterprise actif, créez une clé dans votre profil. Conservez-la sur votre serveur.
- Avec un abonnement Enterprise actif, créez une clé API dans votre profil.
- Envoyez la source à POST /api/v1/invoices:convert avec le format et une clé d’idempotence.
- Conservez l’identifiant de tâche retourné.
- Interrogez GET /api/v1/tasks/{task_id} avec un délai croissant jusqu’à l’état final.
- Téléchargez résultat et rapport. Envoyez les échecs de validation vers une correction, pas une nouvelle tentative identique.
Entrées et formats
L’upload accepte PDF, DOCX et TXT. Une route séparée accepte les données structurées. Les cibles incluent XRechnung, ZUGFeRD, EN 16931, UBL et CII. ZUGFeRD exige une source PDF.
Quand utiliser l’API ?
Utilisez-la pour des flux système à système avec tâches, idempotence et téléchargements explicites. Pour une boîte mail contrôlée et peu volumineuse, utilisez la voie e-mail.
Questions fréquentes
L’API retourne-t-elle la facture immédiatement ?
Non. Elle retourne un identifiant de tâche. L’intégration suit la tâche puis télécharge le résultat.
Existe-t-il des webhooks ?
Le flux partenaire actuel utilise le polling avec délai croissant, pas des webhooks.
Consulter l’API développeur
Consultez l’authentification, les endpoints, les exemples, les limites et les erreurs.