Anpassade rapporter

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.

Viktigt

Activate the developer mode to access the accounting report creation interface.

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.

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 Accounting ‣ Reporting.

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.

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.

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.

’Odoo Domain’ engine

With this engine, a formula is interpreted as an Odoo domain targeting account.move.line objects.

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:

summa

Resultatet är summan av alla saldon för de matchade flyttraderna.

summa_if_pos

Resultatet är summan av alla saldon för de matchade flyttraderna om detta belopp är positivt. I annat fall är det ”0”.

summa_om_neg

Resultatet är summan av alla saldon för de matchade flyttraderna om detta belopp är negativt. I annat fall är det ”0”.

räkna_rader

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.

You can also put a - sign at the beginning of the subformula to reverse the sign of the result.

’Tax Tags’ engine

A formula made for this engine consists of a name used to match tax tags. If such tags do not exist when creating the expression, they will be created.

Vid utvärdering av uttrycket kan uttrycksberäkningen grovt sett uttryckas som: (antal flyttrader med + tag) - (antal flyttrader med - tag).

Example

If the formula is tag_name, the engine matches tax tags +tag_name and -tag_name, creating them if necessary. To exemplify further: two tags are matched by the formula. If the formula is A, it will require (and create, if needed) tags +A and -A.

’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).

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.

’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

21

Aritmetiska uttryck kan också bestå av ett enda prefix, t.ex. här.

Example

21 + 10 - 5

Denna formel adderar saldona för de flyttrader som gjorts på konton vars koder börjar med 21 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)

Formeln fungerar på samma sätt som i föregående exempel, men ignorerar prefixen 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

21D + 10(101, 102)C - 5(57)`

Denna formel adderar saldona för de flyttrader som gjorts på konton vars kod börjar med 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\()

Denna formel matchar konton vars kod börjar med ”21D”, oavsett deras saldotecken.

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)

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(min_modul.min_tag)

Denna formel matchar konton vars associerade taggar innehåller den tagg som anges av min_modul.min_tagg.

Du kan också använda aritmetiska uttryck med taggar och eventuellt kombinera dem med prefixval.

Example

tag(min_modul.min_tag) + tag(42) + 10

Saldona för konton som märkts med my_module.my_tag kommer att summeras med saldona för konton som är kopplade till taggen med ID 42 och konton med kodprefixet 10

Suffixen C och D kan användas på samma sätt som taggar.

Example

tag(min_modul.min_tag)C

Denna formel matchar konton med taggen min_modul.min_tagg och ett kreditsaldo.

Prefixuteslutning fungerar också med taggar.

Example

tag(min_modul.min_tag)\(10)

Denna formel matchar konton med taggen my_module.my_tag och en kod som inte börjar med 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.

Formler kan vara en av följande:

summa

Om resultatet ska vara summan av alla externa värden under perioden.

most_recent

Om 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

redigerbar;avrundning=2

is a correct subformula mixing both behaviors.

’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.

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.

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.

Observera

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 Accounting ‣ Journal Items, 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.

Tips

To find a list of all the model’s fields and their technical names, go to Accounting ‣ Journal Items, and click the (bug) icon, then click Fields. The technical name of each field is listed in the Field Name column.

Se även

Consolidation via grouping by account code

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

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 Configuration ‣ Taxes, select the tax, and click the (settings adjust) icon. From there, check the Tax Closing Entry box to adjust its visibility.

Se även

Tax closing