Skip to main content

Integração Braz Móvel - Guia de Uso

sgptsmx-petroleo.png

1. Introdução

O que é Braz Móvel?

A Braz Móvel é uma MVNO (operadora móvel virtual) brasileira especializada em soluções de mobilidade e conectividade para o setor de telecomunicações. Com foco em serviços de telefonia e internet móvel, a empresa se posiciona como uma alternativa flexível e inovadora no mercado, oferecendo soluções personalizadas para o segmento corporativo e adaptando-se às necessidades específicas de cada cliente.

Este documento apresenta o processo de integração entre a Braz Móvel e o sistema SGP, com o objetivo de centralizar o gerenciamento dos serviços de banda larga e telefonia móvel em uma única plataforma.

A integração tem como propósito simplificar e automatizar a gestão de clientes, contratos, inadimplência e os processos de ativação e manutenção dos serviços, promovendo maior eficiência operacional e melhor experiência para o cliente final.

  • Unificação do gerenciamento de banda larga e telefonia móvel;
  • Simplificação de processos operacionais;
  • Melhoria na gestão de inadimplência;
  • Ampliação da oferta de serviços de telecomunicações.

2. Cadastro Inicial – Planos de Telefonia

Para iniciar a integração com a Braz Móvel, siga os passos abaixo para cadastrar os contratos e planos corretamente.

2.1 Criar Grupo de Contrato

Acesse o menu:

Financeiro
→
Cadastros
→
Contrato
→
Cadastrar Contrato

contratos.png

Crie um contrato com:

  • Grupo: Telefonia
  • Descrição: Nome descritivo do contrato
  • Status: Disponível

svycontrato.png

2.2 Cadastrar Plano de Telefonia

Após o cadastro do grupo de contrato, podemos criar o plano de Telefonia através do Menu:

Administração
→
Planos
→
Cadastrar
→
Telefonia

planos.png

  • Defina uma descrição para o plano
  • Associe ao grupo de contratos Telefonia
  • Configure os planos de contas de Mensalidade e Adesão
  • Definir se o plano é Pós-Pago ou Pré-Pago

plano.png

2.3 Aba "Dados Técnicos"

  • Gateway: Selecione o Braz Móvel
  • UUID: Selecione o plano
  • Auto Bloqueio: marque como habilitado

plano.png

3. Contrato do Cliente

3.1 Novo contrato exclusivo de Telefonia

  • Ir no cadastro do cliente → Guia Contrato
  • Clique em Cadastrar Contrato/Serviçocontratotv.png
  • Tipo de contrato: Telefonia
  • Selecione o POP do clienteconttele.png
  • Em Dados Telefonia
    • Escolha o Plano de Telefonia
    • Email/Usuário: Insira um e-mail válido para o cliente acessar o app mobile da plataforma Braz Móvel;
    • Senha Web: Senha de acesso ao APP. Deve ter entre 6 e 20 caracteres.2025-08-08_11-57.png

3.2 Adicionar serviço de Telefonia a contrato já ativo

  • Na aba Contratos, clique em Opções → Adicionar Serviço de Telefoniaservtel.png
  • Em Dados Telefonia
    • Escolha o Plano de Telefonia
    • Email/Usuário: Insira um e-mail válido para o cliente acessar o app mobile da plataforma Braz Móvel;
    • Senha Web: Senha de acesso ao APP. Deve ter entre 6 e 20 caracteres.2025-08-08_11-57.png

4. Gestão de Usuários e Contratos

A integração com a plataforma Braz Móvel foi desenvolvida para oferecer eficiência, controle e automação na gestão de usuários de Telefonia vinculados aos contratos. Abaixo, veja como funcionam os processos de ativação, bloqueio e cancelamento.

4.1. Ativação do Serviço

O processo de ativação do serviço ocorre logo após o cadastro do contrato ou do serviço do cliente

4.1.1. Novo Contrato

Em caso de ativação de um novo contrato, devemos seguir o processo padrão:

  1. Acessando o cadastro do cliente, basta clicar no botão Status:ativarcontrato.png
  2. Em seguida alterar para Ativo e depois Cadastrar:ativar.png
  3. Após ativação o será criado um cadastro para o cliente no Braz Móvel
  4. Após esse processo, siga para o menu Cadastro e Gerenciamento de Linha
4.1.2. Novo Serviço

