Como configurar e entender as taxas de comissão

A aba Configuração (em Comissões → Configuração) é a janela sobre o motor de comissões — ela mostra todas as regras existentes, qual delas vence em cada situação e por quê, sem precisar adivinhar.

Antes de começar

É necessário ser administrador do negócio para acessar e alterar as configurações.
A aba fica em Comissões → Configuração (terceira aba no topo).
Alterações feitas aqui só valem para atendimentos concluídos a partir da mudança — valores anteriores não são recalculados.

Acerto automático de comissões

O primeiro card da aba Configuração é o Acerto automático de comissões: ele liga o fechamento automático das folhas por cadência (semanal, quinzenal ou mensal). É onde você tira do manual o trabalho de criar e bloquear cada ciclo — o pagamento continua sendo você que faz. O passo a passo completo, o que acontece ao ligar (organizar folhas anteriores) e a regra do caixa aberto estão em Folha de pagamento — ciclos e pagamento em lote.

Início rápido (primeira vez)

Se você ainda não configurou nenhuma comissão, a aba exibe um card de início rápido no topo com três opções:

Todos recebem a mesma porcentagem — pede um único número (ex.: 40) e define o padrão do negócio de uma vez.
As taxas variam por pessoa ou serviço — dispensa o atalho; você configura manualmente por profissional ou serviço.
Não pago comissão — marca que não há comissão configurada e remove o card.

Após definir um padrão (ou dispensar), o card de início rápido não aparece mais.

Testar uma taxa — o resolvedor

O widget Testar uma taxa responde à pergunta mais comum de operação: "por que este atendimento pagou essa comissão?".

Selecione um profissional no seletor.

Escolha o tipo de linha que quer simular: - Serviço (atendimento de preço normal) — selecione um serviço. - Produto — selecione o produto que foi vendido. - Plano de assinatura — selecione o plano de assinatura que cobriu o atendimento.

O resultado aparece imediatamente — sem salvar nada:

Taxa aplicada — o valor final (ex.: 35%).
Venceu em — em qual nível da cascata a taxa foi encontrada (ex.: ② Padrão do profissional).
Trilha completa — todos os níveis listados; o nível ativo fica destacado, os demais aparecem em tom mais baixo com o valor que teriam ou "nenhum definido".
Base de cálculo — se a porcentagem incide sobre o preço original (negócio absorve o desconto) ou o preço com desconto.

Descontos no atendimento inteiro (cupom, voucher, promoção)

Quando a base de cálculo está no modo "preço com desconto" (repasse), apenas um desconto manual — um preço que o operador negociou no balcão — reduz a base da comissão (dividido proporcionalmente entre os serviços e produtos do atendimento). Descontos de marketing da loja no atendimento inteiro — cupom, voucher de fidelidade, promoção — NÃO reduzem a comissão: o profissional recebe sobre o valor cheio, porque um cupom é custo de marketing da loja (aquisição de cliente), não do barbeiro. No modo padrão (negócio absorve), nada muda — a comissão sempre foi sobre o preço original. A regra vale apenas para atendimentos criados a partir de 13/07/2026; comissões já lançadas nunca são recalculadas retroativamente.

Leitura pura — nada é alterado

O resolvedor é 100% de leitura. Ele chama o mesmo mecanismo interno que calcula as comissões reais (CommissionRateFinder.resolveForProfessional, resolveForProductSeller, resolveForPlan) e exibe a resposta — mas não cria nem modifica nenhuma regra.

Os três sistemas de cascata

O motor de comissões tem três cascatas independentes, uma para cada tipo de linha de atendimento. Elas nunca se misturam: uma linha de serviço nunca usa a regra de assinatura, e vice-versa. Cada cascata funciona da mesma forma: percorre os níveis de cima para baixo e aplica o primeiro nível que tiver um valor definido.

Cascata 1 — Serviços (atendimento a preço normal)

Usada quando o cliente paga o serviço diretamente, sem cobertura de assinatura.

