Ir para o conteúdo

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.