# API de conversion de factures : guide simple

- Date: 2026-07-29
- Modified: 2026-08-29
- Vérifié: 29 août 2026
- Reading time: 1 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.

> Vérifié par rapport à API développeur Invoice Converter, Spécification OASIS UBL 2.1.

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

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