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)

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)

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] |