| Nível | O que é | Onde editar | | --------------------------------- | ------------------------------------------------------- | ------------------------------------------- | | ① Override serviço + profissional | Taxa específica para "este profissional + este serviço" | Profissionais → [profissional] → Serviços | | ② Padrão do profissional | Taxa padrão deste profissional para qualquer serviço | Profissionais → [profissional] → Comissão | | ③ Padrão do negócio | Taxa de todos, exceto quem tem própria | Editável inline na aba Configuração | | ④ R$ 0 | Nada configurado acima | — (aparece como alerta em Lacunas) |

Override de serviço vence o padrão do profissional

O nível mais específico sempre ganha. Uma taxa configurada para "João + Corte Degradê" vence a taxa geral do João, que por sua vez vence o padrão do negócio. Se você só configurou um padrão do negócio, todos os profissionais e serviços o herdam — até que você defina algo mais específico.

Cascata 2 — Assinaturas (atendimento coberto por plano)

Usada quando o atendimento é coberto por uma assinatura (o cliente paga R$ 0 no ato). É completamente separada da cascata de serviços — configurar uma não afeta a outra.

| Nível | O que é | Onde editar | | ---------------------------------- | ------------------------------------------------- | ------------------------------------------- | | ① Política do plano | Taxa definida naquele plano específico | Planos de Assinatura → [plano] → Comissão | | ② Padrão de assinaturas do negócio | Taxa para qualquer plano que não define a própria | Editável inline na aba Configuração | | ③ R$ 0 / Pote | Nada definido acima — ou plano com modelo Pote | — |

Base de cálculo em atendimentos de assinatura

A porcentagem é calculada sobre o preço cheio do serviço — o que o cliente pagaria sem o plano — não sobre o R$ 0 que ele efetivamente pagou. Assim o profissional é remunerado pelo trabalho real, independentemente do valor da mensalidade.

Modelo Pote (pool por fichas)

Quando um plano usa o modelo Pote (por fichas), a comissão não é calculada por atendimento. Em vez disso, uma porcentagem da receita de mensalidades vai para um pote compartilhado, dividido pelas fichas que cada profissional acumulou no período. Atendimentos deste tipo não entram na contagem de lacunas. Veja o guia completo em Comissão por fichas (pote).

Cascata 3 — Produtos (venda avulsa)

Usada quando um profissional é registrado como vendedor em uma venda de produto no caixa.

Portão de entrada: se o produto tiver Comissão habilitada = não, a cascata para imediatamente no R$ 0 — nenhum nível abaixo é consultado.

Base de cálculo (configurável por produto):

Preço de venda (padrão): quantidade × preço unitário
Margem: quantidade × (preço unitário − preço de custo)

| Nível | O que é | Onde editar | | ----------------------------------- | ------------------------------------------------ | ------------------------------------------------------- | | ① Override profissional × produto | Taxa de "este vendedor + este produto" | Profissionais → [profissional] → Produtos | | ② Override do produto | Taxa deste produto para qualquer vendedor | Produtos → [produto] → Comissão | | ③ Padrão de produto do profissional | Taxa padrão deste vendedor para qualquer produto | Profissionais → [profissional] → Comissão de produtos | | ④ Padrão de produto do negócio | Taxa de todo profissional em qualquer produto | Editável inline na aba Configuração | | ⑤ R$ 0 | Nada definido acima | — |

Para o guia completo de configuração de comissão de produtos, veja Comissão de produtos.

Descontos e comissão

A chave Descontos e comissão controla o que acontece quando alguém aplica um desconto — tanto num atendimento quanto numa venda avulsa de produto. É uma política só para as duas coisas:

| Estado da chave | O que acontece | Exemplo (item R$ 80 com desconto para R$ 60) | | ---------------------- | --------------------------------------- | -------------------------------------------- | | Desligada (padrão) | Comissão sobre o preço original | Base = R$ 80 — o negócio absorve o desconto | | Ligada | Comissão sobre o preço com desconto | Base = R$ 60 — o desconto é compartilhado |

Esta configuração escreve a chave commission.respects_override nas configurações do negócio.

Com a chave ligada, o compartilhamento vale para descontos manuais (negociados no balcão) — em serviços e em produtos (o lápis de desconto da venda avulsa e o "Desconto no total" seguem a mesma regra). Descontos de marketing da loja — cupom, voucher, promoção — não reduzem a comissão: o profissional recebe sobre o valor cheio (veja o aviso acima).

