Roteiro: Auditar tarifação ponta a ponta (chamada → CDR → ciclo → valores)¶
Perfil necessário: admin Menus usados: Comercial (Tarifação, Planos), Operação (CDR) Risco: baixo (auditoria; nenhuma mutação) Rollback: não aplicável
Pré-requisitos¶
- [ ] Chamada de teste completada (200 OK, com duração)
- [ ] Cliente com plano/franquias configuradas
- [ ] Janela de faturamento conhecida (período do ciclo)
Passo a passo¶
1. Localizar a chamada no CDR¶
Operação → CDR, filtrar por período/cliente/linha. Conferir: código 200, duração, tipo de chamada, rota, tarifação aplicada (colunas de rating).
2. Conferir a classificação da chamada¶
- Tipo de chamada no CDR deve bater com o esperado (LOC/LDN/MOV/INT).
- Se divergir: rodar Testar Classificação com o A/B da chamada e comparar motivo do match.
3. Conferir o plano e franquias¶
Comercial → Planos → Editar plano do cliente: a franquia do tipo de chamada deve cobrir o tipo classificado. Exemplo: chamada LDN_MOB consome franquia do tipo LDN/MOB conforme escopo (Por Cliente / Por Linha).
4. Conferir consumo em Tarifação¶
Comercial → Tarifação → aba Uso Atual
- Selecionar cliente/linha da chamada de teste
- O bucket da franquia deve ter incrementado pelo consumo da chamada
- Excedente aparece destacado quando a franquia estoura
5. Fechamento do ciclo¶
Aba Ciclos Fechados: o ciclo do período acumula Assinatura + Excedente = Total. Validar: - [ ] Quantidade de chamadas do ciclo bate com CDR filtrado no período - [ ] Valor unitário × quantidade = total por tipo - [ ] Assinatura do plano aplicada - [ ] Nenhum CDR sem tarifação dentro do ciclo (chamada 200 sem rating = bug de rating)
6. Divergência? Escalar¶
- CDR tarifa ≠ esperado → revisar classificação/plano/vínculo de plano na linha
- Consumo não abate → verificar franquia do tipo correto e escopo (cliente vs linha)
- Ciclo com total zerado com tráfego real → investigar período/janela do ciclo
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Chamada sem tarifa | classificação falhou ou plano ausente na linha | vincular plano; testar classificação |
| Franquia não abate | escopo errado (Por Cliente vs Por Linha) | revisar escopo da franquia |
| Excedente não aparece | bucket cheio mas ciclo ainda aberto | aguardar fechamento ou conferir status |
Impacto operacional¶
- Auditoria de tarifação é a garantia de receita: um rating errado multiplica por todo o tráfego do tipo.
- Para qualquer mudança de rating, o DoD do projeto exige cenário de rating + CDR conferido (docs/context/TESTS.md).