{"v":{"area":"admin","slug":"comm-my","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/comm-my.md","relative_path":"docs/readme/admin/comm-my.md","title":"Minhas Comissões","html":"<h1>Minhas Comissões</h1><h2>Rota</h2><ul><li><code>/adm/comm-my</code></li><li><code>/adm/comm-my?user_id=&lt;id&gt;</code></li></ul><h2>O que é</h2><p>Tela de extrato do recebedor para consulta de saldos, totais do período e lançamentos de comissão.</p><h2>Para que serve</h2><ul><li>consultar saldo disponível;</li><li>consultar valor em retenção;</li><li>acompanhar totais aprovados e pagos no período;</li><li>listar lançamentos vinculados ao recebedor;</li><li>abrir o detalhe do evento de comissão quando existir vínculo.</li></ul><h2>Blocos principais</h2><ul><li>hero Matdash com saldo disponível, retenção, aprovado e pago;</li><li>leitura consolidada do recorte atual;</li><li>cards de saldo e totais do período;</li><li>alerta contextual sobre análise do extrato;</li><li>tabela principal em <code>DataTable</code>;</li><li>offcanvas de filtros.</li></ul><h2>Botões do topo</h2><ul><li><code>Filtrar</code>: abre o offcanvas com contrato, status e período.</li><li><code>Atualizar</code>: recarrega o extrato mantendo o recorte atual.</li></ul><h2>Filtros</h2><ul><li><code>Contrato</code>: restringe o extrato ao contrato selecionado.</li><li><code>Status</code>: restringe por <code>pending</code>, <code>approved</code>, <code>paid</code> ou <code>reversed</code>.</li><li><code>Período</code>: restringe a consulta por data inicial e final.</li><li><code>Aplicar filtros</code>: recarrega saldo, totais e lançamentos.</li><li><code>Limpar filtros</code>: remove contrato, status e datas.</li></ul><h2>Tabela</h2><p>A tabela usa DataTable para busca local, ordenação e paginação dos lançamentos retornados pela API.</p><h2>Ações da tabela</h2><ul><li><code>Evento</code>: quando existe <code>event_id</code>, abre <code>/adm/comm-detail?event_id=&lt;id&gt;</code>.</li></ul><h2>Observações</h2><ul><li>Quando <code>user_id</code> é informado na URL, a tela consulta o extrato daquele usuário.</li><li>Os totais do hero e da leitura consolidada são recalculados a cada resposta da API.</li><li>A página consulta <code>/adm/api/Commissions/myCommissionsList</code>.</li></ul>"},"exp":1780849787}