Documentação

Português

English
Español

Português

English
Español

Appearance

Gerenciar Escrows ​

Pré-requisitos de acesso

  • Permissão (módulo): viewEscrows (para ver) OU manageEscrows (para editar/registrar entregas) — basta um dos módulos.
  • Licença/Feature: ESCROW
  • Contêiner do menu: GERAL → grupo Operações

O que é / quando usar ​

Painel de acompanhamento dos escrows corporativos — operações em que o valor de uma negociação entre comprador e vendedor fica retido (em custódia) até que as condições de entrega sejam cumpridas. O operador consulta o estado de cada escrow (aceito, aguardando, cancelado, suspenso) e abre os detalhes para auditar a transação e, conforme a permissão, registrar entregas.

Pré-condições ​

  • Permissão: viewEscrows para ver; manageEscrows para editar/registrar entregas (permissão dupla — enum CPM + módulo dinâmico no DB).
  • Licença/Feature: ESCROW habilitada (sem ela o item nem aparece no menu).
  • Dependências de outras telas: o escrow precisa existir (criado a partir de uma negociação entre as partes).

Passo a passo ​

  1. Acesse o menu Operações → Gerenciar Escrows.
  2. Busque por e-mail do comprador ou vendedor e filtre por status (Todos, Aceito, Aguardando, Cancelado, Suspenso).
  3. Clique no ícone visualizar para abrir os detalhes do escrow.

Filtros e colunas ​

Filtro/ColunaO que mostraOrigem do dado
BuscaFiltro local por e-mail (comprador ou vendedor)buyer_email / seller_email
StatusAceito / Aguardando / Cancelado / Suspenso / Todosstatus (EscrowBankingStatus)
VendedorE-mail do vendedor (tooltip com o ID)seller_email / seller
CompradorE-mail do comprador (tooltip com o ID)buyer_email / buyer
StatusEstado do escrowstatus

Ações e modais ​

  • Visualizar (visibility): navega para manage-escrows/view/:id com os detalhes do escrow (partes, valor retido, condições, entregas).
  • Editar: rota manage-escrows/edit/:id (disponível conforme manageEscrows).

O fluxo de registrar entrega (update-delivery) é o que faz o escrow avançar de estado e, ao cumprir as condições, libera o valor retido ao vendedor.

Regras de negócio / cuidados ​

Atenção

  • O escrow só libera fundos ao vendedor quando as condições de entrega são cumpridas — esta tela é o ponto de auditoria desse ciclo.
  • A busca é local sobre a lista carregada (e-mail de comprador/vendedor), combinada com o filtro de status.

Irreversível

  • A liberação do valor retido ao vendedor (ao concluir o escrow) é definitiva. Confirme o cumprimento das condições antes de avançar o estado.
  • Valores financeiros: tratados como BigNumber — sem arredondamento; conferir casas decimais.
  • Idempotência: a liquidação do escrow no FinLib é idempotente por externalId; E00021 "already processed" indica que a liberação já ocorreu — sucesso, não erro.
  • Status APPROVED: comprador e vendedor devem estar APPROVED para movimentar fundos.

Telas relacionadas ​