Pular para o conteúdo principal

CommissionTable (Tabela de Comissao)

O CommissionTable representa uma tabela de regras para calculo de comissoes de profissionais.

Descricao

Tabelas de comissao definem as regras para calcular quanto cada profissional recebe por suas vendas e servicos. Permitem configuracoes flexiveis por tipo de item, categoria e faixas de valor.

Dados

Identificacao

CampoTipoObrigatorioDescricao
nameTextoSimNome da tabela
descriptionTextoNaoDescricao
activeBooleanoSimSe esta ativa

Configuracoes

CampoTipoDescricao
calculation_baseSelecaoBase do calculo
apply_discountBooleanoConsidera desconto dado
minimum_valueMonetarioValor minimo de comissao
maximum_valueMonetarioValor maximo de comissao

Base de Calculo

BaseDescricao
total_valueValor total da venda
net_valueValor liquido (- descontos)
profitLucro (venda - custo)
marginMargem de lucro

Relacionamentos

Pertence a

EntidadeObrigatorioDescricao
AccountSimConta do petshop

Possui

EntidadeDescricao
CommissionRulesRegras da tabela
ProfessionalsProfissionais vinculados

CommissionRule (Regra)

Dados

CampoTipoObrigatorioDescricao
item_typeSelecaoSimTipo de item
category_idReferenciaNaoCategoria especifica
percentageDecimalCondicionalPercentual
fixed_valueMonetarioCondicionalValor fixo
rule_typeSelecaoSimTipo de regra

Tipos de Item

TipoDescricao
productProdutos
serviceServicos de estetica
clinical_serviceServicos clinicos
packagePacotes
allTodos os itens

Tipos de Regra

TipoDescricaoExemplo
percentagePercentual fixo10% sobre vendas
fixedValor fixo por itemR$ 5,00 por servico
tieredFaixas de valor5% ate R$ 1.000, 8% acima
progressiveProgressivoAumenta conforme meta

Regras por Faixa

CommissionTier

CampoTipoDescricao
min_valueMonetarioValor minimo da faixa
max_valueMonetarioValor maximo da faixa
percentageDecimalPercentual na faixa

Exemplo

Faixas de comissao:
R$ 0 a R$ 1.000: 5%
R$ 1.001 a R$ 3.000: 8%
R$ 3.001 a R$ 5.000: 10%
Acima de R$ 5.000: 12%

Calculo de Comissao

Fluxo

Exemplo de Calculo

Venda: R$ 500,00
- Produto A: R$ 200 (regra: 5%) = R$ 10,00
- Servico B: R$ 300 (regra: 15%) = R$ 45,00

Total Comissao: R$ 55,00

Prioridade de Regras

O sistema aplica regras na ordem:

  1. Regra por produto especifico (se existir)
  2. Regra por categoria (se existir)
  3. Regra por tipo de item (produto/servico)
  4. Regra geral (all)

Desconto na Base

Com Desconto (apply_discount = true)

Venda: R$ 100,00
Desconto: R$ 10,00
Base: R$ 90,00
Comissao 10%: R$ 9,00

Sem Desconto (apply_discount = false)

Venda: R$ 100,00
Desconto: R$ 10,00
Base: R$ 100,00 (valor original)
Comissao 10%: R$ 10,00

Limites

Minimo

Se comissao calculada menor que minimo:

Se comissao < minimum_value:
comissao = minimum_value

Maximo

Se comissao calculada maior que maximo:

Se comissao > maximum_value:
comissao = maximum_value

Uso no Sistema

Vinculo com Profissional

Profissional: Maria (Tosadora)
Tabela: Comissao Beauty Center
Regras:
- Banho: 20%
- Tosa: 25%
- Produtos: 5%

Multiplas Tabelas

Um profissional pode ter diferentes tabelas por contexto:

  • Tabela para Beauty Center
  • Tabela para PDV
  • Tabela para Clinico

Validacoes

CampoRegra
nameObrigatorio
rulesMinimo 1 regra
percentage0 a 100

Regras de Negocio

Alteracao de Tabela

Ao alterar regras:

  • Vendas anteriores nao sao recalculadas
  • Apenas novas vendas usam novas regras

Inativacao

Ao inativar tabela:

  • Profissionais ficam sem comissao
  • Deve vincular nova tabela

Permissoes

AcaoDescricao
CriarCriar tabela
EditarAlterar regras
VincularVincular a profissional
DesativarInativar tabela