Roteiro: Validar a classificação BR de uma chamada ponta a ponta no Classifier Tester¶
Perfil necessário: viewer (o teste é leitura; não altera dados nem runtime)
Menus usados: Roteamento
Risco: baixo — o Classifier Tester consulta as mesmas tabelas do runtime (partição classification, CADUP, BDO, SUP) sem mutar estado; nenhum número é roteado.
Rollback: não aplicável — teste somente leitura. Para reverter um cadastro que o teste denunciou, volte ao roteiro de origem (br-sup-bdo-cadup.md) e reverta o dado.
Pré-requisitos¶
- [ ] Números A e B reais no formato que o cliente envia (o teste canonicaliza para E.164
+55...). - [ ] Ao menos um cenário portado e um não portado, quando portabilidade estiver em pauta.
- [ ] CN/CNL esperadas do destino conhecidas (para conferir o resultado contra CADUP).
Passo a passo¶
1. Abrir o Testar Classificação¶
Caminho: Roteamento → Testar Classificação
Clique: [Executar Teste]

Preencha:
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Número A (origem) | sim | 5511999999999 |
origem da chamada; canonicalizado e resolvido em CN/UF/CNL |
| Número B (destino) | sim | 5511888888888, 08001234567, 190, 1056 |
destino a classificar (aceita forma nacional, 0800, SUP) |
| A-CN Override (opcional) | não | 11 |
sobrescreve a CN detectada do A para simular origem de outro DDD |
Resultado esperado: painel Resultado da classificação com os campos do passo 2; o teste entra no Histórico de testes (últimos 50, em localStorage do navegador), com botões de repetir e limpar por linha.
2. Ler o resultado da classificação¶
Caminho: painel Resultado da classificação na mesma tela Clique: — (somente leitura)

Preencha: nada. Campos do resultado e como ler cada um:
| Campo | O que mostra | Como ler |
|---|---|---|
| Tipo de Chamada | tag com Local, LDN, Movel, Int., Especial, Emerg., Desconhecido (backend: LOC_FIX/LOC_MOB/LDN_FIX/VC2_MOB/VC3_MOB/LDI/CNG/SUP/EMG) |
LOC = mesmo CN (A↔B); LDN/VC2/VC3 = mesma UF com CN diferente / UF diferente; CNG = cobrança reversa (0800/0300/0303); SUP/EMG = serviço público/emergência |
| CN Origem (A) | CN (DDD) resolvida do A (ou do override) | - significa que CADUP/BDO não resolveu a origem |
| CN Destino (B) | CN do B canônico | - idem, para o destino |
| Regime | tag STFC, SCMP, SEAC, SMP, Desconhecido; nos fluxos simplificados atuais o backend devolve 67_cns (regime de 67 CNs) |
regimes não usados no caminho atual aparecem como o valor cru |
| Motivo do Match | texto do oráculo: Mesmo CN, Mesma UF com CN diferente, UF diferente, Partição call_classification (dpid N), SUP exato em passthrough, SUP sem tradução para a CNL de origem, Numero encontrado na tabela dids, Classe B nao encontrada; fallback nacional, Dados insuficientes para resolver os CNs; fallback nacional |
explica por que aquele tipo foi escolhido; é o campo de depuração principal |
| Classe B | tag Fixo, Movel, Especial, Emergencia, Desconhecido |
classe estrutural do B (FIX/MOB) usada para derivar LOC_FIX vs LOC_MOB, VC2 vs VC3 etc. |
| SUP Discado | código SUP reconhecido no catálogo (ex.: 190, 1056) |
aparece só quando o B é um SUP cadastrado |
| CNL Origem BDO | CNL da origem resolvida via BDO | insumo para casar a tradução do SUP por CNL |
| SUP Traduzido | número principal E.164 para o qual o SUP será substituído | vazio quando não há tradução para a CNL — a chamada real seria rejeitada (404) |
| Erro SUP | mensagem de falha do caminho SUP (catálogo desincronizado, sem CNL de origem via BDO etc.) | resolver no cadastro SUP/BDO antes de confiar no teste |
O backend também calcula categoria tarifária e rating bucket do tipo resultante (tariff_category, rating_bucket_code), visíveis na resposta da API — base de conferência com a Tarifação.
3. Reproduzir e comparar cenários no histórico¶
Caminho: card Histórico de testes (mesma tela) Clique: ícone ↻ (Repetir teste) na linha desejada
Preencha: nada — o teste da linha é reexecutado com os mesmos números.
Resultado esperado: resultado atualizado no painel e nova entrada no histórico. Use pares A/B alternados (portado × não portado, CN igual × diferente) para confirmar que a classificação muda pelo motivo certo (Motivo do Match deve mudar junto com o Tipo).
Validação¶
- [ ] Visual: painel de resultado exibe Tipo, CNs, Regime, Motivo, Classe B e os campos SUP quando aplicável; histórico acumula os testes.
- [ ] Funcional: tipo resultante bate com a expectativa de negócio por cenário (mesmo CN → Local; UF igual/CN diferente → LDN/VC2; 0800 → CNG;
190→ Emerg.;1056cadastrado → SUP passthrough ou tradução). - [ ] Runtime: os
Motivo do Matchque citam a partição confirmam que o OpenSIPS e o tester leem a mesma fonte (call_classification,dpidemSistema → Configuração); divergência de resultado com chamada real investiga-se pelo CDR/call_logcom o mesmo A/B.
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
Informe o numero A/B e o teste não roda |
campos vazios | preencher A e B (o override é opcional) |
| 0800 classificado como LDI/Int. | dado de CADUP/localidades desatualizado para o B ou B fora do formato canônico | conferir prefixo do B em Sistema → CADUP → Prefixos e re-testar |
| SUP Traduzido vazio com CNL Origem BDO preenchida | sem tradução ativa daquela CNL no serviço | cadastrar tradução por CNL (ver br-sup-bdo-cadup.md) e repetir |
| Erro SUP: "Catálogo SUP desincronizado da partição classification" | catálogo salvo mas dp_reload classification falhou |
rever operação em Roteamento → Avançado → SUP (o CRUD recarrega sozinho; falha indica problema MI) |
CN Origem/Destino - |
número fora das faixas CADUP ou override inválido | validar número no CADUP; usar A-CN Override só com CN válida (2 dígitos) |
| Match inesperado com motivo citando dpid | regra manual na partição classification (Avançado → Dialplan) cobrindo o caso antes |
revisar prioridade/regex da regra manual; regras _pf/_lpn/_a são gerenciadas pelo sistema |