Visualizar Compras Automáticas
Pré-requisitos de acesso
- Permissão (módulo):
viewGeneralJournal - Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Operações
O que é / quando usar
Lista todas as ordens de compra automáticas geradas pela plataforma — compras de tokens, de NFTs, de tickets e de itens de marketplace. Diferente dos pagamentos manuais, estas ordens nascem de um fluxo automatizado (checkout do app). O operador acompanha o status do pedido e, em pedidos ainda em rascunho (created), pode finalizar ou cancelar manualmente quando o fluxo automático não fechou sozinho.
Pré-condições
- Permissão:
viewGeneralJournal(permissão dupla — enum CPM + módulo dinâmico no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: o pedido precisa existir (gerado pelo app). Ações de status só ficam disponíveis para pedidos em
created.
Passo a passo
- Acesse o menu Operações → Visualizar compras automáticas.
- Filtre por tipo (Todos, NFT, Token, Marketplace) e por status (Todos, Cobrança, Cancelado, Criado, Finalizado, Em trânsito). A busca filtra pelo e-mail do usuário.
- Para um pedido em Criado, use check para marcar como finalizado ou delete para cancelar.
Filtros e colunas
| Filtro/Coluna | O que mostra | Origem do dado |
|---|---|---|
| Busca | Filtro local por e-mail do comprador | userEmail (filtragem no front) |
| Tipo | NFT / Token / Marketplace / Todos | isNftBuy, isTokenBuy (sem nenhum dos dois = Marketplace) |
| Status | Estado do pedido | status (OrderStatus) |
| Data | Data de criação | createdAt |
| Comprador | userEmail | |
| Método | Forma de pagamento | paymentMethod |
| Tipo | Compra de tokens / NFTs / tickets / Marketplace | derivado de isTokenBuy/isNftBuy/isTicketBuy |
| Qtd. em tokens | Quantidade de tokens/itens | tokensAmount (BigNumber) |
| Valor / Moeda | Total e unidade | totalAmount / unit_purchased ou assetId (nome do ativo) |
| Pago? | Se o pagamento foi confirmado (verde/vermelho) | wasPaid |
| ID Externo | Identificador no ledger/provedor | external_id |
Ações e modais
- Finalizar (check): chama
changeOrderStatus('finished', id)no OrderService. Marca o pedido como finalizado no backend (OrderBook/FMS). - Cancelar (delete): chama
changeOrderStatus('cancelled', id). Cancela o pedido.
Ambas as ações só aparecem para pedidos com status
created. Não há bottom-sheet de confirmação — a ação é imediata; o resultado é exibido via snackbar e a lista é recarregada.
Regras de negócio / cuidados
Atenção
- Esta tela é majoritariamente de acompanhamento. Só intervenha manualmente quando o pedido ficou travado em
created. - O filtro de busca é local (sobre a página carregada), e não uma consulta paginada ao backend — busca por e-mail exato/parcial.
- Valores financeiros: tratados como BigNumber — sem arredondamento; conferir casas decimais do token.
- Idempotência: o fechamento da ordem credita via FinLib;
E00021"already processed" significa que o pedido já foi liquidado — sucesso, não erro. - Status APPROVED: o comprador precisa estar
APPROVEDpara que o fechamento da compra credite/debite saldo.