Comissão
A tela de Comissão centraliza a configuração das regras de comissão dos vendedores da empresa. É onde você marca quais usuários são vendedores, define o percentual de comissão que cada um recebe, o limite máximo de desconto que pode dar sem perder a comissão, o flux de pagamento (quando a comissão é liberada — antes ou depois da venda ser paga) e as regras de exclusão (cancelados e devoluções entram ou não no cálculo). Vendedores podem ter regras diferentes por categoria de produto e regras com vigência (ex.: comissão promocional de 1 mês).
A tela tem um modo de visualização único, em lista — uma linha por usuário que é vendedor (Salesman=1). Cada linha pode ser expandida para mostrar as regras de comissão do vendedor (sub-tabela). A criação de um novo vendedor passa pela mesma janela usada na tela de Usuários (com os campos extras de comissão habilitados).
Esta tela não tem parametrizações próprias — as configurações que afetam a comissão (Tipo Pagamento → switch Cálculo comissão, parametrização por canal de venda para excluir comissão do marketplace na NF) ficam nas telas respectivas, não aqui.
Índice
Conceito
- O que é a tela de Comissão?
- Como o idworks calcula a comissão de uma venda?
- O que é o "flux de pagamento da comissão"?
- O que são as opções de excluir cancelados/devolvidos?
- O que é o "limite de desconto" da comissão?
- Quais tipos de pagamento entram no cálculo da comissão?
Cadastro e edição
- Como marcar um usuário como vendedor?
- Como adicionar uma regra de comissão a um vendedor?
- Quais campos a regra de comissão tem?
- Como definir comissão diferente por categoria de produto?
- Como criar uma regra de comissão com vigência (promocional)?
- Como editar uma regra de comissão?
- Como remover uma regra de comissão?
Configurações do vendedor
- Como mudar o flux de pagamento de um vendedor?
- Como excluir vendas canceladas/devolvidas do cálculo?
- Como definir o limite padrão de desconto de um vendedor?
Busca e visualização
Regras de negócio
- O que acontece quando o vendedor dá desconto acima do limite?
- Como duas regras vigentes ao mesmo tempo se comportam?
- Onde vejo o histórico de alterações?
Referência rápida
O que é a tela de Comissão?
É a tela onde você configura as regras de comissão de cada vendedor da empresa. A partir dela, marca quais usuários são vendedores, define o percentual de comissão que cada um recebe, define o limite de desconto que pode dar sem perder a comissão, e escolhe quando o sistema libera a comissão (no faturamento, com o pagamento, etc.). As regras configuradas aqui alimentam o Relatório de Comissão (em Relatórios → Vendas), usado para calcular o valor a pagar ao vendedor no fim do mês.
📍 Onde: menu lateral → Configurações → Comissão.
Como o idworks calcula a comissão de uma venda?
O cálculo combina três níveis de configuração:
- Por venda: o sistema verifica o vendedor responsável pela venda — o usuário que abriu o pedido.
- Por tipo de pagamento: vendas pagas com um tipo de pagamento que tem Cálculo comissão = Sim entram na conta. Tipos com Cálculo comissão = Não (ex.: Crédito Loja, vale-presente) ficam de fora. Veja a FAQ de Tipo Pagamento para detalhes.
- Por regra de comissão do vendedor: dentre as regras cadastradas para o vendedor, o sistema escolhe a que se aplica à venda — pela vigência (campos Início/Fim), pela categoria do produto (quando informada) e pelo desconto aplicado (se ultrapassa o % Limite Desconto da regra, a comissão não vale).
O valor da comissão é o % Comissão da regra aplicado sobre o valor da venda elegível. O flux de pagamento do vendedor define quando essa comissão é considerada paga ao vendedor (no faturamento ou conforme a venda for sendo paga pelo cliente).
O que é o "flux de pagamento da comissão"?
É quando a comissão é liberada para o vendedor. Cada vendedor tem um flux configurado no campo Liberação de Comissão:
| Valor | Flux | Quando a comissão é liberada |
|---|---|---|
| 1 | Liberação parcial vinculada ao pagamento das parcelas | O vendedor recebe a comissão parcialmente, conforme a baixa das parcelas da venda. Cada parcela paga libera a parte proporcional da comissão. |
| 2 | Liberação integral no faturamento | A comissão é liberada integralmente ao lançar contas da venda, mesmo que a venda não tenha sido baixada (paga pelo cliente). |
| 3 | Liberação integral após o pagamento da primeira parcela | A comissão é liberada integralmente quando a primeira parcela da venda é baixada. |
| 4 | Liberação integral após o pagamento da última parcela | O vendedor recebe a comissão total apenas quando a última parcela registrada da venda é baixada. |
O flux mais conservador é o 4 (paga só com a venda totalmente quitada — protege contra inadimplência). O mais agressivo é o 2 (paga no faturamento, sem esperar baixa). O 1 é o mais granular (paga proporcionalmente conforme baixa).
O que são as opções de excluir cancelados/devolvidos?
São duas configurações por vendedor que controlam o que entra no cálculo da comissão:
- Excluir pedidos cancelados (
ExcludeCanceledOrdersCommission): quando ativa, vendas com status Cancelado (90) não geram comissão. Quando inativa, a comissão é paga sobre a venda cancelada (geralmente não é o que você quer — ative). - Excluir pedidos devolvidos (
ExcludeReturnedOrdersCommission): quando ativa, vendas com status Devolvido (94) ou Em devolução (95) também ficam de fora. Quando inativa, a venda devolvida ainda gera comissão para o vendedor.
A configuração é por vendedor — você pode ter políticas diferentes para vendedores de canais diferentes, embora normalmente as duas opções fiquem ativas (não se paga comissão sobre venda que não se concretizou).
O que é o "limite de desconto" da comissão?
É o desconto máximo que o vendedor pode dar na venda sem perder a comissão. Existem dois níveis:
- Limite padrão do vendedor (
User.DiscountPercentLimit): aplicado quando nenhuma regra de comissão específica casa com a venda. - Limite da regra de comissão (
SalesmanComission.DiscountPercentLimit): aplicado quando a venda casa com uma regra específica (por categoria/vigência).
Quando o desconto da venda ultrapassa o limite aplicável, a regra de comissão não vale para essa venda — o vendedor pode ter dado um desconto que comeu o lucro, e o sistema penaliza não pagando a comissão. Isso funciona como uma trava comercial: o vendedor decide se vale a pena dar mais desconto ou preservar a comissão.
Quais tipos de pagamento entram no cálculo da comissão?
Apenas os tipos de pagamento marcados com Cálculo comissão = Sim em Financeiro → Tipo Pagamento. Quando um tipo de pagamento está com o switch em Não, vendas pagas com ele ficam de fora do cálculo da comissão para todos os vendedores.
Use isso para tipos administrativos (Crédito Loja, vale-presente, ajuste interno) que não devem gerar comissão. Para mais detalhes, consulte a FAQ de Tipo Pagamento.
Como marcar um usuário como vendedor?
Pela tela de Comissão, clique em Novo Vendedor (ou abra um usuário existente para edição). No formulário do usuário, ative o interruptor Vendedor (Salesman). Salve.
A partir desse momento, o usuário fica disponível para ser selecionado como Vendedor em novos pedidos. As configurações de comissão (limite de desconto padrão, flux de pagamento, excluir cancelados/devolvidos) também aparecem no formulário e podem ser ajustadas no mesmo salvamento.
Alternativamente, é possível fazer isso direto pela tela de Configurações → Usuários — esta tela de Comissão é uma visão filtrada da lista de usuários, focada em vendedores.
Pré-requisito: privilégio Visualizar comissão (e privilégios de criação/edição de usuários).
Como adicionar uma regra de comissão a um vendedor?
Na lista, clique no ícone de expandir (seta) ao lado do nome do vendedor para ver as regras dele. Em seguida clique em Nova Comissão (ou em + Adicionar). Preencha:
- Início e Fim — vigência da regra.
- % Comissão — percentual de comissão.
- % Limite Desconto — desconto máximo permitido para esta regra valer.
- Categoria — opcional. Quando informado, a regra só vale para vendas de SKUs dessa categoria.
Clique em Salvar. A regra aparece na sub-tabela do vendedor e passa a ser usada no cálculo da comissão a partir da data de Início.
Quais campos a regra de comissão tem?
Cada regra (SalesmanComission) tem:
| Campo | O que é |
|---|---|
| Data Criação | Quando a regra foi cadastrada (gerado automaticamente). |
| Início | Primeiro dia da vigência (DateFrom). |
| Fim | Último dia da vigência (DateTo). |
| % Limite Desconto | Desconto máximo permitido — vendas com desconto acima desse limite não geram comissão por esta regra. |
| % Comissão | Percentual aplicado sobre o valor elegível da venda. |
| Categoria | Categoria de SKU (opcional). Quando informada, a regra só se aplica a vendas de produtos dessa categoria. |
Como definir comissão diferente por categoria de produto?
Cadastre uma regra por categoria, todas com a mesma vigência. Exemplo prático: a empresa quer pagar 5% de comissão em "Eletrônicos" e 8% em "Roupas". Configure assim para o vendedor X:
- Regra 1: vigência
2026-01-01 → 2099-12-31, % Comissão = 5%, Categoria = Eletrônicos. - Regra 2: mesma vigência, % Comissão = 8%, Categoria = Roupas.
Para itens de outras categorias, sem regra específica, nenhuma comissão é paga (a menos que você cadastre uma regra sem categoria, que vira o "default").
Cadastros que você precisa ter antes
- Categoria de SKU — em Produtos → Categorias.
Como criar uma regra de comissão com vigência (promocional)?
Cadastre uma regra com Início e Fim correspondendo ao período da promoção. Exemplo: "comissão promocional de 10% durante março de 2026":
- Regra: vigência
2026-03-01 → 2026-03-31, % Comissão = 10%, sem categoria (vale para qualquer produto).
Durante março, o sistema aplica essa regra (em vez da regra "permanente" do vendedor). A partir de abril, a regra expira e o vendedor volta ao percentual padrão (a outra regra com vigência mais ampla).
Quando duas regras estão vigentes ao mesmo tempo, o sistema escolhe a mais específica (com categoria) sobre a mais geral (sem categoria). Veja a regra de prioridade abaixo.
Como editar uma regra de comissão?
Na sub-tabela do vendedor, clique no ícone de editar (lápis) na linha da regra. A janela abre com os campos preenchidos. Altere e salve.
Cuidado ao editar uma regra que já está vigente e gerando comissão — o sistema não recalcula automaticamente as comissões já calculadas. Vendas anteriores mantêm o cálculo com a regra antiga (até gerar o Relatório de Comissão novamente).
Como remover uma regra de comissão?
Na sub-tabela do vendedor, clique no ícone de lixeira na linha da regra e confirme a janela. A regra é apagada fisicamente — não há "desfazer". Vendas que já calcularam a comissão com essa regra mantêm o cálculo antigo nos relatórios já gerados.
Como mudar o flux de pagamento de um vendedor?
Edite o vendedor (lápis na linha principal, não na sub-tabela). No formulário, encontre o seletor Liberação de Comissão (ou Flux Comissão) e escolha um dos 4 valores (parcial conforme parcelas, integral no faturamento, após 1ª parcela, após última parcela). Salve.
A mudança vale para comissões geradas a partir desse momento — comissões já liberadas no flux antigo não são revertidas.
Como excluir vendas canceladas/devolvidas do cálculo?
No formulário de edição do vendedor, ative os interruptores Excluir Cancelado e Excluir Devolvido. Salve.
Em geral, mantenha os dois ativos — não faz sentido pagar comissão sobre venda que não se concretizou. Desative apenas em casos excepcionais (ex.: cláusula contratual que paga comissão sobre venda fechada mesmo que cancelada depois).
Como definir o limite padrão de desconto de um vendedor?
No formulário de edição do vendedor, preencha o campo % Limite Desconto (sem associar a uma regra). Salve.
Esse limite é o default do vendedor — aplicado quando a venda não casa com nenhuma regra específica (SalesmanComission). Para fluxos simples (sem categorias / sem vigências específicas), o limite padrão é suficiente.
Como filtrar a lista de vendedores?
Abra o painel de filtros à direita da tela. Os filtros disponíveis (vindos do compartilhamento com a tela de Usuários) incluem:
- Conta — quando a empresa tem mais de uma conta cadastrada.
- Nome / Login — busca textual no nome ou login do vendedor.
- Filtro por Salesman — embutido no parâmetro
Comission=1que a tela usa.
Para procurar por colunas específicas, use a busca interna da tabela: clique no ícone de lupa no cabeçalho da coluna (Nome, Login, Vendedor, R$ Vendas, R$ Comissão).
O que acontece quando o vendedor dá desconto acima do limite?
A regra de comissão que tem DiscountPercentLimit configurado só paga quando o desconto da venda fica dentro do limite. Se o desconto ultrapassa:
- O sistema procura por outra regra do mesmo vendedor que aceite esse desconto (com limite maior ou sem limite).
- Se nenhuma regra aceita, a venda fica sem comissão para esse vendedor — ele dá o desconto, mas perde a comissão.
Esse mecanismo é uma trava comercial: o gerente pode permitir desconto até X% com comissão integral, e o vendedor decide se vale a pena dar mais desconto (perdendo a comissão) para fechar a venda.
Como duas regras vigentes ao mesmo tempo se comportam?
Quando o vendedor tem duas ou mais regras que cobrem a mesma venda (ambas vigentes na data, ambas casando com o produto, ambas aceitando o desconto), o sistema escolhe pela seguinte ordem de prioridade:
- Regra com categoria específica vence sobre regra sem categoria. Se o produto da venda é "Eletrônicos" e existe regra para "Eletrônicos" + regra geral, a de Eletrônicos vale.
- Entre regras de mesma especificidade, vale a primeira encontrada na ordem de cadastro — para evitar isso, mantenha regras vigentes não conflitantes.
Idealmente, não cadastre duas regras com a mesma combinação (mesma categoria, mesma vigência) — sempre prefira uma única regra por (categoria, vigência).
Onde vejo o histórico de alterações?
Todas as ações de criar, alterar e remover regras de comissão geram log em UserLog (a mesma tabela que loga outras alterações no cadastro do usuário). O log preserva o usuário que fez a alteração, a data/hora e o conteúdo da mudança em JSON. Não há tela dedicada para visualizar o log — a consulta é via banco (ou via tela administrativa de Logs de Usuário, dependendo do perfil de acesso).
Privilégios da tela
Esta tela tem apenas um privilégio próprio. As ações específicas (criar/editar vendedor, criar/remover regras) dependem dos privilégios da tela de Usuários, já que a tela compartilha o cadastro.
| Privilégio | Libera |
|---|---|
| Visualizar comissão | Acesso à tela e à lista de vendedores. Necessário também para acessar o Relatório de Comissão em Relatórios. |
Para criar, editar ou excluir vendedores e suas regras de comissão, o usuário precisa também dos privilégios correspondentes da tela de Usuários (Criar/Editar/Deletar usuário).