> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Template HTML

> Construa um relatório financeiro analítico em HTML com o Reporter — dados da organização, breakdown por conta e lista detalhada de operações.

Este exemplo mostra como estruturar um **Relatório Financeiro Analítico** focado na análise de transações por conta, em formato HTML. O relatório inclui:

* Informações de Organização e Ledger.
* Detalhamento por conta.
* Lista detalhada de operações.

## Código do template

***

<CodeGroup>
  ```html HTML expandable theme={null}
  <!DOCTYPE html>
  <html lang="pt-BR">
  <head>
    <meta charset="UTF-8">
    <title>Relatório Financeiro Analítico</title>
    <style>
      body {
        font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
        background-color: #f4f6f9;
        color: #333;
        padding: 40px;
      }

      .container {
        max-width: 900px;
        margin: auto;
        background: #ffffff;
        padding: 30px 40px;
        border-radius: 8px;
        box-shadow: 0 0 10px rgba(0,0,0,0.1);
      }

      h1 {
        text-align: center;
        font-size: 24px;
        color: #004080;
        margin-bottom: 10px;
      }

      .subtitle {
        text-align: center;
        font-size: 14px;
        color: #777;
        margin-bottom: 30px;
      }

      .section-title {
        font-weight: bold;
        font-size: 16px;
        margin-top: 30px;
        margin-bottom: 10px;
        color: #004080;
        border-bottom: 1px solid #ccc;
        padding-bottom: 4px;
      }

      table {
        width: 100%;
        border-collapse: collapse;
        margin-top: 15px;
      }

      th, td {
        padding: 10px;
        text-align: left;
        border: 1px solid #ccc;
      }

      th {
        background-color: #e8f0fe;
        font-weight: bold;
        color: #003366;
      }

      .info p {
        margin: 4px 0;
      }

      .footer {
        margin-top: 40px;
        text-align: center;
        font-size: 12px;
        color: #999;
      }
    </style>
  </head>
  <body>
    <div class="container">
      <h1>Relatório Financeiro Analítico</h1>
      <div class="subtitle">Análise detalhada de movimentações por contas vinculadas.</div>

      <div class="info">
        <p><strong>Data de Geração:</strong> {% date_time "dd/MM/YYYY HH:mm" %}</p>
        <p><strong>Organização:</strong> {{ midaz_onboarding.organization.0.legal_name }}</p>
        <p><strong>Livro-Razão:</strong> {{ midaz_onboarding.ledger.0.name }}</p>
      </div>

      {% for account in midaz_onboarding.account %}
        {% with balance = filter(midaz_transaction.balance, "account_id", account.id)[0] %}
          <div class="section-title">Conta: {{ account.alias }}</div>
          <div class="info">
            <p><strong>ID:</strong> {{ account.id }}</p>
            <p><strong>Moeda:</strong> {{ balance.asset_code }}</p>
            <p><strong>Saldo Atual:</strong> {{ balance.available }}</p>
          </div>

          <table>
            <thead>
              <tr>
                <th>ID da Operação</th>
                <th>Tipo</th>
                <th>Valor Original</th>
                <th>Desconto (3%)</th>
                <th>Valor Final</th>
                <th>Descrição</th>
              </tr>
            </thead>
            <tbody>
              {% for operation in midaz_transaction.operation %}
                {% if operation.account_id == account.id %}
                  {% set original_amount = operation.amount %}
                  {% set discount_amount = original_amount * 0.03  %}
                  {% set final_amount = original_amount - discount_amount %}
                  <tr>
                    <td>{{ operation.id }}</td>
                    <td>{{ operation.type }}</td>
                    <td>{{ original_amount|floatformat:2 }}</td>
                    <td>{{ discount_amount|floatformat:2 }}</td>
                    <td>{{ final_amount|floatformat:2 }}</td>
                    <td>{{ operation.description }}</td>
                  </tr>
                {% endif %}
              {% endfor %}
            </tbody>
          </table>
        {% endwith %}
      {% endfor %}

      <div class="footer">
        Documento gerado automaticamente via Reporter - Lerian · {{ midaz_onboarding.organization.0.legal_document }}
      </div>
    </div>
  </body>
  </html>
  ```
</CodeGroup>

## Detalhamento do código

***

### Informações de Organização e Ledger

<CodeGroup>
  ```html HTML theme={null}
      <div class="info">
        <p><strong>Data de Geração:</strong> {% date_time "dd/MM/YYYY HH:mm" %}</p>
        <p><strong>Organização:</strong> {{ midaz_onboarding.organization.0.legal_name }}</p>
        <p><strong>Livro-Razão:</strong> {{ midaz_onboarding.ledger.0.name }}</p>
      </div>
  ```
</CodeGroup>

**`<p><strong>Data de Geração:</strong> {% date_time "dd/MM/YYYY HH:mm" %}</p>`**

Esta função aplica a data e hora em que o template é renderizado, utilizando o formato `dd/MM/YYYY HH:mm`.

**`<p><strong>Organização:</strong> {{ midaz_onboarding.organization.0.legal_name }}</p>`**

