Rapoarte Personalizate¶
Odoo vine cu un cadru de raportare puternic și ușor de utilizat. Motorul vă permite să creați rapoarte noi, cum ar fi rapoarte fiscale sau bilanţuri și contații de venit cu grupări specifice și dispoziții.
Important
Activați :ref:`modul dezvoltator<developer-mode> ` pentru a accesa interfața de creare a rapoartelor contabile.
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.
Când un raport rădăcină este deschis dintr-unul dintre meniurile principale ale aplicației de contabilitate, toate variantele sale sunt afișate în selectorul de variante din colțul din dreapta sus al vizualizării.
Example
În imaginea următoare, Raport TVA (BE) este varianta rădăcinii Raport fiscal general.
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.
Motorul «Domeniu Odoo»¶
Cu acest motor, o formulă este interpretată ca un domeniu Odoo 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.
suma_dacă_pozitivăRezultatul este suma tuturor soldurilor liniilor de mutare potrivite dacă această sumă este pozitivă. În caz contrar, este
0.suma_dacă_negativăRezultatul 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.
De asemenea, puteți pune un semn - la începutul subformulei pentru a inversa semnul rezultatului.
Motorul «Agregare alte formule»¶
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 „suma” 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.
Motorul «Prefixul codurilor de cont»¶
Acest motor este folosit pentru a potrivi sumele realizate pe conturi folosind prefixele codurilor acestor conturi ca variabile într-o expresie aritmetică.
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)Dacă eticheta la care faceți referire este definită într-un fișier de date, poate fi folosit un xmlid în loc de 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.Motorul «Valoare externă»¶
Motorul «valoare externă» este folosit pentru a se referi la manual și carryover valori. Aceste valori nu sunt stocate folosind account.move.line, dar cu account.report.external.value. Fiecare dintre aceste obiecte se referă direct la expresia care le afectează, astfel încât foarte puțin trebuie făcut despre selecția lor aici.
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=2Motorul «Funcție Python personalizată»¶
Acest motor este un mijloc pentru dezvoltatori pentru a introduce calculul personalizat al expresiilor pe o bază caz la caz. Formula este numele unei funcții python pentru a apela, iar subformula este o cheie pentru a prelua în dicționarul returnat de această funcție. Folosiți-l numai dacă faceți un modul personalizat al dvs.
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ă.
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.
Vedeți și