Belgium¶

Configuration¶

Install the 🇧🇪 Belgium fiscal localization package to get all the default accounting features of the Belgian localization, following the IFRS rules.

Chart of accounts¶

You can reach the Chart of accounts by going to Accounting ‣ Configuration ‣ Accounting: Chart of Accounts.

The Belgian chart of accounts includes pre-configured accounts as described in the PCMN. To add a new account, click New. A new line appears. Fill it in, click Save, and then Setup to configure it further.

See also

Chart of accounts

Taxes¶

Default Belgian taxes are created automatically when the Belgium - Accounting and the Belgium - Accounting Reports modules are installed. Each tax impacts the Belgian Tax Report, available by going to Accounting ‣ Reporting ‣ Statements Reports: Tax Report.

In Belgium, the standard VAT rate is 21%, but there are lower rates for some categories of goods and services. An intermediate rate of 12% is applied on social housing and food served in restaurants, while a reduced rate of 6% applies to most basic goods, such as food, water supply, books, and medicine. A 0% rate applies to some exceptional goods and services, such as some daily and weekly publications, as well as recycled goods.

Non-deductible taxes¶

In Belgium, some taxes are not fully deductible, such as taxes on the maintenance of cars. This means a part of these taxes is considered as an expense.

In Odoo, you can configure non-deductible taxes by creating tax rules for these taxes and linking them to the corresponding accounts. This way, the system automatically calculates the taxes and allocates them to the appropriate accounts.

To configure a new non-deductible tax, go to Accounting ‣ Configuration ‣ Accounting: Taxes, and click New:

Add a line and select Base in the Based On column;
Add a line, then select on tax in the Based on column and enter the non-deductible percentage in the % column;
On the of tax line, select the Tax Grid(s) related to your tax;
Add a line with the deductible percentage in the % column;
Set of tax in Based On;
Select 411000 VAT recoverable as account, and select the related tax grid.

Once you have created a non-deductible tax, you can apply it to your transactions by selecting the appropriate tax during the encoding of bills and credit notes. The system automatically calculates the tax amount and allocates it to the corresponding accounts based on the tax rules configured.

Example

With the Belgian localization, the 21% car tax is created by default (50% non-deductible).

See also

Reports¶

Here is the list of Belgian-specific reports available:

Balance sheet;
Profit & loss;
Tax report;
Partner VAT Listing;
EC Sales List;
Intrastat.

You can access Belgian-specific versions of reports by clicking on the book icon when on a report and selecting its Belgian version: (BE).

See also

Reporting

Disallowed expenses report¶

Disallowed expenses are expenses that can be deducted from your accounting result but not from your fiscal result.

The disallowed expenses report is available by going to Accounting ‣ Reporting ‣ Management: Disallowed Expenses. It allows financial results in real-time, and periodic changes. This report is generated based on the disallowed expenses categories that you can reach by going to Accounting ‣ Configuration ‣ Management: Disallowed Expenses Categories. Some categories already exist by default but do not have any rates. Click on Set Rates to update a specific category.

Tip

You can add multiple rates for various dates. In that case, the rate used to calculate the expense depends on the date at which it is calculated, and the rate set for that date.
If you have the Fleet app installed, tick the Car Category box when applicable. This makes the vehicle mandatory while booking a vendor bill.

To link a disallowed expenses category with a specific account, go to Accounting ‣ Configuration ‣ Acounting: Chart of Accounts. Find the account you want, and click on Setup. Add the Disallowed Expense category in the Disallowed Expenses field. From now, when an expense is created with this account, the disallowed expense is calculated based on the rate mentioned in the Disallowed Expense category.

Let’s take an example reflecting restaurant and car expenses.

Restaurant expenses¶

In Belgium, 31% of restaurant expenses are non-deductible. Create a new disallowed expenses category and set both Related Account(s) and Current Rate.

Car expenses: vehicle split¶

