Cómo conectar Quaza directamente a la API de cobranza de Sicredi (gateway) y validar la integración — lo que llamamos homologar.
Qué es el gateway Sicredi
El gateway Sicredi conecta Quaza directamente a la API de cobranza del banco. Con él, los boletos se registran por internet y el pago vuelve confirmado automáticamente — sin necesidad de importar archivo de retorno.
Homologar es el acto de validar tus credenciales con Sicredi: informas la clave de acceso, haces clic en Probar gateway y Quaza confirma la conexión.
Cómo funciona la homologación
Configurás la clave, Quaza pide autorización a Sicredi y, si la clave es correcta, la integración queda conectada:
Glosario
| Término |
Qué significa |
| Gateway |
Integración vía API: la cobranza y la baja del pago ocurren en tiempo real, por internet. |
| Homologar |
Validar tus credenciales con el banco. En Quaza, es el botón Probar gateway. |
| Ambiente |
Homologación = ambiente de pruebas; Producción = valiendo de verdad. |
| Clave Principal |
La clave de acceso que Sicredi provee. Es el único campo de credencial que usa el gateway Sicredi.
|
| Cooperativa y cuenta |
Identifican tu cuenta en Sicredi. Se cargan en la Cartera de Cobranza, no en la pestaña Gateway. |
| Convenio de cobranza |
Contrato en Sicredi que habilita la emisión de boletos vía API. |
| Tarea "Financiero - Gateway" |
Rutina automática que sincroniza los pagos de las cobranzas del gateway. |
Antes de empezar
Vas a necesitar:
• Una cuenta en Sicredi con convenio de cobranza vía API habilitado.
• La clave de acceso provista por Sicredi (gerente o banca por internet).
• La cooperativa y la cuenta ya cargadas en la Cartera de Cobranza.
Paso a paso
Primero confirmá los datos bancarios de la cartera:
Cobranza → Cartera de Cobranza
Confirmá que la cooperativa (agencia) y la cuenta de Sicredi estén cargadas. Luego abrí la configuración para cobranza y andá a la pestaña Gateway:
Configuración para cobranza → pestaña Gateway
1 En Integración con gateway, seleccioná Gateway - Sicredi.
2 En Ambiente, elegí Homologación para probar o Producción para valer.
3 En Clave Principal, pegá la clave de acceso de Sicredi.
4 Hacé clic en Guardar configuración para cobranza y luego en Probar gateway.
Pestaña Gateway: (1) Integración con gateway = Gateway - Sicredi, (2) Ambiente, (3) Clave Principal y (4) el botón Probar gateway.
Verificación de cobros (Días anteriores / posteriores). Estos dos campos definen la ventana de días que la tarea revisa para buscar pagos. El valor por defecto suele ser 60 y 60.
El botón "Probar gateway"
El botón Probar gateway pide una autorización a Sicredi usando tu Clave Principal. Si la clave y la cuenta son correctas, aparece el mensaje Conectado con éxito — la integración está homologada.
¿Dio error al probar? Verificá, en este orden: la Clave Principal (sin espacios de más), la cooperativa y la cuenta en la Cartera de Cobranza, y el Ambiente seleccionado. Una clave de Homologación no funciona en Producción y viceversa.
Tareas automáticas
Una vez homologado, no necesitás dar de baja el pago manualmente — Quaza lo hace con tareas que corren solas:
| Tarea |
Qué hace |
| Financiero - Gateway |
Sincroniza el estado de pago de las cobranzas del gateway, dentro de la ventana de días configurada (campos "Verificación de cobros"). Es la tarea principal de la integración. |
| Financiero - Gateway (aviso) |
Genera los avisos y notificaciones relacionados a las cobranzas del gateway. |
| Financiero - Gateway (pago) |
Procesa pagos por tarjeta cuando la cartera usa cobranza recurrente. No aplica al boleto Sicredi común. |
Manual o automático. La baja ocurre sola por la tarea; también podés forzar la reverificación abriendo la cobranza en la pantalla cuando necesités una confirmación inmediata.
Errores frecuentes
1. Homologación no es Producción. Los boletos generados en el ambiente de Homologación son de prueba y no son pagables de verdad. Cambiá a Producción al entrar en operación.
2. Cooperativa y cuenta van en la Cartera. La pestaña Gateway solo recibe la Clave Principal. Los datos bancarios (cooperativa/cuenta) van en la Cartera de Cobranza.
3. Sicredi tiene variaciones en el menú. Para boleto/cobranza usá Gateway - Sicredi. Existen además Sicredi Pix, Sicredi Pago de Tarjeta y Sicredi Transacción Simple — cada uno para una finalidad diferente.
4. Clave Principal exacta. Pegá la clave exactamente como Sicredi la entregó, sin espacios al inicio o al final.
Preguntas frecuentes
¿Quién puede configurar la homologación?El operador del área financiera con acceso a la Configuración para cobranza. Como involucra credenciales bancarias, suele hacerlo quien administra la cobranza de la empresa.
¿Dónde consigo la Clave Principal?Con Sicredi — en la banca por internet PJ o con tu gerente, junto al convenio de cobranza vía API. Quaza no genera esa clave.
¿Necesito importar archivo de retorno?No. En el gateway el pago vuelve confirmado automáticamente. La importación de retorno se usa en el modelo de Remesa/Retorno, no en el gateway.
¿El pago se da de baja solo?Sí. La tarea Financiero - Gateway sincroniza los pagos automáticamente, dentro de la ventana de días configurada.
¿En cuánto tiempo aparece el pago?En la próxima ejecución de la tarea de sincronización, siempre que el vencimiento esté dentro de la ventana "Verificación de cobros (Días anteriores/posteriores)".
"Probar gateway" dio error. ¿Qué hago?Verificá la Clave Principal (sin espacios), la cooperativa y la cuenta en la Cartera, y el Ambiente. Corregí, guardá y probá de nuevo.
¿Y el Pix de Sicredi?El Pix tiene integraciones propias en el menú — Sicredi Pix y Sicredi Pix Automático. Esta wiki trata del gateway de boleto/cobranza.
¿Puedo probar antes de poner en producción?Sí. Seleccioná el ambiente Homologación, validá la conexión y recién después cambiá a Producción.
Cambié la clave. ¿Debo probar de nuevo?Sí. Cada vez que cambiés la Clave Principal o el ambiente, guardá y hacé clic en Probar gateway nuevamente.
Documentos relacionados