# Créer des factures XRechnung à partir d’un fichier CSV ou JSON

- 2026-11-17

Ce pilote crée des factures XRechnung à partir de données de facture au lieu de PDF. Téléversez un fichier CSV ou JSON dans un traitement par lots, associez les colonnes, vérifiez les factures dans un aperçu et lancez le traitement. Le service lit le fichier sans IA : chaque donnée doit donc figurer dans le fichier.

## Des données de facture au lieu de PDF

Un fichier de 500 factures au maximum devient un traitement par lots de fichiers XRechnung.

Dans un traitement par lots pour XRechnung, vous pouvez téléverser un fichier CSV ou JSON au lieu de PDF. Le service lit le fichier sans IA. Chaque donnée vient du fichier : rien n’est déduit, complété ou arrondi. Le pays, la devise, la TVA, les dates et tous les totaux doivent figurer dans le fichier.

Un traitement contient soit des PDF, soit des factures importées, pas les deux. Le pilote crée uniquement des XRechnung (UBL). Le traitement par lots demande un abonnement Enterprise actif.

> **Pilote**: L’import est un pilote. Les fichiers Excel ne sont pas lus directement : exportez d’abord la feuille en CSV UTF-8.

## Importer un fichier

1. Ouvrez Profil, puis Traitement par lots, et choisissez Importer un CSV ou un JSON.
2. Choisissez le fichier. Indiquez le séparateur décimal et le format de date du fichier.
3. Associez les colonnes. Une colonne dont le nom correspond à un champ de facture, à son numéro BT ou à son libellé reçoit une proposition. Chaque colonne qui contient des valeurs doit être associée ou ignorée.
4. Vérifiez les factures dans l’aperçu. Une facture avec des constats ne peut pas être importée : corrigez le fichier, choisissez le fichier corrigé et mettez l’aperçu à jour.
5. Confirmez la vérification et choisissez Ajouter les factures au lot.
6. Lisez le contrôle des coûts et lancez le traitement, comme pour des PDF.

## Types de fichiers

| Fichier | Structure |
| --- | --- |
| CSV | UTF-8 avec une ligne d’en-tête. Séparateur `,` `;` tabulation ou `|`, guillemets selon la RFC 4180. Une marque d’ordre des octets est admise. |
| Enregistrements JSON à plat | Un tableau d’objets dont les valeurs sont du texte ou des nombres. Chaque objet est une ligne, et ses clés sont les colonnes. |
| JSON canonique | Un tableau d’objets de facture structurés, ou `{"invoices": [...]}`. Il n’a pas besoin d’association de colonnes. |

## Comment les lignes deviennent des factures

- Une ligne CSV ou un enregistrement JSON à plat est une ligne de facture.
- Les lignes portant le même numéro de facture (BT-1) forment une facture. Elles doivent concorder sur les données de la facture, par exemple le nom de l’acheteur.
- Une facture en CSV ou en JSON à plat a une seule ventilation de TVA. Envoyez les factures avec plusieurs catégories ou taux de TVA en JSON canonique.

## Nombres et dates

| Valeur | Règle |
| --- | --- |
| Séparateur décimal | `.` ou `,`. Avec `,`, le `.` sépare les milliers. Les nombres JSON utilisent toujours `.`. |
| Format de date | `2026-11-13` (ISO) ou `13.11.2026` |
| Montants en CSV | Deux décimales au maximum |
| Quantités et prix | Dix décimales au maximum |
| Chaque nombre | 15 chiffres au maximum avant le séparateur décimal |
| Identifiants comme les codes postaux | Les zéros initiaux sont conservés |

## Quand une facture attend

Une facture a un constat, et l’import attend, lorsque :

- ses lignes divergent sur une donnée de la facture, par exemple deux noms d’acheteur ;
- un champ obligatoire est vide, ou une valeur ne peut pas être lue ;
- ses totaux ne concordent pas (règles EN 16931 BR-CO-10, BR-CO-13, BR-CO-14, BR-CO-15 et BR-CO-16) ;
- un montant de ligne (BT-131) s’écarte de plus d’un centime de quantité × prix unitaire ÷ quantité de base du prix, sur une ligne sans remise ni frais de ligne ;
- une catégorie de TVA autre que `O` n’a pas de taux (BT-119, BT-152) ;
- les données ne respectent pas le schéma canonique de facture.

## Fichiers que le service refuse

Le service refuse un fichier qu’il pourrait lire de plusieurs façons :

- des noms de colonnes vides ou répétés ;
- des lignes avec plus ou moins de cellules que l’en-tête ;
- des clés JSON répétées ;
- `NaN`, `Infinity` et les nombres avec exposant ;
- des valeurs imbriquées dans des enregistrements à plat, et des champs inconnus en JSON canonique.

## Limites

| Limite | Valeur |
| --- | --- |
| Taille du fichier | 2 Mo |
| Factures par fichier | 500 |
| Lignes | 10 000 |
| Colonnes | 100 |
| Profondeur JSON | 32 |

## Facturation

Chaque facture importée est convertie, validée, facturée et délivrée comme une facture PDF dans un traitement par lots : une conversion par facture délivrée, d’abord sur vos conversions incluses, puis sur les crédits API. Vous voyez le coût avant le lancement.

Rien n’est enregistré avant l’import. Si vous répétez un import inchangé, les mêmes factures sont réutilisées.

## Fichier d’exemple

L’exemple synthétique contient trois factures avec des données fictives. Il utilise des points-virgules, des virgules décimales et des dates comme 13.11.2026. La facture SYNTH-0002 a deux lignes.

- [Télécharger l’exemple CSV](/examples/structured-invoices.csv)

## Étapes suivantes

Le traitement par lots demande un abonnement Enterprise actif.

- [Lire le guide du traitement par lots](/developer-api/bulk-runs)
- [Démarrer Enterprise](/pricing)
- [Consulter la documentation de l’External API V1](/developer-api)
