Integración de Hubsoft con Efí

Acerca de Efí

Efí, conocida hasta 2023 como Gerencianet, es una institución de pagos brasileña orientada a empresas. Ofrece cuenta digital, emisión de boletos bancarios y carnés, Pix y cobros con tarjeta, todo mediante API. Para el proveedor de internet, funciona como un banco de cobros sin sucursal: la cuenta se abre por internet y las credenciales de integración se obtienen desde el propio panel.

Qué hace la integración

La integración utiliza las API de Cobranças y Pix de Efí. Después de configurarla, estos procesos ocurren automáticamente:

• Registro del boleto bancario y del carné cuando se genera la factura, con cancelación y cambio de fecha de vencimiento realizados por Hubsoft.
• Código QR y código Pix «copia y pega» en el boleto bancario, en la Central del Suscriptor y en la Aplicación del Cliente.
• Boleto híbrido (Bolix): boleto bancario y Pix en el mismo cobro, con un solo registro.
• Pix Automático: el suscriptor autoriza una vez en su banco y las siguientes mensualidades se debitan en la fecha acordada, en cualquier banco brasileño.
• Pago con tarjeta de crédito desde la Central del Suscriptor y la aplicación, con respuesta inmediata.
• Liquidación automática de la factura: Efí informa a Hubsoft sobre el pago, y Hubsoft también consulta los Pix pagados cada 8 minutos.
• Split Pix: el cobro puede dividirse entre hasta 20 cuentas, por porcentaje o valor fijo, directamente en la integración.

Qué necesitas

• Cuenta Efí de persona jurídica.
• Una aplicación creada en el panel de Efí con la API de Cobranças y la API Pix activas (Client ID y Client Secret).
• Certificado digital generado en el panel de Efí; el soporte de Hubsoft convierte el archivo al formato utilizado por Hubsoft.
• Una clave Pix registrada en la cuenta Efí, preferiblemente aleatoria.
• Módulo Financiero de Hubsoft, incluido en la licencia.

Cómo activar

1. En el panel de Efí, en API, crea una nueva aplicación, activa la API Pix y la API de Cobranças y copia el Client ID y el Client Secret de producción.
2. También en Efí, en API > Meus Certificados, genera un certificado y descarga el archivo.
3. En la aplicación de Efí, registra o copia la clave Pix de la cuenta.
4. En Hubsoft, en Configuração > Integrações > Pagamento, agrega Efí con las credenciales para boleto bancario y carné.
5. En Configuração > Integrações > PIX, agrega Efí con las credenciales, el certificado y la clave Pix. La modalidad predeterminada es el cobro con vencimiento; Pix Automático se activa en el mismo registro.
6. Usa Ações > Testar integração para validar las credenciales antes de asociar la cartera a los planes o clientes.

El paso a paso con las pantallas está en la wiki de Hubsoft: integración de boleto bancario con Efí y integración de Pix con Efí.

Limitaciones

• Pix Automático no aplica descuento por pago hasta el vencimiento: el valor autorizado siempre es el valor total de la factura. Para ofrecer descuento por pago puntual, usa Pix convencional o el boleto bancario.
• El pago con tarjeta es por factura, no recurrente: Efí no guarda la tarjeta para cobrar el mes siguiente. Para pagos recurrentes, usa Pix Automático.
• El pago con tarjeta no tiene un entorno de pruebas en Efí; la prueba se realiza con un cobro real de bajo valor.

Alianza entre Efí y Hubsoft

Efí es partner de Hubsoft y ofrece condiciones especiales a quienes abren la cuenta mediante el cupón de la alianza. Descubre cómo funciona en la página de la alianza con Efí.

Preguntas frecuentes

¿La liquidación del pago es automática?

Sí. Efí notifica a Hubsoft cuando se paga el boleto bancario o Pix, y la factura se liquida sin intervención. Los Pix también se consultan cada 8 minutos, por lo que la liquidación puede tardar hasta ese tiempo en aparecer.

¿Puedo usar Efí solo para Pix y otro banco para el boleto bancario?

Sí. Cada cartera de cobros de Hubsoft tiene su banco, y la elección puede hacerse por plan o por cliente.

¿El suscriptor debe autorizar Pix Automático todos los meses?

No. La autorización se realiza una vez, en la aplicación bancaria del suscriptor, y es válida para los siguientes cobros hasta que la cancele. Cada mes, Hubsoft registra el cobro antes del vencimiento con el valor de ese ciclo.

¿Hubsoft cobra por la integración?

No. Las integraciones bancarias están incluidas en la licencia de Hubsoft, sin cobro por integración. Las tarifas de boletos bancarios y Pix son las de Efí.

Revisado el 10/10/2026.