Documento de estudo do processo de apuração de comissão de ordens de serviço da Ditrasa (concessionária agrícola), antes do desenvolvimento do agente. Fatos confirmados separados de questões em aberto; regras ambíguas viram exceção, nunca inferência silenciosa.
Todas as ordens de serviço são fechadas manualmente. Cinco etapas, todas com pessoa no meio:
Vocabulário: na Ditrasa quem recebe o fechamento é o RH, não "DP"/Departamento Pessoal.
Cargos: o técnico é o mecânico; o assistente técnico é o assistente do mecânico. A regra já é explícita — e regra explícita é o que um agente executa sem variar.
| Composição | Regra |
|---|---|
| Dois técnicos, mesmas horas | Comissão dividida ao meio |
| Técnico + assistente técnico | Assistente recebe metade das horas; em 4h juntos → 4h integrais ao técnico e 2h ao assistente |
| Mais de dois profissionais | Cálculo proporcional às horas de cada um |
| Caso especial | A planilha permite divisão manual |
Consequência para a proposta: a complexidade da apuração não é defeito a eliminar, é o preço de uma decisão comercial que funciona. Qualquer solução que simplifique o rateio está atacando o modelo de negócio, não a dor.
Todas as OS são fechadas manualmente. Não existe "parte automatizada e parte não" — o ganho é o fechamento inteiro, não um canto dele.
Dentro desse trabalho todo manual, a OS trabalhada em partes é o caso mais caro: dentro da mesma ordem de serviço, parte das horas foi executada individualmente e parte em dupla.
Uma OS de reforma de máquina com 20 horas. Um trecho o técnico fez sozinho → comissão integral. Outro trecho foi em dupla → entra o rateio, e a regra depende de quem era o par. Uma OS só, mais de um critério de apuração dentro dela.
Não existe divisão única para a OS: é preciso separar as horas por trecho, aplicar a regra correspondente a cada um e somar por profissional — profissional por profissional, OS por OS.
Wester respondeu ao levantamento enviado por e-mail. Respostas confirmadas:
| Tópico | Resposta | Estado |
|---|---|---|
| Comissionamento | Todos os técnicos são comissionados | confirmado |
| Esforço — Matriz | ~16 horas | confirmado |
| Esforço — BD/PTC/PM Jacto | 6–8 horas | confirmado |
| Esforço — MOC/PTU | ~4 horas | confirmado |
| Prazo | Fechamento começa dia 26, entrega até dia 27 | confirmado |
| Apontamento | Individual; por trecho no deslocamento, por período no trabalho | confirmado |
| Referência individual vs. dupla | Campo Dealer; erros humanos devem ser corrigidos, mas alguns permanecem | confirmado |
| Variação da comissão | Nível técnico + faturamento atingido; alguns percentuais fixos | confirmado |
| Retrabalho | Não gera comissão | confirmado |
| Garantia | Paga normalmente | confirmado |
| Horas internas | Desconto aplicado antes do faturamento | confirmado |
| Divisão manual | Sem padrão conhecido; precisa analisar planilha | aberto |
| Entrega ao RH | Planilha avaliada por Ricardo; não confirmado se RH redigita | aberto |
| API / banco / Solution | Verificar com Fabrício; existe export Excel com ajustes manuais | aberto |
| "~20% do processo" | Significado exato não confirmado | aberto |
| Acompanhante por trecho | Não esclarecido | aberto |
Este mapa é uma especificação de estudo, não uma autorização para automatizar regras ainda ambíguas. Dado ausente, divergência ou regra não confirmada deve virar exceção para revisão humana; o agente não deve inferir silenciosamente.
| # | Etapa | Entradas | Saídas | Controles a validar |
|---|---|---|---|---|
| 1 | Preparação da competência | Período, OS, níveis, percentuais, versão das regras | Escopo e parâmetros | Data de corte, competência, responsável |
| 2 | Execução e apontamento | OS, profissionais, registros | Horas individuais por trecho/período | Ausente, duplicado, incompatível, sem acompanhante |
| 3 | Conferência | OS, apontamentos, Dealer | Corrigidos ou fila de pendências | Não presumir que toda OS com erro foi corrigida |
| 4 | Fechamento manual | Dados conferidos e pendências | OS fechada (ou com ressalva) | Pendência bloqueia, exclui ou marca? |
| 5 | Classificação | OS fechada, faturamento, tipo | Base elegível | Formalizar retrabalho, garantia, hora interna, cancelamento |
| 6 | Decomposição e rateio | Trechos, horas, profissionais | Participação por pessoa | Regra por trecho, não plana; preservar ajustes manuais |
| 7 | Cálculo | Horas rateadas, nível, faturamento | Comissão por profissional | Fórmula, arredondamento, vigência, mínimos/tetos |
| 8 | Consolidação | Export bruto + regras + ajustes | Planilha final + memória de cálculo | Preservar original, ajuste e resultado separadamente |
| 9 | Validação | Planilha, exceções, memória | Aprovação ou devolução por Ricardo | Registrar divergências e alterações |
| 10 | Entrega | Planilha aprovada | RH | Layout, canal, aceite, tratamento pós-entrega |
Começar pequeno e expandir, por unidade. Em cada etapa, shadow mode: o agente apura em paralelo, mostra o que entregaria, compara-se lado a lado, e só então vira a chave.
Um técnico. Validar ingestão, Dealer, apontamentos, fechamento e cálculo básico. Confirmar ausência de rateios compartilhados. Executar em paralelo ao processo atual.
Três técnicos, sobreposição rara. Introduzir comparação de OS individuais, duplas e rateios. Testar exceções e overrides em volume controlado. Só avançar após Ricardo e RH concordarem que as divergências estão explicadas.
Operação maior. Somente após regras, campos, exceções e critérios de aprovação estabilizados. Expandir gradualmente, mantendo o processo manual como fallback.
Critérios de passagem: concordância por OS e pessoa, cobertura dos casos, quantidade/tipo de exceções, tempo de fechamento, ausência de divergência material para a folha. Limiares numéricos ainda não definidos.
Ruan Barroso
ruanbarroso@outlook.com
Interlocutores na Ditrasa: Wester (processo), Fabrício (infraestrutura), Ricardo (validação). Entrada pela Patrícia Barroso.
ERP: Solution/Solutium — API, banco e contato técnico a confirmar com Fabrício.
Comercial: projeto case, sem custo para a Ditrasa. A aposta é que o primeiro agente puxe os próximos processos.