Esta linha renderiza a razão social da primeira Organização associada aos dados de onboarding.

* `midaz_onboarding.organization`: a lista de Organizações no sistema.
* `0`: busca o primeiro item da lista.
* `legal_name`: busca o valor do campo `legal_name`.

**`<p><strong>Livro-Razão:</strong> {{ midaz_onboarding.ledger.0.name }}</p>`**

Esta linha renderiza o nome do primeiro Ledger associado aos dados de onboarding.

* `midaz_onboarding.ledger`: a lista de Ledgers no sistema.
* `0`: busca o primeiro item da lista.
* `name`: busca o valor do campo `name`.

### Iterando pelas contas

<CodeGroup>
  ```html HTML theme={null}
      {% for account in midaz_onboarding.account %}
        {% with balance = filter(midaz_transaction.balance, "account_id", account.id)[0] %}
  ```
</CodeGroup>

**`{% for account in midaz_onboarding.account %}`**

Este loop percorre cada conta na lista `midaz_onboarding.account`.

* Esta lista representa todas as contas vinculadas a um cliente ou associadas a um fluxo de onboarding.
* Para cada iteração, cria um novo escopo onde `account` se refere a um item específico dessa lista.

**`{% with balance = filter(midaz_transaction.balance, "account_id", account.id)[0] %}`**

Dentro do loop, esta linha:

* Usa a função filter para encontrar um saldo na lista `midaz_transaction.balance` onde o `account_id` corresponde ao ID da conta atual.
* O `[0]` obtém o primeiro saldo correspondente (assumindo que há apenas um por conta).
* O resultado é armazenado em uma variável temporária chamada `balance`, com escopo apenas dentro deste bloco.

### Informações da conta

<CodeGroup>
  ```html HTML theme={null}
          <div class="section-title">Conta: {{ account.alias }}</div>
          <div class="info">
            <p><strong>ID:</strong> {{ account.id }}</p>
            <p><strong>Moeda:</strong> {{ balance.asset_code }}</p>
            <p><strong>Saldo Atual:</strong> {{ balance.available }}</p>
          </div>
  ```
</CodeGroup>

**`<div class="section-title">Conta: {{ account.alias }}</div>`**

Exibe um título de seção com o alias da conta (um nome amigável ou legível para a conta).

**`<p><strong>ID:</strong> {{ account.id }}</p>`**

Mostra o identificador único da conta.

**`<p><strong>Moeda:</strong> {{ balance.asset_code }}</p>`**

Exibe o código da moeda (como "BRL" ou "USD") associado ao saldo da conta.

**`<p><strong>Saldo Atual:</strong> {{ balance.available }}`**

Mostra o saldo disponível atual.

### Informações das operações

<CodeGroup>
  ```html HTML theme={null}
              {% for operation in midaz_transaction.operation %}
                {% if operation.account_id == account.id %}
                  {% set original_amount = operation.amount %}
                  {% set discount_amount = original_amount * 0.03  %}
                  {% set final_amount = original_amount - discount_amount %}
  ```
</CodeGroup>

**`{% for operation in midaz_transaction.operation %}`**

Este loop percorre todas as operações da lista `midaz_transaction.operation`.

**`{% if operation.account_id == account.id %}`**

Esta linha verifica se a operação atual está relacionada à conta atual no loop externo (do bloco anterior) e só prossegue se:

* O `account_id` da operação corresponder ao `account.id` em foco.

**`{% set original_amount = operation.amount %}`**

Esta linha define uma variável temporária chamada `original_amount` e atribui a ela o valor do campo `amount` no objeto da operação.

**`{% set discount_amount = original_amount * 0.03 %}`**

Esta linha calcula um desconto de 3% sobre o valor original.

* O resultado é salvo como `discount_amount`.

**`{% set final_amount = original_amount - discount_amount %}`**

Esta linha subtrai o desconto do valor original.

* O resultado final é armazenado em `final_amount`, que pode ser renderizado posteriormente.

### Colunas da tabela

<CodeGroup>
  ```html HTML theme={null}
                  <tr>
                    <td>{{ operation.id }}</td>
                    <td>{{ operation.type }}</td>
                    <td>{{ original_amount|floatformat:2 }}</td>
                    <td>{{ discount_amount|floatformat:2 }}</td>
                    <td>{{ final_amount|floatformat:2 }}</td>
                    <td>{{ operation.description }}</td>
                  </tr>
  ```
</CodeGroup>

Este bloco gera uma linha de tabela limpa e legível para cada operação, incluindo as seguintes informações:

**`<td>{{ operation.id }}</td>`**

Identificador único da operação.

**`<td>{{ operation.type }}</td>`**

Tipo da operação, como `credit` ou `debit`.

**`<td>{{ original_amount|floatformat:2 }}</td>`**

Mostra o valor original (sem ajuste), formatado com 2 casas decimais.

**`<td>{{ discount_amount|floatformat:2 }}</td>`**

Exibe o desconto calculado, também com 2 casas decimais.

**`<td>{{ final_amount|floatformat:2 }}</td>`**

Mostra o valor final após aplicar o desconto de 3%, devidamente formatado.

