Hub Cloud

Connectez votre caisse SwiftUP à l'application web SwiftUP Consulting pour superviser votre commerce à distance, en temps réel, depuis n'importe quel navigateur.

Accessible parAdministrateurGérant

Vue d'ensemble

Le Hub Cloud est une passerelle sécurisée entre votre caisse (POS Desktop) et l'application web hébergée. La caisse se connecte au Hub via un canal temps réel (WebSocket) authentifié par jeton JWT. Une fois connectée, vous pouvez consulter vos ventes, produits, utilisateurs et l'état de la caisse depuis le tableau de bord web — sans rien installer sur le téléphone ou l'ordinateur distant.

La caisse reste la seule source de données : le Hub ne stocke pas vos ventes, il les relaie à la demande depuis la base SQLite locale de la caisse. Si la caisse est hors ligne, les données distantes ne sont pas disponibles.
🟢

Statut temps réel

Voyez immédiatement si la caisse est en ligne ou hors ligne.

💸

Ventes & tickets

Consultez les ventes, tickets et pièces commerciales à distance.

📦

Produits

Catalogue et catégories synchronisés à la demande.

👥

Utilisateurs web

Comptes web autorisés à se connecter : créés/modifiés depuis le Hub ou dans Équipe → Utilisateurs web de la caisse.

💰

Caisse & sessions

Solde, mouvements de caisse (consultation, ajout, annulation) et historique des sessions.

⚡

Événements en direct

Les nouvelles ventes remontent instantanément au tableau de bord.

Comment ça marche

  1. 1La caisse (POS Desktop) démarre et se connecte automatiquement au Hub via WebSocket, authentifiée par son jeton (JWT) ou son code POS (xPosCode).
  2. 2Sur l'application web, page Inscription (/register) : saisissez le xPosCode de votre caisse. Le Hub crée un utilisateur par défaut et génère un QR code / jeton.
  3. 3Sur l'application web, page Connexion (/login) : entrez vos identifiants. L'authentification (NextAuth) délivre un jeton JWT de session.
  4. 4Le tableau de bord affiche en temps réel : l'état de la caisse (en ligne / hors ligne), les ventes, produits et utilisateurs, ainsi que les événements en direct (une nouvelle vente apparaît instantanément).

Trouver vos informations Hub dans la caisse

Ouvrez la caisse → Configuration → onglet Général → section Hub Cloud (réservée à l'administrateur). Vous y trouverez tout ce qu'il faut pour connecter l'application web :

  • Statut du jeton — « Token enregistré » (vert) ou « Aucun token ».
  • Code POS (xPosCode) — l'identifiant unique de votre caisse, à saisir lors de l'inscription web. Bouton de copie disponible.
  • QR Code d'accès Hub — scannez-le pour ouvrir directement l'application web connectée à cette caisse.
  • Lien de l'application connectée — l'URL de l'application web (copiable).
  • Token JWT — le jeton d'authentification de la caisse (copiable).
  • Utilisateurs web — la liste des comptes web synchronisés avec leur statut.

Inscription & connexion web

  1. 1Ouvrez l'application web SwiftUP Consulting dans un navigateur (ou scannez le QR Code d'accès Hub depuis la caisse).
  2. 2Page Inscription : saisissez le xPosCode affiché dans la section Hub Cloud de votre caisse.
  3. 3Le Hub crée un utilisateur par défaut pour ce xPosCode et génère le jeton ; ce compte apparaît ensuite dans « Utilisateurs web » côté caisse.
  4. 4Page Connexion : entrez vos identifiants pour ouvrir une session sécurisée et accéder au tableau de bord.

Utilisateurs web

Les comptes autorisés à se connecter à l'application web sont distincts des utilisateurs de la caisse. Chacun est rattaché à un xPosCode et possède un statut :

  • ACTIF (ACTIVE) — le compte peut se connecter au tableau de bord.
  • SUSPENDU (SUSPENDED) — l'accès est bloqué.
  • Défaut — l'utilisateur créé automatiquement lors de l'inscription (badge « Défaut »).
Ces comptes se gèrent dans la caisse via Équipe → Utilisateurs web (création, statut, mot de passe) ou directement depuis le Hub. La section Hub Cloud de Config. application n'en affiche que la liste. Les utilisateurs web servent uniquement au Hub : ils ne donnent pas accès à la caisse ni aux pages locales (/mobile, /admin).

Le Hub n'est pas en lecture seule

En plus de consulter les données, le Hub peut agir sur la caisse connectée :

  • Créer des utilisateurs web et modifier leur statut (Actif / Suspendu).
  • Enregistrer des mouvements de caisse (type, montant, motif obligatoire).
  • Supprimer un mouvement de caisse : il n'est pas effacé mais annulé par un contre-mouvement, comme dans le Coffre, pour garder la traçabilité.
  • Envoyer des commandes serveur, relayées à l'application de caisse.
Toute personne disposant d'un compte web actif peut donc modifier la caisse de votre commerce à distance : ne créez des comptes web que pour des personnes de confiance.

Sécurité

  • La connexion caisse ↔ Hub est authentifiée par jeton JWT.
  • Ne partagez jamais votre Token JWT ni votre xPosCode publiquement : ils donnent accès aux données de votre commerce.
  • L'accès web est protégé par identifiant/mot de passe (NextAuth).
  • Suspendez immédiatement tout utilisateur web qui ne doit plus avoir accès.
Le Token JWT et le xPosCode sont des secrets. Toute personne disposant de ces informations peut tenter d'accéder aux données de votre caisse. S'ils ont été exposés, suspendez les utilisateurs web concernés (Équipe → Utilisateurs web) et contactez le support.
Le Hub passe par une connexion sortante de la caisse vers Internet : aucun port à ouvrir pour lui. Le serveur WebSocket local (port 3001), son code d'appairage à 6 caractères et la découverte UDP (port 3003) servent à la tablette Backup POS sur le réseau local — voir Liens serveur & QR.

FAQ