Relatório Financeiro do Token
Pré-requisitos de acesso
- Permissão (módulo):
manageToken - Licença/Feature:
MANAGE_TOKENS - Contêiner do menu: TOKENIZAÇÃO → grupo Tokenização → Gerenciar Tokens → ícone Relatório financeiro na linha
O que é / quando usar
Mostra o resumo de vendas de um token em um período: quantidade vendida e valor vendido, separados por compras manuais e compras automáticas, com quebra por forma de pagamento. Use para conciliação financeira, acompanhamento de captação e fechamento contábil de um token específico.
Pré-condições
- Permissão:
manageToken(dupla — enum CPM + módulo no DB). - Licença/Feature:
MANAGE_TOKENS.
Passo a passo
- Em Gerenciar Tokens, clique no ícone Relatório financeiro na linha do token.
- Escolha o tipo de período: por mês (mês + ano) ou por intervalo de datas (início/fim).
- Clique em Aplicar filtros para carregar (
getTokenFinancialReport).
Filtros e colunas
| Filtro / Coluna | O que mostra | Origem do dado |
|---|---|---|
| Tipo de período | "Mês" ou "Intervalo" | Seleção local |
| Mês / Ano | Período mensal (anos a partir de 2020) | selectedMonthNumber / selectedYear |
| Início / Fim | Intervalo customizado | rangeStart / rangeEnd (ISO) |
| Forma de pagamento | Meio usado na compra | Relatório (TokenController + FMS) |
| Quantidade vendida | Quantidade de tokens vendida | quantitySold |
| Valor vendido | Valor financeiro vendido | amountSold |
| Totais | Soma de manual + automático | getTotalSoldQuantity / getTotalSoldAmount |
Regras de negócio / cuidados
Atenção
- O relatório separa compras manuais (lançadas pelo operador) de compras automáticas (fluxo de checkout). Os totais somam as duas.
- A moeda do relatório segue a configuração do token: usa o código ISO da moeda (símbolo quando ISO conhecido, código quando não-ISO) — derivada de
reportCurrencyou dopairdo token.
- Valores financeiros: quantidades e valores são tratados com precisão (BigNumber) — sem arredondamento; o relatório é leitura, não recalcula liquidações.