**`<td>{{ operation.description }}</td>`**

Renderiza a descrição ou rótulo da operação, como "Transferência para poupança".

### Rodapé do relatório

<CodeGroup>
  ```html HTML theme={null}
      <div class="footer">
        Documento gerado automaticamente via Reporter - Lerian · {{ midaz_onboarding.organization.0.legal_document }}
      </div>
  ```
</CodeGroup>

Esta linha renderiza um rodapé na parte inferior do documento, indicando que o conteúdo foi gerado automaticamente usando o Reporter da Lerian.

* Também inclui o número do documento legal da primeira organização vinculada aos dados de onboarding, obtido dinamicamente usando o placeholder `{{ midaz_onboarding.organization.0.legal_document }}`.

## Saída do template

***

<CodeGroup>
  ```html HTML expandable theme={null}
  <!DOCTYPE html>
  <html lang="pt-BR">
  <head>
    <meta charset="UTF-8">
    <title>Relatório Financeiro Analítico</title>
    <style>
      body {
        font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
        background-color: #f4f6f9;
        color: #333;
        padding: 40px;
      }

      .container {
        max-width: 900px;
        margin: auto;
        background: #ffffff;
        padding: 30px 40px;
        border-radius: 8px;
        box-shadow: 0 0 10px rgba(0,0,0,0.1);
      }

      h1 {
        text-align: center;
        font-size: 24px;
        color: #004080;
        margin-bottom: 10px;
      }

      .subtitle {
        text-align: center;
        font-size: 14px;
        color: #777;
        margin-bottom: 30px;
      }

      .section-title {
        font-weight: bold;
        font-size: 16px;
        margin-top: 30px;
        margin-bottom: 10px;
        color: #004080;
        border-bottom: 1px solid #ccc;
        padding-bottom: 4px;
      }

      table {
        width: 100%;
        border-collapse: collapse;
        margin-top: 15px;
      }

      th, td {
        padding: 10px;
        text-align: left;
        border: 1px solid #ccc;
      }

      th {
        background-color: #e8f0fe;
        font-weight: bold;
        color: #003366;
      }

      .info p {
        margin: 4px 0;
      }

      .footer {
        margin-top: 40px;
        text-align: center;
        font-size: 12px;
        color: #999;
      }
    </style>
  </head>
  <body>
    <div class="container">
      <h1>Relatório Financeiro Analítico</h1>
      <div class="subtitle">Análise detalhada de movimentações por contas vinculadas.</div>

      <div class="info">
        <p><strong>Data de Geração:</strong> 23/05/2025 14:08</p>
        <p><strong>Organização:</strong> Mante - Pfannerstill</p>
        <p><strong>Livro-Razão:</strong> Rice, Rowe and O'Hara</p>
      </div>
          <div class="section-title">Conta: @external/USD</div>
          <div class="info">
            <p><strong>ID:</strong> 0196d97e-a58d-7814-8eb3-e510b818f6a5</p>
            <p><strong>Moeda:</strong> USD</p>
            <p><strong>Saldo Atual:</strong> 499950.00</p>
          </div>

          <table>
            <thead>
              <tr>
                <th>ID da Operação</th>
                <th>Tipo</th>
                <th>Valor Original</th>
                <th>Desconto (3%)</th>
                <th>Valor Final</th>
                <th>Descrição</th>
              </tr>
            </thead>
            <tbody>
                  <tr>
                    <td>0196d982-4085-7e1d-b698-3aad306df721</td>
                    <td>CREDIT</td>
                    <td>500000.00</td>
                    <td>15000.00</td>
                    <td>485000.00</td>
                    <td>Teste de conta duplicada</td>
                  </tr>
                  <tr>
                    <td>0196d983-a2c2-7dce-ad14-78eb36d9f2d1</td>
                    <td>DEBIT</td>
                    <td>20.00</td>
                    <td>0.60</td>
                    <td>19.40</td>
                    <td>Pagamento de empréstimo pessoa1</td>
                  </tr>
                  <tr>
                    <td>0196d983-a2c2-7e0d-a246-45d5234138e3</td>
                    <td>DEBIT</td>
                    <td>30.00</td>
                    <td>0.90</td>
                    <td>29.10</td>
                    <td>Pagamento de empréstimo pessoa1</td>
                  </tr>
            </tbody>
          </table>
      <div class="footer">
        Documento gerado automaticamente via Reporter - Lerian · 123.456.789-0001/00
      </div>
    </div>
  </body>
  </html>
  ```
</CodeGroup>

## Saída renderizada

***

<Frame caption="Figura 1. Um exemplo de relatório financeiro renderizado a partir do código HTML do exemplo.">
  <img src="https://mintcdn.com/lerian-49cb71fc/XIMPBv817SL6hw4D/images/pt/docs/html_template.jpg?fit=max&auto=format&n=XIMPBv817SL6hw4D&q=85&s=4835f071501eb1b232453b9ac0b4ed9e" alt="Exemplo de relatório financeiro renderizado a partir do código do modelo HTML mostrado acima" width="1090" height="716" data-path="images/pt/docs/html_template.jpg" />
</Frame>
