Configurar Ágora Retail en ImaCash
Esta guía corresponde a POS > AgoraRetail y su lectura SQL Server. Ágora POS y Ágora API son modalidades distintas. Los nombres anteriores AgoraRetail V2 y V3 remiten al mismo conector; no acreditan versiones comerciales ni compatibilidad adicional.
Antes de empezar
El proveedor debe confirmar la versión y estructura compatibles, el servidor y la base activos y una cuenta autorizada con los permisos de lectura necesarios. Comprueba el acceso bajo la identidad que ejecuta ImaCash y conserva una configuración operativa. No copies valores de manuales ni supongas que toda instalación de Ágora es compatible.
Pasos de configuración
- Abre Configuración > Integración y selecciona POS > AgoraRetail. Confirma con el proveedor la modalidad preparada antes de cambiar una instalación existente.
- Revisa con el técnico estos campos y utiliza únicamente los datos privados facilitados por el administrador:
- IP del servidor y Puerto identifican el destino SQL Server de tu instalación. El puerto se utiliza cuando el destino no lleva una instancia ni un puerto ya incorporado; no existe un puerto universal para esta guía.
- Nombre de la BBDD es el nombre exacto de la base de ventas compatible, no un archivo ni una lista de puestos.
- Nombre de instancia identifica la instancia SQL Server, cuando corresponda. La instancia tiene prioridad sobre el campo Puerto; no añadas dos veces la instancia ni combines datos de otra instalación.
- Rellena Usuario y Contraseña con la cuenta SQL privada autorizada y escribe la clave solo en ImaCash. Esta modalidad no muestra una casilla de autenticación Windows. Si una configuración anterior ya utiliza esa autenticación, conserva su identidad Windows válida y pide revisión técnica; no edites archivos para activarla.
Guarda la conexión y elige las formas reales de la instalación cuando aparezcan las listas. Conserva la configuración válida y comprueba lo guardado antes de usarla. Si no aparecen formas, no asumas que la conexión ha validado los pagos. Completa un nuevo inicio normal de ImaCash, sin operaciones en curso, para aplicar y comprobar los medios guardados.
Efectivo, tarjeta y movimientos de caja
Selecciona la forma de efectivo por su nombre real. Para tarjetas, elige una forma distinta y activa Aceptar tarjetas en Ajustes. Con esa opción desactivada solo se consulta la forma de efectivo; al activarla se añade la forma de tarjeta seleccionada. No uses identificadores de ejemplo ni supongas que una lista vacía o cancelar una selección deja la clasificación correcta. Crédito, vales y otras formas no se incorporan automáticamente.
Se lee cada pago como importe pagado menos cambio, conservando el signo. Un documento mixto puede producir movimientos separados de sus componentes seleccionados; no se repite el total por forma de pago. Un importe negativo no acredita una devolución ejecutada ni autorización bancaria. Esta modalidad no incluye una lectura independiente de caja/proveedores.
Puestos, operarios y filtros
Verifica puestos y operarios con documentos conocidos antes de aplicar filtros. La lista de puestos puede ofrecer identificadores mientras los movimientos muestran nombres; su correspondencia debe comprobarse. En ciertos esquemas el puesto corresponde a la apertura del ticket, no al punto donde se pagó. El operario procede de la apertura del documento. Los filtros locales de ImaCash pueden excluir pagos aunque SQL los haya leído; una referencia genérica de tienda no identifica una tienda física.
Comprobar los resultados
Compara pagos existentes de efectivo, tarjeta y documentos mixtos, cambio, importes negativos, fechas y correspondencia con el documento. Revisa pagos sin documento asociado, duplicados, omisiones y filtros con el proveedor. No provoques cobros ni devoluciones reales para probar la configuración. Una conexión SQL correcta no acredita la lectura completa ni el cierre del documento. Los pagos sin documento asociado pueden carecer de puesto u operario; no completes esos datos por suposición.
El enlace lee pagos; no importa productos ni escribe confirmaciones, rechazos o anulaciones en Ágora. Las listas de formas, una conexión y las variantes de esquema previstas no acreditan compatibilidad de todas las versiones ni validación física. Confirma el alcance de la instalación antes del uso automático.