Custom reports

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.

Importante

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

Para criar um novo relatório, abra o aplicativo Financeiro e navegue até Configuração ‣ Relatórios Contábeis. A partir daqui, você pode criar um relatório raiz ou uma variante.

Root reports

Root reports can be regarded as generic, neutral accounting reports. They serve as models on which local accounting versions are built. If a report has no root report, it is considered to be a root report itself.

Example

A tax report for Belgium and the US would both use the same generic version as a base and adapt it for their domestic regulations.

Ao criar um novo relatório raiz, você precisa criar um item de menu para ele. Para fazer isso, abra o relatório e, nesse mesmo relatório, clique no ícone (Ações), depois selecione Criar Item de Menu. Atualize a página; o relatório agora está disponível em Financeiro ‣ Relatórios.

Nota

Cases that require creating a new root report are rare, such as when a country’s tax authorities require a new and specific type of report.

Variantes

Variants are country-specific versions of root reports and, therefore, always refer to a root report. To create a variant, select a generic (root) report in the Root Report field when creating a new report.

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.

Linhas do relatório

Após ter criado um relatório (raiz ou variante), você precisa preenchê-lo com linhas de relatório. Você pode criar uma nova clicando em Adicionar uma linha, ou modificar uma linha de relatório existente clicando nela. Todas as linhas de relatório exigem um Nome e podem ter um Código adicional opcional (de sua escolha) se você desejar usar seu valor em fórmulas.

Expressão

Cada linha de relatório pode conter uma ou múltiplas expressões. Expressões podem ser vistas como sub-variáveis necessárias por uma linha de relatório. Para criar uma expressão, clique em Adicionar uma linha dentro de uma linha de relatório.

Ao criar uma expressão, você deve atribuir um Rótulo usado para se referir a essa expressão. Portanto, ele deve ser único entre as expressões de cada linha. Tanto um Motor de Computação quanto uma Fórmula também devem ser indicados. O motor define como sua(s) fórmula(s) e subfórmula(s) são interpretadas. É possível misturar expressões usando diferentes motores de computação sob a mesma linha, se necessário.

Nota

Depending on the engine, subformulas may also be required.

‘Odoo Domain’ engine

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

The subformula allows you to define how the move lines matching the domain are used to compute the value of the expression:

sum

The result is the sum of all the balances of the matched move lines.

sum_if_pos

The result is the sum of all the balances of the matched move lines if this amount is positive. Otherwise, it is 0.

sum_if_neg

The result is the sum of all the balances of the matched move lines if this amount is negative. Otherwise, it is 0.

count_rows

O resultado é o número de sub-linhas desta expressão. Se a linha do relatório tiver um valor de agrupamento, isso corresponderá ao número de chaves de agrupamento distintas nas linhas de lançamento correspondentes. Caso contrário, será o número de linhas de lançamento correspondentes.

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.

