ST_COMISSAOTERCEIROS — Calcular Comissão Sobre Serviços de Terceiros
Tela de configuração: OFI001 — Parâmetros de Oficina Localização: Aba Ordem 1 Tabela / Campo:
PARMOFICINA.ST_COMISSAOTERCEIROSTipo:CHAR(1),NOT NULL, padrão'S'Controle na tela: CheckboxchkST_COMISSAOTERCEIROSDataSource:dmOFI001.dsoPARMOFICINA
Resumo
Define se os serviços de terceiros (campo ST_TERCEIRO = 'S' em ORDEMSERVITEM) são incluídos ou não na base de cálculo de comissões de vendedores/mecânicos nas Ordens de Serviço.
Quando habilitado ('S'), a comissão é calculada sobre todos os serviços da OS, incluindo os terceirizados. Quando desabilitado ('N'), apenas serviços próprios (ST_TERCEIRO = 'N') entram no cálculo.
Campos envolvidos
| Tabela | Campo | Relação |
|---|---|---|
PARMOFICINA | ST_COMISSAOTERCEIROS | Parâmetro (esta tela) |
ORDEMSERVITEM | ST_TERCEIRO | Indica se o item é serviço de terceiro |
ORDEMSERVITEM | VL_TOTAL | Valor do serviço usado na base de comissão |
ORDEMSERVITEM | VL_DESCONTO | Desconto do serviço usado na base de comissão |
Telas impactadas
| Tela | Uso |
|---|---|
| OFI001 | Configuração do parâmetro |
| MOF001 | Cálculo de totais da OS e comissão na emissão |
| MOF006 | Consulta de parâmetros durante validação de placa/veículo |
| LNF107 | Layout de impressão — totais de comissão |
Opções disponíveis
✓ — Marcado ('S' — Incluir serviços de terceiros na comissão)
| O que faz | Detalhe |
|---|---|
| Comportamento | Serviços terceirizados (ST_TERCEIRO = 'S') entram na base de cálculo de comissão |
| Editável | Sim, via checkbox na aba Ordem 1 |
| Restrição | Nenhuma |
Simulação passo a passo
- Acesse OFI001 (Parâmetros de Oficina).
- Na aba Ordem 1, localize o checkbox "Calcular Comissão Sobre Serviços de Terceiros".
- Marque o checkbox (fique marcado ✓).
- Clique em Salvar.
- Abra ou crie uma Ordem de Serviço em MOF001 com dois serviços: um próprio e um terceirizado.
- Informe um vendedor com comissão configurada.
- Finalize/emita a OS.
- Consulte o relatório de comissões (ROF004 ou ROF008).
Resultado esperado: A base de comissão do vendedor inclui o valor de ambos os serviços (próprio + terceiro). O total de serviços para comissão (VL_TOTSERVICOSCOMISS) soma todos os itens da OS.
✗ — Desmarcado ('N' — Excluir serviços de terceiros da comissão)
| O que faz | Detalhe |
|---|---|
| Comportamento | Serviços terceirizados (ST_TERCEIRO = 'S') são excluídos da base de cálculo de comissão |
| Editável | Sim, via checkbox na aba Ordem 1 |
| Restrição | Nenhuma |
Simulação passo a passo
- Acesse OFI001 (Parâmetros de Oficina).
- Na aba Ordem 1, localize o checkbox "Calcular Comissão Sobre Serviços de Terceiros".
- Desmarque o checkbox (fique vazio).
- Clique em Salvar.
- Abra ou crie uma Ordem de Serviço em MOF001 com dois serviços: um próprio (R$ 200,00) e um terceirizado (R$ 150,00).
- Informe um vendedor com comissão de 10%.
- Finalize/emita a OS.
- Consulte o relatório de comissões (ROF004 ou ROF008).
Resultado esperado: A base de comissão do vendedor considera apenas o serviço próprio (R$ 200,00). O serviço terceirizado (R$ 150,00) é ignorado no cálculo. A comissão será R$ 20,00 e não R$ 35,00.
Excecao / Importante: Este parâmetro atua em conjunto com
ST_CALCULOCOMISSAO(configurado na mesma tela, OFI001, aba Ordem 1). SeST_CALCULOCOMISSAO = 'N'(comissão desabilitada globalmente), este parâmetro não terá efeito prático pois o cálculo de comissão como um todo está desligado.
Regra Geral de Cálculo
O sistema segue esta lógica ao calcular comissões sobre serviços:
SE ST_COMISSAOTERCEIROS = 'S'
→ Soma TODOS os serviços da OS (próprios + terceiros)
SENÃO
→ Soma APENAS serviços com ST_TERCEIRO = 'N' (serviços próprios)
Esta regra é aplicada tanto no cálculo de totais em tela (MOF001, rotina Totais) quanto nas views de relatório de comissões (VIEW_ROF004, VIEW_ROF004B, VIEW_ROF008).
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | O que faz |
|---|---|---|
tabPARMOFICINAAfterInsert | source/OFI001/UdmOFI001.pas | Define valor padrão 'S' ao inserir novo registro |
chkST_COMISSAOTERCEIROSMouseMove | source/OFI001/UOFI001.pas | Exibe hint/status bar ao passar mouse sobre o checkbox |
Busca_Parametros | source/MOF001/UdmMOF001.pas | Lê o parâmetro para variável iST_COMISSAOTERCEIROS |
Totais | source/MOF001/UdmMOF001.pas | Filtra itens de serviço conforme o parâmetro para base de comissão |
Busca_Parametros | source/MOF006/UdmMOF006.pas | Lê o parâmetro para uso em MOF006 |
Calcula_Totais | source/LNF107/ULNF107.pas | Lê o parâmetro para cálculo de totais no layout de impressão |
Referências SQL diretas ao campo em Scripts/
| Procedure/View | Arquivo | O que faz |
|---|---|---|
VIEW_ROF004 | Scripts/VIEW_ROF004.sql | Soma serviços para comissão; filtra terceiros quando 'N' |
VIEW_ROF004B | Scripts/VIEW_ROF004B.sql | Constrói filtro dinâmico: SI.ST_TERCEIRO = PO.ST_COMISSAOTERCEIROS |
VIEW_ROF004B_V2 | Scripts/VIEW_ROF004B_V2.sql | Mesma lógica da VIEW_ROF004B (versão 2) |
VIEW_ROF004_OFXMM | Scripts/VIEW_ROF004_OFXMM.sql | Variante OFXMM do relatório de comissão |
VIEW_ROF008 | Scripts/VIEW_ROF008.sql | Relatório de comissões com filtro condicional por terceiros |
Candidatas por uso da tabela (sem referência direta ao campo)
Estas procedures/views acessam a tabela PARMOFICINA, mas não citam o campo ST_COMISSAOTERCEIROS nas evidências disponíveis:
PARCELA_FINANC_MNF017— Scripts/PARCELA_FINANC_MNF017.sqlPARCELA_FINANCIAMENTO— Scripts/PARCELA_FINANCIamento.sqlREABRE_OS— Scripts/REABRE_OS.sqlRETORNA_MOTIVOBLOQUEIO— Scripts/RETORNA_MOTIVOBLOQUEIO.sqlRETORNA_PRECOITEM— Scripts/RETORNA_PRECOITEM.sqlVERIFICA_BLOQUEIO— Scripts/VERIFICA_BLOQUEIO.sqlVIEW_DOCUMENTOSBLOQUEADOS— Scripts/VIEW_DOCUMENTOSBLOQUEADOS.sql
Parâmetros relacionados
| Parâmetro | Tela | Relação |
|---|---|---|
ST_CALCULOCOMISSAO | OFI001 — aba Ordem 1 | Habilita/desabilita cálculo de comissão globalmente; se 'N', ST_COMISSAOTERCEIROS não tem efeito |
ST_DESCONTOTERCEIROS | OFI001 — aba Ordem 1 | Controla se descontos de terceiros são aplicados (parâmetro independente, mesma área de configuração) |
ST_SERVTERCEIROS | OFI001 — aba Ordem 1 | Controla exibição/permissão de serviços de terceiros na OS |
Tabela Comparativa Resumida
| Aspecto | 'S' (Marcado) | 'N' (Desmarcado) |
|---|---|---|
| Serviços próprios na comissão | ✅ Incluídos | ✅ Incluídos |
| Serviços de terceiros na comissão | ✅ Incluídos | ❌ Excluídos |
| Valor padrão ao criar empresa | 'S' | — |
| Impacto em relatórios ROF004/ROF008 | Soma total | Filtra ST_TERCEIRO = 'N' |