Pular para o conteúdo principal

Commission (Comissao)

O Commission representa uma comissao calculada para um profissional.

Descricao​

Comissoes sao valores devidos aos profissionais por vendas ou servicos realizados. Sao calculadas automaticamente com base nas tabelas de comissao e podem ser pagas individualmente ou em lote.

Dados​

Identificacao​

CampoTipoObrigatorioDescricao
referenceTextoAutoCodigo de referencia
statusSelecaoSimStatus da comissao
valueMonetarioSimValor da comissao
calculation_dateDataSimData do calculo
payment_dateDataNaoData do pagamento

Status​

StatusDescricao
pendingPendente de pagamento
approvedAprovada
paidPaga
canceledCancelada

Origem​

CampoTipoDescricao
origin_typeSelecaoTipo da origem
origin_idReferenciaID da origem

Tipos de Origem​

TipoDescricao
saleVenda
beauty_appointmentAgendamento beauty
clinical_appointmentAtendimento clinico

Relacionamentos​

Pertence a​

EntidadeObrigatorioDescricao
AccountSimConta do petshop
StoreSimFilial
ProfessionalSimProfissional
CommissionTableSimTabela usada
SaleCondicionalVenda (se origem=sale)
BeautyAppointmentCondicionalAgendamento

Possui​

EntidadeDescricao
CommissionItemsDetalhamento por item
FinancialTransactionTransacao de pagamento

CommissionItem​

Dados​

CampoTipoDescricao
item_typeSelecaoTipo do item
item_idReferenciaID do item
item_nameTextoNome do item
sale_valueMonetarioValor vendido
commission_percentageDecimalPercentual aplicado
commission_valueMonetarioValor da comissao

Ciclo de Vida​

Calculo Automatico​

Quando Calcula​

EventoMomento
Venda finalizadaAo mudar para status "paid"
Agendamento concluidoAo mudar para status "done"
ManualAo solicitar recalculo

Processo​

Detalhamento​

Exemplo de Comissao​

Comissao #1234
Profissional: Maria
Data: 15/01/2026
Status: Pendente
Valor Total: R$ 85,00

Itens:
| Item | Valor Venda | % | Comissao |
|------|-------------|---|----------|
| Banho Grande | R$ 80,00 | 20% | R$ 16,00 |
| Tosa Maquina | R$ 120,00 | 25% | R$ 30,00 |
| Hidratacao | R$ 60,00 | 20% | R$ 12,00 |
| Shampoo Premium | R$ 45,00 | 5% | R$ 2,25 |
| Perfume | R$ 35,00 | 5% | R$ 1,75 |
| Laco | R$ 15,00 | 5% | R$ 0,75 |
| ... | ... | ... | ... |

Aprovacao​

Fluxo de Aprovacao​

PassoAcao
1Comissao calculada automaticamente
2Supervisor revisa valores
3Aprova ou ajusta
4Comissao liberada para pagamento

Ajustes​

Antes de aprovar, pode-se ajustar:

  • Valor total
  • Itens individuais
  • Motivo do ajuste (obrigatorio)

Pagamento​

Individual​

Pagar uma comissao especifica:

1. Selecionar comissao aprovada
2. Confirmar pagamento
3. Gerar transacao financeira
4. Marcar como paga

Em Lote​

Pagar varias comissoes:

1. Selecionar periodo
2. Selecionar profissional (ou todos)
3. Filtrar aprovadas
4. Gerar pagamento em lote
5. Uma transacao por profissional

Integracao Financeira​

Geracao de Transacao​

Ao pagar comissao:

FinancialTransaction
type: expense
status: done
value: valor_comissao
category: "Comissoes"
description: "Comissao #1234 - Maria"
professional_id: profissional

Folha de Pagamento​

Comissoes podem ser:

  • Pagas separadamente
  • Somadas ao salario
  • Pagas em data especifica

Relatorios​

Relatorio de Comissoes​

FiltroOpcoes
PeriodoData inicio/fim
ProfissionalTodos ou especifico
StatusPendente, aprovada, paga
LojaTodas ou especifica

Indicadores​

IndicadorDescricao
Total pendenteValor a pagar
Total pago periodoValor pago no periodo
Media por profissionalMedia de comissao
RankingMaiores comissoes

Estorno​

Quando Estornar​

SituacaoAcao
Venda canceladaEstornar comissao
DevolucaoEstornar proporcional
Erro de calculoRecalcular

Processo de Estorno​

1. Identificar comissao original
2. Criar comissao negativa (estorno)
3. Se ja paga: gerar transacao de estorno

Validacoes​

CampoRegra
professional_idObrigatorio
valueMaior que zero
originObrigatoria

Regras de Negocio​

Comissao Minima​

Se tabela tem valor minimo e profissional nao atingiu:

  • Nao gera comissao (valor zero)
  • Ou gera com valor minimo

Divisao de Comissao​

Se servico feito por mais de um profissional:

  • Pode dividir comissao
  • Percentual de cada um definido

Periodo de Referencia​

Comissoes podem ser:

  • Por venda (imediata)
  • Por periodo (semanal/mensal)

Permissoes​

AcaoDescricao
VisualizarVer comissoes
AprovarAprovar comissoes
PagarRegistrar pagamento
EstornarEstornar comissao
AjustarAlterar valores