---
title: "Installation"
weight: 10
description: "Installation and activation guide for the Accounting Assistant module."
source_hash: "302d7c81"
---

# Installation

## Download

Get the module archive from the Dolistore or the repository provided by the editor. The module comes as an `accountingassistant` folder.

## Copying the files

Copy the `accountingassistant` folder into the custom modules directory of your Dolibarr installation:

```
htdocs/custom/accountingassistant/
```

If the `custom` folder does not exist, create it. Check that the `MAIN_MODULE_MULTICOMPANY_TRANSVERSE_MODE` constant or the `$dolibarr_main_document_root_alt` variable in `conf.php` points to this directory.

## Activating the module

1. Log in to Dolibarr as an administrator
2. Go to **Home > Setup > Modules/Applications**
3. In the **Finance** category, look for **Accounting Assistant**
4. Click the activation button (toggle switch)

![Activation of the Accounting Assistant module in the Dolibarr module list](screenshots/activation-module.webp)

> **Warning:** The **Double-entry Accounting** module must be enabled first. If it is not, the Accounting Assistant module will not appear in the list.

## Assigning permissions

After activation, assign permissions to the relevant users. Go to **Home > Users & Groups**, select the user and open the **Permissions** tab.

The available permissions are organized by feature:

| Feature | Permission | Description |
|---------|------------|-------------|
| Reassignment | Read | View reassignment rules |
| Reassignment | Create/modify | Create and modify rules |
| Reassignment | Apply | Run the rules (modify entries) |
| Reassignment | Delete | Delete rules |
| Bernard | Use | Receive accounting code suggestions (applying them also requires the right to modify the product or service) |
| Bernard | Contribute | Share your assignments with the community |
| Bernard | Configure | Access the Bernard configuration |
| VAT allocation | Configure | Manage allocation rules by rate |
| VAT check | Audit | Run the VAT rate audit |
| VAT check | Correct | Correct the VAT rates of audited documents (also requires the right to modify the document) |
| CA3 report | View | Generate the CA3 preparatory report |
| VAT closure | Generate | Generate and delete VAT closure entries |
| Import reverse charge | View | See the invoices requiring reverse charge |
| Import reverse charge | Generate | Create the reverse charge entries |

## Verification

After activation, the **Accounting > Accounting Assistant** menu appears in the left sidebar. Click it to reach the module home page and check that the expected features are visible.

## Demo data

To discover the module without touching your data, install the demo dataset on a test instance: Boulangerie Dupont SARL, a fictitious company, with its customers and suppliers (France, European Union, outside the European Union), two months of invoices transferred to accounting, two bank accounts with their statements, and the module settings.

- The month before last is clean: the CA3 report and the VAT closure can be verified there.
- Last month contains deliberate errors that the module tools detect: inconsistent VAT rates, import invoices without reverse charge, products without a sales account for export, packaging booked to the wrong account, bank statement imported on the wrong account.

To install it:

1. Go to **Home > Setup > Modules/Applications**, then in the module configuration, **Demo** tab.
2. Tick the confirmation checkbox, then click **Generate demo data**.

The `accountingassistantdemo` account (password `demo1234`) is created with the module rights, and a guided tour accompanies its first arrival on the module home page. As long as the demo is installed, the Dolibarr home page leads to this page; the **Dolibarr Dashboard** button brings an administrator back to the usual home page.

The **Purge demo data** button removes the whole dataset and restores the original settings. Dates follow the current date: purge then generate again to refresh them.

> [!WARNING]
> Generation is refused on a production installation. It is only possible in advanced feature mode (level 2 or higher), with the `ACCOUNTINGASSISTANT_ALLOW_DEMO_DATA` constant set to 1, or on a demo instance.