Rest API
¿Qué es la REST API de ImaCash?
La REST API es el puente que conecta tu sistema POS con ImaCash y los dispositivos de control de efectivo. Funciona con peticiones HTTP simples en formato JSON, y todo el acceso está protegido por token para mantener la seguridad.
¿Cuándo usar esta integración?
Esta API está pensada para cuando tu POS no puede conectarse directamente con ImaCash por diferencias de plataforma, arquitectura o tecnología. En lugar de modificar tu sistema, usas nuestra API para comunicarte.
Importante
Para operaciones físicas directas con la máquina (como conteos manuales, vaciados o mantenimiento), tendrás que trabajar con la interfaz de ImaCash directamente. La API gestiona la comunicación de datos, no el control físico del hardware.
Configuración
NOTA IMPORTANTE: Para que el POS pueda vincularse a ImaCash mediante la REST API de Imagina, necesitarás un token de autenticación que deberás solicitar a nuestro equipo.
Pasos a seguir:
1. Solicita el token de autenticación:
- Contacta con Imagina IT Solutions para obtener el token de autenticación necesario para la integración a través de [email protected]
2. Accede a la configuración de integración:
- Ve a CONFIG → INTEGRACIÓN en ImaCash
3. Selecciona el tipo de integración:
- Selecciona la categoría «ImaCash»
- A continuación, selecciona REST API Imagina del menú desplegable
4. Configura el token:
- Token: Introduce el token de autenticación proporcionado por Imagina IT Solutions
5. Guarda la configuración:
- Haz clic en el botón GUARDAR (icono de disquete) en la parte inferior izquierda
Flujo de Comunicación POS - ImaCash mediante REST API
La siguiente imagen ilustra cómo funciona la comunicación entre el sistema POS e ImaCash a través de la REST API:
- El POS crea una transacción mediante POST /PutTransaction.php
- ImaCash espera y procesa la transacción mediante GET /statusTransaction.php
- ImaCash actualiza el estado una vez completado el proceso
- El POS recibe la confirmación del estado de la transacción
Para más información sobre la implementación técnica y documentación completa de la API pulsa el botón: