Migration vers Odoo — extension comptable

Guide utilisateur — Migration vers Odoo (extension comptable, lot L3)

Ce module ajoute la comptabilité à migration_base : dépose un FEC, cochez « Écritures » (ou « Factures clients »/« Factures fournisseurs »/« Comptes auxiliaires »), et l'assistant écrit réellement dans account.move.

0. Le droit qu'il faut pour écrire des écritures

Une exécution réelle qui écrit des écritures ou des factures demande le groupe « Migration : Administrateur » (migration_base.group_migration_ manager) — un opérateur seul (« Migration : Opérateur ») peut préparer un job et lancer une simulation (mode essai), mais pas écrire pour de vrai. Ce module ajoute automatiquement, à son installation, le droit comptable nécessaire (« Facturation », account.group_account_invoice — crée et valide account.move) aux implied_ids du groupe « Migration : Administrateur » : rien à faire à la main si ce groupe est déjà attribué. Sans lui, le clic sur « Lancer » (essai compris) est bloqué avant tout traitement, avec un message qui nomme le modèle et le groupe à demander.

1. Avant de lancer : la table de correspondance des journaux

Le FEC porte un JournalCode (« VE », « AC »...) propre au logiciel source ; Odoo a ses propres journaux (account.journal). La première écriture qui cite un code encore inconnu crée automatiquement une ligne dans l'onglet Correspondance des journaux du job — avec le journal deviné si un code ou un libellé correspond, laissée vide sinon. Tant qu'elle est vide, chaque écriture qui cite ce code est rejetée (motif « journal introuvable »), pas attachée au hasard au premier journal venu : complétez la ligne, puis relancez le job — les écritures déjà migrées ne sont pas doublées, les rejetées sont rejouées.

2. Les comptes absents du plan comptable

Par défaut, un CompteNum du FEC qui ne correspond à aucun compte Odoo fait rejeter l'écriture entière (motif « compte introuvable ») — jamais une écriture tronquée à ses lignes valides. Si vous préférez que ces comptes soient créés au fil de l'eau, cochez Créer les comptes absents du plan comptable et choisissez un type de compte par défaut : obligatoire dès que la case est cochée, le module ne devine jamais un type.

3. Les comptes auxiliaires (tiers)

Le FEC porte parfois CompAuxNum/CompAuxLib sur certaines lignes (les comptes de tiers, en général). Cochez Comptes auxiliaires (FEC) dans le périmètre et déposez le même fichier sur ce checkpoint : chaque tiers cité est créé une seule fois, même s'il apparaît sur cent lignes. Migrez-les avant les écritures qui les citent : une écriture dont le tiers auxiliaire n'a pas encore été trouvé dans le registre est rejetée avec un motif qui dit quoi faire.

4. Factures clients / fournisseurs

Mêmes réglages que les écritures, avec move_type forcé sur out_invoice/in_invoice. Le journal résolu doit être compatible (un journal de vente pour une facture client) : sinon, c'est Odoo lui-même qui la refuse, avec le motif « refus_odoo » et son message d'origine.

5. Brouillon, puis validation optionnelle

Les écritures créées restent à l'état brouillon — jamais validées d'office. Pour les comptabiliser, cochez Valider les écritures à l'étape 6 avant de passer l'étape « Rapprochement » de l'assistant (ou utilisez le bouton dédié sur la fiche du job). Une écriture qui échoue à la validation (contrainte Odoo) est signalée dans le fil de discussion du job, les autres sont validées quand même — un échec n'en bloque pas d'autres.

6. Le rapprochement, étape 6

Comparaison, compte par compte et journal par journal, entre les soldes du FEC déposé et les soldes réellement écrits dans Odoo. Seuls les écarts sont listés : un compte parfaitement rapproché n'apparaît pas dans le tableau — « pas de nouvelle, bonne nouvelle ». Chaque écart a aussi sa ligne de rapport (migration.issue, motif « écart de rapprochement ») et peut être exporté en CSV.

7. Le lettrage du FEC

EcritureLet/DateLet sont conservés tels quels sur chaque ligne d'écriture migrée (migration_lettrage_source/migration_date_lettrage_source) — ils ne sont pas traduits automatiquement dans le lettrage natif d'Odoo (full_reconcile_id), qui suppose de retrouver et coupler les lignes lettrées ensemble : hors périmètre de ce lot, un rapprochement ultérieur (à la main, ou dans une extension premium) s'appuie sur ces deux champs.

8. Ce que ce module ne fait pas

Aucun historique multi-exercices automatisé, aucun lettrage automatique, aucun rapprochement bancaire Aucune API : ce module lit un FEC déposé à la main, comme le reste du socle.