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
- 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.
Prêt à convertir vos factures ?
Convertissez vos factures PDF en XRechnung, ZUGFeRD et d’autres formats. Abonnements à partir de 10 €/mois en facturation annuelle (hors taxes), avec un essai de 3 jours sur le premier abonnement. Ou sans abonnement : 5 € par conversion (hors taxes).