Ordens de Pagamento

Pré-requisitos de acesso

• Permissão (módulo): viewPayments
• Licença/Feature: Nenhuma específica.
• Contêiner do menu: GERAL → grupo Operações (rota /manage-orders)

Rota sem item de menu

Esta tela existe na aplicação (/manage-orders) mas não possui item fixo no menu. Ela é mantida para o fluxo de pedidos/ordens de pagamento (precatórios e alocações). Antes de divulgá-la a operadores, confirme com o coordenador se permanece ativa neste tenant.

O que é / quando usar

São ordens criadas por alocação ou precatórios, em que é liberada uma NFT de valor. O usuário, sabendo que tem um valor a receber, pode aguardar o pagamento ou comercializar sua NFT pelo valor que determinar; ao final, quem estiver com a NFT em mãos recebe o valor total da precatória/alocação. Esta tela lista esses pedidos, permite acompanhar o status, visualizar o detalhe de cada ordem e exportar a lista em PDF.

Pré-condições

• Permissão: viewPayments (permissão dupla — enum CPM + módulo dinâmico no DB).
• Licença/Feature: Nenhuma específica.
• Dependências de outras telas: o pedido/NFT de valor precisa ter sido emitido (alocação ou precatório).

Passo a passo

1. Acesse /manage-orders (Ordens de Pagamento).
2. Busque por ID do pedido ou e-mail do cliente.
3. Clique em visualizar para abrir os detalhes do pedido; use enviar (caminhão) para avançar o status; use Gerar PDF para exportar a lista.

Filtros e colunas

Filtro/Coluna	O que mostra	Origem do dado
Busca	Filtro local por ID do pedido ou e-mail	id / userEmail
Pedido	Número do pedido (com indicador de mensagem)	id, hasMessage, hasNewMessage
Data	Data/hora de criação	createdAt
E-mail / Cliente	Comprador e nome	userEmail, user.data.firstName/lastName
Documento	CPF/CNPJ/passaporte (com máscara automática)	user.data.identifier
Total	Valor do pedido	totalAmount (moeda fiduciária do tenant)
Status	Estado do pedido (vermelho=cancelado, verde=entregue)	status (orderStatus)

Estados possíveis: aguardando pagamento, em curso, entregue, processando cancelamento, cancelado, separando estoque.

Ações e modais

• Visualizar (visibility): abre o modal DialogOrderViewComponent com os detalhes do pedido.
• Marcar como enviado (local_shipping): chama changeOrderStatus('finished', id) — avança o pedido para finalizado. Ação imediata, com feedback via snackbar.
• Gerar PDF: exporta a lista de pedidos em pedidos.pdf (jsPDF/autoTable).

Regras de negócio / cuidados

Atenção

• O filtro/busca é local sobre a lista carregada (ID ou e-mail).
• A mudança de status é imediata (sem bottom-sheet de confirmação) — confirme o pedido antes de clicar.

• Valores financeiros: tratados como BigNumber — sem arredondamento; o total é exibido na moeda fiduciária do tenant.
• Idempotência: liquidações associadas ao pedido seguem a idempotência por externalId do FinLib (E00021 = já processado = sucesso).
• Status APPROVED: movimentações financeiras pressupõem usuário APPROVED.

Telas relacionadas

• Visualizar Compras Automáticas
• Gerenciar Pagamentos Manuais
• Voltar ao índice Financeiro