Rapports personnalisés

Odoo comes with a powerful and easy-to-use reporting framework. The engine allows you to create new reports, such as tax reports, or balance sheets and income statements with specific groupings and layouts.

Important

Activate the developer mode to access the accounting report creation interface.

To create a new report, open the Accounting app and navigate to Configuration ‣ Accounting Reports. From here, you can either create a root report or a variant.

Rapports racines

Les rapports racines sont considérés comme des rapports comptables neutres et génériques. Ils servent de modèles sur lesquels sont construites les versions comptables locales. Si un rapport n’a pas de rapport racine, il est lui-même considéré comme un rapport racine.

Example

Les déclarations d’impôt pour la Belgique et les États-Unis utiliseraient toutes deux la même version générique comme base et seraient adaptées à leurs réglementations nationales respectives.

When creating a new root report, you need to create a menu item for it. To do so, open the report and, on that same report, click the (Actions) icon, then select Create Menu Item. Refresh the page; the report is now available under Accounting ‣ Reporting.

Note

Les situations qui demandent la création d’un nouveau rapport racine sont rares, par exemple lorsque les autorités fiscales d’un pays nécessitent un nouveau type de rapport spécifique.

Variantes

Les variantes sont des versions nationales des rapports racines et font donc toujours référence à un rapport racine. Pour créer une variante, sélectionnez un rapport (racine) générique dans le champ Rapport racine lors de la création d’un nouveau rapport.

When a root report is opened from one of the accounting app’s main menus, all its variants are displayed in the variant selector in the top right corner of the view.

Example

In the following image, VAT Report (BE) is the variant of the root Generic Tax report.

Report lines

After having created a report (either root or variant), you need to fill it with report lines. You can either create a new one by clicking on Add a line, or modify an existing report line by clicking on it. All report lines require a Name, and can have an optional additional Code (of your choice) if you wish to use their value in formulas.

Expressions

Each report line can contain one or multiple expressions. Expressions can be seen as sub-variables needed by a report line. To create an expression, click on Add a line within a report line.

When creating an expression, you must attribute a Label used to refer to that expression. Therefore, it has to be unique among the expressions of each line. Both a Computation Engine and a Formula must also be indicated. The engine defines how your formula(s) and subformula(s) are interpreted. It is possible to mix expressions using different computation engines under the same line if you need to.

Note

Selon le moteur, des sous-formules peuvent également être nécessaires.

“Odoo Domain” engine

With this engine, a formula is interpreted as an Odoo domain targeting account.move.line objects.

La sous-formule vous permet de définir comment les lignes d’écriture correspondant au domaine sont utilisés pour calculer la valeur de l’expression :

sum

Le résultat est la somme de tous les soldes des lignes d’écritures correspondantes.

sum_if_pos

Le résultat est la somme de tous les soldes des lignes d’écriture correspondantes si ce montant est positif. Sinon, il est égal à 0.

sum_if_neg

Le résultat est la somme de tous les soldes des lignes d’écriture correspondantes si ce montant est négatif. Sinon, il est égal à 0.

count_rows

The result is the number of sub-lines of this expression. If the report line has a group-by value, this will correspond to the number of distinct grouping keys in the matched move lines. Otherwise, it will be the number of matched move lines.

You can also put a - sign at the beginning of the subformula to reverse the sign of the result.

“Tax Tags” engine

A formula made for this engine consists of a name used to match tax tags. If such tags do not exist when creating the expression, they will be created.

Lors de l’évaluation de l’expression, le calcul de l’expression peut être grossièrement exprimé comme suit : (montant des lignes d’écriture avec une étiquette + ) - (montant des lignes d’écriture avec une étiquette - ).

Example

If the formula is tag_name, the engine matches tax tags +tag_name and -tag_name, creating them if necessary. To exemplify further: two tags are matched by the formula. If the formula is A, it will require (and create, if needed) tags +A and -A.

“Aggregate Other Formulas” engine

