Rapports personnalisés

Odoo est fourni avec un framework de reporting puissant et facile à utiliser. Le moteur permet de créer de nouveaux rapports, tels que des rapports fiscaux, ou des bilans et comptes de résultat avec des regroupements et présentations spécifiques.

Important

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

Pour créer un nouveau rapport, ouvrez l’application Comptabilité et allez dans Configuration ‣ Rapports comptables. De là, vous pouvez créer soit un rapport racine, soit une variante.

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.

Lors de la création d’un nouveau rapport racine, vous devez créer un élément de menu pour celui-ci. Pour ce faire, ouvrez le rapport et, sur ce même rapport, cliquez sur l’icône (Actions), puis sélectionnez Créer un élément de menu. Actualisez la page ; le rapport est maintenant disponible sous Comptabilité ‣ 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 depuis l’un des menus principaux de l’application Comptabilité, toutes ses variantes sont affichées dans le sélecteur de variantes dans le coin supérieur droit de la vue.

Example

Dans l’image suivante, Rapport TVA (BE) est la variante du Rapport fiscal générique racine.

Lignes de rapport

Après avoir créé un rapport (racine ou variante), vous devez le remplir avec des lignes de rapport. Vous pouvez soit en créer une nouvelle en cliquant sur Ajouter une ligne, soit modifier une ligne de rapport existante en cliquant dessus. Toutes les lignes de rapport nécessitent un Nom, et peuvent avoir un Code supplémentaire optionnel (de votre choix) si vous souhaitez utiliser leur valeur dans des formules.

Expressions

Chaque ligne de rapport peut contenir une ou plusieurs expressions. Les expressions peuvent être considérées comme des sous-variables nécessaires à une ligne de rapport. Pour créer une expression, cliquez sur Ajouter une ligne dans une ligne de rapport.

Lors de la création d’une expression, vous devez attribuer un Libellé utilisé pour faire référence à cette expression. Par conséquent, il doit être unique parmi les expressions de chaque ligne. Un Moteur de calcul et une Formule doivent également être indiqués. Le moteur définit comment vos formules et sous-formules sont interprétées. Il est possible de mélanger des expressions utilisant différents moteurs de calcul sous la même ligne si nécessaire.

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 les 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

Le résultat est le nombre de sous-lignes de cette expression. Si la ligne de rapport a une valeur de regroupement, cela correspondra au nombre de clés de regroupement distinctes dans les lignes d’écriture correspondantes. Sinon, ce sera le nombre de lignes d’écriture correspondantes.

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

Moteur “Balises fiscales”

Une formule conçue pour ce moteur consiste en un nom utilisé pour faire correspondre des balises fiscales. Si de telles balises n’existent pas lors de la création de 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 balises fiscales +tag_name et -tag_name, en les créant si nécessaire. Pour illustrer davantage : deux balises sont mises en correspondance par la formule. Si la formule est A, elle nécessitera (et créera, si besoin) les balises +A et -A.

Moteur “Agrégation d’autres formules”

Utilisez ce moteur lorsque vous devez effectuer des opérations arithmétiques sur les montants obtenus pour d’autres expressions. Les formules ici sont composées de références à des expressions séparées par l’un des quatre opérateurs arithmétiques de base (addition +, soustraction -, division / et multiplication *). Pour faire référence à une expression, saisissez le code de sa ligne de rapport suivi d’un point . et du libellé de l’expression (ex. code.libellé).

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.

Moteur “Préfixe de codes de compte”

Ce moteur est utilisé pour faire correspondre les montants effectués sur des comptes en utilisant les préfixes des codes de ces comptes comme 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)

Cette formule correspond aux comptes dont les balises associées contiennent celle avec l’id 25.

Si la balise que vous référencez est définie dans un fichier de données, un xmlid peut être utilisé à la place de l’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 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 impacte, donc très peu de choses doivent être faites 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 mélangeant les deux comportements.

Moteur “Fonction Python personnalisée”

Ce moteur est un moyen pour les développeurs d’introduire un calcul personnalisé des expressions 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 retourné par cette fonction. Utiliser uniquement si vous créez 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.

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

Pour regrouper les lignes, accédez à l’onglet Lignes du rapport souhaité, cliquez sur la ligne que vous souhaitez regrouper, et modifiez le champ Regrouper par. Saisissez le nom technique (Nom du champ) du champ à utiliser comme clé de regroupement.

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

