Saltar al contenido
Hubsoft
Logo Caixa

Boleto bancario

Integración de Hubsoft con Caixa

Hubsoft, el ERP para proveedores de internet, se integra con Caixa para boleto bancario, boleto bancario híbrido y débito automático. El boleto bancario se registra mediante el WebService de Caixa o por CNAB, y el pago regresa para cancelar la factura.

Caixa Econômica Federal atiende en todo el país. En Hubsoft, el proveedor registra boletos bancarios mediante la API de Caixa, activa el boleto bancario con código QR PIX y genera débito automático para cuentahabientes

Acerca de Caixa

Caixa Econômica Federal es una institución financiera constituida como empresa pública, con sede en Brasilia y presencia en todo el territorio nacional. Desempeña un papel central en políticas públicas, vivienda y programas sociales. Para el proveedor, es un banco de cobranza con alcance en prácticamente todos los municipios.

Qué hace la integración

  • Registro mediante la API: con el WebService habilitado, Hubsoft transmite el boleto bancario sin archivo de remesa. El registro se realiza en hasta 5 minutos. En facturaciones grandes, el envío se hace por lotes y puede tardar más.
  • CNAB 240 y 400: remesa y retorno en archivo, para registro y liquidación.
  • Boleto bancario híbrido: en la versión v2 de la API, cada boleto bancario registrado recibe un código QR PIX. El suscriptor paga mediante el código de barras o PIX.
  • Reconocimiento del pago: en el boleto bancario híbrido, Caixa envía un webhook cuando se paga el boleto bancario o PIX, y la rutina de pagos consulta la plataforma TotalBank para confirmar.
  • Débito automático: remesa y retorno en la versión 4, para suscriptores con cuenta en Caixa.

Qué necesitas

  • Cuenta en Caixa con convenio de cobranza. El gerente proporciona el convenio, la sucursal, la cuenta y la cartera.
  • Para la API: la modalidad WebService activada en la cartera de cobranza, dentro del mismo convenio.
  • Para el boleto bancario híbrido: las credenciales de la versión v2 y la clave de API proporcionadas por Caixa, además del acceso a TotalBank para consultar los pagos.
  • Para el débito automático: convenio de débito en cuenta en la versión 4.
  • Módulo Financiero de Hubsoft, incluido en la licencia.

Cómo activarlo

  1. En Configuración > Finanzas > Forma de Cobranza, crea la forma de cobranza con el banco 104 - Caixa Econômica Federal y homologa mediante remesa y retorno.
  2. Solicita al banco la habilitación del WebService en la cartera.
  3. Edita la forma de cobranza, activa la API en la pestaña API y completa los parámetros.
  4. Para el boleto bancario híbrido, indica en Parámetros Extra la versión v2, las credenciales, los datos de acceso a TotalBank y el parámetro de PIX.
  5. Genera un boleto bancario de prueba y comprueba que se haya registrado en hasta 5 minutos.
  6. Para el débito automático, crea otra forma de cobranza con el tipo de convenio V4 y homologa con un cliente de prueba.

La guía paso a paso con las pantallas está en la wiki de Hubsoft: boleto bancario Caixa y débito automático Caixa.

Limitaciones

  • Sin los datos de acceso a TotalBank, Hubsoft no puede consultar los pagos del boleto bancario híbrido.
  • El webhook de Caixa es configurado por el propio banco.
  • El débito automático solo debita cuentas de Caixa y funciona únicamente mediante remesa y retorno. La remesa debe enviarse al menos 5 días antes del vencimiento.

Preguntas frecuentes

¿El débito automático de Caixa debita una cuenta de otro banco?

No. Un banco solo debita cuentas propias. Para el suscriptor de otro banco, usa el boleto bancario.

¿Por qué el boleto bancario no se registró mediante la API?

Los errores suelen ser específicos de algún dato del cliente o de la comunicación con el banco. El soporte de Hubsoft analiza el caso.

¿Necesito enviar una remesa si uso la API?

Para registrarlo, no. Hubsoft transmite el boleto bancario mediante el WebService de Caixa.

Revisado el 10/10/2026.

Integraciones similares

Cables de fibra óptica iluminados convergiendo hacia un punto de conexión

¿Quieres usar esta integración en tu proveedor?

Contáctanos

Da el primer paso para superar a tus competidores: solicita una demostración y descubre cómo Hubsoft se diferencia de los demás softwares.

Sea nuestro socio

Cuéntenos sobre su empresa y nuestro equipo de alianzas se pondrá en contacto.

Socio(a): consultoría, reventa o recomendación. Producto: una solución que se integra con Hubsoft.

Antes de irte: ¿quieres hablar con un especialista?

Déjanos tus datos y nuestro equipo te mostrará, en una conversación rápida, cómo Hubsoft puede simplificar la operación de tu proveedor.