Integración de Hubsoft con Bradesco

Acerca de Bradesco

Bradesco es uno de los mayores grupos financieros de Brasil, en actividad desde 1943, con sede en Osasco, São Paulo. Tiene agencias o puntos de atención en buena parte de los municipios del país. Para el proveedor, esto significa contar con un banco de cobranza disponible en casi cualquier región.

Qué hace la integración

• API V2: Hubsoft envía al banco el registro, el cambio de vencimiento y la baja por cancelación o pago, sin archivo de remesa. La respuesta se lee mediante la rutina de verificación de boletos bancarios en la API Bancaria.
• Registro en hasta 5 minutos: en la API, el boleto bancario queda registrado en hasta 5 minutos. En facturaciones grandes, el envío se realiza por lotes y puede tardar más.
• CNAB 240 y 400: la remesa y la respuesta en archivo siguen disponibles.
• PIX con vencimiento (COBV): el PIX tiene fecha de vencimiento, intereses, multa y descuento hasta el vencimiento, como el boleto bancario. Hubsoft envía, consulta y cancela el PIX automáticamente, con verificación de los pagos cada 8 minutos.
• PIX en la factura: código QR en la impresión del boleto bancario y PIX para copiar y pegar en la visualización de la factura.

Lo que necesitas

• Cuenta en Bradesco con convenio de cobranza.
• Certificado digital de la empresa registrado en Hubsoft. La clave pública del certificado se envía al banco.
• Para la API V2: la habilitación de la funcionalidad 175 - Registro vía Webservice y las credenciales generadas en el panel developers de Bradesco.
• Para PIX: la activación de PIX COBV por parte del gerente, las credenciales de PIX y una clave PIX, preferentemente aleatoria.
• Módulo Financiero de Hubsoft, incluido en la licencia.

Cómo activar

1. Crea la forma de cobranza en Configuración > Financiero > Forma de Cobranza, con el banco 237 - Banco Bradesco S/A, y homologa mediante remesa y respuesta.
2. Registra el certificado en Configuración > General > Certificado Digital y descarga la clave pública en Acciones > Descargar Clave Pública.
3. Solicita al gerente la habilitación del Registro vía Webservice y genera las credenciales en el panel developers.
4. En la pestaña API de la forma de cobranza, activa las acciones deseadas. En Parámetros Extra, informa la versión v2 y las credenciales. En la pestaña Certificado, vincula el certificado.
5. Registra la rutina de verificación de boletos bancarios en la API Bancaria para que los pagos se compensen.
6. Para PIX, registra Bradesco en Configuración > Integraciones > PIX, con las credenciales, la clave, el certificado y la caja financiera, y vincúlalo a la forma de cobranza.

El paso a paso con las pantallas está en la wiki de Hubsoft: boleto bancario Bradesco y PIX Bradesco.

Limitaciones

• Bradesco no tiene PIX Automático en Hubsoft.
• La API V0, más antigua, solo realiza el registro del boleto bancario.
• En el PIX separado del boleto bancario, el pago por PIX debe generar la baja del boleto bancario en el banco para evitar pagos duplicados mediante el código de barras.
• Los diseños de carnés no muestran el código QR automáticamente. Se necesita un diseño específico, que configura el soporte.
• PIX COBV acepta pagos hasta 60 días después del vencimiento.

Preguntas frecuentes

¿Qué versión de la API debo usar?

La V2, con credenciales generadas en el panel developers de Bradesco. La V1 y la V0 siguen documentadas para quienes ya las utilizan.

¿El PIX de Bradesco cobra intereses después del vencimiento?

Sí. PIX COBV aplica intereses, multa y descuento como el boleto bancario, y puede pagarse hasta 60 días después del vencimiento.

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

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

Revisado el 10/10/2026.