Use this engine when you need to perform arithmetic operations on the amounts obtained for other expressions. Formulas here are composed of references to expressions separated by one of the four basic arithmetic operators (addition +, subtraction -, division /, and multiplication *). To refer to an expression, type in its report line’s code followed by a period . and the expression’s label (ex. code.label).

Les sous-formules peuvent être l’une des suivantes :

if_above(CUR(amount))

La valeur de l’expression arithmétique ne sera renvoyée que si elle est supérieure à la borne fournie. Sinon, le résultat sera 0.

if_below(CUR(amount))

La valeur de l’expression arithmétique ne sera renvoyée que si elle est inférieure à la borne fournie. Sinon, le résultat sera 0.

if_between(CUR1(amount1), CUR2(amount2))

La valeur de l’expression arithmétique ne sera renvoyée que si elle est strictement comprise entre les bornes fournies. Sinon, elle sera ramenée à la borne la plus proche.

if_other_expr_above(LINE_CODE.EXPRESSION_LABEL, CUR(amount))

La valeur de l’expression arithmétique ne sera renvoyée que si la valeur de l’expression désignée par le code de ligne et le libellé d’expression fournis est supérieure à la borne fournie. Sinon, le résultat sera 0.

if_other_expr_below(LINE_CODE.EXPRESSION_LABEL, CUR(amount))

La valeur de l’expression arithmétique ne sera renvoyée que si la valeur de l’expression désignée par le code de ligne et le libellé d’expression fournis est inférieure à la borne fournie. Sinon, le résultat sera 0.

CUR est le code de la devise en lettres capitales et amount est le montant de borne exprimée dans cette devise.

cross_report(xml_id | report_id)

Utilisé pour associer une expression d’un autre rapport ciblé par le xml_id ou l’ID du rapport lui-même.

“Prefix of Account Codes” engine

This engine is used to match amounts made on accounts using the prefixes of these accounts” codes as variables in an arithmetic expression.

Example

21

Les expressions arithmétiques peuvent également être un simple préfixe, comme dans cet exemple.

Example

21 + 10 - 5

Cette formule additionne les soldes des lignes d’écritures effectuées sur les comptes dont les codes commencent par 21 et 10, et soustrait le solde des lignes sur des comptes dont le préfixe est 5.

Il est également possible d’ignorer une sélection de sous-préfixes.

Example

21 + 10\(101, 102) - 5\(57)

Cette formule fonctionne de la même façon que l’exemple précédent, mais ignore les préfixes 101, 102, et 57.

Vous pouvez appliquer un “sous-filtrage” sur les crédits et débits à l’aide des suffixes C et D. Dans ce cas, un compte ne sera pris en considération que si son préfixe correspond et si le solde total des lignes d’écriture effectuées sur ce compte est créditeur/débiteur.

Example

Le compte 210001 a un solde de -42 et le compte 210002 a un solde de 25. La formule 21D correspond uniquement au compte 210002, et renvoie donc 25. 210001 n’est pas pris en considération, car son solde est créditeur.

Les exclusions de préfixes peuvent être mélangées avec les suffixes C et D.

Example

21D + 10\(101, 102)C - 5\(57)

Cette formule additionne les soldes des lignes d’écritures effectuées sur les comptes dont le code commence par 21 si c’est débiteur (D) et par 10 si c’est créditeur (C), mais ignore les préfixes 101, 102, et soustrait le solde des lignes effectuées sur les comptes avec le préfixe 5, tout en ignorant le préfixe 57.

Pour faire correspondre la lettre C ou D à un préfixe et ne pas l’utiliser comme un suffixe, utilisez une exclusion vide ().

Example

21D\()

Cette formule correspond aux comptes dont le code commence par 21D, quel que soit le signe de leur solde.

En plus d’utiliser des préfixes de code pour inclure des comptes, vous pouvez également les associer avec des étiquettes de compte. Cela est particulièrement utile, par exemple, si votre pays ne dispose pas d’un plan comptable standardisé, où le même préfixe peut être utilisé à des fins différentes selon les sociétés.

