Rapoarte Personalizate¶
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 . From here, you can either create a root report or a variant.
Rapoarte rădăcină¶
Rapoartele rădăcină pot fi considerate rapoarte contabile generice, neutre. Acestea servesc drept modele pe care sunt construite versiunile de contabilitate locală. Dacă un raport nu are un raport rădăcină, este considerat a fi un raport rădăcină în sine.
Example
Un raport fiscal pentru Belgia și SUA ar folosi aceeași versiune generică ca bază și ar adapta-o pentru reglementările lor interne.
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 .
Notă
Cazurile care necesită crearea unui nou raport rădăcină sunt rare, cum ar fi atunci când autoritățile fiscale ale unei țări solicită un tip de raport nou și specific.
Variante¶
Variantele sunt versiuni specifice țării ale rapoartelor rădăcină și, prin urmare, se referă întotdeauna la un raport rădăcină. Pentru a crea o variantă, selectați un raport generic (rădăcină) în câmpul Raport rădăcină când creați un nou raport.
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.
Expresii¶
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.
Notă
În funcție de motor, pot fi necesare și subformulele.
«Odoo Domain» engine¶
With this engine, a formula is interpreted as an Odoo domain
targeting account.move.line objects.
Subformula vă permite să definiți cum sunt utilizate liniile de mutare care se potrivesc domeniului pentru a calcula valoarea expresiei:
sumaRezultatul este suma tuturor soldurilor liniilor de mutare potrivite.
sum_if_posRezultatul este suma tuturor soldurilor liniilor de mutare potrivite dacă această sumă este pozitivă. În caz contrar, este
0.sum_if_negRezultatul este suma tuturor soldurilor liniilor de mutare potrivite dacă această sumă este negativă. În caz contrar, este
0.count_rowsThe 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.
«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).
Subformulele pot fi una dintre următoarele:
if_above(CUR(amount))Valoarea expresiei aritmetice va fi returnată numai dacă este mai mare decât limita furnizată. În caz contrar, rezultatul va fi
0.if_below(CUR(amount))Valoarea expresiei aritmetice va fi returnată numai dacă este mai mică decât limita furnizată. În caz contrar, rezultatul va fi
0.if_between(CUR1(amount1), CUR2(amount2))Valoarea expresiei aritmetice va fi returnată numai dacă se află strict între limitele furnizate. În caz contrar, va fi adus înapoi la limita cea mai apropiată.
if_other_expr_above(LINE_CODE.EXPRESSION_LABEL, CUR(amount))Valoarea expresiei aritmetice va fi returnată numai dacă valoarea expresiei indicată de codul liniei furnizate și eticheta expresiei este mai mare decât limita furnizată. În caz contrar, rezultatul va fi
0.if_other_expr_below(LINE_CODE.EXPRESSION_LABEL, CUR(amount))Valoarea expresiei aritmetice va fi returnată numai dacă valoarea expresiei indicată de codul liniei furnizate și eticheta expresiei este mai mică decât limita furnizată. În caz contrar, rezultatul va fi
0.
CUR este codul monedei cu majuscule, iar amount este valoarea limitei exprimată în acea monedă.
De asemenea, puteți utiliza subformula cross_report pentru a potrivi o expresie găsită într-un alt raport.
«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
21Example
21 + 10 - 521 și 10 și scade soldul celor pe conturi cu prefixul 5.De asemenea, este posibil să ignorați o selecție de sub-prefixe.
Example
21 + 10\(101, 102) - 5\(57)101, 102 și 57.Putem aplica «sub-filtrare» pe credite și datorii folosind C și D sufixe. În acest caz, un cont va fi luat în considerare doar dacă prefixul se potrivește, și dacă totalul soldului liniei de mutare făcute pe acest cont este credit/debit.
Example
Contul 210001 are un sold de -42 și contul 210002 are un sold de 25. Formula 21D se potrivește doar cu contul 210002, și de aceea returnează 25. 210001 nu este potrivit, deoarece soldul său este credit.
Excluderile prefixului pot fi amestecate cu C și D sufixele.
Example
21D + 10\(101, 102)C - 5\(57)21 dacă este debit (D) și 10 dacă este credit (C), dar ignoră prefixele 101, 102, și scade soldul celor de pe conturi cu prefixul 5, ignorând prefixul 57.Pentru a se potrivi cu litera C sau D într-un prefix și nu-l folosi ca sufix, utilizați o excludere goală ().
Example
21D\()21D, indiferent de semnul lor de sold.Pe lângă utilizarea prefixelor de cod pentru a include conturi, le puteți asocia și cu etichete de cont. Acest lucru este util în special, de exemplu, dacă țara dvs. nu are un plan de conturi standardizat, în care același prefix poate fi utilizat în scopuri diferite de la o companie.
Example
tag(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)De asemenea, puteți utiliza expresii aritmetice cu etichete, eventual combinându-le cu selecții de prefix.
Example
tag(my_module.my_tag) + tag(42) + 1010Sufixele C și D pot fi folosite în același mod cu etichetele.
Example
tag(my_module.my_tag)CExcluderea prefixului funcționează și cu etichete.
Example
tag(my_module.my_tag)\(10)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.
Formulele pot fi una dintre următoarele:
sumaDacă rezultatul trebuie să fie suma tuturor valorilor externe în perioada.
most_recentDacă rezultatul trebuie să fie valoarea ultimei valori externe în perioada.
În plus, subformulele pot fi utilizate în două moduri:
rounding=XÎnlocuirea
Xcu un număr instruiește să rotunjească suma la X zecimale.editableIndică că această expresie poate fi editată manual, declanșând afișarea unui icon în raport, permițând utilizatorului să efectueze această acțiune.
Notă
Valorile manuale sunt create la date_to selectat în prezent în raport.
Ambele subformule pot fi amestecate prin separarea lor cu un ;.
Example
editable;rounding=2«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.
Coloane¶
Rapoartele pot avea un număr nelimitat de coloane pentru afișare. Fiecare coloană primește valorile din expresiile declarate pe linii. Câmpul expression_label al coloanei dă eticheta expresiilor ale căror valori sunt afișate. Dacă o linie nu are expresie în acel câmp, atunci nimic nu este afișat pentru ea în această coloană. Dacă sunt necesare mai multe coloane, trebuie să utilizați etichete diferite de expresie.
Când utilizați funcția comparare perioadă găsită în fila Opțiuni a unui raport contabil, toate coloanele sunt repetate în și pentru fiecare perioadă.
Line grouping¶
Non-standard grouping is possible by adding or using existing fields on the Journal Item model, provided that the fields are related and non-stored.
Notă
Grouping lines requires the report to have explicit report lines that can be edited. The deferred reports, for example, do not support grouping lines as they use dynamic lines that are generated.
Create a new field on journal item¶
To create a non-stored, related field in the Journal Item model, first go to , and click the (bug) icon, then click Fields. Click New to create a new field, and complete the following fields:
Field Name: a technical name for the field
Field Label: the label to be displayed for the field
Field Type: the type of field that this related field should point to
Stored: Leave this field unchecked as only non-stored fields can be used to group lines.
Related Model: If the field type is one2many, many2many, or many2one, select the model of the original field to group by.
Related Field Definition: the technical path to the field you want to group by
Example
To group by the sales team of the commercial partner, set the related field definition to
move_id.team_id.
Group lines¶
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.
Sfat
To find a list of all the model’s fields and their technical names, go to , and click the (bug) icon, then click Fields. The technical name of each field is listed in the Field Name column.
Custom tax report setup¶
Report configuration¶
Sfat
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 , 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:
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 .In the Subformula field, enter either
baseto report the untaxed amount, ortaxto 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 this scenario, your company does not use tax grids. Instead, it tracks everything strictly via General Ledger accounts:
Select Prefix of Account Codes as the computation engine: Odoo uses this for lines that need to pull financial totals. Instead of looking for transaction tags, Odoo pulls live balances directly from your chart of accounts.
In the Formula field, type the starting digits of the accounts you want to track, (e.g.,
40will pull the combined total of all revenue accounts starting with400000,401000, etc.).
Repeat this process as necessary. Then, Save & Close.
Alternatively, you can:
Select Aggregate Other Formulas as the computation engine. Odoo uses this to calculate subtotals, net tax, or grand totals by adding or subtracting your other report lines.
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 this scenario, your company requires advanced filtering, manual user overrides, or complex algorithmic logic that standard tags and account prefixes cannot handle:
Select Odoo Domain as the computation engine: Odoo uses this to bypass tax tags entirely and filter raw journal items (
account.move.line) using standard Odoo search syntax.In the Formula field, enter a valid domain starting with brackets to isolate tax-exempt transactions for specific partner categories.
Alternatively, you can:
Select External Value as the computation engine. Odoo uses this to log manual overrides or historical carryover values.
In the Formula field, type either
sum(to add all manual values together over multi-period reports) ormost_recent(to display only the latest value).In the Subformula field, type
editableto display an edit icon on the live report, allowing users to modify the value manually. Additionally, you can round numbers by typingrounding=x.
Alternatively, you can:
Select Custom Python Function as the computation engine. Odoo uses this as an execution engine to run specific calculations through backend coding when rules involve progressive brackets, loops, or multi-tier thresholds.
In the Formula field, enter the exact technical name of the Python method defined in your custom localization module.
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))Tax configuration¶
Next, go to 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 , 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.
Sfat
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 , select the tax, and click the (settings adjust) icon. From there, check the Tax Closing Entry box to adjust its visibility.
Vezi și