{"v":{"area":"admin","slug":"comm-statements","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/comm-statements.md","relative_path":"docs/readme/admin/comm-statements.md","title":"Extratos de Comissão","html":"<h1>Extratos de Comissão</h1><h2>Rota</h2><ul><li><code>/adm/comm-statements</code></li></ul><h2>O que é</h2><p>Tela financeira para consultar extratos consolidados de comissão por recebedor.</p><h2>Para que serve</h2><ul><li>listar valores em aberto e pagos por recebedor;</li><li>acompanhar quantidade de entradas agregadas;</li><li>filtrar a visão por contrato, tipo de recebedor, ID e período;</li><li>acessar a rotina de criação de lote de pagamento.</li></ul><h2>Blocos principais</h2><ul><li>hero Matdash com métricas de recebedores, aberto, pago e entradas;</li><li>leitura consolidada do recorte atual;</li><li>alerta contextual sobre uso dos filtros antes de gerar lotes;</li><li>tabela principal em <code>DataTable</code>;</li><li>offcanvas de filtros.</li></ul><h2>Botões do topo</h2><ul><li><code>Atualizar</code>: recarrega a tabela mantendo o recorte atual.</li><li><code>Filtrar</code>: abre o offcanvas com filtros financeiros.</li><li><code>Criar Lote</code>: direciona para a tela de pagamentos de comissão.</li></ul><h2>Filtros</h2><ul><li><code>Contrato</code>: restringe os extratos ao contrato selecionado.</li><li><code>Recebedor</code>: filtra por <code>usuario</code>, <code>profissional</code>, <code>empresa</code> ou <code>equipe</code>.</li><li><code>ID do recebedor</code>: restringe a consulta a um recebedor específico.</li><li><code>Período</code>: aceita o formato <code>YYYY-mm-dd..YYYY-mm-dd</code>.</li><li><code>Aplicar filtros</code>: recarrega o DataTable com o recorte informado.</li><li><code>Limpar filtros</code>: remove tipo, ID, período e contrato quando o usuário pode selecionar contratos.</li></ul><h2>Tabela</h2><p>A tabela usa DataTable para busca local, ordenação e paginação, mantendo os dados carregados pela API de comissões.</p><h2>Observações</h2><ul><li>Os totais do hero e da leitura consolidada consideram o recorte retornado pela API.</li><li>A tela não cria pagamentos diretamente; a criação de lote fica centralizada em <code>/adm/comm-payouts</code>.</li><li>O agrupamento depende dos campos <code>open_amount</code>, <code>paid_amount</code> e <code>entries</code> retornados pela API.</li></ul>"},"exp":1780849788}