In Belgium, the deductible percentage varies from car to car and, therefore, should be indicated for each vehicle. To do so, open Fleet and select a vehicle. In the Tax info tab, go to the Disallowed Expenses Rate section and click on Add a line. Add a Start Date and a %. The amounts go in the same account for all car expenses.

When you create a bill for car expenses, you can link each expense to a specific car by filling the Vehicle column, so the right percentage is applied.

The vehicle split option available in the disallowed expenses report allows you to see the rate and disallowed amount for each car.

Fee form 281.50 and form 325¶

Fee form 281.50¶

Annually, a 281.50 fee form must be reported to the fiscal authorities. To do so, the tag 281.50 must be added on the contact form of the entities concerned by the 281.50 fee. To add the tag, open Contacts, select the person or company you want to create a 281.50 fee form for, and add the 281.50 tag in the Tags field.

Note

Make sure the street, zip code, country, and VAT number are also informed on the Contact form.

Then, depending on the nature of the expense, add the corresponding 281.50 tag on the impact accounts. To do so, go to Accounting ‣ Configuration ‣ Accounting: Chart of Accounts, and click on Setup to add the corresponding 281.50 tag on the impacted accounts, i.e., 281.50 - Commissions, depending on the nature of the expense.

Form 325¶

You can create a 325 form by going to Accounting ‣ Reporting ‣ Belgium: Create 325 form. A new page pops up: select the right options and click Generate 325 form. To open an already generated 325 form, go to Accounting ‣ Reporting ‣ Belgium: Open 325 forms.

CODA and SODA statements¶

CODA¶

CODA is an electronic XML format used to import Belgian bank statements. You can download CODA files from your bank and import them directly into Odoo by clicking Import Statement from your Bank journal on your dashboard.

See also

Import bank statements files

SODA¶

SODA is an electronic XML format used to import accounting entries related to salaries. SODA files can be imported into the journal you use to record salaries by going to your Accounting dashboard and clicking Upload in the related journal card form.

Once your SODA files are imported, the entries are created automatically in your ‘salary’ journal.

CodaBox¶

CodaBox is a service that allows Belgian accounting firms accessing their clients’ bank information and statements. Odoo provides a way to import such statements automatically.

Note

As an accounting firm, you must manage your clients on separate databases and configure them individually to avoid mixing up their data.

Configuration¶

The configuration must be done on each client database. In the following instructions, we will refer to your client’s company as Company and to your accounting firm as Accounting Firm.

You must first Install CodaBox and CodaBox Bridge to start.

Important

Make sure the company settings are correctly configured, i.e., the country is set to Belgium, the Tax ID and Accounting Firm fields are filled, as well as the Tax ID of the accounting firm (unless it is the same as the company’s Tax ID).

Configure the Journals¶

Create a new bank journal.
Set the right IBAN in the Account Number field.
Select CodaBox synchronisation as the Bank Feed.

Configure the Connection¶

First, you must select which users can access the CodaBox connection settings. To do so, go to Settings ‣ Users & Companies ‣ Groups, and search for the group Allow to show and modify the CodaBox Connection Settings. Add the users you want to this group. By default, only the Administrator is part of this group.

Then, to configure the connection itself, go to Accounting ‣ Configuration ‣ Accounting: CodaBox.

The procedure differs depending on whether CodaBox is being setup for a first client or an additional one.

Click on Connect, where you are redirected to the CodaBox platform, here validate the connection.
Once redirected back to Odoo, the Status should be set to Connected and a new field Access Token should appear.

Note

This Access Token will be used to create new connections for other clients without having to validate the connection again.

Synchronisation¶

Once the connection is established, Odoo can be synchronized with CodaBox.

CODA files are automatically imported from CodaBox every 12 hours. You do not have to do anything. However, if you wish, it can also be done manually, by clicking on Fetch CODA’s in the Accounting Dashboard.

Note

