Transações gerais (Jornal)
Pré-requisitos de acesso
- Permissão (módulo):
viewGeneralJournal - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Jornais de transações → Transações gerais (
/general-journal)
O que é / quando usar
É o livro-razão consolidado das transações financeiras dos usuários: cada linha é um lançamento (crédito ou débito) registrado pelo Finance Management Service (FMS). O operador usa esta tela para auditar movimentações, conferir o fluxo de uma transação específica, identificar a moeda transacionada e abrir o "recibo" completo de um lançamento durante atendimentos de suporte ou conciliações.
Diferente das telas de Operações (que executam ações), aqui o foco é consulta e rastreabilidade — nenhum lançamento é criado ou alterado a partir desta tela.
Pré-condições
- Permissão:
viewGeneralJournalcadastrado para a role do operador (lembrar: permissão é dupla — enum CPM no backend + módulo dinâmico no DB). - Licença/Feature: nenhuma — o item aparece no menu apenas em função da permissão.
- Dependências de outras telas: Nenhuma. Os lançamentos já existem no FMS; esta tela apenas os lê.
Passo a passo
- Acesse o menu Jornais de transações → Transações gerais.
- A listagem carrega já ordenada do mais recente para o mais antigo (
DESC, vinda do backend). - Use o campo de busca para filtrar por status da transação.
- Use o seletor de tipo/moeda para restringir a um token específico (a lista é preenchida dinamicamente com os tokens do tenant) ou deixe em
all. - Clique no ícone de recibo na linha para abrir o detalhe completo do lançamento.
Filtros e colunas
| Filtro / Coluna | O que mostra / faz | Origem do dado |
|---|---|---|
| Busca (status) | Filtra os lançamentos por status de transação. Texto vazio limpa o filtro. | Parâmetro selectedStatus enviado ao FMS (getUserTransactionHistoryAdmin). |
| Seletor de tipo/moeda | Restringe a um token específico; all traz todos. A lista é montada com os IDs dos tokens do tenant. | TokensService.getTokens() + parâmetro selectedDepositType. |
Data/hora (date) | Data e hora do lançamento, no idioma da sessão. | Campo when do lançamento. |
E-mail (name) | E-mail do cliente de origem da transação. | customerFromEmail. |
Nome (identifier) | Nome do cliente de origem. | customerFromName. |
Tipo (type) | Sentido da transação (fluxo: creditado/debitado). | transactionFlow. |
Valor (amount) | Valor total transacionado. | totalAmount. |
Moeda transacionada (unitOfMoney) | Unidade monetária do lançamento. | monetaryamount.unitOfMoney. |
| Recibo (ação) | Abre o modal de detalhes com o lançamento completo (incluindo carteira de destino). | openFullScreenReceipt(element). |
A paginação é feita no servidor: a troca de página dispara nova consulta ao FMS com limit/offset.
Ações e modais
- Recibo (ícone): abre o modal de detalhe do lançamento (
DetailsViewComponent), exibindo todos os campos da transação selecionada, inclusive a carteira de destino. É somente leitura.
Regras de negócio / cuidados
Atenção
- A tela vem paginada e ordenada do backend (
DESC). O comprimento do paginador é estimado (não é o total exato de registros); navegue pelas páginas para varrer o histórico. - O filtro de busca atua sobre status, não sobre nome/e-mail. Para localizar por usuário, prefira a tela de Detalhes do usuário ou os jornais específicos (Sincronismos, Saques).
- Valores financeiros: tratados como BigNumber no backend (FMS) — sem arredondamento; a coluna de valor reflete a precisão do token. Não considere o número exibido como definitivo para reconciliação contábil sem conferir as casas decimais do token.
- Idempotência: os lançamentos podem ter origem em processos idempotentes por
externalId. Em retries, o errorCodeE00021("already processed") significa sucesso (transação já contabilizada), não falha — não trate uma repetição como erro.