Tournées de vente — Application vendeur (PWA mobile)

Guide d'utilisation de l'application mobile vendeur (omagweb-mobile) — une Progressive Web App (PWA) qui s'installe sur smartphone Android et permet au vendeur de gérer sa tournée même hors-ligne.

Installation

1. Ouvrez Chrome sur Android et accédez à l'URL de l'application vendeur
2. Connectez-vous avec votre email et mot de passe OMAG
3. Sélectionnez la société (si vous avez accès à plusieurs)
4. Chrome propose « Ajouter à l'écran d'accueil » → installez l'app

L'app fonctionne ensuite comme une application native, avec un icône sur l'écran d'accueil.

iOS / Safari

Safari iOS supporte la PWA mais pas WebBluetooth (impression Bluetooth). Pour utiliser une imprimante Bluetooth, il faut Chrome sur Android.

Navigation

Une barre de menu en bas de l'écran est présente en permanence sur les écrans principaux et donne accès à 4 sections :

Onglet	Rôle
🚚 Tournée	Écran d'accueil : KPI + liste des visites du jour
🕑 Opérations	Historique de toutes vos opérations
🔄 Sync	Téléchargement / envoi des données (badge = nombre d'opérations en attente)
⚙️ Réglages	Compte, imprimante Bluetooth, déconnexion

La barre est masquée sur les écrans de saisie (visite, vente, encaissement, retour, clôture) pour laisser toute la place au travail en cours — un bouton « retour » permet d'en sortir.

Premier lancement : télécharger les données

À la première connexion (et chaque matin si nouvelle tournée préparée par l'ADV) :

1. Allez dans Sync (barre du bas)
2. Cliquez « Tout télécharger »

Cela récupère :

• Votre tournée du jour + visites prévues
• Le catalogue articles (vendables)
• Les clients de votre secteur
• Le stock courant de votre camion

Mode hors-ligne complet

Après ce téléchargement, vous pouvez travailler entièrement hors-ligne. Les ventes, encaissements et statuts sont sauvegardés localement et synchronisés quand vous retrouvez une connexion.

Écran tournée

L'écran principal affiche :

• En-tête bleu : votre nom, votre camion, votre secteur, et 3 KPI (Visites, CA réalisé, Encaissé)
• Liste des visites dans l'ordre du parcours, avec leur statut visuel
• Raccourcis en haut à droite : 📜 Mes opérations et 🔄 Sync (également accessibles depuis la barre du bas)
• Bandeau jaune (si opérations en attente) : compteur + bouton Synchroniser
• Bouton "Clôturer la tournée" en bas (à utiliser en fin de journée)

Faire une visite client

Cliquez sur une visite dans la liste. L'écran visite affiche :

Fiche client

• Nom, ville
• Téléphone (cliquable → appel direct)
• Adresse (cliquable → itinéraire Google Maps)

Capture GPS

Bloc « Position » :

• Cliquez « Capturer » quand vous êtes devant le client
• L'app enregistre votre position avec une précision (±X mètres)
• Le bouton devient « Recapturer » si vous voulez refaire la mesure
• Côté ADV, la position apparaît sur la carte de la tournée

4 actions principales

Action	Effet
Nouvelle vente	Création d'un BL terrain (vente directe depuis le camion)
Encaissement	Règlement de facture(s) ou crédit disponible
Retour marchandise	Le client rend un produit + génère optionnellement un avoir
Refus / Absent	Marque la visite comme non réalisée

Récap opérations

Toute vente / commande / retour / encaissement effectué sur cette visite apparaît en bas :

• Bandeau jaune = en attente de synchronisation (modifiable / supprimable)
• Bandeau vert = synchronisé (lecture seule, n° de document affiché)

Nouvelle vente

1. Cliquez « Nouvelle vente »
2. Recherchez l'article (par code ou nom)
3. Renseignez la quantité
4. Répétez pour tous les articles du panier
5. Allez à l'étape paiements : ajoutez 1 ou plusieurs paiements (Espèces, Chèque, Virement)
6. Validez

Crédit accepté

Si le total payé < total TTC, la différence devient crédit client (un BL impayé). À régler plus tard via Encaissement.

Mode tournée

Si votre tournée est en mode PV (pré-vente), le bouton crée une commande (livraison ultérieure depuis le dépôt) au lieu d'un BL.

Encaissement

Recouvrement de factures impayées :

1. Cliquez « Encaissement »
2. Le mini-relevé client s'affiche : total dû, crédit disponible, solde net
3. Saisissez le montant encaissé
4. Choisissez le mode (ESP / CHQ / VRT)
5. La liste des BL + factures impayés s'affiche, triée du plus ancien
6. Cliquez Auto-FIFO pour affecter automatiquement aux plus anciens, OU saisissez manuellement les affectations
7. Si le total affecté < montant encaissé, le reliquat sera en crédit disponible
8. Validez

Affectation BL et factures

Le système gère les deux types : un BL non facturé reste « impayé » et un BL groupé en facture est « impayé » sur la facture. Vous voyez tout dans une liste unique avec un tag BL ou FAC.

Retour marchandise

Le client rend des produits :

1. Cliquez « Retour marchandise »
2. Choisissez les articles + quantités
3. Optionnel : cochez « Avec avoir » pour générer un avoir client (crédit financier)
4. Validez

L'effet à la synchronisation :

• Création d'un bon de retour client (bretourc) → re-crédite le stock camion
• Si avec avoir : création d'un avoir client (avoirc) lié

Mes opérations

Accessible via l'onglet 🕑 Opérations de la barre du bas (ou le raccourci 📜 en haut de la tournée).

Vue complète de toutes vos opérations avec :

• Recherche par nom ou code client
• Période : Aujourd'hui / 7 jours / 30 jours / Tout
• Type : Toutes / Ventes / Commandes / Retours / Encaissements / En attente

Cliquez sur une opération → détail complet : client, montant, articles, paiements, affectations, géoloc.

Bouton « Imprimer ticket » disponible si une imprimante Bluetooth est configurée.

Synchronisation

Manuelle

Bouton « Envoyer en attente » sur la page Sync — envoie au serveur toutes les opérations non synchronisées.

L'app affiche le nombre d'opérations par type : ventes, commandes, retours, paiements, statuts visite.

Pas de sync automatique

La sync est volontairement manuelle pour éviter qu'une opération en cours de modification soit envoyée à mi-saisie. À vous de penser à synchroniser régulièrement (à chaque pause Wi-Fi).

Re-télécharger

Bouton « Tout télécharger » — utile si :

• L'ADV a modifié la tournée (ajout/suppression de visites)
• L'ADV a rouvert votre tournée
• Vous changez de société

Impression Bluetooth (optionnel)

Pour imprimer des tickets en direct au client :

Configuration unique

1. Allumez votre imprimante thermique Bluetooth (ESC/POS 58mm ou 80mm)
2. Onglet Réglages → section « Imprimante Bluetooth »
3. Cliquez « Sélectionner imprimante » → choisissez votre modèle dans la liste
4. Choisissez la largeur du papier (58 ou 80 mm)
5. Cliquez « Test d'impression » pour valider

Modèles compatibles

Toute imprimante thermique Bluetooth compatible ESC/POS : Xprinter XP-P810, MUNBYN, Goojprt PT-260, RPP02N…

Impression

Bouton « Imprimer » disponible sur :

• L'écran visite (récap vente)
• Le détail d'une opération (Mes opérations)

Le ticket contient : société, n° BL, date, vendeur, client, articles (libellé + qté × PU + total), total TTC, paiements.

Clôture de la tournée

À la fin de votre journée, avant de rentrer au dépôt :

1. Synchronisez toutes vos opérations en attente
2. Cliquez « Clôturer la tournée »
3. Si vous avez du stock restant sur le camion :
   • Comptez physiquement chaque article
   • Saisissez la quantité réelle dans la colonne « Phys. »
   • L'écart (théo - phys) s'affiche en couleur : vert (OK), rouge (manquant), ambre (surplus)
4. Validez

Bandeau rouge "Opérations non synchronisées"

La clôture nécessite que toutes vos opérations soient déjà sur le serveur. Si le bandeau rouge apparaît, cliquez Sync d'abord.

L'app envoie au serveur un bon de retour camion (brouillon) avec les quantités physiques + les écarts pour analyse ADV.

Après clôture, vous ne pouvez plus saisir : l'écran visite passe en lecture seule (« Tournée clôturée — lecture seule »). Contactez l'ADV si vous devez rouvrir.

Déconnexion

Onglet Réglages → bouton rouge « Se déconnecter » en bas.

Les opérations non synchronisées sont conservées

La déconnexion garde les opérations locales. À la prochaine connexion (même utilisateur, même société), elles seront proposées à la synchronisation.