Reportes personalizados

Odoo dispone de un marco de reportes avanzado y fácil de usar. Esta herramienta le permite crear nuevos reportes como reportes fiscales, balances generales y estados de resultados con grupos y diseños específicos.

Importante

Active el modo de desarrollador para acceder a la interfaz de creación de reportes contables.

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.

Reporte raíz

Los reportes raíz se pueden considerar como reportes contables generales; sirven como modelos sobre los que se construyen las versiones de contabilidad locales. Si se crea un reporte y no se le asigna un reporte raíz, se considera que dicho reporte es un reporte raíz.

Example

Un reporte fiscal para Bélgica y Estados Unidos usará la misma versión general como base y se adaptará según sus normativas nacionales.

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.

Nota

No es normal encontrarse casos que requieran crear un nuevo reporte raíz, un ejemplo de casos que lo necesitan son los reportes específicos que exigen algunas autoridades fiscales.

Variantes

Las variantes son versiones específicas de los reportes raíz, por lo que siempre van a referirse a un reporte raíz. Para crear una variante, selecciona un reporte raíz general en reporte raíz al crear un nuevo reporte.

Cuando se abre un reporte raíz desde uno de los menús principales de la aplicación Contabilidad, aparecerán todas sus variantes en el selector de variantes situado en la esquina superior derecha de la vista.

Example

La siguiente imagen, reporte de IVA (BE) es una variante del reporte raíz reporte general de impuestos.

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.

opciones de la herramienta de líneas

Expresiones

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.

Nota

En algunos casos también va a ser necesario definir subfórmulas.

Motor del dominio de Odoo

Este motor identifica una fórmula como un dominio de Odoo cuyo destino son los objetos account.move.line.

La subformula le permite definir el uso de 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 coincidentes.

sum_if_pos

El resultado es la suma de todos los balances de las líneas de movimiento coincidentes 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 coincidentes 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 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.

Si coloca el signo - al principio de la subfórmula, el resultado tendrá un signo invertido.

Línea de expresión dentro de una línea de reporte

Etiquetas de impuestos

Cualquier fórmula creada mediante este motor tendrá un nombre que permita que coincidan con las etiquetas de impuestos. Si dichas etiquetas no existen al crear la expresión, se crearán.

Cuando se evalúa la expresión, su cálculo puede expresarse de la siguiente manera: (cantidad de líneas de movimiento con + etiqueta) - (cantidad de líneas de movimiento con - etiqueta).

Example

Si la fórmula es nombre_etiqueta, el motor compara las etiquetas de impuestos +nombre_etiqueta y -nombre_etiqueta, y las crea si es necesario. Para ejemplificar, la fórmula coincide con dos etiquetas; si la fórmula es A, necesitará (y creará, si es necesario) las etiquetas +A y -A.

Agregar otras fórmulas

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

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 encontrada en otro reporte.

Prefijo de los códigos de cuenta

Este motor se utiliza para hacer coincidir los importes realizados en las cuentas mediante los prefijos de los códigos de estas cuentas como variables de una expresión aritmética.

Example

21
Las expresiones aritméticas también pueden tener solo un prefijo, como aquí.

Example

21 + 10 - 5
Esta fórmula suma los balances de las líneas de movimiento realizadas en cuentas cuyos códigos empiezan por 21 y 10, y resta el balance de las realizadas 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 igual que en el ejemplo anterior, solo que en este caso no se tienen en cuenta los prefijos 101, 102 y 57.

También puede aplicar un «subfiltrado» en los créditos y débitos utilizando los sufijos C y D. En este caso, solo se tendrá en cuenta una cuenta si su prefijo coincide, y si el balance total de las líneas de movimiento realizadas en esta cuenta es de crédito/débito.

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 su saldo es de crédito.

Se pueden mezclar las exclusiones de los prefijos 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 por 21 si es débito (D) y 10 si es crédito (C) pero ignora los prefijos 101 y 102, y resta el balance de las realizadas en cuentas con el prefijo 5, sin tomar en cuenta el prefijo 57.

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

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 cuentas. Esto es muy útil, por ejemplo, si su país no tiene un plan de cuentas estandarizado, donde es posible que se use el mismo prefijo para diferentes propósitos de una empresa a otra.

Example

etiqueta(25)
Esta fórmula devuelve las cuentas con las etiquetas asociadas que incluyen el ID 25.

Si la etiqueta a la que hace referencia está definida en un archivo de datos, puede usar XMLID en lugar del ID.

Example

etiqueta(mi_módulo.mi_etiqueta)
Esta fórmula devuelve las cuentas con las etiquetas asociadas a la etiqueta indicada por mi_módulo.mi_etiqueta.

También puede usar expresiones aritméticas con etiquetas y tiene la posibilidad de combinarlas con selecciones de prefijo.

Example

etiqueta(mi_módulo.mi_etiqueta) + etiqueta(42) + 10
Los saldos de las cuentas etiquetadas como mi_módulo.mi_etiqueta se sumarán con 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.

Valor externo

La herramienta “valor externo” se utiliza para referirse a los valores manuales y traspasados. Estos valores no se almacenan con account.move.line, sino con account.report.external.value. Cada uno de estos objetos dirige directamente a la expresión sobre la que actúa, por lo que no hace falta hacer mucho para seleccionarlos.

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

Se sustituye X por un número para redondear la cantidad a X decimales.

editable

Indica que esta expresión se puede editar de forma manual, lo que provoca la aparición de un icono en el reporte que permite que el usuario realice 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, solo se deben separar por ;.

Example

editable;rounding=2
es una fórmula correcta que mezcla ambos comportamientos.

Función python personalizada

Esta herramienta permite que los desarrolladores introduzcan cálculos personalizados de expresiones caso por caso. La fórmula es el nombre de una función de python a llamar, y la subfórmula es una clave a buscar en el diccionario devuelto por esta función. Utilícela solo si está creando su propio módulo personalizado.

Columnas

Los reportes pueden tener un número indefinido de columnas. Cada columna obtiene sus valores de las expresiones indicadas 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, no se mostrará nada para ella en esta columna. Si se necesitan varias columnas, debe utilizar diferentes etiquetas de expresión

Columnas en el reporte

Si utiliza la función comparación de periodos en la pestaña Opciones de un reporte contable, todas las columnas se repiten en y para cada periodo.

Custom tax report setup

Report configuration

Truco

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:

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

Tax grids configuration.

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.

Truco

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

Ver también

Tax closing