Vendas antigas não mudam

A política sobre produtos vale para vendas novas — comissões já acumuladas de vendas anteriores nunca são recalculadas retroativamente.

Legenda de herança

No rodapé da aba, uma legenda explica a regra universal:

O mais específico vence. Uma taxa definida para esta pessoa + este serviço vence uma taxa de esta pessoa, que vence o padrão do negócio. A primeira regra que tiver um valor é a que paga. Se nenhuma regra tiver valor, a comissão é R$ 0 — e o atendimento aparece na contagem de Lacunas no relatório de visão geral.

O que cada edição inline altera

As edições feitas diretamente na aba Configuração escrevem as seguintes chaves nas configurações do negócio (BusinessSetting):

| Campo editável | Chave gravada | | ----------------------------------------- | --------------------------------- | | Padrão do negócio (serviços) — percentual | DefaultCommissionPercent | | Padrão do negócio (serviços) — fixo | DefaultCommissionFixed | | Padrão de assinaturas — percentual | MemberDefaultCommissionPercent | | Padrão de assinaturas — fixo | MemberDefaultCommissionFixed | | Padrão de produto do negócio — percentual | DefaultProductCommissionPercent | | Padrão de produto do negócio — fixo | DefaultProductCommissionFixed | | Base de cálculo de produto | ProductCommissionBase | | Descontos e comissão | commission.respects_override |

Configurações por profissional, por serviço, por plano e por produto continuam nos seus editores próprios (acessíveis pelos links de cada tier na cascata). Isso mantém uma única fonte de verdade por nível.

Lacunas (comissões R$ 0)

Quando um ou mais atendimentos concluídos não geraram comissão porque nenhuma regra cobriu aquela linha, o sistema registra uma lacuna. Lacunas aparecem:

No contador Sem comissão nos KPIs da Visão geral (em âmbar quando há lacunas).
No Centro de alertas da Visão geral, com o total de atendimentos afetados.

Use o resolvedor Testar uma taxa para descobrir por que a taxa resultou em R$ 0 e em qual nível a regra está ausente.

Profissional por linha (opcional)

Na mesma página de configuração existe o cartão Profissional por linha. Com ele ligado, a tela de finalização da comanda mostra, em cada linha, quem executou o serviço e quem vendeu o produto — pré-selecionado com o profissional do agendamento, editável com um toque.

Para que serve: registrar atendimentos em que mais de um profissional participou da mesma comanda (ex.: um faz o corte, outro faz a barba, um terceiro vende a pomada), preparando a atribuição de comissão por linha.
O que NÃO muda ao ligar: o cálculo de comissão de hoje continua exatamente igual (uma comissão por atendimento, no profissional do agendamento). O seletor apenas registra a atribuição por linha; a comissão por profissional-por-linha será ativada em uma etapa futura.
Padrão: desligado. Se a sua equipe sempre trabalha um-profissional-por-atendimento, não é preciso ligar.

Perguntas frequentes

Posso testar a taxa de qualquer profissional, mesmo sem ter atendimentos abertos? Sim. O resolvedor é uma simulação de leitura — não precisa de atendimentos reais para funcionar.

Alterei o padrão do negócio. Isso recalcula atendimentos antigos? Não. A nova taxa vale apenas para atendimentos concluídos após a alteração. Atendimentos já concluídos mantêm a taxa que tinham no momento da conclusão.

Por que a cascata de assinaturas não inclui o override por serviço? As duas cascatas são independentes por design. Em um atendimento coberto por assinatura, a regra é: qual política este plano define? Se nenhuma, qual é o padrão de assinaturas do negócio? A taxa por serviço específico não entra nessa cadeia — ela só é consultada para atendimentos a preço normal.

O que significa "Venceu em ③ Padrão do negócio" no resolvedor? Significa que os níveis ① e ② não tinham valor definido para aquela combinação de profissional e serviço. A primeira regra com valor foi o padrão do negócio, então essa foi a taxa aplicada. Para mudar o resultado, defina uma taxa nos níveis acima (override do serviço ou padrão do profissional).