Hubsoft integration with Gertel

About Gertel

Gertel is a company from Santa Cruz do Sul (RS) specializing in mobile services and is part of Grupo Gertel, which brings together the Gertel, 1Cel, Cluqi, and Clubo brands. As a mobile virtual network operator (MVNO), it allows the internet service provider (ISP) to sell voice and data plans under its own brand. Coverage is nationwide, using Vivo's network through Telecall's infrastructure. Gertel also manages the plans and provides technical and commercial support to the provider.

What the integration does

• Plan synchronization: Gertel plans are brought into Hubsoft through the integration screen.
• Line activation: in the customer's service, the agent selects the plan and area code and enters the chip's ICCID. After transmission, Hubsoft records the generated number.
• Full or partial blocking: when the customer's service is suspended in Hubsoft, the line is blocked in Gertel. The provider chooses whether blocking is full, the default, or partial, for all numbers or one number at a time.
• Top-up with an invoice: through the number's actions, the agent selects the top-up plan and enters the amount, service type, and due date. Hubsoft generates the top-up invoice and sends the request to Gertel.
• Plan change: through the number's actions, without deleting and registering the line again.
• Change of ownership: the number is assigned to another Hubsoft customer or service through the transmission queue.
• Number portability: when registering the line, by entering the number to be ported, or later through the number's actions. Hubsoft checks the status every hour.
• Cancellation: when the number or plan is deleted, the request enters the transmission queue for cancellation.
• MVNO report: lists services with Gertel lines and transmission errors.

What you need

• A contract with Gertel and the API username and password provided by Gertel.
• Chips identified by their ICCID.
• Hubsoft plans that will receive lines, marked with the "Service Allows MVNO" option.

How to activate

1. In Hubsoft, go to Settings > Integrations > MVNO > Add and select Gertel.
2. Enter the username and password. If you want, set the default blocking type.
3. Synchronize plans under Actions > Plans > Synchronize.
4. Under Settings > General > Services / Plans, select "Service Allows MVNO" for the plans that will have a mobile line.
5. In the customer's service, go to Other Options > MVNO Data > Add, select the plan and area code, enter the ICCID, and save.

The step-by-step guide with screenshots is on the Gertel page in the Hubsoft wiki.

Limitations

• Cancellation is not immediate in Gertel: the top-up already made remains valid until the end of the month, and cancellation prevents the next automatic top-up.
• Every top-up made through Hubsoft generates an invoice for the subscriber.

Gertel and Hubsoft Partnership

Gertel is a Hubsoft partner. See how it works on the Gertel partnership page.

Frequently asked questions

What is the difference between full and partial blocking?

The provider chooses how Gertel blocks the suspended subscriber's line. Full blocking is the default. The type can be set for the entire integration or for a specific number.

Can the subscriber keep a number from another carrier?

Yes. Portability can be requested when registering the line, with the number to be ported, or later through the number's actions. Progress is shown on the Status tab of the portability screen.

How do I charge for a one-time top-up?

Under MVNO Data > Actions > Top-up, enter the plan, amount, service type, and due date. Hubsoft generates the invoice for the subscriber and sends the top-up to Gertel.

Reviewed on 10/10/2026.