Integración de Hubsoft con Unicred

Acerca de Unicred

Unicred es una institución financiera cooperativa que ofrece cuentas, crédito y servicios a sus cooperados. La atención está a cargo de cooperativas, y cada una tiene su propio código registrado en la cuenta. Para el proveedor cooperado, la cartera de cobranza de Unicred puede utilizarse en Hubsoft mediante archivo o API.

Qué hace la integración

• Boleto híbrido mediante la API: el boleto bancario y Pix se generan mediante una única integración. El suscriptor paga con el código QR o el código de barras.
• Registro sin archivo de envío: en la API, el boleto bancario queda registrado hasta 5 minutos después de su generación.
• Cancelación mediante webhook: Unicred envía a Hubsoft los datos de los títulos pagados y la factura queda saldada. No es necesario configurar una rutina de verificación de cobranza.
• Envío y respuesta CNAB 240: para quienes trabajan con intercambio de archivos.
• Envío de la cobranza: correo electrónico, SMS y mensajeros, notificación en la Aplicación del Cliente y llamadas.

Qué necesitas

• Cuenta en Unicred con convenio de cobranza.
• Acceso al Portal Developers de Unicred, con una aplicación aprobada por Unicred para las API de autenticación y de títulos de cobranza.
• Los datos de integración proporcionados por Unicred: usuario, contraseña, identificador del beneficiario, variación de la cartera y código de la cooperativa (que no es la sucursal).
• Una URL de webhook en HTTPS y dos claves UUID diferentes, generadas por el proveedor, para autenticación y cifrado.
• 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 Unicred y homologa con boletos bancarios de prueba, archivos de envío y respuesta.
2. En el Portal Developers de Unicred, registra la nueva aplicación y espera la aprobación. Después, copia el token en los detalles de la aplicación.
3. En la pestaña Parámetros de la forma de cobranza, ingresa el token y los demás datos de integración.
4. Activa la respuesta mediante webhook, con la URL, el tipo de respuesta parcial, la versión y las dos claves.
5. Genera un boleto bancario de prueba y verifica si se recuperó el código QR.

El paso a paso con las pantallas está en la página de Unicred en la wiki de Hubsoft.

Limitaciones

• En la API de Unicred, todos los boletos bancarios son híbridos. No es posible desactivar Pix.
• La API no permite consultar pagos por período: la cancelación depende del webhook.
• El boleto bancario solo se marca como transmitido después de que Hubsoft recupera el código QR, lo que puede tardar un tiempo.
• CNAB 400 no está disponible para Unicred.

Preguntas frecuentes

Generé un boleto bancario de prueba y el código QR desapareció al recuperar la cobranza. ¿Qué ocurrió?

Con Unicred, la transmisión solo es válida cuando se recupera el código QR. Una rutina consulta el banco periódicamente hasta que el código QR está disponible.

¿Necesito configurar la rutina de verificación de cobranza en la API?

No. Los pagos de Unicred llegan únicamente por webhook.

El suscriptor dice que el boleto bancario no está registrado. ¿Qué debo verificar?

Si el boleto bancario se envió mediante un archivo de envío, verifica que el archivo haya sido enviado y procesado por el banco.

Revisado el 10/10/2026.