Documentación Técnica

Guía de Sincronización Móvil

Cómo funciona la autenticación y sincronización entre InventaPlus GO y la nube

1

Vinculación del Dispositivo

El usuario nunca escribe su contraseña en el celular. En su lugar, utiliza un sistema de vinculación por Código QR que es más seguro y conveniente:

Proceso de Vinculación

  1. El usuario inicia sesión en el Panel Web desde su computadora
  2. Navega a Ajustes → Dispositivos Móviles
  3. Hace clic en "Vincular Dispositivo" para generar un código QR
  4. Abre la app InventaPlus GO en su teléfono
  5. Escanea el código QR con la cámara del dispositivo
  6. ¡Listo! El dispositivo queda vinculado automáticamente

¿Qué contiene el QR?

El código QR contiene un token JWT firmado que vincula el dispositivo a una "StoreId" específica. Este token tiene una validez limitada (5 minutos) y solo puede usarse una vez, lo que previene ataques de reproducción.

2

Sincronización Proactiva (Plan Pro/Business)

En los planes de pago, la sincronización ocurre de forma automática en segundo plano utilizando WorkManager (Android) para garantizar la entrega incluso con conexión intermitente.

Modo Subida (Upload)

  • Cada 15 minutos o al finalizar una venta
  • El SyncWorker envía transacciones pendientes a la nube
  • Incluye: ventas, ajustes de stock, nuevos productos

Modo Bajada (Download)

  • Al abrir la app o detectar cambios
  • Descarga actualizaciones de precios
  • Sincroniza nuevos productos del Dashboard
3

Plan Nano (Restricciones)

En el plan gratuito, la sincronización en segundo plano está desactivada para optimizar recursos del servidor:

Limitaciones del Plan Nano

  • • El usuario debe tener internet activo para que la venta se registre
  • • Si no hay conexión, la app mostrará un error: "Modo Offline no disponible en este plan"
  • • No hay cola de sincronización; las transacciones deben subirse inmediatamente
  • • No se recomienda para negocios con conectividad inestable

Recomendación: Si tu negocio opera en zonas con internet intermitente, considera actualizar al Plan Pro que incluye capacidad offline completa.

Diagrama de Flujo

App MóvilBase de datos local
Funciona offline
Sincroniza cuando hay red
NubeBase de datos central