Integración de Hubsoft con Sicredi

Sobre Sicredi

Sicredi es un sistema brasileño de cooperativas de crédito, con agencias en varios estados y en el Distrito Federal. Ofrece cuentas corrientes, crédito, seguros y otras soluciones financieras a sus asociados. Para el proveedor asociado, Sicredi reúne boleto bancario, Pix, Pix Automático y débito automático en Hubsoft.

Qué hace la integración

• Boleto bancario mediante la API V1: registro, respuesta, cambio de fecha de vencimiento, baja y boleto híbrido. El registro ocurre hasta 5 minutos después de la emisión.
• Boleto bancario mediante la API V0: registro, respuesta, cambio de fecha de vencimiento, baja y descuento de valor, para quienes ya usan la versión anterior.
• Webhook: Sicredi avisa a Hubsoft en cuanto se paga el boleto bancario o el Pix. La rutina de verificación en la API también comprueba los pagos.
• CNAB 240 y 400: envío y respuesta en archivo.
• Pix: código QR y copiar y pegar en las facturas, con envío, consulta de pago y cancelación automáticos. Hubsoft verifica nuevos pagos cada 8 minutos.
• Pix Automático: el suscriptor autoriza la recurrencia una sola vez, mediante un código QR generado en su registro, y las mensualidades siguientes se debitan en la fecha acordada.
• Débito automático: envío y respuesta en las versiones 4 y 5, según el convenio contratado.

Qué necesitas

• Cuenta en Sicredi con convenio de cobranza.
• Para la API V1: cuenta en el portal de desarrolladores de Sicredi y una aplicación creada para la cuenta.
• Para el boleto híbrido: la opción habilitada en el convenio, confirmada con el gerente.
• Para Pix: las credenciales de Pix Sicredi y una clave Pix.
• Para el débito automático: convenio de débito en cuenta corriente V4 o V5.
• Módulo Financiero de Hubsoft, incluido en la licencia.

Cómo activar

1. En Configuración > Finanzas > Forma de cobranza, crea la forma de cobranza de Sicredi y realiza la homologación mediante envío y respuesta.
2. En el portal de desarrolladores de Sicredi, crea la aplicación y copia las credenciales.
3. En la pestaña Parámetros de la forma de cobranza, informa la versión v1 y las credenciales. Para el boleto híbrido, activa el parámetro de Pix.
4. Copia la URL del webhook y regístrala en Acciones > Webhook de la forma de cobranza.
5. Para Pix y Pix Automático, registra Sicredi en Configuración > Integraciones > PIX, con las credenciales, la clave Pix y la caja financiera. En Pix Automático, informa también los datos del receptor y la política de reintentos.
6. Vincula la integración de Pix con la forma de cobranza.

El paso a paso con las pantallas está en la wiki de Hubsoft: boleto bancario Sicredi, Pix Sicredi y débito automático Sicredi.

Limitaciones

• Sicredi no registra intereses diarios inferiores a R$ 0,01. En boletos bancarios de bajo valor, el banco registra el boleto sin esos intereses.
• El código QR del boleto híbrido solo aparece en los boletos bancarios registrados después de la activación.
• En Pix con validez hasta el vencimiento, Hubsoft genera un nuevo Pix por cada día de atraso, con los intereses actualizados.
• El débito automático solo debita cuentas de Sicredi y el envío debe realizarse al menos 5 días antes del vencimiento.

Preguntas frecuentes

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

La V1, que incluye boleto híbrido y webhook. La V0 sigue disponible para quienes ya la usan.

¿Por qué el boleto bancario de R$ 10 salió sin intereses?

Porque el interés diario quedó por debajo de R$ 0,01. Sicredi registra el boleto bancario, pero sin ese valor.

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

No. Para debitar una cuenta de cualquier banco, usa Pix Automático.

Revisado el 10/10/2026.