Anpassade rapporter¶
Odoo levereras med ett kraftfullt och lättanvänt rapporteringsramverk. Motorn gör att du kan skapa nya rapporter, till exempel skatterapporter, eller balansräkningar och resultaträkningar med specifika grupperingar och layouter.
Viktigt
Aktivera utvecklarläge för att få tillgång till gränssnittet för skapande av redovisningsrapporter.
To create a new report, open the Accounting app and navigate to . From here, you can either create a root report or a variant.
Rotrapporter¶
Rotrapporter kan betraktas som generiska, neutrala redovisningsrapporter. De fungerar som modeller på vilka lokala bokföringsversioner byggs upp. Om en rapport inte har någon rotrapport, anses den själv vara en rotrapport.
Example
En skatterapport för Belgien och USA skulle båda använda samma generiska version som bas och anpassa den till sina nationella bestämmelser.
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 .
Observera
Fall som kräver att en ny rotrapport skapas är sällsynta, till exempel när ett lands skattemyndigheter kräver en ny och specifik typ av rapport.
Varianter¶
Varianter är landsspecifika versioner av rotrapporter och hänvisar därför alltid till en rotrapport. Om du vill skapa en variant väljer du en generisk rapport (rotrapport) i fältet Root Report när du skapar en ny rapport.
När en rotrapport öppnas från någon av bokföringsappens huvudmenyer visas alla dess varianter i variantväljaren i det övre högra hörnet av vyn.
Example
I följande bild är VAT Report (BE) varianten av roten 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.
Uttryck¶
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.
Observera
Beroende på motorn kan subformulas också krävas.
Motorn ”Odoo Domain¶
Med denna motor tolkas en formel som en Odoo-domän som riktar sig till account.move.line-objekt.
Med hjälp av underformeln kan du definiera hur de flyttlinjer som matchar domänen används för att beräkna värdet på uttrycket:
summaResultatet är summan av alla saldon för de matchade flyttraderna.
summa_if_posResultatet är summan av alla saldon för de matchade flyttraderna om detta belopp är positivt. I annat fall är det ”0”.
summa_om_negResultatet är summan av alla saldon för de matchade flyttraderna om detta belopp är negativt. I annat fall är det ”0”.
räkna_raderThe 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.
Du kan också sätta ett --tecken i början av delformeln för att vända tecknet på resultatet.
Motorn ”Aggregera andra formler¶
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).
Subformler kan vara något av följande:
if_above(CUR(belopp))Värdet på det aritmetiska uttrycket returneras endast om det är större än den angivna gränsen. I annat fall blir resultatet
0.if_below(CUR(belopp))Värdet på det aritmetiska uttrycket returneras endast om det är lägre än den angivna gränsen. I annat fall blir resultatet
0.if_between(CUR1(belopp1), CUR2(belopp2))Värdet på det aritmetiska uttrycket returneras endast om det ligger strikt mellan de angivna gränserna. Annars kommer det att återföras till den närmaste gränsen.
if_other_expr_above(LINE_CODE.EXPRESSION_LABEL, CUR(amount))Värdet på det aritmetiska uttrycket returneras endast om värdet på det uttryck som anges med den angivna radkoden och uttrycketiketten är större än den angivna gränsen. I annat fall blir resultatet
0.if_other_expr_below(LINE_CODE.EXPRESSION_LABEL, CUR(amount))Värdet på det aritmetiska uttrycket returneras endast om värdet på det uttryck som anges med den angivna radkoden och uttrycketiketten är lägre än den angivna gränsen. I annat fall blir resultatet
0.
CUR är valutakoden i versaler och belopp är beloppet för den bundna betalningen uttryckt i den valutan.
Du kan också använda subformeln cross_report för att matcha ett uttryck som finns i en annan rapport.
Motorn ”Prefix för kontokoder¶
Denna motor används för att matcha belopp som gjorts på konton med hjälp av prefixen för dessa kontons koder som variabler i ett aritmetiskt uttryck.
Example
21Example
21 + 10 - 521 och 10 och subtraherar saldot för dem på konton med prefixet 5.Det är också möjligt att ignorera ett urval av subrefix.
Example
21 + 10\(101, 102) - 5\(57)101, 102 och 57.Du kan tillämpa ”underfiltrering” på krediter och debiteringar med hjälp av suffixen C och D. I detta fall kommer ett konto endast att beaktas om dess prefix matchar, och om det totala saldot för de flyttrader som gjorts på detta konto är kredit/debit.
Example
Konto 210001 har ett saldo på -42 och konto 210002 har ett saldo på 25. Formeln 21D matchar endast kontot 210002 och returnerar därför 25. 210001 matchas inte, eftersom dess saldo är kredit.
Prefixuteslutningar kan kombineras med suffixen C och D.
Example
21 om det är debet (D) och 10 om det är kredit (C), men ignorerar prefixen 101, 102, och subtraherar saldot för dem på konton med prefixet 5, ignorerar prefixet 57.För att matcha bokstaven C eller D i ett prefix och inte använda den som suffix, använd en tom uteslutning ().
Example
21D\()Förutom att använda kodprefix för att inkludera konton kan du också matcha dem med kontotaggar. Detta är särskilt användbart om ditt land till exempel saknar en standardiserad kontoplan, där samma prefix kan användas för olika ändamål i olika företag.
Example
tag(25)Om taggen som du refererar till är definierad i en datafil kan en xmlid användas i stället för id.
Example
tag(min_modul.min_tag)Du kan också använda aritmetiska uttryck med taggar och eventuellt kombinera dem med prefixval.
Example
tag(min_modul.min_tag) + tag(42) + 1010Suffixen C och D kan användas på samma sätt som taggar.
Example
tag(min_modul.min_tag)CPrefixuteslutning fungerar också med taggar.
Example
tag(min_modul.min_tag)\(10)10.Motor för ”externt värde¶
Motorn ”externt värde” används för att hänvisa till manuella och överförda värden. Dessa värden lagras inte med hjälp av account.move.line, utan med account.report.external.value. Vart och ett av dessa objekt pekar direkt på det uttryck som det påverkar, så mycket lite behöver göras om deras val här.
Formler kan vara en av följande:
summaOm resultatet ska vara summan av alla externa värden under perioden.
most_recentOm resultatet ska vara värdet av det senaste externa värdet under perioden.
Dessutom kan subformler användas på två sätt:
- avrundning=X
Om du ersätter ”X” med ett tal avrundas beloppet till X decimaler.
- ”redigerbar
Indikerar att detta uttryck kan redigeras manuellt, vilket utlöser visning av en ikon i rapporten som gör det möjligt för användaren att utföra denna åtgärd.
Observera
Manuella värden skapas vid det ”date_to” som för närvarande är valt i rapporten.
Båda delformlerna kan blandas genom att separera dem med ett ;.
Example
Motorn ”Anpassad Python-funktion¶
Denna motor är ett sätt för utvecklare att införa anpassad beräkning av uttryck från fall till fall. Formeln är namnet på en python-funktion som ska anropas och underformeln är en nyckel som ska hämtas i den ordbok som returneras av denna funktion. Använd den endast om du gör en egen anpassad modul.
Kolumner¶
Rapporter kan ha ett obegränsat antal kolumner att visa. Varje kolumn får sina värden från de uttryck som deklareras på raderna. Fältet expression_label i kolumnen anger etiketten för de uttryck vars värde visas. Om en rad inte har något uttryck i det fältet visas ingenting för den i den här kolumnen. Om flera kolumner krävs måste du använda olika expression-etiketter.
När du använder funktionen periodjämförelse som finns under fliken Options i en redovisningsrapport, upprepas alla kolumner i och för varje period.
Radgruppering¶
Icke-standardgruppering är möjlig genom att lägga till eller använda befintliga fält i modellen Affärshändelse, förutsatt att fälten är relaterade och icke-lagrade.
Observera
Gruppering av rader kräver att rapporten har explicita rapportrader som kan redigeras. De uppskjutna rapporterna stöder till exempel inte gruppering av rader eftersom de använder dynamiska rader som genereras.
Skapa ett nytt fält för affärshändelse¶
För att skapa ett icke-lagrat, relaterat fält i modellen Affärshändelse, gå först till och klicka på ikonen (bug), klicka sedan på Fält. Klicka på Skapa för att skapa ett nytt fält och fyll i följande fält:
Fältnamn: ett tekniskt namn för fältet
Fältetikett: etiketten som ska visas för fältet
Fälttyp: typen av fält som detta relaterade fält ska peka på
Lagrat: Lämna detta fält omarkerat eftersom endast icke-lagrade fält kan användas för att gruppera rader.
Relaterad modell: Om fälttypen är en till många, många till många eller många till en, välj modellen för det ursprungliga fältet att gruppera efter.
Relaterad fältdefinition: den tekniska sökvägen till fältet du vill gruppera efter
Example
För att gruppera efter säljteamet för den kommersiella partnern, ställ in den relaterade fältdefinitionen till
move_id.team_id.
Gruppera rader¶
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.
Tips
För att hitta en lista över alla modellens fält och deras tekniska namn, gå till och klicka på ikonen (bug), klicka sedan på Fält. Det tekniska namnet för varje fält visas i kolumnen Fältnamn.
Custom tax report setup¶
Report configuration¶
Tips
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.
Tips
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.
Se även