Programa de Indicação — Histórico de comissões
Pré-requisitos de acesso
- Permissão (módulo):
viewIndicationProgram - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Programa de Indicação
O que é / quando usar
Tela de auditoria das comissões de indicação geradas. Cada linha é uma comissão (multilevel_commissions) com seus pagamentos (multilevel_commissions_payments) e o status de processamento. Há filtros por status (todas / processadas / pendentes) e busca por usuário, motivo ou moeda, além de contadores de processadas e pendentes.
Use para conferir o que foi gerado pelos Programas de Indicação, identificar pendências e validar liquidação.
Pré-condições
- Permissão:
viewIndicationProgram(permissão dupla: enum CPM + módulo dinâmico no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: as comissões só existem se houver programas ativos e ações de indicados que disparem os eventos cobertos.
Passo a passo
- Acesse o menu Programa de Indicação → Histórico de comissões (
/indication-program/commissions). - Use os filtros de status (Todas / Processadas / Pendentes) e a busca (usuário, motivo, moeda).
- Clique em uma linha para expandir e ver os pagamentos que compõem a comissão.
Filtros e colunas
| Filtro / Coluna | O que mostra | Origem do dado |
|---|---|---|
| Status (Todas/Processadas/Pendentes) | Filtra por wasProcessed | Filtro client-side |
| Busca | userId, reason ou unit_of_money | Filtro client-side |
Usuário (userId) | Beneficiário da comissão | multilevel_commissions.userId |
Valor (amount) | Valor da comissão | multilevel_commissions.amount (string BigNumber) |
Moeda (unit_of_money) | Asset creditado | multilevel_commissions.unit_of_money |
Motivo (reason) | Origem/descrição da comissão | multilevel_commissions.reason |
Data (when) | Quando foi gerada | multilevel_commissions.when |
Processada (wasProcessed) | Se já foi liquidada | flag no registro |
Pagamentos (payments[]) | Quebra por pagamento (data/status) | multilevel_commissions_payments |
Ações e modais
- Expandir/recolher linha: mostra os pagamentos da comissão. É somente leitura.
- Contadores: "processadas" e "pendentes" agregam o total carregado.
Regras de negócio / cuidados
Atenção
wasProcessed = falseindica comissão pendente de liquidação — não assuma crédito ao usuário antes do processamento.- Esta tela compartilha as mesmas entidades de comissão da tela Pagamento de comissões; a diferença é o recorte de auditoria por programa de indicação.
- Idempotência: liquidação via FinLib é idempotente por
externalId;E00021("already processed") é sucesso, não erro. - Valores financeiros: valores em string BigNumber — sem arredondamento.