Hubsoft integration with Braz Móvel

About Braz Móvel

Braz Móvel is a mobile virtual operator accredited by Anatel. Personal Mobile Service is provided by Vivo, and Braz reports coverage in more than 4,500 cities, with 5G-compatible plans and no contract lock-in. Through the Braz para Provedores program, the internet service provider (ISP) can sell mobile services to its own customer base.

What the integration does

• Plan synchronization: Braz plans are imported into Hubsoft through the integration screen.
• ICCID activation: in the customer's service, the agent selects the plan and enters the SIM card's ICCID. Braz generates the number, and Hubsoft records it in the account when transmission is complete.
• Automatic account completion: the line is pre-activated at Braz. Hubsoft checks the activation every 5 minutes and only then links the plan. Those who do not want to wait can use the Complete Account action.
• Blocking and unblocking: when the customer's service is suspended or enabled in Hubsoft, the block or unblock request is sent to Braz.
• Block the entire line (optional): with the line-blocking parameter enabled, suspension and deletion block the line, not just the plan.
• Recurring checks: with recurring checks enabled, Hubsoft checks open invoices once a day and blocks or unblocks the line according to payment status.
• Subscriber password: the provider chooses which account data becomes the customer's password at Braz, such as the authentication login or CPF/CNPJ.
• Number portability: after activation, the provider registers portability by entering the originating operator. Hubsoft sends the request and checks the status every hour.
• Plan and SIM Card changes: through the number's actions, without deleting and re-registering the line or generating improper charges on the platform.
• Cancellation: when the number or plan is deleted, the cancellation is sent to Braz.
• MVNO report: lists services with Braz lines and transmission errors.

What you need

• A contract with Braz Móvel and the authentication token provided by Braz itself.
• Braz SIM cards identified by their ICCID.
• Hubsoft plans that will receive lines, marked with the "Serviço Permite MVNO" option.
• To bill the line through Hubsoft, a package linked to the number.

How to activate

1. In Hubsoft, go to Configuração > Integrações > MVNO > Adicionar and select Brazmóvel.
2. Enter the token and, if desired, the optional parameters for line blocking, recurring checks, and password.
3. Save and synchronize the plans under Ações > Planos > Sincronizar.
4. Under Configuração > Geral > Serviços / Planos, check "Serviço Permite MVNO" for the plans that will have a mobile line.
5. In the customer's service, go to Outras Opções > Dados MVNO > Adicionar, select the plan, and enter the ICCID.
6. Wait for transmission: the number appears in the account when Braz completes the activation.

The step-by-step instructions with screenshots are on the Braz Móvel page in the Hubsoft wiki.

Limitations

• The number is not selected in the account: Braz generates it from the ICCID.
• Activation is not immediate. Until Braz releases the line, the number remains pending completion.
• Without the line-blocking parameter, suspension blocks only the line's plan.

Frequently asked questions

If the customer's service is suspended due to nonpayment, is the line also suspended?

Yes. The suspension in Hubsoft enters the transmission queue, and the block is sent to Braz. When the service is enabled, the unblock request follows the same process.

Why doesn't the number appear right after saving?

Because Braz generates the number after registration. Hubsoft checks the activation every 5 minutes and records the number when the line becomes active. The Complete Account action forces this check immediately.

Can the subscriber bring a number from another operator?

Yes. Register portability in the number's actions, including the originating operator. Progress appears on the Status tab of the portability screen.

Reviewed on 10/10/2026.