Example

tag(25)

This formula matches accounts whose associated tags contain the one with id 25.

If the tag you reference is defined in a data file, an xmlid can be used instead of the id.

Example

tag(my_module.my_tag)

Cette formule associe les comptes dont les étiquettes associées incluent l’étiquette désignée par my_module.my_tag.

Vous pouvez également utiliser des expressions arithmétiques avec des étiquettes, en les combinant éventuellement avec des sélections de préfixes.

Example

tag(my_module.my_tag) + tag(42) + 10

Les soldes des comptes étiquetés comme my_module.my_tag seront additionnés avec ceux des comptes liés à l’étiquette avec l’ID 42 et les comptes avec le préfixe de code 10

Les suffixes C et D peuvent être utilisés de la même manière avec des étiquettes.

Example

tag(my_module.my_tag)C

Cette formule correspond aux comptes avec l’étiquette my_module.my_tag et un solde créditeur.

L’exclusion par préfixe fonctionne également avec les étiquettes.

Example

tag(my_module.my_tag)\(10)

Cette formule correspond aux comptes avec l’étiquette my_module.my_tag et un code ne commençant pas par 10.

“External Value” engine

The “external value” engine is used to refer to manual and carryover values. Those values are not stored using account.move.line, but with account.report.external.value. Each of these objects directly points to the expression it impacts, so very little needs to be done about their selection here.

Les formules peuvent être l’une des suivantes :

sum

Si le résultat doit être la somme de toutes les valeurs externes de la période.

most_recent

Si le résultat doit être la valeur de la dernière valeur externe de la période.

De plus, les sous-formules peuvent être utilisées de deux manières :

rounding=X

En remplaçant X par un nombre, on demande d’arrondir le montant à X décimales.

editable

Indique que cette expression peut être éditée manuellement, ce qui déclenche l’affichage d’une icône dans le rapport, permettant à l’utilisateur d’effectuer cette action.

Note

Les valeurs manuelles sont créées à la date_to actuelle sélectionnée dans le rapport.

Les deux sous-formules peuvent être utilisées ensemble en les séparant par un ;.

Example

editable;rounding=2

is a correct subformula mixing both behaviors.

“Custom Python Function” engine

This engine is a means for developers to introduce custom computation of expressions on a case-by-case basis. The formula is the name of a python function to call, and the subformula is a key to fetch in the dictionary returned by this function. Use it only if you are making a custom module of your own.

Colonnes

Les rapports peuvent afficher un nombre indéfini de colonnes. Chaque colonne obtient ses valeurs des expressions déclarées sur les lignes. Le champ expression_label de la colonne donne le libellé des expressions dont la valeur s’affiche. S’il y a aucune expression dans ce champ, rien n’est affiché dans cette colonne. Si plusieurs colonnes sont requises, vous devez utiliser des libellés d”expression différents.

Lorsque vous utilisez la fonctionnalité comparaison de période que vous trouvez dans l’onglet Options d’un rapport comptable, toutes les colonnes sont répétées dans et pour chaque période.

Regroupement de lignes

Un regroupement non standard est possible en ajoutant ou en utilisant des champs existants sur le modèle Écriture comptable, à condition que les champs soient liés et non stockés.

Note

Regrouper les lignes nécessite que le rapport ait des lignes de rapport explicites qui peuvent être modifiées. Les rapports différés, par exemple, ne prennent pas en charge le regroupement de lignes car ils utilisent des lignes dynamiques qui sont générées.

Créer un nouveau champ sur l’écriture comptable

Pour créer un champ lié non stocké dans le modèle Écriture comptable, aller d’abord à Comptabilité ‣ Écritures comptables, puis cliquer sur l’icône (bug), puis cliquer sur Champs. Cliquer sur Nouveau pour créer un nouveau champ et remplir les champs suivants :

• Nom du champ : nom technique du champ

