Configurar Ágora POS en ImaCash
Esta guía corresponde al selector AgoraPOS de ImaCash y su lectura SQL Server. Ágora API y Ágora Retail son modalidades distintas: confirma con el proveedor cuál está preparada en tu instalación antes de elegir o cambiar el enlace.
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 > AgoraPOS. No selecciones API ni Retail por semejanza de nombre.
- 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 con el botón Guardar y comprueba la conexión. Si cambias una configuración existente, hazlo con soporte y sin operaciones en curso. Guardar o abrir SQL no demuestra que se lean todos los pagos y movimientos correctos.
Efectivo, tarjeta y movimientos de caja
Esta modalidad utiliza los medios de efectivo y tarjeta previstos por el enlace; no ofrece selectores propios de formas de pago. El proveedor debe confirmar su correspondencia. Con Aceptar tarjetas desactivado se leen los pagos de documentos de efectivo; al activarlo se incluyen también los de tarjeta previstos. No incorpora automáticamente medios personalizados, crédito o vales ni autoriza un pago bancario.
La lectura recoge cada pago por su importe pagado menos el cambio. Los pagos separados de un documento mixto pueden generar movimientos separados de sus componentes; no se repite el total completo por cada medio. Caja/proveedores se lee como efectivo y conserva el signo del TPV, incluso con tarjetas activadas: no todos esos movimientos son salidas. Valida su alcance y significado antes de usarlos para movimientos automáticos de efectivo.
Puestos, operarios y filtros
Revisa los nombres e identificadores reales que ofrece tu instalación. Configura los filtros en ImaCash y contrástalos con documentos conocidos. El filtro de operario también puede excluir movimientos de caja/proveedores; no supongas que ambas lecturas tienen el mismo origen o selección. Una lista de centros no acredita por sí sola equivalencia con puestos, y la referencia de tienda de este enlace no identifica una tienda física real.
Comprobar los resultados
Con el proveedor, contrasta pagos de efectivo, tarjeta y mixtos, importes pagados menos cambio, documentos negativos y movimientos de caja/proveedores ya registrados. Revisa fechas, puestos, operarios, ausencias y duplicidades. Los negativos conservan su signo, pero no acreditan una devolución realizada. Los albaranes identificados como reabiertos se omiten en esta lectura; eso no confirma una anulación ni la retirada de un pendiente anterior. No ejecutes cobros o devoluciones reales para probar la configuración.
El enlace lee datos y no importa artículos ni escribe confirmaciones, rechazos o anulaciones en Ágora. Una conexión correcta no acredita lectura completa, documento cerrado, pago bancario, conciliación ni validación física. Confirma el alcance de las dos lecturas y de cada instalación con el proveedor.