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.

1. Écritures simples : utiliser les colonnes 1 à 6 ou 1 à 7.
2. Écritures avec monnaie étrangère : utiliser les colonnes 1 à 9.
3. É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.

• Related Articles

• Règles et comportements de l’import des écritures

  Cet article décrit les règles de fonctionnement de l'import. Pour la procédure, consultez Importer des écritures comptables. Pour la structure du fichier, consultez Structure du fichier d'import des écritures. Règles générales Création automatique ...

• Importer des écritures comptables

  Cheel permet d'importer des écritures comptables à partir d'un fichier Excel (.xlsx) ou CSV (.csv), dans le cadre d'une migration ou d'une intégration depuis un outil tiers. Pour préparer votre fichier, consultez Structure du fichier d'import des ...

• Créer des écritures multiples

  Une écriture multiple permet de répartir une opération comptable depuis un compte spécifique vers plusieurs autres comptes: Créer une écriture multiple Accédez à la page des écritures comptables: menu Comptabilité, Comptabilité financière, Ecritures. ...

• Créer des écritures simples

  Une écriture simple en comptabilité est une opération qui n’implique que deux comptes. Créer une écriture simple Accédez à la page des écritures comptables: Menu Comptabilité, Comptabilité financière, Ecritures. Pour créer une nouvelle écriture ...

• Ecritures 100% TVA (TVA pure)

  Une écriture 100% TVA ou TVA pure désigne une écriture comptable où la totalité du montant est liée à la TVA. Paramétrer un Chiffre et taux TVA à 100% (TVA pure) Ouvrez le Chiffre TVA concerné: menu Comptabilité, TVA, Chiffres et taux de TVA. Pour ...

• Recent Articles

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

• Règles et comportements de l’import des écritures

  Cet article décrit les règles de fonctionnement de l'import. Pour la procédure, consultez Importer des écritures comptables. Pour la structure du fichier, consultez Structure du fichier d'import des écritures. Règles générales Création automatique ...

• Importer des écritures comptables

  Cheel permet d'importer des écritures comptables à partir d'un fichier Excel (.xlsx) ou CSV (.csv), dans le cadre d'une migration ou d'une intégration depuis un outil tiers. Pour préparer votre fichier, consultez Structure du fichier d'import des ...

• Copier des éléments de configuration d'un salarié vers d'autres salariés

  La duplication de configuration permet d’uniformiser rapidement les paramètres de salaire entre collaborateurs. Vous pouvez copier en une seule opération les assurances, éléments de salaire, comptabilisation et certificat de salaire d’un salarié de ...

• Restaurer une base de données locale

  Procédure de restauration d’une base de données locale La restauration d’une base de données locale s’effectue au moyen de l’outil d’administration correspondant à votre moteur de base de données : SQL Server, PostgreSQL, MariaDB ou MySQL. Étapes à ...