Para integrar AhoraTPV con ImaCash, es necesario tener un módulo activo por parte de Ahora TPV que permita la comunicación entre sistemas. Una vez activo, el técnico deberá completar los datos de conexión.
Pasos a seguir
1- Accede a la configuración de integración:
- En ImaCash, abre Configuración > Integración > AhoraTPV.
2- Selecciona el sistema POS:
- Selecciona la categoría del POS, en este caso Retail.
- A continuación, selecciona AhoraTPV del menú desplegable
3- Completa los datos de conexión:
- URL Web: introduce la URL base con el protocolo exacto del servicio, http:// o https://, y el host verificado. No incluyas puerto, barra final, rutas /api/Imacash, parámetros, usuario ni contraseña.
- Puerto: introduce por separado el puerto real del servicio. Ejemplo: URL Web https://192.168.1.20 y Puerto 8443, solo si ese es el endpoint HTTPS autorizado.
- Usuario: cuenta autorizada por AhoraTPV para el módulo ImaCash, con permisos de consulta y confirmación de transacciones.
- Contraseña: contraseña de esa cuenta, exclusivamente en su campo. Nunca incluyas credenciales en la URL ni las compartas en capturas o registros.
- ID ImaCash: identificador asignado a esta instalación en AhoraTPV. Corresponde al campo interno Puestos; debe coincidir con el configurado en el módulo AhoraTPV.
4- Guarda la configuración:
- Haz clic en el botón GUARDAR (icono de disquete) en la parte inferior izquierda
Requisito previo: el módulo ImaCash de AhoraTPV debe estar habilitado. Confirma con su responsable el protocolo, host, puerto, cuenta autorizada e ID ImaCash antes de guardar.
HTTPS, certificados y redirecciones
ImaCash 4.4.3.1263 admite certificados privados o autofirmados exclusivamente en el endpoint HTTPS local o privado de AhoraTPV. La excepción no se aplica a servidores públicos ni desactiva globalmente la validación de certificados. No cambia automáticamente de HTTPS a HTTP cuando falla TLS.
ImaCash 4.4.3.1264: compilación validada; publicación pendiente de confirmar. Bloquea redirecciones de HTTPS a HTTP, a otro host y a otro puerto dentro del mismo protocolo. Permite pasar de HTTP a HTTPS en el mismo host y conserva HTTPS local. No atribuyas esta protección adicional a 4.4.3.1263; comprueba la versión instalada y su disponibilidad antes de actualizar.
Un fallo TLS o una redirección rechazada no demuestra que la contraseña sea incorrecta ni exige cambiar el servicio AhoraTPV. Para certificados locales, configura directamente la URL HTTPS final verificada y su puerto, sin depender de redirecciones.
Si una redirección apunta a otro host, verifica primero con el responsable de AhoraTPV la identidad y autorización del destino. Configura explícitamente su URL base final y su puerto en ImaCash; no envíes credenciales a un destino sin verificar ni añadas usuario o contraseña a la URL.
Ante un fallo de ImaCash, no desactives la seguridad de Windows, el antivirus, el cortafuegos ni la validación TLS global, y no modifiques el servidor como solución al fallo del cliente. Revisa primero la versión y los datos de conexión. HTTP solo debe configurarse expresamente si es el protocolo real autorizado, nunca como alternativa automática a un error HTTPS.
Comprobaciones antes de producción
Desde el equipo ImaCash, verifica el acceso al host y puerto autorizados; guarda la configuración y confirma el inicio de sesión y la carga de usuarios y mostradores. Si falla, revisa el módulo habilitado, el ID, las credenciales y el diagnóstico saneado, sin divulgar contraseñas ni tokens.
En una prueba controlada, comprueba la recepción de una venta y la devolución de su estado a AhoraTPV. La integración consulta transacciones y confirma su finalización, error o cancelación mediante PUT /api/Imacash/transaccion; solo una respuesta HTTP 2xx confirma ese envío. Un timeout o error HTTP no demuestra confirmación: revisa ambos sistemas antes de repetir una operación de efectivo. Esta documentación no sustituye la validación en la instalación real.
