# Ledger individual do profissional — extrato e pagamento de comissões

Fonte: https://docs.barbeiro.app/business-admin/commissions/professional-ledger
Perfil: Administrador
Verificado em: 2026-09-02

O ledger individual é o extrato bancário de um profissional dentro da plataforma — mostra cada comissão gerada, o estado de pagamento de cada uma e o histórico imutável de tudo que aconteceu. É aqui que você efetua o pagamento.

## Antes de começar

-   O saldo corrente e o pagamento (Conta do profissional) estão disponíveis em **todos os planos**, depois de ativar a conta.
-   Acesso requer perfil de **administrador do negócio**.
-   Para pagar comissões, o **caixa do dia** precisa estar fechado — comissões com caixa ainda aberto ficam no estado **Em aberto** e não podem ser selecionadas para pagamento.

> **Como o pagamento acontece depende do seu plano**
>
> **Com a Conta do profissional ativa:** o pagamento é feito **pelo saldo** no card
> **Conta do profissional**, no topo da página (botão **Pagar** — veja [Conta do profissional —
> pagamento](business-admin/commissions/professional-payout)). No extrato abaixo, cada comissão com
> o caixa fechado aparece como **"Lançada"** (já entrou no saldo) — e passa a **"Pago"** quando fica
> comprovadamente coberta por pagamentos passados (sempre que o saldo da conta **zera**, tudo que
> entrou antes está quitado). Você **pode selecionar** linhas ainda não pagas para **somá-las** e
> preencher o valor do pagamento (barra **Somar no pagamento**), mas isso é só uma **calculadora** —
> **não** existe **Marcar como paga** por linha aqui. O saldo já reúne comissões, bônus, vales e
> consumo em **um único número**, e a quitação é sempre pelo saldo (marcar linha por linha contaria
> a comissão duas vezes).
>
> **Nos demais planos:** vale o fluxo de **Marcar como paga** em lote descrito mais abaixo — nele
> você seleciona as linhas de comissão e as quita diretamente.

## Como abrir o ledger de um profissional

1. Em **Comissões → Visão geral**, localize o profissional na tabela e toque em **Ver** ou
   **Pagar**. Em telas menores, o card do profissional tem os mesmos botões. O sistema abre o
   ledger já filtrado pelo mesmo período de tempo que estava selecionado na Visão geral.

2. Para voltar à lista, toque em **Comissões** no cabeçalho da página (breadcrumb) ou use o botão
   Voltar do navegador.

## Filtro de período — dentro do extrato

O seletor de datas fica no **cabeçalho do cartão Extrato de comissões**, não no topo da página. Ele
governa o que está dentro daquele cartão e nada além dele: **a Conta do profissional acima não muda
quando você troca as datas**, porque o saldo dela é o que você deve hoje, reunindo comissões, bônus,
vales e consumo desde o último pagamento — de qualquer mês.

Os presets disponíveis são:

| Preset             | O que cobre                                                               |
| ------------------ | ------------------------------------------------------------------------- |
| **Ciclo atual**    | Do último pagamento até agora — o padrão ao abrir a página                |
| **Hoje**           | Dia corrente no fuso do negócio                                           |
| **Esta semana**    | Seg → Dom corrente                                                        |
| **Este mês**       | Mês corrente                                                              |
| **Mês passado**    | Mês anterior completo                                                     |
| **Escolher datas** | Qualquer intervalo — abre uma folha com seletor de data início e data fim |

> **Por que o Ciclo atual é o padrão**
>
> No ciclo, o número **Comissão no ciclo** do extrato é exatamente a linha **Comissões desde
> dd/MM** da Conta do profissional logo acima. As duas metades da tela mostram o mesmo dinheiro, e
> dá para conferir uma contra a outra sem calculadora. O ciclo começa na **hora** do último
> pagamento, não na meia-noite daquele dia: se você pagou às 18h, o que ele ganhou naquela manhã
> já está pago e fica de fora.

> **Preset gravado na URL**
>
> O preset escolhido fica gravado na URL — você pode copiar e compartilhar o link e ele abrirá
> exatamente o mesmo profissional e período. Vindo da Visão geral pelo botão **Ver**, a página
> abre no mesmo período que estava selecionado lá.

## Os números do extrato

Logo abaixo do seletor, dentro do mesmo cartão, três números resumem o período escolhido (quatro
quando o profissional participa de um pote):