• Libellé du champ : libellé à afficher pour le champ

• Type de champ : type de champ vers lequel ce champ lié doit pointer

• Stocké : Laisser ce champ non coché car seuls les champs non stockés peuvent être utilisés pour regrouper les lignes.

• Modèle lié : Si le type de champ est one2many, many2many ou many2one, sélectionner le modèle du champ d’origine sur lequel regrouper.

• Définition du champ associé : le chemin technique vers le champ par lequel vous souhaitez regrouper

  Example

  Pour regrouper par équipe commerciale du partenaire commercial, définir la définition du champ associé sur move_id.team_id.

Regrouper les lignes

To group lines, go to the Lines tab of the desired report, click on the line you want to group, and edit the Group by field. Enter the technical name (Field Name) of the field to use as the grouping key.

Astuce

Pour trouver une liste de tous les champs du modèle et leurs noms techniques, aller à Comptabilité ‣ Écritures comptables et cliquer sur l’icône (bug), puis cliquer sur Champs. Le nom technique de chaque champ est listé dans la colonne Nom du champ.

Voir également

Consolidation via regroupement par code de compte

Custom tax report setup

Report configuration

Astuce

All technical terms and functions of Odoo’s reports engine are explained in the previous sections of this page. We strongly recommend reading these sections before setting up a custom tax report.

To create a custom tax report, open the Accounting app, navigate to Configuration ‣ Accounting Reports, then click New:

• Enter a name for your report.

• Select a Root Report.

• Under the Availability field, select Country Matches, then select the Country matching your company.

Next, create a report line by clicking the Add a line. Once created, click that report line to configure it:

• Click Add a line again to create an Expression and name it.

• In the Definition tab, select a Computation Engine for that expression depending on the following scenarios:

Scenario A (Tax grids)Scenario B (No tax grids)Scenario C (Advanced Engines)

In this scenario, your company uses tax grids:

• Select Tax Tags as the computation engine. Odoo uses this field to link the report line to your taxes.

• In the Formula field, type your short grid identifier (e.g., vat_sales_base). Odoo automatically generates the + and - variants of this tag for you to map inside Configuration ‣ Taxes.

• In the Subformula field, enter either base to report the untaxed amount, or tax to report the actual tax amount collected/paid.

Repeat this process as necessary. Then, Save & Close.

Alternatively, you can:

• Select Aggregate Other Formulas as the computation engine. Odoo uses this field to perform math on lines already present in the report rather than scanning raw transactions.

• In the Formula field, use basic algebra referencing your line codes (e.g., LINE_10 - LINE_20).

Repeat this process as necessary. Then, Save & Close.

In the Options tab of an Expression, populate the Carry Over To field with a formula to always carry over balances or only carry them over when the amount is negative. Leave this field blank if you do not want to use this feature.

Example

if_below(EUR(0))

This formula will only carry over amounts below 0.00 EUR.

Tax configuration

Next, go to Configuration ‣ Taxes and click New to create and configure new taxes for your custom tax report. Create your Sales and Purchases taxes, and populate the Tax Grids for all taxes using the matching tax grids you created earlier. Finally, make sure to specify both a tax payable and tax receivable account for each tax.

Example

Closing entry

To close taxes, a tax group must be specified on each tax used in your custom tax report. To do this, open the Accounting app, navigate to Configuration ‣ Taxes, open a tax that requires a tax group, click the Advanced Options tab, and select a group in the Tax Group field. Once assigned, click the (right arrow) icon and set both a Tax Payable Account and a Tax Receivable Account.

Astuce

• When everything has been set up, make sure to test your report by creating invoices, bills, and credit notes using the taxes specific to that report. Finally, test the closing entry itself.

• If you want to hide a specific account from displaying in the tax closing entry, go to Configuration ‣ Taxes, select the tax, and click the (settings adjust) icon. From there, check the Tax Closing Entry box to adjust its visibility.

Voir également

Tax closing