Beta técnica: Guía contrastada con la beta publicada de ImaCash 4.4.3.1528. El conector requiere una validación controlada de su instalación antes de gestionar efectivo; no se presenta esa versión como la última estable.
Este conector es exclusivamente para Lightspeed Retail X-Series, antes Vend. No es compatible con Lightspeed Restaurant K-Series ni con Ikentoo.
Requisitos previos
- Confirme con su proveedor la edición Retail X-Series, el acceso a su API y el prefijo o URL privada de la tienda. No utilice la dirección de Restaurant K-Series ni el nombre comercial del establecimiento.
- Una Private App aprobada por el administrador de la tienda, con sales:read, users:read y payment_types:read. Lightspeed indica disponibilidad de Private Apps en planes Plus; confirme la cuenta contratada. Los tokens personales son una alternativa heredada para cuentas que todavía los admitan.
- Salida HTTPS por el puerto 443 hacia *.retail.lightspeed.app. No requiere abrir puertos entrantes ni acceso a una base de datos local.
- Un tipo de pago en efectivo activo. ImaCash solo importa ventas que ya estén cerradas en Lightspeed.
Configuración en ImaCash
- Abra Configuración > Integración > POS y seleccione Lightspeed Retail X-Series. Retail describe su sector; no necesita buscar otro selector de ese nombre. Su cuenta de ImaCash debe permitir acceder y modificar la configuración.
- En URL de la API introduzca el prefijo o la URL HTTPS de su tienda terminada en retail.lightspeed.app. Una URL histórica vendhq.com se adapta al dominio actual. No introduzca la ruta de una base de datos ni una URL de otro producto.
- En Clave de API introduzca el token privado de la aplicación aprobada. No es la contraseña de ImaCash ni un identificador de caja. No publique su valor ni lo envíe en capturas; confirme su vigencia con el responsable de la tienda.
- Al validar una configuración nueva o modificada, ImaCash consulta tipos de pago y usuarios mediante la API; necesita reconocer al menos un tipo de efectivo. Guardar sin cambios puede reutilizar la validación anterior. Un aviso correcto no acredita lecturas completas, filtros ni efectivo. El guardado general tiene varias fases: salir o cancelar después no revierte lo ya guardado; reabra y compruebe los datos. El permiso de ventas y su lectura se comprueban en la primera sincronización, no al cargar usuarios. Use el reinicio solo cuando el resumen de configuración lo ofrezca.
Funcionamiento y alcance
- Las ventas de efectivo entran por su importe en efectivo; las ventas solo con tarjeta se ignoran.
- En un pago mixto se importa únicamente la parte pagada en efectivo. Los importes negativos en efectivo se tratan como abonos.
- La beta es de solo lectura: no confirma cobros ni modifica ventas en Lightspeed.
- La lectura paginada está limitada a las últimas dos horas y solapa dos minutos entre consultas, separadas al menos quince segundos. Un fallo o un lote incompleto no adelanta la sincronización. Si Lightspeed limita las peticiones, espere el plazo indicado por el servicio; una interrupción larga puede dejar ventas fuera de la ventana y requiere revisión.
Alcance de tiendas y usuarios
Los filtros de usuario actúan sobre la vista local de ImaCash; no limitan el acceso de la Private App ni se envían a la API. Se carga el catálogo de vendedores, pero no listas de tiendas o cajas. Las referencias de la venta no acreditan aislamiento entre establecimientos. Compruebe el alcance de la cuenta y de cada puesto en la validación supervisada.
Confirmaciones y resultados inciertos
Confirmar en ImaCash no escribe un cobro, cierre ni anulación en Lightspeed. Una venta cerrada ya contiene pagos registrados en el POS: su aparición en ImaCash no demuestra dinero entregado ni autoriza a cobrarlo otra vez. Compruebe referencias, estado y efectivo real antes de repetir, resincronizar o reiniciar.
Qué no incluye este conector
No sincroniza artículos, stock, turnos ni búsquedas de tickets por EAN. No importa ventas únicamente con tarjeta ni un total bancario independiente. El token se facilita de forma privada; no hay un asistente de renovación OAuth automática. La guía de iKentoo corresponde a Restaurant K-Series y sigue siendo independiente. Solo lectura se refiere a la API de Lightspeed: el circuito normal de ImaCash puede accionar una máquina de efectivo.
Prueba obligatoria antes de producción
Antes del uso comercial, acuerde con el proveedor una prueba supervisada de efectivo, tarjeta, pago mixto, abono y recuperación de conexión, comprobando referencias y resultados reales en ambos sistemas. La guía, el código y una conexión correcta no acreditan esa validación.