| Número                   | O que mostra                                                                                              |
| ------------------------ | --------------------------------------------------------------------------------------------------------- |
| **Gerou no ciclo**       | O valor dos atendimentos que ele concluiu no período, contando pelo preço de tabela o que um plano cobriu |
| **Comissão no ciclo**    | Toda comissão lançada no período (paga, a pagar e em aberto)                                              |
| **Ainda pode mudar** (◷) | A parte dessa comissão cujo caixa do dia ainda está aberto — não pagável até o fechamento                 |
| **Bolão estimado**       | A estimativa do pote no período, rotulada **provisório** porque só fecha com o período de pagamento       |

Os rótulos dizem qual período estão somando: **no ciclo**, **em agosto**, **no período**. Assim eles
não se confundem com a linha da Conta logo acima, que fala do saldo.

> **Os números somam o período inteiro, sempre**
>
> Esses números são calculados no servidor sobre **todas** as comissões do período — não sobre a
> parte do extrato que está na tela. Um profissional com 134 comissões no mês vê a soma das 134
> mesmo antes de rolar a lista. Se um número parecer diferente do que você somou à mão, veja [Como
> a comissão é calculada](/business-admin/commissions/commission-how-it-works).

> **Quando você sai do ciclo**
>
> Ao escolher qualquer outro período, o cabeçalho avisa **Fora do ciclo — não soma no saldo a
> pagar**, e ao pé do extrato aparece uma linha explicando a diferença entre o que entrou naquele
> intervalo e o saldo que você tem a pagar, com um atalho para voltar ao ciclo atual. No ciclo
> essa linha não aparece, porque não há diferença para explicar.

Quando o profissional tem modelo **por fichas (pote)**, um card adicional aparece abaixo da grade mostrando a estimativa do pote no período. Esse card tem três estados possíveis:

-   **Sem fundos**: o pote ainda não recebeu nenhum pagamento de assinatura — os pontos acumulados já contam, mas a estimativa aparece só quando entrar dinheiro.
-   **Estimativa**: valor estimado com base nos pontos acumulados e no valor por ponto corrente — rotulado **provisório** porque pode mudar até o fechamento do período de pagamento.
-   **Nenhum**: o profissional não participa de nenhum pote ativo no período.

## Como o extrato é organizado

O extrato agrupa as comissões **pelo dia em que foram lançadas** — o dia em que o caixa fechou ou a
comanda foi finalizada — que é o mesmo dia que aparece no histórico da conta e no período de
pagamento. Quando o atendimento aconteceu em outro dia (uma comanda de sábado à noite fechada no
domingo, por exemplo), a linha diz **atend. dd/MM** ao lado do horário, para você reconhecer a visita.

O extrato carrega **100 linhas por vez**. Se o período tiver mais, um botão **Carregar mais** ao pé
da lista mostra quantas faltam. Os números do topo não dependem disso: eles já somam o período
inteiro.

> **Os filtros valem para o período inteiro**
>
> Os filtros de situação, de origem e a busca não olham só as linhas já carregadas — eles
> perguntam ao sistema e trazem **todas** as linhas do período que combinam, mesmo as que ainda
> não tinham aparecido na lista. Por isso o número na aba (por exemplo **A pagar 132**) e a
> quantidade de linhas que você vê ao clicar nela são a mesma coisa.

## Filtros do extrato

Três controles ficam na barra de ferramentas acima do extrato:

**Pills de status** (abas)

| Aba                                    | O que mostra                                      |
| -------------------------------------- | ------------------------------------------------- |
| **Todos**                              | Todas as comissões do período                     |
| **Em aberto** (◷)                      | Caixa ainda aberto — acumulando                   |
| **A pagar** (●, com badge de contagem) | Caixa fechado, não pagas — prontas para pagamento |
| **Pago** (✓)                           | Já marcadas como pagas                            |

**Filtro de Origem** (seletor dropdown)

Filtra por tipo de transação que gerou a comissão:

| Opção            | Tipo                                                           |
| ---------------- | -------------------------------------------------------------- |
| Todas as origens | Sem filtro                                                     |
| Serviço          | Atendimento avulso                                             |
| Assinatura       | Atendimento coberto por plano (chip roxo "Coberto pelo plano") |
| Serviço + plano  | Atendimento misto (parte avulso, parte coberto)                |
| Produto          | Venda avulsa de produto                                        |
| Pote             | Estimativa de pote de fichas                                   |

**Busca por cliente ou serviço** (campo de texto)

Filtra em tempo real (sem nova requisição ao servidor) pelo nome do cliente ou serviço em todas as linhas visíveis.

## Extrato em linha do tempo

O extrato é **agrupado por dia**, como um extrato bancário. Cada dia traz o seu próprio cabeçalho (**Hoje**, **Ontem** ou a data por extenso), o **subtotal do dia** e — o que torna um período misto legível — o **estado do dia inteiro**: um dia só é **● Pronto pra pagar** quando todas as linhas dele estão fechadas; basta um caixa aberto para o dia todo continuar **◷ Ainda pode mudar**.

**Cada linha do extrato mostra:**

-   Checkbox de seleção (só aparece quando a linha é pagável — estado **A pagar**)
-   Nome do cliente (ou **Venda de produtos** para vendas avulsas)
-   Serviço(s) realizados
-   Chip de origem (cor + rótulo conforme a tabela acima)
-   **Base**: valor sobre o qual a taxa foi aplicada
-   **Taxa**: percentual ou valor fixo configurado
-   **Comissão**: valor resultante (tabular-nums, sem arredondamento visual)
-   Badge de estado: ● A pagar / ◷ Em aberto / ✓ Pago (com a Conta do profissional ativa, uma comissão já somada ao saldo mas ainda não coberta por um zeramento aparece como **Lançada**, em cinza; quando o saldo zera num pagamento, as linhas cobertas viram **✓ Pago**)

> **Atendimentos de assinatura — Coberto pelo plano**
>
> Quando o cliente usou uma assinatura, a linha exibe o chip roxo **Coberto pelo plano** na
> origem. A base de cálculo é o **preço cheio do serviço** (sem a assinatura), não o que o cliente
> pagou (R$ 0) — assim o profissional recebe pelo trabalho real.

> **Estornos aparecem riscados**
>
> Se uma reserva foi revertida ou cancelada após gerar comissão, a linha aparece **riscada** com o
> estado **Estornada** — ela permanece visível no extrato como registro histórico, mas não compõe
> nenhum total nem é selecionável para pagamento.

**Abrir detalhes de uma reserva**

Toque em qualquer linha do extrato que tenha uma reserva associada para abrir o painel lateral
**Detalhes da reserva** — você vê o histórico completo do atendimento sem sair da tela de comissões.

**Seleção por dia**

No cabeçalho de cada grupo diário há um checkbox que seleciona todas as comissões **A pagar** daquele dia de uma só vez — útil para quitar um dia inteiro de trabalho sem marcar linha por linha.

## Ações em lote — Marcar como paga

> **Disponível sem a Conta do profissional**
>
> Esta seção descreve o fluxo de **liquidação em lote** (marcar como paga), que aparece nos planos
> **sem** a Conta do profissional. Com a **Conta do profissional** ativa, a mesma seleção de
> linhas vira uma **calculadora** (**Somar no pagamento**) e o pagamento é feito pelo saldo — veja
> [Conta do profissional — pagamento](business-admin/commissions/professional-payout).

> **Só comissões A pagar podem ser selecionadas**
>
> Comissões no estado **Em aberto** (caixa ainda aberto) não aparecem com checkbox e não podem ser
> incluídas em um pagamento. Para liberá-las, feche o caixa do dia correspondente — elas passam
> automaticamente para **A pagar**.

1. **Selecione as comissões**: toque nos checkboxes individuais, use o checkbox do cabeçalho do dia
   para selecionar todas do dia, ou toque em **Pagar todas a pagar** (botão acima do extrato) para
   selecionar todo o conjunto **A pagar** do período de uma vez.

2. **Barra flutuante**: ao selecionar ao menos uma comissão, uma barra aparece ancorada na parte
   inferior da tela mostrando **\{contagem\} selecionadas · \{total formatado\}**. Para limpar a seleção
   sem pagar, toque no **X** da barra ou pressione **Esc**.

3. **Marcar como paga**: toque em **Marcar como paga (\{total\})** na barra flutuante. O diálogo de
   acerto abre com: - **Como você está pagando?** — Dinheiro / PIX / Transferência bancária
   (obrigatório) - **Observações (opcional)** — campo livre para referência (ex.: chave PIX, número
   do comprovante) - Resumo: _"Você está prestes a marcar \{contagem\} comissão(s) totalizando{' '}
   \{total\} para
   \{profissional\} como pagas."_

4. Toque em **Marcar como paga (\{total\})** no diálogo para confirmar. Todas as linhas
   selecionadas mudam para ✓ **Pago**, os números do topo se atualizam na hora e aparece a
   confirmação.

> **Exportar selecionadas (CSV)**
>
> Com comissões selecionadas, um botão **Exportar selecionadas** fica disponível para baixar um
> arquivo CSV das linhas marcadas — útil para controle externo ou integração com planilhas de
> folha de pagamento.

## Histórico de atividade (imutável)

Abaixo do extrato fica a seção **Histórico de atividade** — uma linha do tempo financeira agrupada por dia que registra cada evento que afetou as comissões deste profissional. Este histórico é **somente leitura e imutável**: registros passados não podem ser editados nem excluídos. Correções entram como um novo evento (estorno ou ajuste), nunca sobrescrevendo o original.

