Cómo conectar Quaza a la API de Efí (Gerencianet) para cobrar con boleto y Pix y validar la integración — lo que llamamos homologar.
Qué es el gateway Efí (Gerencianet)
El gateway Efí (Gerencianet) conecta Quaza directamente a la API de Efí (Gerencianet). Con él, las cobranzas se generan por internet y el pago vuelve confirmado automáticamente.
Homologar es validar tus credenciales con Efí (Gerencianet): las informás, hacés clic en Probar gateway y Quaza confirma la conexión.
Cómo funciona la homologación
Configurás las credenciales, Quaza pide autorización a Efí (Gerencianet) y, si son correctas, 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 Efí (Gerencianet). En Quaza, es el botón Probar gateway. |
| Ambiente |
Homologación = ambiente de pruebas; Producción = valiendo de verdad. |
| Clave Principal |
el Client ID de tu cuenta en Efí |
| Clave Secreta |
el Client Secret de tu cuenta en Efí |
| Tarea "Financiero - Gateway" |
Rutina automática que sincroniza los pagos de las cobranzas del gateway. |
Antes de empezar
Vas a necesitar:• Una cuenta en Efí (Gerencianet) con la API de cobranza/integración habilitada.
• Las credenciales de API: Clave Principal, Clave Secreta.
Paso a paso
Abrí la configuración para cobranza y andá a la pestaña Gateway:
Configuración para cobranza → pestaña Gateway
1 Em Integración con gateway, seleccioná Gateway - Gerencianet.
2 Em Ambiente, elegí Homologación para probar ou Producción.
3 Em Clave Principal, pegá el Client ID de tu cuenta en Efí.
4 Em Clave Secreta, pegá el Client Secret de tu cuenta en Efí.
Guardá y hacé clic en Probar gateway.
Pestaña Gateway: (1) Integración con gateway, (2) Ambiente, (3) Clave Principal, (4) Clave Secreta y el botón Probar gateway.
El botón "Probar gateway"
El botón Probar gateway pide una autorización a Efí (Gerencianet) usando las credenciales informadas. Si son correctas, aparece Conectado con éxito — la integración está homologada.
¿Dio error al probar? Verificá las credenciales (sin espacios de más) y el Ambiente seleccionado. Las credenciales de Homologación no funcionan 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. |
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. Las credenciales de prueba solo valen en el ambiente de Homologación. Cambiá a las de Producción al entrar en operación.
2. Son 2 credenciales. Efí (Gerencianet) exige todas completas — si falta una, la prueba falla.
3. Credenciales exactas. Pegá cada valor exactamente como Efí (Gerencianet) lo 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, suele hacerlo quien administra la cobranza de la empresa.
¿Dónde consigo las credenciales?Las provee Efí (Gerencianet) — las obtenés en el panel/portal de integración de Efí (Gerencianet). Quaza no genera esas credenciales.
¿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.
¿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.
"Probar gateway" dio error. ¿Qué hago?Verificá las credenciales y el ambiente. Corregí, guardá y probá de nuevo.
¿Necesito importar archivo de retorno?No. En el gateway el pago vuelve confirmado automáticamente.
Cambié las credenciales. ¿Debo probar de nuevo?Sí. Cada vez que cambiés una credencial o el ambiente, guardá y hacé clic en Probar gateway.
¿En cuánto tiempo aparece el pago como pagado?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)".
¿Para qué sirven los campos "Verificación de cobros"?Definen la ventana de días (anterior y posterior al vencimiento) que la tarea revisa al buscar pagos. El valor por defecto suele ser 60 y 60.
¿Gerencianet y Efí son lo mismo?Sí. Gerencianet pasó a llamarse Efí; las credenciales son las mismas de tu aplicación en el panel de Efí.
Documentos relacionados