Structure du fichier d'import des écritures
Cet article décrit la structure du fichier à utiliser pour importer des écritures comptables. Pour la procédure, consultez Importer des écritures comptables. Pour comprendre les règles de traitement, consultez Règles et comportements de l'import des écritures.
Règles générales
- Le fichier doit être au format .xlsx ou .csv.
- Pour les fichiers CSV, utiliser le séparateur point-virgule (;).
- L'ordre des colonnes doit être strictement respecté.
- Les colonnes attendues doivent être présentes, même si certaines valeurs sont vides.
- Pour les fichiers Excel (.xlsx), seule la première feuille est utilisée lors de l’import.
Structure des colonnes
Les colonnes doivent être respectées dans l’ordre suivant:
- Colonne 1 - Date: date de l'écriture (jj.mm.aaaa)
- Colonne 2 - Numéro de pièce: numéro de pièce
- Colonne 3 - Libellé: description de l'écriture
- Colonne 4 - Compte débit: compte débité
- Colonne 5 - Compte crédit: compte crédité
- Colonne 6 - Montant: montant
- Colonne 7 - Journal: code journal (facultatif)
Codes admis: - d: Divers
- s: Salaires
- a: Achats
- v: Ventes
- i: Inventaires
- m: Amortissements
- o: Soldes initiaux
- b: Bouclement
- x: À extourner (transitoires)
- Colonne 8 - Cours de change: cours de change
- Colonne 9 - Montant en devise: montant en monnaie étrangère
- Colonne 10 - Taux de TVA: taux de TVA
- Colonne 11 - Montant TVA: montant de TVA
- Colonne 12 - Compte TVA: d (débit) ou c (crédit)
- Colonne 13 - Type de TVA: type (1 à 4)
- Colonne 14 - Méthode TVA: 1=brut, 2=net
- Colonne 15 - Part soumise TVA: part soumise à la TVA (%)
- Colonne 16 - Code devise: non utilisé lors de l'import
- Colonne 17 - Quantité devise: quantité en monnaie étrangère (0 si non utilisée)
- Colonne 18 - Commentaire: non utilisé lors de l'import
- Colonne 19 - Compte analytique: non disponible actuellement
- Colonne 20 - Code TVA: permet de forcer l’application d’un code ou d’un chiffre TVA spécifique (ex. <vt_code=xxx> ou <vt_number=xxx>)
Structure minimale attendue
Selon le type d’écritures à importer, toutes les colonnes ne sont pas nécessaires.
- Écritures simples : utiliser les colonnes 1 à 6 ou 1 à 7.
- Écritures avec monnaie étrangère : utiliser les colonnes 1 à 9.
- Écritures avec TVA : utiliser les colonnes 1 à 20.
Monnaie étrangère
La devise est déterminée automatiquement à partir des comptes utilisés dans l’écriture. Les colonnes 8 et 9 doivent être renseignées pour les écritures en monnaie étrangère.
Points d’attention
- L'ordre des colonnes est déterminant : un décalage entraîne des erreurs d'import.
- Les colonnes requises doivent être présentes même si elles sont vides.
- L'import ne détecte pas les doublons.
Exemples de fichier CSV
Exemple - Ecriture sans TVA
Date;Numéro de pièce;Libellé;Compte débit;Compte crédit;Montant;Journal
13.04.2026;1001;Facture fournisseur;4000;2000;1500;a
Exemple - Cas courants (TVA, devise étrangère, code TVA)
Date;Numéro de pièce;Libellé;Compte débit;Compte crédit;Montant;Journal;Cours de change;Montant en devise;Taux de TVA;Montant TVA;Compte TVA;Type de TVA;Méthode TVA;Part soumise TVA;Code devise;Quantité devise;Commentaire;Compte analytique;Code TVA
13.04.2026;C-001;Écriture sans TVA;2000;1000;100;a;;;;;;;;;;;;;
14.04.2026;B1-001;Achats avec TVA;4000;1020;205.2;a;;;2.6;5.2;d;;;;;;;;
15.04.2026;B1-002;Ventes avec TVA;1020;3200;2162;v;;;8.1;162;c;;;;;;;;
16.04.2026;B2-002;Vente en devise avec code TVA;1040;3600;95;v;0.95;100;;;c;;;;;;;;<vt_number=220>
17.04.2026;Bouclement-01;Charges sociales à extourner;5700;2300;5000;x;;;;;;;;;;;;;
La ligne du 15.04.2026 illustre une écriture TVA. Le taux TVA (colonne 10), le montant TVA (colonne 11) et le compte TVA (colonne 12) sont suffisants.
La ligne du 16.04.2026 illustre l’utilisation d’un chiffre TVA forcé (<vt_number=220>) avec une écriture en monnaie étrangère.
La ligne du 17.04.2026 illustre l’utilisation du journal "x" pour les écritures à extourner.