Ir para o conteúdo

Roteiro: Criar operadora (carrier)

Perfil necessário: admin Menus usados: Roteamento Risco: baixo ao criar (a operadora só entra no runtime no próximo Publicar plano); médio se criada com RN1 errado (a rota passa a filtrar destino pelo RN1 da BDO, e um RN1 errado direciona tráfego para o tronco errado quando publicado) Rollback: excluir a operadora na própria aba ([OK] na confirmação) ou desligar o toggle Ativa; recarregar não é necessário — a mudança só vale a partir da próxima publicação de plano

Pré-requisitos

  • [ ] RN1 (código de operadora usado na portabilidade/BDO) da prestadora em mãos — ex.: 15 (TIM), 21 (Vivo), 31 (Oi)
  • [ ] Perfil admin (criação exige admin; viewer só consulta)
  • [ ] Se a operadora vai receber tráfego LDI: confirmar a capacidade antes de marcar Suporta LDI

Passo a passo

1. Abrir a aba Operadoras

Caminho: Roteamento → Operadoras e Troncos → aba Operadoras Clique: [Operadoras] (tab do topo da página)

Aba Operadoras da página Operadoras e Troncos

Resultado esperado: listagem de operadoras com colunas RN1, Nome, CNPJ, Cód. Anatel, LDI e Ativa.

2. Abrir o dialog Nova Operadora

Clique: [Nova Operadora] (toolbar da listagem)

Botão Nova Operadora destacado na aba Operadoras

Resultado esperado: dialog Nova Operadora abre com os campos abaixo.

3. Preencher e salvar

Preencha:

Campo Obrig. Formato/exemplo Efeito
RN1 * sim 15 Código Anatel/RN1 da operadora; é o valor casado contra o rn1_out devolvido pela BDO quando a rota filtra Operadoras Destino (RN1); também vira carrier code em dlg_val/CDR. Único por operadora
Nome * sim TIM Wholesale Nome comercial; usado só na UI e relatórios
CNPJ não 12345678000199 Informativo/auditoria; não participa do roteamento
Código Anatel não TIM Informativo; não participa do roteamento em runtime
Suporta LDI não toggle (default desligado) Marca que a operadora entrega internacional; informativo — a capacidade real vem da cobertura dos troncos
Ativa não toggle (default desligado) Se desligada, a operadora não entra no plano compilado. Para sair do draft para produção, ligue antes de publicar

Clique: [Criar] (rodapé do dialog; [Salvar] quando editando)

Resultado esperado: toast "Operadora salva com sucesso", dialog fecha e a operadora aparece na listagem com a tag Ativa = Não enquanto não for habilitada.

A criação não recarrega nem publica nada por si só. Para a operadora valer no roteamento: ligue Ativa, crie tronco e rotas (roteiros próprios) e feche com [Publicar plano] no topo da página (roteiro carrier-homologation.md).

Validação

  • [ ] Visual: operadora listada na aba Operadoras com RN1/Nome corretos e tag de status esperada
  • [ ] Funcional: GET /api/carrier-routing/carriers (Swagger /api/docs) retorna a operadora nova
  • [ ] Funcional: o seletor Operadora do dialog Novo Tronco e o Operadoras Destino (RN1) de Nova Rota por Operadora já listam a operadora

Erros comuns

Sintoma Causa provável Correção
"RN1 da operadora é obrigatório" ao salvar RN1 vazio informe o RN1 antes de Criar
"Nome é obrigatório" ao salvar Nome vazio informe o nome comercial
Toast de erro ao salvar com RN1 preenchido RN1 já existe para outra operadora (rn1 é unique no banco) usar o RN1 correto da prestadora ou editar a operadora existente
Operadora criada mas roteamento não muda esperado: catálogo não é runtime publicar o plano com [Publicar plano] (ver carrier-homologation.md)
Operadora não aparece no seletor do tronco/rota recarregue a página — os selects vêm de /carrier-routing/options recarregar a página (F5) e refazer o dialog

Tabela de referência rápida

Ação Onde Botão
Criar operadora aba Operadoras [Nova Operadora] → [Criar]
Editar operadora linha da tabela ícone de edição → [Salvar]
Excluir operadora linha da tabela ícone de exclusão → [OK]
Ligar/desligar no plano dialog da operadora toggle Ativa → [Salvar]