The connection between Odoo and CodaBox can be revoked by using the Revoke button in the CodaBox settings, which will revoke the link on Odoo’s side only.

If you have multiple connections, you will still be able to use the Access Token of one of them to easily reconnect Odoo and CodaBox for another client.

However, if you have only one (remaining) connection, you will not be able to use its Access Token to create new connections. In that case, you will have to revoke the connection from the CodaBox platform too, and then recreate a new one following the steps in the first connection section.

Potential issues¶

CodaBox is not configured. Please check your configuration.

Either the Company VAT of the Accounting Firm VAT is not set.

It seems that the fiduciary VAT number you provided is not valid. Please check your configuration.

Either the Company VAT of the Accounting Firm VAT is in the wrong format.

It seems that the fiduciary VAT number you provided does not exist in CodaBox. Please check your configuration.

The Accounting Firm VAT number you provided is not registered in CodaBox.

Error while connecting to the IAP server. Please contact Odoo support.

It seems that Odoo’s IAP server is down or unreachable. Please contact Odoo support.

It seems that your CodaBox connection is not valid anymore. Please check your configuration.

It seems that you have either revoked the access of Odoo to your CodaBox account, or that you have not completed the configuration process. In this case, you must click on the Revoke connection button in the settings, and follow again the steps in the first connection section.

A previous CodaBox registration already exists. Paste the access token from a previous connection here. Odoo will generate a new one, exclusive to this database.

It seems that you have already your Accounting Firm with Odoo, but that the Access Token is either not filled or wrong. You should follow the steps in the following connection tab section.

If you have lost your Access Token, you have to go on the CodaBox platform, and revoke the access of Odoo to your CodaBox account. Then, you will have to follow the steps in the first connection section.

The provided access token is not valid for this fiduciary. Please check your configuration. If you have lost your access token, please contact Odoo support.

Same as above.

It seems that no connection linked to your database/VAT number exists. Please check your configuration.

You may obtain this error when revoking or trying to fetch files from CodaBox if the pair (Accounting Firm VAT, Company VAT) is not registered yet. This may happen if you have changed the company VAT after the connection was established for instance. For security reasons, you have to recreate a connection for this company VAT by following the steps in the first connection section.

No files were found. Please check your configuration.

This may occur if the company VAT has changed after the connection was established. In that case, you must click on the Revoke connection button in the settings, and recreate the connection.

It seems you have already created a connection to CodaBox with this fiduciary. To create a new connection, you must first revoke the old one on myCodaBox portal.

You must go on the CodaBox platform, and revoke the access of Odoo to your CodaBox account. Then, you will have to follow the steps in the first connection section.

Electronic invoicing¶

Odoo supports the Peppol BIS Billing 3.0 (UBL) electronic invoicing format. To enable it for a customer, go to Accounting ‣ Customers ‣ Customers, open their contact form, and under the Accounting tab, select the Peppol BIS Billing 3.0 format.

See also

Electronic invoicing (EDI)

Cash discount¶

In Belgium, if an early payment discount is offered on an invoice, the tax is calculated based on the discounted total amount, whether the customer benefits from the discount or not.

To apply the right tax amount and report it correctly in your VAT return, set the tax reduction as Always (upon invoice).

See also

Cash discounts and tax reduction

Fiscal certification: POS restaurant¶

In Belgium, the owner of a cooking business such as a restaurant or food truck is required by law to use a government-certified Cash Register System for their receipts. This applies if their yearly earnings (excluding VAT, drinks, and take-away food) exceed 25,000 euros.

This government-certified system entails the use of a certified POS system, along with a device called a Fiscal Data Module (or black box) and a VAT Signing Card.

Important

Do not forget to register as foodservice industry manager on the Federal Public Service Finance registration form.

Certified POS system¶

The Odoo POS system is certified for the major versions of databases hosted on Odoo Online and Odoo.sh. Please refer to the following table to ensure that your POS system is certified.

	Odoo Online	Odoo.sh	On-Premise
