[IMP] account_import_helper: re-write module

Full re-write of the module account_import_helper: it should now be used
directly in the production DB and handles the deletion of existing
accounts.
Add in account_import_helper the wizard of the module
account_ir_property_helper.

Author: alexis-via

account_import_helper/README.rst

@@ -2,51 +2,37 @@
 Account Import Helper
 =====================
 
-This module provides methods to help on the import of accounting-related data, in particular the chart of accounts.
+This module is designed to replace the standard chart of account of Odoo by the chart of accounts of the company before go-live.
 
-First, in a standard test Odoo database with the chart of account of the official addons, use the wizard available via the menu *Configuration > Technical > Chart Generate > Chart Generate* to generate the file *account.account.csv*.
+This module has been fully re-written on december 30th 2025 ; if you were used to the old procedure, please read carefully the new procedure below.
 
-Then, in the future production database, after the installation of the official addons that has the chart of accounts for the country:
+In the production database, install this module **account_import_helper** before go-live. As you are before go-live, there should be no journal items in the database.
 
-* Unconfigure the links to the accounts from several objects and ir.properties:
+In developer mode, go to the menu **Settings > Technical > Tools for Chart of Accounts > Import Chart of Accounts** : it will start a wizard to import a custom chart of account from an XLSX file. The XLSX file should contain 2 columns with an optional third column:
 
-.. code::
+- column A: the account code (required)
+- column B: the label of the account (required)
+- column C: some notes related to the account (optional)
 
-  UPDATE account_journal SET default_account_id=null, suspense_account_id=null WHERE company_id=X;
+When you run the import, Odoo will use the account code and label (and notes) from the XLSX file and the fields *Type*, *Allow Reconciliation* and *Non Trade* from the standard Odoo chart of accounts (you can choose between using the chart of account of the module *l10n_fr_account* or the OCA module *l10n_fr_account_oca*).
 
-  UPDATE FROM pos_payment_method SET outstanding_account_id=null, receivable_account_id=null WHERE company_id=X;
+If you select several companies in the *Companies* field of the wizard, Odoo will import the chart of accounts as shared accounts between those companies (new feature of Odoo 18).
 
-  UPDATE ir_default SET json_value = false FROM ir_model_fields f WHERE f.id = ir_default.field_id AND f.relation = 'account.account' AND ir_default.company_id = X
+Once the chart of account has been imported, check that the imported accounts are ok. Check that you have one and only one account with type *Current Year Earnings*.
 
-  DELETE FROM account_fiscal_position_account WHERE company_id=X;
+Go to the menu **Settings > Technical > Tools for Chart of Accounts > Re-configure after Chart of Account Import**: it starts a wizard that make it easy to re-configure the default accounts for partners and product categories, and also the suspense account for bank/cash journals and the transfer account of the company.
 
-* Delete all accounts:
-
-.. code::
-
-  DELETE FROM account_account_res_company_rel WHERE res_company_id=X
-
-  DELETE FROM account_account WHERE id in (SELECT a.id FROM account_account a LEFT JOIN account_account_res_company_rel rel ON rel.account_account_id = a.id WHERE rel.account_account_id IS NULL)
-
-* In the menu *Invoicing > Configuration > Accounting > Chart of accounts*, import the file *account.account.csv* with *Encoding* set to **utf-8** and *Use first row as header* enabled.
+Eventually:
 
 * In the menu *Invoicing > Configuration > Accounting > Taxes*, reconfigure the account on taxes.
 
 * In the menu *Invoicing > Configuration > Accounting > Fiscal Positions*, on each fiscal position, configure the account mapping.
 
 * In the menu *Invoicing > Configuration > Accounting > Journals*, on each journal, configure all the fields that point to accounts.
 
-* On the page *Invoicing > Configuration > Settings*, update the section *Default Accounts*
-
-* In the menu *Settings > Technical > Actions > User-defined Defaults*, edit the default having a 0 value including : 
-
-  - Account Receivable
-  - Account Payable
-  - Expense Account
-  - Income Account
-
-and set the field *Default Value (JSON format)* with **67** where 67 is the ID of the account you want to have as default for that property.
+* On the page *Invoicing > Configuration > Settings*, update the section *Default Accounts*.
 
+Once you have finished, you can uninstall the module **account_import_helper**.
 
 Contributors
 ============

account_import_helper/__init__.py

@@ -1,2 +1 @@
-from . import models
-from . import wizard
+from . import wizards

account_import_helper/__manifest__.py

@@ -14,7 +14,8 @@
     "external_dependencies": {"python": ["openpyxl"]},
     "data": [
         "security/ir.model.access.csv",
-        "wizard/account_chart_generate_view.xml",
+        "wizards/account_chart_import_view.xml",
+        "wizards/account_chart_import_postprocess_view.xml",
     ],
     "installable": True,
 }

account_import_helper/models/__init__.py

@@ -1,2 +1,3 @@
 id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
-access_account_chart_generate_system,Full access on account.chart.generate,model_account_chart_generate,base.group_system,1,1,1,1
+access_account_chart_import_system,Full access on account.chart.import,model_account_chart_import,base.group_system,1,1,1,1
+access_account_chart_import_postprocess_system,Full access on account.chart.import.postprocess,model_account_chart_import_postprocess,base.group_system,1,1,1,1