Esse é o processo de ativação quando o serviço é cadastrado em um contrato já existente

  1. Acessando a guia de contratos do cliente, identifique o serviço inativo e clique sobre ele para editarativar serv.png
  2. Em Dados do Serviço clique em Ativar:ativserv2.png
  3. Após ativação o será criado um cadastro para o cliente no Braz Móvel
  4. Após esse processo, siga para o menu Cadastro e Gerenciamento de Linha

4.2. Bloqueio de Contrato

O processo de bloqueio de contrato funciona de forma autônoma, sem depender da comunicação com sistemas externos.

Para isso, o autobloqueio deve estar ativo nos planos criados nos passos anteriores.

O processo de bloqueio manual também é possivel através da alteração de status do contrato ou desativação do serviço.

4.3. Cancelamento de Contrato

Quando um contrato com serviço de Telefonia é cancelado, é enviado uma requisição para o Braz Móvel para que a linha seja cancelada/removida.

Esse processo ocorre em cancelamentos:

  • Manuais, realizados por um operador;
  • Automáticos, por inadimplência ou outras regras.

5. Cadastro e Gerenciamento de Linha

A ativação do da linha MVNO consiste em realizar a ativação de um novo numero ou solicitar a portabilidade de uma operadora para a Braz Móvel.

A plataforma Braz Móvel valida os seguintes dados para a ativação de uma linha MVNO:

  • Data de nascimento;
  • E-mail
  • Nome/Razão social;
  • CPF/CNPJ;
  • Gênero;
  • Endereço (campos CEP, Endereço, Número, Complemento).

Atente-se ao cadastro do cliente para que todos estes dados estejam devidamente cadastrados.

5.1. Cadastro de Linha

Após realizar o cadastro do contrato/serviço, podemos clicar sobre o serviço de Telefonia para edita-lo e acessar a guia de Linhas

  • Ao acessar a guia de Linha, basta clicar no botão Adicionar Linha para cadastrar uma linha para um cliente

    linha.png

  • Em seguida basta definir o SimCard e o DDD
    • Ao definir esses dados, uma linha disponível no Braz Móvel será atribuída ao SimCard

      numero.png

  • Após cadastro da Linha ela deverá aparecer no sistemalinha.png

5.2. Sincronização de Linha

Após realizar o cadastro do contrato/serviço, podemos clicar sobre o serviço de Telefonia para edita-lo e acessar a guia de Linhas

  • Ao acessar a guia de Linha, basta clicar no botão Sync Integração para cadastrar uma linha para um cliente

    sync.png

  • Caso tenha linha vinculada ao cliente, ela deverá aparecer no sistema

    linha.png

5.3. Portabilidade

Após realizar o cadastro do contrato/serviço, podemos clicar sobre o serviço de Telefonia para edita-lo e acessar a guia de Linhas

  • Ao acessar a guia de Linha, basta clicar no botão Adicionar Linha para cadastrar uma linha para um cliente

    linha.png

  • Para realizar a portabilidade é preciso definir os seguintes dados:
    • Número da linha atual que será portada
    • SimCard do novo chip disponibilizado para o cliente
    • DDD
    • Marcar a checkbox de Portabilidade

      port.png

  • Após cadastro da Linha ela deverá aparecer no sistemalinha.png
  • Com a conclusão do processo por parte do cliente, é possivel validar em Opções → Validar Portabilidadevalida.png

5.4. Recarga

O processo de Recarga pode ser solicitado pelo SGP para clientes com o Plano Pré-pago, pois esse tipo de plano não envia o atributo de recorrência e exige recarga manual para manter o serviço ativo.

  • Esse processo pode ser realizado através da guia Linha → Opções → Recargarecarga.png
  • Basta selecionar o tipo de recarga e cadastrartiporecarga.png

Para cliente com o Plano Pós-pago na ativação, a recorrência é configurada automaticamente, mas deve seguir as regras abaixo:

  1. Faturamento e prazo de suspensão
    • No SGP, ao gerar a fatura, considerar no máximo 1 dia de atraso.
    • Se não houver pagamento/recorrência dentro desse prazo, suspender o serviço.
  2. Recorrência Brazmóvel
    • Segundo as regras da Brazmóvel, com 1 dia de atraso sem recorrência, o serviço deve ser suspenso.
    • Aplicar esse mesmo prazo também para planos Brazmóvel.

6. Funcionalidades Disponíveis

Funcionalidade Disponível
Suspende a linha ao suspender no SGP ✔️
Remove a linha ao cancelar no SGP ✔️
Redução de Velocidade (aplica bloqueio parcial) ✔️
Portabilidade ✔️
Sincronização de Linha ✔️
Recarga ✔️

tsmx-petroleo.png

Back to top