Documente a regra antes de conferir o cálculo
Um percentual não define sozinho uma comissão. A especificação precisa identificar o fato de origem, o beneficiário, as condições de elegibilidade, a base e a versão da regra aplicável. Também precisa esclarecer quando o valor pode ser disponibilizado e como o pagamento será comprovado.
Use uma ficha para cada regra. O objetivo deste artigo é organizar sua documentação e seus testes. Os exemplos são hipotéticos: não descrevem um plano da UZA, não recomendam remuneração e não afirmam que qualquer tratamento seja automático no sistema.
Complete os campos que mudam o resultado
- Identificação e vigência
- Nome, versão, responsável pela aprovação e evento/data que determina a regra aplicável.
- Elegibilidade
- Quem pode receber, condições necessárias e momento em que elas devem estar atendidas.
- Base de cálculo
- Componentes incluídos e excluídos, como desconto, frete ou taxas, conforme a decisão comercial.
- Fórmula e limites
- Taxa, sequência do cálculo, condições por beneficiário e limites expressamente definidos.
- Arredondamento
- Precisão, critério adotado e momento em que o arredondamento ocorre.
- Cancelamento e correção
- Tratamento esperado para cancelamento total/parcial, pagamento desfeito e ajuste autorizado, preservando a referência ao lançamento original.
Preencha a ficha de regra e cenários de comissão junto com as pessoas responsáveis pelas regras comerciais, pelo financeiro e pelo cálculo. Um campo sem decisão fica pendente; não deve ser resolvido por suposição durante a configuração.
Exemplo hipotético: a mesma taxa, duas bases
Considere uma venda fictícia de R$ 200, desconto de R$ 20 e taxa hipotética de 5%. Sobre o valor anterior ao desconto, o resultado é R$ 10. Sobre o valor após o desconto, o resultado é R$ 9. A diferença vem da base, não da taxa.
Se o participante não atender à condição de elegibilidade definida para esse exemplo, o resultado esperado pode ser não conceder a comissão. Isso precisa estar escrito no cenário. A presença de uma venda não determina, por si só, o direito ao valor.
Exemplo hipotético: o momento do arredondamento
Imagine três itens de R$ 0,10, taxa fictícia de 5% e arredondamento convencional para centavos, elevando meio centavo ao centavo seguinte. Arredondar cada resultado de R$ 0,005 produz três parcelas de R$ 0,01: total R$ 0,03. Somar primeiro R$ 0,015 e só então arredondar produz R$ 0,02.
Esse exemplo apenas evidencia a necessidade de escolher e documentar o método. Ele não prescreve um método financeiro nem descreve o cálculo da UZA. Registre os valores esperados antes de pedir a validação técnica.
Separe cálculo, disponibilidade e pagamento
Comissão calculada é o resultado apurado conforme a regra do cenário. Saldo disponível depende das condições definidas para liberação. Valor pago exige o registro do pagamento correspondente. Um resultado correto na primeira etapa não comprova as outras duas.
Inclua nos testes uma venda válida, uma condição não atendida e um cancelamento total ou parcial. Defina o efeito esperado antes e depois da disponibilidade ou do pagamento. Não presuma estorno automático, compensação futura ou recálculo retroativo: cada tratamento precisa de decisão e comprovação.
Ao mudar a regra, preserve a versão anterior e esclareça qual evento determina a vigência para pedidos antigos e correções posteriores. Avalie a aplicação da ficha no Sistema MMN. A ligação entre pedidos, pagamentos e lançamentos fica no artigo de conciliação, que trata da conferência dos registros.