Beta tecnica: La integracion esta implementada y disponible para pruebas controladas antes de utilizarla con cobros reales.
Este conector es exclusivamente para Lightspeed Retail X-Series, antes Vend. No es compatible con Lightspeed Restaurant K-Series ni con Ikentoo.
Requisitos previos
- Una cuenta Retail X-Series y el prefijo o URL actual de la tienda, por ejemplo https://mi-tienda.retail.lightspeed.app.
- Una Private App aprobada con los permisos sales:read, users:read y payment_types:read. El token personal se admite solo para cuentas antiguas compatibles.
- 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 esten cerradas en Lightspeed.
Configuracion en ImaCash
- Abra Configuracion > Integracion > POS y seleccione Lightspeed Retail X-Series en la categoria Retail.
- En URL de la API introduzca el prefijo de la tienda o su URL completa *.retail.lightspeed.app.
- En Clave de API pegue el token de la Private App. No lo envie por correo, capturas ni registros de soporte.
- Guarde la configuracion. ImaCash valida la tienda, el token, los usuarios y los tipos de pago contra la API real antes de aceptarla.
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 unicamente 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 sincronizacion es incremental, paginada y acotada; ante un limite 429 conserva el cursor y respeta Retry-After.
Prueba obligatoria antes de produccion
Valide una venta en efectivo, una venta solo con tarjeta, una venta mixta, un abono y la recuperacion tras un corte de red o un 429. Compruebe que no aparecen duplicados al repetir la sincronizacion.
