====== Import OD Comptable ======

Cet utilitaire permet d'importer un fichier **Excel (.xlsx/.xls)** ou **CSV** contenant des lignes comptables (une exportation de paie, par exemple), de les faire correspondre au plan comptable officiel, puis de générer automatiquement une ou plusieurs **écritures multi-lignes de type OD (Opérations Diverses)**.

Accès : //Comptabilité > Utilitaire > Import OD Comptable//.

===== Vue d'ensemble du principe =====

  - On importe un fichier.
  - On indique à l'écran quelle colonne du fichier correspond à quel champ comptable (date, compte, libellé, débit, crédit...).
  - L'écran propose automatiquement, pour chaque ligne, un compte du plan officiel et signale les lignes en erreur.
  - On corrige si besoin directement dans le tableau.
  - On génère : une écriture est créée **par date distincte** présente dans le fichier (toutes les lignes d'une même date forment une seule écriture multi-lignes).

**⚠ Important :** la génération n'est pas réversible depuis cet écran : une fois les écritures postées en comptabilité, il faut passer par les écrans habituels de la comptabilité pour les corriger ou les supprimer.

===== 1. Importer un fichier =====

Cliquez sur **Importer un fichier Excel ou CSV** et choisissez votre fichier (extensions acceptées : ''.xlsx'', ''.xls'', ''.csv'').

Quelques points d'attention gérés automatiquement pour les fichiers CSV :

  * **Encodage** : les fichiers en UTF-8 (avec ou sans BOM) ou en Windows-1252 (l'encodage le plus courant des exports Windows/Excel en France) sont détectés et décodés automatiquement.
  * **Séparateur de colonnes** : point-virgule, virgule ou tabulation sont détectés automatiquement, y compris quand le fichier commence par une ligne de titre sans aucun séparateur (ex : ''Bulletin de paie - Juillet 2026'').
  * **Nombres décimaux** : la virgule et le point sont acceptés indifféremment comme séparateur décimal (''1234,56'' ou ''1234.56''), y compris avec un séparateur de milliers de l'autre type (''1.234,56'' ou ''1,234.56'').

Une fois le fichier lu, le popup **Mappage des colonnes** s'ouvre automatiquement.

===== 2. Le popup "Mappage des colonnes" =====

En haut du popup :

  * **Profil** : liste déroulante des profils de mappage déjà enregistrés (voir [[#profils_de_mappage|Profils de mappage]] ci-dessous). En choisir un remplit automatiquement tous les onglets.
  * **Enregistrer sous...** : sauvegarde la configuration actuelle (les 4 onglets) sous un nom de profil réutilisable.
  * Une icône poubelle apparaît à côté du sélecteur de profil pour supprimer le profil actuellement chargé.

Le popup comporte ensuite **4 onglets** :

==== Onglet "Commentaire" ====

Une zone de texte enrichi (mise en forme possible : gras, listes, etc.) pour noter le contexte du profil (par exemple : "Export de paie mensuelle du logiciel X, colonnes toujours dans cet ordre").

Ce que vous tapez y est enregistré automatiquement **dans le profil actuellement chargé**, au fil de la frappe. Si aucun profil n'est chargé, un avertissement s'affiche : la note reste alors locale à cet import et sera perdue à la fermeture, sauf si vous l'enregistrez ensuite via **Enregistrer sous...**.

==== Onglet "Colonnes" ====

  - **Numéro de la ligne d'en-têtes** : certains exports commencent par une ou deux lignes de titre/période avant la vraie ligne des intitulés de colonnes. L'écran essaie de la deviner automatiquement (première ligne contenant au moins 3 cellules non vides), mais vous pouvez la corriger ici. Un aperçu des premières lignes du fichier s'affiche juste en dessous, avec la ligne actuellement retenue comme en-têtes surlignée en bleu.
  - **Format des dates** : Français (JJ/MM/AAAA, par défaut) ou Américain (MM/JJ/AAAA), pour les dates saisies en texte dans le fichier (une vraie cellule Excel de type date n'est pas concernée par ce choix).
  - **Mappage des champs** : pour chaque champ ci-dessous, choisissez la colonne du fichier qui lui correspond. L'écran essaie de deviner chaque correspondance à partir de l'intitulé de la colonne (accents, espaces et casse ignorés) :

^ Champ ^ Obligatoire ^ Remarque ^
| Date | Non | Voir [[#date_facultative|Date facultative]] ci-dessous. |
| N° de compte | **Oui** | |
| Libellé | **Oui** | |
| Sous-titre | Non | Si renseigné, le libellé final devient "titre : sous-titre" (voir plus bas). |
| N° de pièce | Non | |
| Débit | Au moins un des deux | |
| Crédit | Au moins un des deux | |

=== Colonne "Sous-titre" ===

Certains exports (la paie, typiquement) comportent deux colonnes de libellé distinctes, par exemple "Libellé compte" et "Libellé ligne". La détection automatique affecte la première au champ **Libellé**, et reconnaît la seconde comme **Sous-titre** si son intitulé contient "libellé" (ou une variante : "complément", "sous-titre"...).

Si une colonne Sous-titre est mappée et qu'une ligne a une valeur dans cette colonne, le libellé final de la ligne devient :
<code>
Titre : Sous-titre
</code>
Sinon, seul le titre est conservé.

=== Date facultative ===

La colonne Date n'est **pas obligatoire**. Trois cas possibles après validation du mappage :

  * Toutes les lignes ont une date exploitable → import normal.
  * **Aucune** ligne n'a de date exploitable (colonne non mappée, ou mappée mais vide sur toutes les lignes) → un popup **"Date de l'import"** s'ouvre et demande une date unique, appliquée à l'ensemble des lignes importées.
  * **Certaines** lignes ont une date et d'autres non → les lignes sans date sont marquées en erreur ("Date illisible"), les autres sont traitées normalement.

==== Onglet "Comptes" ====

**💡 Astuce :** cet onglet est en **lecture/suppression seule** : on ne peut pas y ajouter une correspondance manuellement. Une correspondance s'ajoute (ou se met à jour) automatiquement uniquement quand vous changez le compte proposé d'une ligne **directement dans le tableau** (voir [[#corriger_un_compte_dans_le_tableau|plus bas]]).

La liste affiche toutes les correspondances "compte demandé → compte retenu" actuellement connues, avec un bouton poubelle pour oublier une correspondance individuellement.

==== Onglet "Équilibrage" ====

Une écriture générée doit être équilibrée (total débit = total crédit) pour chaque date. Si votre fichier source ne l'est naturellement pas (cas d'un export qui ne contient qu'un seul sens, par exemple), cochez **"Ajouter une ligne d'équilibrage automatique à chaque écriture générée"** et renseignez :

  * le **compte d'équilibrage** (ex : un compte d'attente),
  * un **libellé** (par défaut : "Équilibrage" si laissé vide).

À la génération, chaque écriture (une par date) reçoit automatiquement une ligne supplémentaire sur ce compte, du côté et du montant nécessaires pour combler l'écart de **cette écriture précise**. Le bouton "Générer en comptabilité" n'est alors plus bloqué par un déséquilibre, et le bilan (voir plus bas) affiche "⚖ équilibré automatiquement" au lieu de "✗ Déséquilibré".

===== 3. Profils de mappage =====

Un **profil** enregistre en une seule fois :

  * le mappage des colonnes et le format de date,
  * les correspondances de compte apprises,
  * le paramétrage de la ligne d'équilibrage,
  * la note de l'onglet Commentaire.

C'est le moyen de ne pas avoir à refaire tout le paramétrage à chaque import d'un même type de fichier récurrent (l'export de paie mensuel, par exemple).

  * **Enregistrer sous...** : donnez un nom au profil (un nom déjà utilisé écrase le profil existant).
  * Si un profil était déjà chargé lors d'un **nouvel import** dans la même session, il se **réapplique automatiquement** (pas besoin de le resélectionner dans la liste).
  * Les profils sont propres à chaque utilisateur (ils ne sont pas partagés entre collègues).

===== 4. Le tableau des lignes importées =====

Après validation du mappage, le tableau s'affiche avec les colonnes suivantes :

^ Colonne ^ Modifiable ^ Description ^
| ID | Non | Numéro de ligne interne. |
| Date | Non | Date de l'écriture (ou la date globale si le fichier n'en fournissait pas). |
| Compte demandé | Non | Le numéro de compte **tel qu'il apparaît dans le fichier**, jamais modifié. |
| Compte proposé | **Oui** | Le compte du plan officiel retenu pour l'écriture. Cliquez dans la cellule pour choisir un autre compte dans une liste déroulante (recherche possible). |
| Libellé | Non | |
| N° pièce | Non | |
| Débit / Crédit | Non | Les montants négatifs sont acceptés et basculés automatiquement du bon côté à la génération. |
| Erreurs | Non | Détail de la ou des erreurs de la ligne, le cas échéant. |
| (icône poubelle) | — | Supprime définitivement la ligne de l'import (contrairement au compte "Ne pas tenir compte", voir plus bas). |

==== Couleurs des lignes ====

^ Couleur ^ Signification ^
| Blanc (normal) | Ligne correcte, sans particularité. |
| **Rouge** | Ligne en erreur : compte non trouvé dans le plan officiel, date illisible, ou date hors de l'exercice comptable. Voir le détail dans la colonne Erreurs. |
| **Gris** | Ligne volontairement exclue via le compte fictif "Ne pas tenir compte" (voir plus bas). |
| **Bleu** | Le compte proposé vient d'une correspondance apprise automatiquement (profil ou correction précédente), pas d'une détection habituelle : ligne à vérifier avant génération. |

==== Corriger un compte dans le tableau ====

Cliquez directement dans la cellule **Compte proposé** d'une ligne pour ouvrir une liste déroulante de recherche. Les comptes dont le préfixe correspond au compte demandé apparaissent en premier.

Cette correction a deux effets automatiques :

  - Elle s'applique à **toutes les lignes du tableau** qui ont le même compte demandé (pas seulement la ligne éditée) — ces autres lignes passent en bleu (correction automatique à vérifier), la ligne que vous avez éditée directement reste en blanc.
  - Elle est mémorisée comme **règle de bascule** ("compte demandé X → compte retenu Y"), visible et supprimable dans l'onglet Comptes du popup de mappage, et réappliquée automatiquement lors d'un prochain import similaire (si un profil est chargé, la règle y est enregistrée immédiatement, sans besoin de recliquer sur "Enregistrer sous...").

==== Le compte fictif "99999 : Ne pas tenir compte" ====

En tête de la liste déroulante des comptes se trouve toujours un compte fictif **99999 : Ne pas tenir compte**. L'affecter à une ligne permet de l'**exclure du bilan et de la génération** (ni comptée dans les totaux débit/crédit, ni envoyée à la comptabilité), tout en la gardant visible dans le tableau (en gris) pour référence — contrairement à la suppression pure et simple de la ligne (bouton poubelle), qui la fait disparaître définitivement de l'import.

===== 5. Le bilan "Écritures à générer" =====

Sous le tableau, une ligne de bilan est affichée **par date distincte** présente dans les lignes importées, indiquant :

  * le nombre de lignes de cette date,
  * le total débit et le total crédit,
  * l'état : **✓ Équilibré**, **✗ Déséquilibré** (avec l'écart), ou **⚖ équilibré automatiquement** si la ligne d'équilibrage est active.

Chaque date génèrera **une écriture multi-lignes distincte** : une écriture ne peut porter qu'une seule date, c'est pourquoi le regroupement se fait ainsi.

===== 6. Générer en comptabilité =====

Le bouton **Générer en comptabilité (N écriture(s) OD "libellé")** n'est actif que si :

  * il y a au moins une ligne importée,
  * aucune ligne n'est en erreur,
  * chaque date est équilibrée (nativement, ou grâce à la ligne d'équilibrage).

Le libellé de génération repris pour chaque écriture est le nom du fichier importé (sans son extension).

Un clic déclenche une demande de confirmation, puis génère et envoie en une seule fois au serveur toutes les écritures (une par date). En cas de succès, l'écran se réinitialise entièrement, prêt pour un nouvel import. En cas d'échec, un message d'erreur détaillé s'affiche et rien n'est modifié : vous pouvez corriger et relancer.

===== 7. Recommencer =====

Le bouton **Recommencer** (visible dès qu'un fichier est chargé) efface l'import en cours (tableau, fichier, règles de bascule de la session) pour repartir de zéro, sans toucher aux profils enregistrés.

===== Questions fréquentes =====

**Pourquoi ma ligne n'apparaît dans aucune écriture générée alors qu'elle est visible dans le tableau ?**
Vérifiez que son compte proposé n'est pas "99999 : Ne pas tenir compte" (ligne grise), qui l'exclut volontairement de la génération.

**Pourquoi le bouton "Générer en comptabilité" reste grisé ?**
Il y a soit au moins une ligne en erreur (en rouge), soit au moins une date déséquilibrée sans ligne d'équilibrage active. Le message sous le bouton précise la raison.

**Ma correction de compte n'a pas été reprise au prochain import du même type de fichier.**
Vérifiez qu'un profil était bien sélectionné au moment de la correction (les corrections faites sans profil chargé restent locales à la session en cours), et que ce même profil est bien rechargé (automatiquement s'il était déjà actif, ou manuellement via le sélecteur "Profil").