Rapports personnalisés

Odoo propose un cadre d’analyse puissant et facile d’utilisation. Le moteur vous permet de créer de nouveaux rapports, tels que la déclaration de TVA, le bilan ou le compte de résultat avec des regroupements et des mises en page spécifiques.

Important

Activez le mode développeur pour accéder à l’interface de création des rapports comptables.

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.

Lorsqu’un rapport racine est ouvert à partir d’un des menus principaux de l’application Comptabilité, toutes ses variantes s’affichent dans le sélecteur de variantes situé dans le coin supérieur droit de la vue.

Example

Dans l’image suivante, Déclaration à la TVA (BE) est la variante du rapport racine Déclaration de TVA générique.

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.

Moteur “Domaine Odoo”

Avec ce moteur, une formule est interprétée comme un domaine Odoo ciblant des objets account.move.line.

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.

Vous pouvez également placer un signe - au début de la sous-formule pour inverser le signe du résultat.

Moteur des “Étiquettes de taxes”

Une formule faite pour ce moteur consiste en un nom utilisé pour faire correspondre les étiquettes de taxes. Si ces étiquettes n’existent pas au moment de créer l’expression, elles seront créées.

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

Si la formule est tag_name, le moteur fait correspondre les étiquettes de taxes +tag_name et -tag_name, les créant si nécessaire. Pour illustrer davantage : deux étiquettes sont mises en correspondance par la formule. Si la formule est A, elle demandera (et créera si nécessaire) les étiquettes +A et -A.

Moteur “Agréger d’autres formules”

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.

Vous pouvez également utiliser la sous-formule cross_report pour mettre en correspondance une expression trouvée dans un autre rapport.

Moteur “Préfixe des codes de compte”

Ce moteur est utilisé pour mettre en correspondance des montants effectués sur des comptes en utilisant les préfixes des codes de ces comptes en tant que variables dans une expression arithmétique.

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.

Moteur “Valeur externe”

Le moteur “valeur externe” est utilisé pour faire référence aux valeurs manuelles et aux valeurs reportées. Ces valeurs ne sont pas stockées avec account.move.line, mais avec account.report.external.value. Chacun de ces objets pointe directement vers l’expression qu’il affecte, de sorte qu’il n’y a pas grand-chose à faire concernant leur sélection ici.

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

est une sous-formule correcte qui utilise les deux comportements.

Moteur “Fonction Python personnalisée”

Ce moteur est un moyen pour les développeurs d’introduire des calculs d’expressions personnalisés au cas par cas. La formule est le nom d’une fonction python à appeler et la sous-formule est une clé à récupérer dans le dictionnaire renvoyé par cette fonction. N’utilisez cette formule que si vous construisez votre propre module personnalisé.

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.

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