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.
Vue d’ensemble de l’article
Cet article explique API de conversion de factures : guide simple comme une référence pratique pour la facturation électronique européenne. Il définit le sujet en langage clair, le replace dans le contexte de conformité et relie l’explication aux formats XRechnung, ZUGFeRD/Factur-X, UBL et CII.
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.
Comment utiliser ce guide
Utilisez l’article comme point de départ avant de modifier un processus finance ou ERP : identifiez la règle pays ou la norme applicable, déterminez le format structuré attendu, validez le XML généré et conservez un processus d’exception documenté pour les factures nécessitant une revue manuelle.
Le flux API en cinq étapes
Pour Le flux API en cinq étapes, cette séquence donne l’ordre de travail pratique.
- Demandez l’accès et créez une clé API avec facturation approuvée ou crédits prépayés.
- 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.
Consulter l’API développeur
Consultez authentification, endpoints, exemples, erreurs et contrat actuel.
Ouvrir la documentation APIPrêt à convertir vos factures ?
Commencez dès aujourd’hui à convertir des factures PDF en XRechnung, ZUGFeRD et autres formats avec des crédits ou un plan payant.