Reportes personalizados

Odoo incluye un marco de trabajo de reportes potente y fácil de usar. El motor te permite crear nuevos reportes, como declaraciones fiscales, balance general y estados de ingresos con agrupamientos y diseños específicos.

Importante

Activa el modo de desarrollador para acceder a la configuración de los reportes contables.

Para crear un reporte nuevo, ve a Contabilidad ‣ Configuración ‣ Reportes contables. Aquí podrás crear un reporte raíz o un variante.

Truco

  • Considera guardar los reportes modificados como variantes de reportes para mantener los reportes de raíz intactos.

  • Para acceder a la interfaz de gestión de un reporte desde el mismo reporte, haz clic en el icono (gears).

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.

Debes crear un elemento de menú para acceder al nuevo reporte de raíz. Para hacerlo, abre la configuración del reporte, haz clic en Acción, crea un elemento de menú y vuelve a cargar la página. El reporte estará disponible en Contabilidad ‣ Reportes.

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.

Cuando se abre un reporte raíz desde el menú Reportes de la aplicación Contabilidad, todas sus variantes se muestran en el selector de variantes del reporte en la esquina superior derecha de la vista.

Example

Reporte fiscal (BE) es una variante del reporte raíz Reporte fiscal genérico.

Captura de pantalla de la selección de variante de reportes.

Líneas

Después de crear un reporte (ya sea de raíz o una variante), el siguiente paso es agregar las líneas. Para crear una línea nueva, haz clic en Agregar una línea. Para modificar una línea existente, haz clic en la línea y edita la ventana emergente. Todas las líneas deben tener un Nombre y pueden tener un código opcional, para usar el valor de las líneas en fórmulas.

opciones de la herramienta de líneas

Expresiones

Cada línea puede contener una o varias expresiones. Las expresiones se pueden ver como variables secundarias que necesita una línea de reporte. Para crear una expresión, haz clic en Agregar una línea dentro la venta emergente de una línea.

Al crear una expresión debes ingresar una etiqueta que se use para referirse a esa expresión. La etiqueta debe ser única en las expresiones de cada línea de reporte, además, también debes completar los campos Motor de cálculo y Fórmula. El motor de cálculo define cómo las fórmulas y subfórmulas se interpretarán. Puedes combinar expresiones si usas diferentes motores de cálculo en la misma línea si es necesario.

Nota

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

Motor de cálculo Odoo Domain

Al usar el motor de cálculo Odoo Domain`una fórmula se interpreta como una :ref:`dominio de Odoo <reference/orm/domains> focalizado a objetos account.move.line.

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

El resultado es el número de sublíneas de esta expresión. Si la línea principal tiene un valor agrupar por, corresponderá al número de claves de agrupamiento distintivas en las líneas de movimiento que coincidan. De lo contrario, será un número de líneas de movimiento que coincidan.

Truco

Para revertir el signo del resultado, pon un signo `-`al inicio de la subformula.

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

Motor de cálculo de las etiquetas de impuestos

Al usar el motor de cálculo de las etiquetas de impuestos, los contenidos del campo Fórmula se vinculan con etiquetas de impuestos. Si estas etiquetas no existen al crear la expresión, se crearán.

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

Si la Fórmula se establece como tag_name, el motor vincula las etiquetas de impuesto +tag_name y -tag_name y las creará si es necesario. Otro ejemplo: se vinculan dos etiquetas por la fórmula, si la fórmula es A, necesitarás las etiquetas +A y `-A`(y crearlas, si es necesario).

Motor de cálculo Agregar otras fórmulas

El motor de cálculo Agregar otras fórmulas realiza operaciones aritméticas en las cantidades obtenidas de otras expresiones. Las fórmulas aquí están compuestas de referencias a expresiones separadas por uno o cuatro operadores aritméticos básicos (suma +, resta -, división / y multiplicación *). Para referirse a la expresión, escribe el código de su línea principal seguido de un punto `.`y la etiqueta de la expresión (por ejemplo, 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.

Motor de cálculo Prefijo de códigos de cuenta

El motor de cálculo Prefijo de códigos de cuenta se usa para hacer coincidir los montos en cuentas que usan los prefijos de estos códigos de cuentas como variables en una expresión aritmética.

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)
Esta fórmula coincide las cuentas cuyas etiquetas asociadas contienen una con ID 25.

Si la etiqueta a la que haces referencia está definida en un archivo de datos, puedes usar un XMLID en lugar del 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.

Motor de cálculo Valor externo

El motor de cálculo Valor externo se usa para referirse al manual y los valores de traspaso. Esos valores se almacenan con account.report.external.value y no con account.move.line. Cada uno de estos objetos hace referencia a la expresión a la que afectará, para que se deba hacer poco sobre la selección.

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
En esta subfórmula se muestra la forma correcta de mezclar ambos comportamientos.

Motor de cálculo Función de Python personalizada

El motor de cálculo Función de Python personalizada es una forma en la que los desarrolladores pueden introducir expresiones de cálculo personalizadas según el caso. La fórmula es el nombre de una función de Python a la que se llamará y la subfórmula es la clave que se buscará en el diccionario que resulte de esta función. Usa este motor de cálculo solo si estás haciendo un módulo personalizado.

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.

Columnas en el reporte

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.

Agrupamiento en línea

El agrupamiento no estándar es posible si agregas o usas campos existentes en el modelo apunte contable, solo si los campos son relacionados y no almacenados.

Nota

Agrupar líneas requiere que el reporte tenga líneas de reporte explícitas que se puedan editar. Los reportes diferidos, por ejemplo, no son compatibles con el agrupamiento de líneas ya que usan líneas dinámicas que se generan.

Crear un nuevo campo en un apunte contable

Para crear un campo relacionado no almacenado en el modelo apunte de diario primero ve a Contabilidad ‣ Apuntes contables`y haz clic en el icono :icon:`fa-bug (bug). Después, haz clic en Campos y luevo en Nuevo para crear un campo nuevo; deberás completar los campos a continuación:

  • Nombre del campo: El nombre técnico del campo.

  • Etiqueta del campo: La etiqueta que se mostrará para ese campo.

  • Tipo de campo: El tipo de campo al que debe llevar este campo relacionado.

  • Almacenado: Deja este campo sin seleccionar ya que solo se pueden usar los campos no almacenados en los agrupamientos de líneas.

  • Modelo relacionado: Si el tipo de campo es one2many, many2many, o many2one selecciona el modelo del campo original para agrupar por.

  • Definición del campo relacionado: La dirección técnica al campo por el que quieres agrupar.

    Example

    Para agrupar por el equipo de ventas del socio comercial, establece la definición del campo relacionado como move_id.team_id.

Agrupar líneas

Para agrupar líneas ve a la pestaña Líneas <accounting/customize/lines> del reporte que quieras. Haz clic en la línea por la que quieras agrupar y edita el campo :guilabel:`Agrupar por. Escribe el nombre técnico (Nombre del campo) del campo que se usará como la clave de agrupamiento.

Truco

Si quieres ver una lista de todos los modelos de campos y sus nombres técnicos, ve a Contabilidad ‣ Apuntes contables, haz clic en el icono (bug) y después haz clic en Campos. Podrás ver el nombre técnico de cada campo en la columna Nombre del campo.