When evaluating the expression, the expression computation can roughly be expressed as: (amount of the move lines with + tag) - (amount of the move lines with - 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 este mecanismo quando você precisar realizar operações aritméticas nos valores obtidos para outras expressões. As fórmulas aqui são compostas de referências a expressões separadas por um dos quatro operadores aritméticos básicos (adição +, subtração -, divisão / e multiplicação *). Para fazer referência a uma expressão, digite o código da linha do relatório seguido de um ponto . e o rótulo da expressão (ex. código.rótulo).

Subformulas can be one of the following:

if_above(CUR(amount))

The value of the arithmetic expression will be returned only if it is greater than the provided bound. Otherwise, the result will be 0.

if_below(CUR(amount))

The value of the arithmetic expression will be returned only if it is lower than the provided bound. Otherwise, the result will be 0.

if_between(CUR1(amount1), CUR2(amount2))

The value of the arithmetic expression will be returned only if it is strictly between the provided bounds. Otherwise, it will be brought back to the closest bound.

if_other_expr_above(LINE_CODE.EXPRESSION_LABEL, CUR(amount))

The value of the arithmetic expression will be returned only if the value of the expression denoted by the provided line code and expression label is greater than the provided bound. Otherwise, the result will be 0.

if_other_expr_below(LINE_CODE.EXPRESSION_LABEL, CUR(amount))

The value of the arithmetic expression will be returned only if the value of the expression denoted by the provided line code and expression label is lower than the provided bound. Otherwise, the result will be 0.

CUR is the currency code in capital letters, and amount is the amount of the bound expressed in that currency.

You can also use the cross_report subformula to match an expression found in another report.

‘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

Arithmetic expressions can also be a single prefix, such as here.

Example

21 + 10 - 5

This formula adds the balances of the move lines made on accounts whose codes start with 21 and 10, and subtracts the balance of the ones on accounts with the prefix 5.

It is also possible to ignore a selection of sub-prefixes.

Example

21 + 10\(101, 102) - 5\(57)

This formula works the same way as the previous example but ignores the prefixes 101, 102, and 57.

You can apply ‘sub-filtering’ on credits and debits using the C and D suffixes. In this case, an account will only be considered if its prefix matches, and if the total balance of the move lines made on this account is credit/debit.

Example

Account 210001 has a balance of -42 and account 210002 has a balance of 25. The formula 21D only matches the account 210002, and hence returns 25. 210001 is not matched, as its balance is credit.

Prefix exclusions can be mixed with the C and D suffixes.

Example

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

This formula adds the balances of the move lines made on accounts whose code starts with 21 if it is debit (D) and 10 if it is credit (C), but ignores prefixes 101, 102, and subtracts the balance of the ones on accounts with the prefix 5, ignoring the prefix 57.

To match the letter C or D in a prefix and not use it as a suffix, use an empty exclusion ().

Example

21D\()

This formula matches accounts whose code starts with 21D, regardless of their balance sign.

In addition to using code prefixes to include accounts, you can also match them with account tags. This is especially useful, for example, if your country lacks a standardized chart of accounts, where the same prefix might be used for different purposes across companies.

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(my_module.my_tag)

This formula matches accounts whose associated tags include the tag denoted by my_module.my_tag.

You can also use arithmetic expressions with tags, possibly combining them with prefix selections.

Example

tag(my_module.my_tag) + tag(42) + 10

The balances of accounts tagged as my_module.my_tag will be summed with those of accounts linked to the tag with ID 42 and accounts with the code prefix 10

C and D suffixes can be used in the same way with tags.

Example

tag(my_module.my_tag)C

This formula matches accounts with the tag my_module.my_tag and a credit balance.

Prefix exclusion also works with tags.

Example

tag(my_module.my_tag)\(10)

This formula matches accounts with the tag my_module.my_tag and a code not starting with 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.

Formulas can be one of the following:

sum

If the result must be the sum of all the external values in the period.

most_recent

If the result must be the value of the latest external value in the period.

In addition, subformulas can be used in two ways:

rounding=X

Replacing X with a number instructs to round the amount to X decimals.

editable

Indicates this expression can be edited manually, triggering the display of an icon in the report, allowing the user to perform this action.

Nota

Manual values are created at the date_to currently selected in the report.

Both subformulas can be mixed by separating them with a ;.

Example

editable;rounding=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.

Colunas

Reports can have an indefinite number of columns to display. Each column gets its values from the expressions declared on the lines. The field expression_label of the column gives the label of the expressions whose value is displayed. If a line has no expression in that field, then nothing is displayed for it in this column. If multiple columns are required, you must use different expression labels.

When using the period comparison feature found under the Options tab of an accounting report, all columns are repeated in and for each period.

Configuração de relatório fiscal personalizado

Configuração do relatório

Dica

Todos os termos técnicos e funções do mecanismo de relatórios do Odoo estão explicados nas seções anteriores desta página. Recomendamos fortemente a leitura dessas seções antes de configurar um relatório fiscal personalizado.

Para criar um relatório fiscal personalizado, abra o aplicativo Financeiro, navegue até Configuração ‣ Relatórios Contábeis e clique em Novo:

• Digite um nome para o seu relatório.

• Selecione um Relatório Raiz.

• No campo Disponibilidade, selecione País Corresponde e, em seguida, selecione o País correspondente à sua empresa.

Em seguida, crie uma linha de relatório clicando em Adicionar uma linha. Uma vez criada, clique nessa linha de relatório para configurá-la:

• Clique em Adicionar uma linha novamente para criar uma Expressão e nomeie-a.

• Na guia Definição, selecione um Mecanismo de Cálculo para essa expressão dependendo dos seguintes cenários:

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

Neste cenário, sua empresa usa grades de impostos:

• Selecione Etiquetas Fiscais como mecanismo de cálculo. O Odoo usa este campo para vincular a linha do relatório aos seus impostos.

• No campo Fórmula, digite seu identificador curto de grade (por exemplo, vat_sales_base). O Odoo gera automaticamente as variantes + e - desta etiqueta para você mapear dentro de Configuração ‣ Impostos.

• No campo Subfórmula, digite base para reportar o valor sem impostos, ou tax para reportar o valor real do imposto cobrado/pago.

Repita este processo conforme necessário. Em seguida, Salvar e Fechar.

Como alternativa, você pode:

• Selecione Agregar Outras Fórmulas como mecanismo de cálculo. O Odoo usa este campo para realizar cálculos em linhas já presentes no relatório em vez de escanear transações brutas.

• No campo Fórmula, use álgebra básica referenciando seus códigos de linha (por exemplo, LINE_10 - LINE_20).

Repita este processo conforme necessário. Em seguida, Salvar e Fechar.

Na aba Opções de uma Expressão, preencha o campo Transportar Para com uma fórmula para sempre transportar saldos ou transportá-los apenas quando o valor for negativo. Deixe este campo em branco se não quiser usar este recurso.

Example

if_below(EUR(0))

Esta fórmula transportará apenas valores abaixo de 0,00 EUR.

Configuração de impostos

Em seguida, vá para Configuração ‣ Impostos e clique em Novo para criar e configurar novos impostos para seu relatório fiscal personalizado. Crie seus impostos de Vendas e Compras e preencha as Grades Fiscais para todos os impostos usando as grades fiscais correspondentes que você criou anteriormente. Por fim, certifique-se de especificar uma conta de impostos a pagar e uma conta de impostos a receber para cada imposto.

Example

Lançamento de fechamento

Para fechar impostos, um grupo de impostos deve ser especificado em cada imposto usado no seu relatório fiscal personalizado. Para fazer isso, abra o aplicativo Financeiro, navegue até Configuração ‣ Impostos, abra um imposto que requer um grupo de impostos, clique na aba Opções Avançadas e selecione um grupo no campo Grupo de Impostos. Após atribuir, clique no ícone (seta para a direita) e defina tanto uma Conta de Imposto a Pagar quanto uma Conta de Imposto a Receber.

Dica

• Quando tudo estiver configurado, certifique-se de testar seu relatório criando faturas, contas a pagar e notas de crédito usando os impostos específicos para esse relatório. Por fim, teste o próprio lançamento de fechamento.

• Se você deseja ocultar uma conta específica de ser exibida no lançamento de fechamento fiscal, vá para Configuração ‣ Impostos, selecione o imposto e clique no ícone (ajustar configurações). A partir daí, marque a caixa Lançamento de Fechamento Fiscal para ajustar sua visibilidade.

Veja também

Fechamento fiscal