**Tipos de evento e seus glifos:**

| Glifo | Tipo              | Cor      | Ator                                                                    |
| ----- | ----------------- | -------- | ----------------------------------------------------------------------- |
| ＋    | Comissão gerada   | Verde    | Sistema (automático ao concluir a reserva)                              |
| ◆     | Pote emitido      | Âmbar    | Sistema (provisório — atualiza com novos pagamentos de assinatura)      |
| ✓     | Pagamento em lote | Verde    | Pessoa (você ou outro admin — mostra o nome)                            |
| ✓✓    | Período pago      | Verde    | Pessoa                                                                  |
| ↩    | Estornada         | Vermelho | Sistema ("venda estornada" — automático ao cancelar/reverter a reserva) |
| ✎     | Editada           | Azul     | Pessoa                                                                  |
| 🔒    | Período bloqueado | Cinza    | Sistema                                                                 |

Cada entrada mostra:

-   Glifo + cor por tipo
-   Valor monetário em tabular-nums (estornos em negativo/vermelho)
-   Ator: **Você**, **sistema** ou o nome do administrador que agiu
-   Data e hora no fuso do negócio
-   Link para o assunto (Reserva #, Venda #, ou período), quando aplicável

> **Por que o histórico é imutável**
>
> O princípio contábil por trás do histórico imutável é simples: uma comissão paga é um passivo
> liquidado. Se houve um estorno depois do pagamento, o sistema registra o estorno como um novo
> evento — mas não apaga o pagamento anterior, porque ele já ocorreu. Isso garante rastreabilidade
> completa para auditorias e conciliações.

## Três estados da comissão

| Estado        | Símbolo   | Quando ocorre                                        | Pode pagar?                  |
| ------------- | --------- | ---------------------------------------------------- | ---------------------------- |
| **Em aberto** | ◷ cinza   | Atendimento concluído, mas caixa do dia ainda aberto | Não — feche o caixa primeiro |
| **A pagar**   | ● laranja | Caixa fechado, comissão confirmada, ainda não paga   | Sim                          |
| **Pago**      | ✓ verde   | Marcada como paga via fluxo de liquidação            | N/A                          |

## Perguntas frequentes

**O ledger mudou — a lógica de cálculo da comissão também mudou?**
Não. O ledger é apenas a camada de visualização e pagamento. O cálculo da comissão (taxa × base) é feito pelos mesmos serviços de sempre e não foi alterado no redesign.

**Posso pagar parte das comissões agora e o resto depois?**
Sim. Selecione apenas as linhas que deseja pagar — as outras permanecem em **A pagar** para o próximo pagamento.

**O que acontece se eu selecionar uma comissão que já foi paga?**
O sistema detecta comissões já pagas no lote e exibe um aviso em toast (sem falhar o lote inteiro). As comissões efetivamente não pagas são marcadas normalmente.

**Posso pagar pelo assistente?**
Sim. Peça algo como _"marca as comissões do João como pagas"_ — o assistente mostra um resumo primeiro e só efetua o pagamento após você confirmar.

**A comissão "Em aberto" vai liberar sozinha?**
Sim. Assim que você fechar o caixa do dia (em **Caixa → Fechar caixa**), todas as comissões cujo caixa era aquele passam automaticamente para **A pagar**.

**O pote aparece no extrato ou só no card de KPI?**
O pote aparece como uma linha separada no extrato (origem **Pote**) com estado estimado e o badge provisório. Ela não é selecionável para pagamento — o pagamento do pote acontece no fechamento do período de pagamento, não aqui. Para o detalhamento completo, veja [Comissão por fichas (pote)](business-admin/commissions/pool-by-points).

## Relacionados

-   [Comissões: por onde começar](/business-admin/commissions/commission-overview)
-   [Comissão por fichas (pote)](business-admin/commissions/pool-by-points)
-   [Comissão de produtos](business-admin/commissions/product-commission-config)
-   [Adiantamentos, bônus, ajustes e consumo de produto](business-admin/commissions/professional-advances-and-consumption)

## Leia também

- [Comissões: por onde começar](https://docs.barbeiro.app/business-admin/commissions/commission-overview)
- [Comissão por fichas (pote)](https://docs.barbeiro.app/business-admin/commissions/pool-by-points)
- [Como configurar a comissão de produtos?](https://docs.barbeiro.app/business-admin/commissions/product-commission-config)
- [Adiantamentos, bônus, ajustes e consumo de produto do profissional](https://docs.barbeiro.app/business-admin/commissions/professional-advances-and-consumption)