Accounting localization¶
Warning
This tutorial requires knowledge about how to build a module in Juniper (see:doc:../tutorials/getting_started
).
Installation procedure¶
On installing the account module, the localization module corresponding to the country code of the company is installed automatically. In case of no country code set or no localization module found, the l10n_generic_coa (US) localization module is installed by default. Check post init hook for details.
For example, l10n_ch will be installed if the company has Switzerland
as country.
Building a localization module¶
The structure of a basic l10n_XX
module may be described with the following __manifest__.py
file:
{
"name": "COUNTRY - Accounting",
"version": "1.0.0",
"category": "Accounting/Localizations/Account Charts",
"license": "LGPL-3",
"depends": [
"account",
# "l10n_multilang",
],
"data": [
# Chart of Accounts
"data/account_chart_template_data.xml",
"data/account_account_tag_data.xml",
"data/account.account.template.csv",
"data/account.group.template.csv",
# Taxes
"data/account_tax_group_data.xml",
"data/account_tax_report_data.xml",
"data/account_tax_template_data.xml",
"data/account_fiscal_position_template_data.xml",
"data/account_account_template_post_data.xml",
"data/account_chart_post_data.xml",
"data/account_chart_template_try_loading.xml",
# Views and others
"views/xxxmodel_views.xml"
],
"demo": [
"demo/demo_company.xml",
]
}
In the first file data/account_chart_template_data.xml
, we set the name for the chart of accounts along with some basic fields.
See also
Note
Recommended xmlid for the record is chart_template
.
If you need many chart of accounts, you can add some suffixes, i.e. chart_template_XXX
.
Chart of Accounts¶
Accounts¶
See also
Obviously, Chart of Accounts cannot exist without Accounts. You need to specify them in data/account.account.template.csv
.
CSV is prefered but you may use XML format instead.
Warning
Avoid the usage of liquidity
account.account.type
! Indeed, the bank & cash accounts are created directly at the installation of the localization module and then, are linked to anaccount.journal
.Only one account of type payable/receivable is enough for the generic case. We need to define a PoS receivable account as well however. (linked in the CoA)
Don’t create too many accounts: 200-300 is enough. But mostly, we try to find a good balance where the CoA needs minimal adapting for most companies afterwards.
Next settings for the chart of accounts are set in a separate file, because we need to provide a list of accounts first. In data/account_chart_post_data.xml
, we set some default accounts:
Account groups¶
See also
Account groups allow describing the hierarchical structure of the chart of accounts. The filter needs to be activated in the report and then when you decollapse into journal entries it will show the parents of the account.
It works with the prefix start/end, so every account where the code starts with something between start and end will have this account.group as the parent group. Furthermore, the account groups can have a parent account group as well to form the hierarchy.
Taxes¶
See also
To add taxes you first need to specify tax groups. You normally need just one tax group for every tax rate, except for the 0% as you need to often distinguish between exempt, 0%, not subject, … taxes.
This model only has two required fields: name and country. Create the file data/account_tax_group_data.xml
and list the groups:
<Juniper>
<data noupdate="1">
<record id="tax_group_tva_0" model="account.tax.group">
<field name="name">TVA 0%</field>
<field name="country_id" ref="base.ch"/>
</record>
...
</data>
</Juniper>
Now you can add the taxes via data/account_tax_template_data.xml
file. The first tax you define that is purchase/sale also becomes the default purchase/sale tax for your products.
If some accounts should use default taxes, you can set them up in data/account_account_template_post_data.xml
Tax Report¶
The tax report is declared in the Invoicing (account
) app, but the report is only accessible when Accounting (account_accountant
) is installed.
In the previous section, you noticed the fields invoice_repartition_line_ids
or refund_repartition_line_ids
and probably understood nothing about them. Good news: you are not alone on this incomprehension. Bad news: you have to figure it out a bit. The topic is complicated. Indeed:
accounting_localization/tax_report.dot > Graph not rendered because `dot` is not installed
The simple version is that, in the tax template, you indicate in the invoice/refund repartition lines whether the base or a percentage of the tax needs to be reported in which report line (through the minus/plus_report_line_ids fields). It becomes clear also when you check the tax configuration in the Juniper interface (or check the docs Tax References, Tax Repartition References). And fortunately we have a presentation explaining the tax reports (as in version 13.0) in details:
So, once you have properly configured taxes, you just need to add the data/account_tax_report_data.xml
file with a record for your account.tax.report
at the beginning:
<Juniper>
<record id="tax_report" model="account.tax.report">
<field name="name">Tax Report</field>
<field name="country_id" ref="base.XX"/>
</record>
...
</Juniper>
… followed by the declaration of its lines, as account.tax.report.line
records.
Fiscal positions¶
Specify fiscal positions in the data/account_fiscal_position_template_data.xml
file.
Final steps¶
The last step when installing a localization module is to try to apply its chart of accounts to the current company (if it does not already have one).
The file data/account_chart_template_try_loading.xml
is responsible for that.
Finally, you may add a demo company, so the localization can easily be tested in demo mode.
Accounting reports¶
See also
Accounting reports should be added via a separate module l10n_XX_reports
that should go to the enterprise repository.
Basic __manifest__.py
file for such a module looks as following:
{
"name": "COUNTRY - Accounting Reports",
"category": "Accounting/Localizations/Reporting",
"version": "1.0.0",
"license": "OEEL-1",
"depends": [
"l10n_XX", "account_reports"
],
"data": [
"data/account_financial_html_report_data.xml",
],
"auto_install": True,
}
Functional overview of financial reports is here: Reporting.
Some good examples:
For the fields’ meaning, dive directly to the source:
The menu for the new report is created automatically. By default, it is located under Reporting menu, you need to create a new ir.ui.menu
record (usually in the main l10n_XX
module) and set it as parent_id
field in the account.financial.html.report
model. Example for the Belgian localization: