Reportes personalizados

Odoo comes with a powerful and easy-to-use reporting framework. The engine allows you to create new reports, such as tax reports, balance sheets, and income statements with specific groupings and layouts.

Importante

Activate the developer mode to access the accounting report configuration.

To create a new report, go to Accounting ‣ Configuration ‣ Accounting Reports. From here, create either a root report or a variant.

Truco

• Consider saving modified reports as report variants to keep their root reports intact.

• To access an existing report’s management interface from the report itself, click on the (gears) icon.

Reporte principal

Los reportes principales pueden considerarse como reportes contables genéricos y sirven como modelo sobre los que se construyen las versiones de contabilidad locales. Si al crear uno no se le asigna un reporte principal, entonces se considera que ese reporte es un reporte principal.

Example

Los reportes fiscales para Bélgica y Estados Unidos utilizarían la misma versión genérica como base y la adaptarían a sus normas nacionales.

Creating a menu item is required to access a new root report. To do so, open the report’s configuration, click Action, Create Menu Item, and refresh the page. The report is now available under Accounting ‣ Reporting.

Nota

Los casos en los que es necesario crear un nuevo reporte principal no son comunes. Un ejemplo podría ser cuando las autoridades fiscales de un país solicitan un tipo nuevo y específico.

Variantes

Las variantes son versiones específicas de los reportes principales, así que siempre hacen referencia a un reporte principal. Para crear una variante, seleccione un reporte genérico (principal) en el campo Reporte principal al crear uno nuevo.

When a root report is opened from the Accounting app’s Reporting menu, all of its variants are displayed in the report variant selector in the top right corner of the view.

Example

VAT Report (BE) is a variant of the root Generic Tax report.

Líneas

After creating a report (either root or variant), the next step is to fill it with lines. To create a new line, click on Add a line. To modify an existing line, click on the line itself and edit the popup. All lines require a Name and can have an optional Code which allows using the line’s value in formulas.

Expresiones

Each 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 line’s popup.

When creating an expression, you must enter a Label used to refer to that expression. The label must be unique among the expressions of each report line. Both the Computation Engine and the Formula fields must also be completed. The computation engine defines how the formula(s) and subformula(s) are interpreted. It is possible to mix expressions using different computation engines under the same line if needed.

Nota

Es posible que deba incluir subfórmulas, eso depende del motor que elija.

Odoo Domain computation engine

When using the Odoo Domain computation engine, a formula is interpreted as an Odoo domain targeting account.move.line objects.

La subfórmula le permite definir cómo se utilizan las líneas de movimiento que coinciden con el dominio para calcular el valor de la expresión:

sum

El resultado es la suma de todos los balances de las líneas de movimiento correspondientes.

sum_if_pos

El resultado es la suma de todos los balances de las líneas de movimiento correspondientes si el importe es positivo, de lo contrario es 0.

sum_if_neg

El resultado es la suma de todos los balances de las líneas de movimiento correspondientes si el importe es negativo, de lo contrario es 0.

count_rows

The result is the number of sub-lines of this expression. If the parent 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.

Truco

To reverse the sign of the result, put a - sign at the beginning of the subformula.

Tax Tags computation engine

When using the Tax Tags computation engine, the contents of the Formula field are matched to tax tags. If such tags do not exist when creating the expression, they will be created.

