Documentação

Português

English
Español

Português

English
Español

Appearance

Linha do tempo das filas de pagamento ​

Pré-requisitos de acesso

  • Permissão (módulo): processPaymentQueue (controla os botões na UI) + manageToken (exigida pelo backend das rotas /v1/assets/...)
  • Licença/Feature: Nenhuma específica.
  • Contêiner do menu: GERAL → grupo Cobranças → item Orders de Pagamento (ícone timeline, rota /manage-payment-queues-timelines)

Mesma tela, dois nomes

No menu lateral este item aparece como "Orders de Pagamento" (rótulo i18n paymentQueuesTimelines, ícone de linha do tempo). É a execução, em ordem de prioridade, das Filas de Pagamento — cada linha é uma NFT a ser recomprada. O detalhamento campo-a-campo da liquidação de cada NFT (o que acontece ao aprovar) está em Ordens da fila de pagamento; esta página descreve a linha do tempo/listagem priorizada e a ação de processar. Não confunda com a tela Ordens de Pagamento (/manage-orders), do grupo Operações.

O que é / quando usar ​

Esta tela é a linha do tempo de pagamento das filas: lista cada NFT individual que entrou em uma fila de recompra (precatórios, debêntures, dívidas públicas tokenizadas etc.), ordenada pela prioridade definida nas Filas de Pagamento. É aqui que o operador processa (aprova) o pagamento de cada NFT, na ordem.

A ordem de exibição da tabela é a linha do tempo: do mais prioritário (order menor) ao menos. Ordens já pagas permanecem visíveis com Pago = Sim, sem ação; as não pagas exibem o botão de aprovar.

Ao aprovar uma NFT, o sistema:

  1. Paga ao detentor atual o valor price_paid (o que ele pagou pela NFT), a partir da carteira da plataforma, na moeda fiduciária do tenant;
  2. Transfere a NFT de volta ao TKN_OWNER;
  3. Marca a ordem como paga e reordena as entradas restantes.

Pré-condições ​

  • Permissão: processPaymentQueue para os botões na UI; o backend valida manageToken nas rotas (getPaymentQueuesTimelines, executePaymentQueue). Permissão dupla — enum CPM no backend + módulo dinâmico no DB.
  • Licença/Feature: Nenhuma específica.
  • Dependências de outras telas: as Filas de Pagamento precisam estar configuradas e ter selecionado NFTs (por coleção + atributo + valor). O detentor da NFT precisa ter carteira válida e estar APPROVED.

Passo a passo ​

  1. Acesse Cobranças → Orders de Pagamento (rota /manage-payment-queues-timelines).
  2. A página carrega a linha do tempo (GET /v1/assets/getPaymentQueuesTimelines), já ordenada por prioridade (do mais prioritário ao menos). Cada linha é uma NFT.
  3. Identifique a NFT pelo Nome do ativo e pelo NFT ID.
  4. Nas linhas com Pago = Não, clique no ícone de check (Aprovar).
  5. O sistema executa o pagamento ao detentor, devolve a NFT ao TKN_OWNER, exibe a mensagem "Fila processada com sucesso" e recarrega a página.

Filtros e colunas ​

A tela é uma listagem priorizada (sem filtros de busca), paginada (5/10/25/100 por página, padrão 25).

ColunaO que mostraOrigem do dado
NomeNome do ativo/coleção da NFTassetName (resolvido a partir do asset_id)
OrdemPosição da NFT na fila (prioridade efetiva)order
NFT IDIdentificador on-chain da NFTblockchain_token_id
PagoSe a NFT já foi liquidada (Sim/Não)paid
AçãoBotão Aprovar (check), visível só quando paid = false—

A própria ordenação da tabela (order) é a linha do tempo: reflete a prioridade configurada nas filas. Não há botão de criação nesta tela — a composição da fila vem da configuração em Filas de Pagamento.

Ações e modais ​

  • Aprovar (check): chama POST /v1/assets/executePaymentQueue com a ordem selecionada. Não há modal de confirmação — a ação é imediata. Em sucesso, exibe o snackbar "Fila processada com sucesso" e recarrega a página; em erro, exibe "Erro ao processar fila".

Regras de negócio / cuidados ​

Atenção

  • A aprovação é imediata e sem confirmação — um clique já dispara o pagamento. Confira a NFT (Nome + NFT ID) antes.
  • O backend bloqueia repagamento: se a NFT já estiver paga, executePaymentQueue recusa a operação ("It was already paid"). Se a NFT ou o detentor não forem encontrados, falha sem pagar.
  • O valor pago é o price_paid da NFT (o que o detentor pagou), não um valor digitado na tela.
  • Respeite a ordem: a tabela já vem priorizada; pular linhas fora de ordem pode contrariar a precedência de pagamento desejada.

Movimentação financeira efetiva

Aprovar uma ordem paga dinheiro real ao detentor e remove a NFT dele (volta para TKN_OWNER). É uma liquidação — trate como irreversível do ponto de vista operacional.

  • Valores financeiros: o price_paid é tratado como BigNumber — sem arredondamento. O pagamento sai da carteira da plataforma na moeda fiduciária do tenant.
  • Idempotência: a NFT já paga não é paga novamente (guarda explícita paid); as transações ao FinLib seguem a idempotência por externalId — E00021 ("already processed") é sucesso, não falha (ex.: retry após crash).
  • Status APPROVED: o detentor precisa estar aprovado para receber o pagamento na carteira.

Telas relacionadas ​