Roteiro: SUP não cadastrado (uncataloged) — comportamento e kill switch¶
Perfil necessário: admin
Menus usados: Comercial (Políticas de Saída), Sistema (Configuração)
Risco: médio (passthrough de SUP não catalogado pode mandar tráfego SUP para roteamento default)
Rollback: voltar sup_uncataloged_handling para reject no perfil / desligar o kill switch global
Contexto (ADR 0017)¶
Chamadas SUP (serviços públicos) discadas com código não presente no catálogo SUP podem: - reject (default): rejeitar a chamada - passthrough: deixar passar sem tradução (bypass)
O comportamento é definido por perfil de saída, com um kill switch global em Sistema → Configuração.
Passo a passo¶
1. Decidir o comportamento por perfil¶
Padrão seguro: reject. Use passthrough apenas quando o cliente tem contrato legítimo de serviços SUP próprios.
2. Configurar no perfil¶
Caminho: Comercial → Políticas → Políticas de Saída → editar perfil
Campo: SUP não cadastrado (1XX curto) → Passthrough ou Reject (default).
Aviso da UI: passthrough exige regra no perfil com tipo SUP; o prefixo B vazio vira catch-all.
3. Kill switch global¶
Caminho: `Sistema → Configuração → "SUP não cadastrado (bypass)"** - Global ON: permite passthrough (o perfil decide) - Global OFF: força reject em todos os perfis (ignora a configuração do perfil)
4. Criar a regra de rota SUP no perfil (para passthrough intencional)¶
No perfil com passthrough, crie regra com tipo Serviço (SUP) — o prefixo B vazio atua como catch-all para o SUP não catalogado.
5. Testar¶
- [ ] Testar Classificação com SUP catalogado: tradução normal (ver br-classification)
- [ ] SUP não catalogado com perfil reject: chamada rejeitada
- [ ] SUP não catalogado com perfil passthrough + kill switch ON: passa pelo tronco sem tradução
- [ ] Kill switch OFF: mesmo perfil passthrough rejeita (global vence)
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Passthrough não funciona | kill switch global OFF | ligar o global E o perfil |
| Tradução errada de SUP | conflito com código de serviço duplicado no catálogo | revisar catálogo SUP |
| Chamada SUP vazia passa para carrier | passthrough sem regra tipo SUP no perfil | criar regra SUP no perfil |
Impacto operacional¶
- Passthrough mal aplicado envia tráfego de serviço público para o carrier sem tradução CNL — risco regulatório.
- Mudança do kill switch é imediata (config runtime); mudança de perfil exige compilação/sincronização do perfil.