Al evaluar la expresión, su cálculo puede expresarse de la siguiente manera: (cantidad de líneas de movimiento con la etiqueta +`**)** `- (cantidad de líneas de movimiento con la etiqueta - ).

Example

If the Formula is set to 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 computation engine

The Aggregate Other Formulas computation engine performs arithmetic operations on the amounts obtained from 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 parent line’s code followed by a period . and the expression’s label (ex. code.label).

Las subfórmulas pueden ser las siguientes:

if_above(CUR(amount))

Se devolverá el valor de la expresión aritmética solo si es mayor que el límite proporcionado. De lo contrario, el resultado será 0.

if_below(CUR(amount))

Se devolverá el valor de la expresión aritmética solo si es menor que el límite proporcionado. De lo contrario, el resultado será 0.

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

Se devolverá el valor de la expresión aritmética solo si se encuentra entre los límites proporcionados. De lo contrario, se devolverá al límite más cercano.

if_other_expr_above(LINE_CODE.EXPRESSION_LABEL, CUR(amount))

Se devolverá el valor de la expresión aritmética solo si el valor indicado por el código de línea y la etiqueta de expresión es mayor que el límite establecido. De lo contrario, el resultado será 0.

if_other_expr_below(LINE_CODE.EXPRESSION_LABEL, CUR(amount))

Se devolverá el valor de la expresión aritmética solo si el valor indicado por el código de línea y la etiqueta de expresión es inferior al límite establecido. De lo contrario, el resultado será 0.

CUR es el código de la divisa en mayúsculas e importe es el importe del límite expresado en esa divisa.

También puede utilizar la subfórmula cross_report para que coincida con una expresión en otro reporte.

Prefix of Account Codes computation engine

The Prefix of Account Codes computation engine is used to match amounts made on accounts using the prefixes of these accounts” codes as variables in an arithmetic expression.

Example

21

Las expresiones aritméticas también pueden tener un solo prefijo, como en este caso.

Example

21 + 10 - 5

Esta fórmula suma los balances de las líneas de movimiento realizadas en cuentas cuyos códigos comienzan con 21 y 10, y resta el balance de aquellas en cuentas con el prefijo 5.

También es posible ignorar una selección de subprefijos.

Example

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

Esta fórmula funciona de la misma manera que el ejemplo anterior, pero ignora los prefijos 101, 102 y 57.

También puede aplicar un «subfiltrado» en los abonos y cargos con los sufijos C y D. En este caso, se considerará una cuenta solo si su prefijo coincide y si el balance total de las líneas de movimiento realizadas en esta cuenta es un abono o cargo.

Example

La cuenta 210001 tiene un balance de -42 y la cuenta 210002 tiene un balance de 25. La fórmula 21D solo coincide con la cuenta 210002, por lo que devuelve 25. La cuenta 210001 no coincide, ya que es de crédito.

Las exclusiones de prefijos se pueden combinar con los sufijos C y D.

Example

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

Esta fórmula suma los balances de las líneas de movimiento realizadas en cuentas cuyos códigos empiezan con 21 si es de débito (D) o 10 si es crédito (C), pero ignora los prefijos 101 y 102 y resta el balance de las realizadas en las cuentas con el prefijo 5 e ignora el prefijo 57.

Use una exclusión vacía () para que la letra C o D coincida con un prefijo y no se utilice como sufijo.

Example

21D\()

Esta fórmula coincide con las cuentas cuyo código empieza con 21D, sin importar el signo de su balance.

Además de utilizar prefijos de código para incluir cuentas, también puede hacer que coincidan con las etiquetas de cuenta. Esto es muy útil, por ejemplo, si su país no tiene un plan de cuentas estandarizado, donde podría usarse el mismo prefijo para diferentes propósitos en distintas empresas.

Example

etiqueta(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

etiqueta(mi_módulo.mi_etiqueta)

Esta fórmula devuelve las cuentas cuyas etiquetas asociadas incluyen la etiqueta denominada mi_módulo.mi_etiqueta.

También puede utilizar expresiones aritméticas con etiquetas y, si es necesario, puede combinarlas con selecciones de prefijos.

Example

etiqueta(mi_módulo.mi_etiqueta) + etiqueta(42) + 10

Los balances de las cuentas etiquetadas como mi_módulo.mi_etiqueta se sumarán a los de las cuentas vinculadas a la etiqueta con el ID 42 y las cuentas con el prefijo de código 10.

Los sufijos C y D se pueden utilizar de la misma forma con las etiquetas.

Example

etiqueta(mi_módulo.mi_etiqueta)C

Esta fórmula devuelve las cuentas con la etiqueta mi_módulo.mi_etiqueta y un saldo positivo.

La exclusión de prefijos también funciona con las etiquetas.

Example

etiqueta(mi_módulo.mi_etiqueta)\(10)

Esta fórmula devuelve las cuentas con la etiqueta mi_modulo.mi_etiqueta y un código que no empieza con 10.

External Value computation engine

The External Value computation 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.

Las fórmulas pueden ser las siguientes:

sum

Si el resultado debe ser la suma de todos los valores externos del periodo.

most_recent

Si el resultado debe ser el valor del último valor externo del periodo.

Además puede usar las subfórmulas de dos formas:

rounding=X

Reemplazar X con un número indica que se debe redondear el importe a X decimales.

editable

Indica que puede editar esta expresión de forma manual. Aparecerá un icono en el reporte para que el usuario pueda realizar esta acción.

Nota

Los valores manuales se crean en la date_to seleccionada en el reporte.

Ambas fórmulas se pueden usar al mismo tiempo al separarlas con ;.

Example

editable;rounding=2

This subformula shows the correct way to mix both behaviors.

Custom Python Function computation engine

The Custom Python Function computation 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 this computation engine only if making a custom module.

Columnas

Los reportes pueden tener un número indefinido de columnas. Cada columna obtiene sus valores de las expresiones declaradas en las líneas. El campo expression_label de la columna proporciona la etiqueta de las expresiones cuyo valor se muestra. Si una línea no tiene ninguna expresión en ese campo, entonces no se mostrará nada para ella en esa columna. Si se necesitan varias columnas debe utilizar diferentes etiquetas de expresión.

Todas las columnas se repiten en y para cada periodo cuando utiliza la función de comparación de periodos que se encuentra en la pestaña Opciones de un reporte contable.

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.

Nota

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.

Truco

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.

Ver también

Consolidation via grouping by account code