# API de conversion de factures : guide simple

- Date: 2026-07-29
- Reading time: 4 min de lecture

Intégrez la conversion par API : obtenez l’accès, envoyez avec une clé d’idempotence, suivez la tâche et téléchargez le résultat.

## 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](/fr/blog/invoice-conversion-by-email).

## Consulter l’API développeur

Consultez authentification, endpoints, exemples, erreurs et contrat actuel.

[Ouvrir la documentation API](/fr/developer-api)

## FAQ

### 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.

## Sources officielles

- [API développeur Invoice Converter](https://www.invoice-converter.com/en/developer-api)
- [Spécification OASIS UBL 2.1](https://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html)