Configuration d’un rapport de taxes personnalisé

Configuration du rapport

Astuce

Tous les termes techniques et fonctions du moteur de rapports d’Odoo sont expliqués dans les sections précédentes de cette page. Nous recommandons vivement de lire ces sections avant de configurer un rapport de taxes personnalisé.

Pour créer un rapport de taxes personnalisé, ouvrez l’application Comptabilité, accédez à Configuration ‣ Rapports comptables, puis cliquez sur Nouveau :

• Saisissez un nom pour votre rapport.

• Sélectionnez un Rapport racine.

• Sous le champ Disponibilité, sélectionnez Correspondances de pays, puis sélectionnez le Pays correspondant à votre société.

Ensuite, créez une ligne de rapport en cliquant sur Ajouter une ligne. Une fois créée, cliquez sur cette ligne de rapport pour la configurer :

• Cliquez à nouveau sur Ajouter une ligne pour créer une Expression et la nommer.

• Dans l’onglet Définition, sélectionnez un Moteur de calcul pour cette expression en fonction des scénarios suivants :

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

Dans ce scénario, votre société utilise des grilles de taxes :

• Sélectionnez Étiquettes de taxe comme moteur de calcul. Odoo utilise ce champ pour lier la ligne de rapport à vos taxes.

• Dans le champ Formule, saisissez votre identifiant court de grille (par ex., vat_sales_base). Odoo génère automatiquement les variantes + et - de cette étiquette pour que vous puissiez les mapper dans Configuration ‣ Taxes.

• Dans le champ Sous-formule, saisissez soit base pour déclarer le montant hors taxe, soit tax pour déclarer le montant réel de la taxe collectée/payée.

Répétez ce processus autant que nécessaire. Ensuite, Enregistrer & Fermer.

Vous pouvez également :

• Sélectionner Agréger autres formules comme moteur de calcul. Odoo utilise ce champ pour effectuer des calculs sur les lignes déjà présentes dans le rapport plutôt que d’analyser les transactions brutes.

• Dans le champ Formule, utiliser de l’algèbre de base en référençant vos codes de ligne (par exemple, LINE_10 - LINE_20).

Répétez ce processus autant que nécessaire. Ensuite, Enregistrer & Fermer.

Dans l’onglet Options d’une Expression, remplir le champ Reporter vers avec une formule pour toujours reporter les soldes ou uniquement les reporter lorsque le montant est négatif. Laisser ce champ vide si vous ne souhaitez pas utiliser cette fonctionnalité.

Example

if_below(EUR(0))

Cette formule ne reportera que les montants inférieurs à 0,00 EUR.

Configuration de taxe

Ensuite, accédez à Configuration ‣ Taxes et cliquez sur Nouveau pour créer et configurer de nouvelles taxes pour votre rapport de taxe personnalisé. Créez vos taxes de Ventes et d”Achats, et remplissez les Grilles de taxes pour toutes les taxes en utilisant les grilles de taxes correspondantes que vous avez créées précédemment. Enfin, assurez-vous de spécifier à la fois un compte de taxe à payer et un compte de taxe à recevoir pour chaque taxe.

Example

Pièce de clôture

Pour clôturer les taxes, un groupe de taxes doit être spécifié sur chaque taxe utilisée dans votre rapport de taxe personnalisé. Pour ce faire, ouvrez l’application Comptabilité, accédez à Configuration ‣ Taxes, ouvrez une taxe qui nécessite un groupe de taxes, cliquez sur l’onglet Options avancées, et sélectionnez un groupe dans le champ Groupe de taxes. Une fois attribué, cliquez sur l’icône (flèche droite) et définissez à la fois un Compte de taxe à payer et un Compte de taxe à recevoir.

Astuce

• Lorsque tout a été configuré, assurez-vous de tester votre rapport en créant des factures, des notes de frais et des notes de crédit en utilisant les taxes spécifiques à ce rapport. Enfin, testez la pièce de clôture elle-même.

• Si vous souhaitez masquer un compte spécifique de l’affichage dans la pièce de clôture de taxe, accédez à Configuration ‣ Taxes, sélectionnez la taxe, et cliquez sur l’icône (réglages ajuster). De là, cochez la case Pièce de clôture de taxe pour ajuster sa visibilité.

Voir également

Clôture de taxe