Odoo 16.0	Certified	Certified	Not certified
Odoo 15.2	Not certified	Not certified	Not certified
Odoo 15.0	Certified	Certified	Not certified
Odoo 14.0	Certified	Certified	Not certified

See also

Supported versions

A certified POS system must adhere to rigorous government regulations, which means it operates differently from a non-certified POS.

On a certified POS, you cannot:
- Set up and use the global discounts feature (the pos_discount module is blacklisted and cannot be activated).
- Set up and use the loyalty programs feature (the pos_loyalty module is blacklisted and cannot be activated).
- Reprint receipts (the pos_reprint module is blacklisted and cannot be activated).
- Modify prices in order lines.
- Modify or delete order lines in POS orders.
- Sell products without a valid VAT number.
- Use a POS that is not connected to an IoT box.
The cash rounding feature must be activated and set to a Rounding Precision of 0,05 and a Rounding Method set as Half-Up.
Taxes must be set as included in the price. To set it up, go to Point of Sale ‣ Configuration ‣ Settings, and from the Accounting section, open the Default Sales Tax form by clicking the arrow next to the default sales tax field. There, click Advanced Options and enable Included in Price.
At the start of a POS session, users must click Work in to clock in. Doing so allows the registration of POS orders. If users are not clocked in, they cannot make POS orders. Likewise, they must click Work Out to clock out at the end of the session.

Warning

If you configure a POS to work with a FDM, you cannot use it again without it.

Fiscal Data Module (FDM)¶

An FDM, or black box, is a government-certified device that works together with the Point of Sale application and saves your POS orders information. Concretely, a hash (unique code) is generated for each POS order and added to its receipt. This allows the government to verify that all revenue is declared.

Warning

Only the FDM from Boîtenoire.be with the FDM certificate number BMC01 is supported by Odoo. Contact the manufacturer (GCV BMC) to order one.

Configuration¶

Before setting up your database to work with an FDM, ensure you have the following hardware:

a Boîtenoire.be (certificate number BMC01) FDM;
an RS-232 serial null modem cable per FDM;
an RS-232 serial-to-USB adapter per FDM;
an IoT Box (one IoT box per FDM); and
a receipt printer.

Black box module¶

As a pre-requisite, activate the Belgian Registered Cash Register module (technical name: pos_blackbox_be).

Once the module is activated, add your VAT number to your company information. To set it up, go to Settings ‣ Companies ‣ Update Info, and fill in the VAT field. Then, enter a national registration number for every staff member who operates the POS system. To do so, go to the Employees app and open an employee form. There, go to HR settings tab ‣ Attendance/Point of Sale, and fill in the INSZ or BIS number field.

ISNZ or BIS number field on employee form

Tip

To input your information, click on your avatar, go to My Profile ‣ Preference tab, and enter your INSZ or BIS number in the designated field.

Warning

You must configure the FDM directly in the production database. Utilizing it in a testing environment may result in incorrect data being stored within the FDM.

IoT Box¶

In order to use an FDM, you need a registered IoT Box. To register your IoT box, you must contact us through our support contact form and provide the following information:

your VAT number;
your company’s name, address, and legal structure; and
the Mac address of your IoT Box.

Once your IoT box is certified, connect it to your database. To verify that the IoT Box recognizes the FDM, go to the IoT homepage and scroll down the IOT Device section, which should display the FDM.

Hardware status page on a registered IoT Box

Then, add the IoT to your POS. To do so, go to Point of Sale ‣ Configuration ‣ Point of Sale, select your POS, scroll down to the Connected Device section, and enable IoT Box. Lastly, add the FMD in the Fiscal Data Module field.

Note

To be able to use an FDM, you must at least connect one Receipt Printer.

VAT signing card¶

When you open a POS session and make your initial transaction, you are prompted to enter the PIN provided with your VSC. The card is delivered by the FPS upon registration.

Edit on GitHub