Saltar al contenido principal
Este ejemplo muestra cómo estructurar un Reporte Financiero Analítico enfocado en el análisis de transacciones a nivel de cuenta, en formato HTML. El reporte incluye:
  • Información de Organización y Libro Contable.
  • Desglose por cuenta.
  • Lista detallada de operaciones.

Código de plantilla


Desglose del código


Información de Organización y Libro Contable

<p><strong>Fecha de Generación:</strong> {% date_time "dd/MM/YYYY HH:mm" %}</p> Esta función aplica la fecha y hora cuando se renderiza la plantilla, usando el formato dd/MM/YYYY HH:mm. <p><strong>Organización:</strong> {{ midaz_onboarding.organization.0.legal_name }}</p> Esta línea renderiza el nombre legal de la primera Organización asociada con los datos de onboarding.
  • midaz_onboarding.organization: la lista de Organizaciones en el sistema.
  • 0: obtiene el primer elemento de la lista.
  • legal_name: obtiene el valor del campo legal_name.
<p><strong>Ledger:</strong> {{ midaz_onboarding.ledger.0.name }}</p> Esta línea renderiza el nombre del primer Libro Contable asociado con los datos de onboarding.
  • midaz_onboarding.ledger: la lista de Libros Contables en el sistema.
  • 0: obtiene el primer elemento de la lista.
  • name: obtiene el valor del campo name.

Iterando a través de las cuentas

{% for account in midaz_onboarding.account %} Este bucle recorre cada cuenta en la lista midaz_onboarding.account.
  • Esta lista representa todas las cuentas vinculadas a un cliente o asociadas con un flujo de onboarding.
  • Para cada iteración, crea un nuevo alcance donde account se refiere a un elemento específico en esa lista.
{% with balance = filter(midaz_transaction.balance, "account_id", account.id)[0] %} Dentro del bucle, esta línea:
  • Usa la función filter para encontrar un saldo de la lista midaz_transaction.balance donde el account_id coincida con el ID de la cuenta actual.
  • El [0] obtiene el primer saldo coincidente (asumiendo que solo hay uno por cuenta).
  • El resultado se almacena en una variable temporal llamada balance, con alcance solo dentro de este bloque.

Información de la cuenta

<div class="section-title">Cuenta: {{ account.alias }}</div> Muestra un título de sección con el alias de la cuenta (un nombre amigable o legible para la cuenta). <p><strong>ID:</strong> {{ account.id }}</p> Muestra el identificador único de la cuenta. <p><strong>Moneda:</strong> {{ balance.asset_code }}</p> Muestra el código de moneda (como “BRL” o “USD”) asociado con el saldo de la cuenta. <p><strong>Saldo Actual:</strong> {{ balance.available }} Muestra el saldo disponible actual.

Información de operaciones

{% for operation in midaz_transaction.operation %} Este bucle recorre todas las operaciones de la lista midaz_transaction.operation. {% if operation.account_id == account.id %} Esta línea verifica si la operación actual está relacionada con la cuenta actual en el bucle externo (de tu bloque anterior) y solo procede si:
  • El account_id de la operación coincide con el account.id en foco.
{% set original_amount = operation.amount %} Esta línea establece una variable temporal llamada original_amount y le da el valor del campo amount en el objeto de operación. {% set discount_amount = original_amount * 0.03 %} Esta línea calcula un descuento del 3% sobre el monto original.
  • El resultado se guarda como discount_amount.
{% set final_amount = original_amount - discount_amount %} Esta línea resta el descuento del monto original.
  • El resultado final se almacena en final_amount, que puede renderizarse más tarde.

Columnas de la tabla

Este bloque genera una fila de tabla limpia y legible para cada operación, incluyendo la siguiente información: <td>{{ operation.id }}</td> Identificador único de la operación. <td>{{ operation.type }}</td> Tipo de operación, como credit o debit. <td>{{ original_amount|floatformat:2 }}</td> Muestra el monto original (sin ajustar), formateado con 2 decimales. <td>{{ discount_amount|floatformat:2 }}</td> Muestra el descuento calculado, también con 2 decimales. <td>{{ final_amount|floatformat:2 }}</td> Muestra el monto final después de aplicar el descuento del 3%, bien formateado. <td>{{ operation.description }}</td> Renderiza la descripción o etiqueta de la operación, como “Transferencia a ahorros”.

Pie de página del reporte

Esta línea renderiza un pie de página en la parte inferior del documento, indicando que el contenido fue generado automáticamente usando Reporter de Lerian.
  • También incluye el número de documento legal de la primera organización vinculada a los datos de onboarding, extraído dinámicamente usando el marcador de posición {{ midaz_onboarding.organization.0.legal_document }}.

Salida de la plantilla


Salida renderizada


Ejemplo de informe financiero renderizado a partir del código de la plantilla HTML mostrado arriba

Figura 1. Un ejemplo de un reporte financiero renderizado desde el código HTML en el ejemplo.