Synchronisation des produits
WCPOS conserve une copie locale de vos produits sur chaque appareil : le catalogue se parcourt et se recherche instantanément, et continue de fonctionner hors connexion. Ce guide explique comment les produits arrivent sur l'appareil et comment ils restent à jour.
La v1.10.0 introduit un nouveau moteur de synchronisation. Si votre PDV est antérieur à la v1.10.0, consultez Ce qui a changé dans la v1.10.0 ci-dessous.
Comment les produits arrivent sur l'appareil
- Un amorçage du catalogue s'exécute en arrière-plan. Dès le premier lancement, le PDV télécharge votre catalogue par petits lots, selon une planification, sans que vous ayez quoi que ce soit à faire. Vous pouvez commencer à vendre dès que les premiers produits arrivent — l'encaissement n'attend pas un téléchargement complet.
- Ce que vous consultez se télécharge à la demande. Une recherche, un filtrage par catégorie ou la lecture d'un code-barres récupère directement les produits correspondants s'ils ne sont pas encore locaux. Une recherche n'entraîne plus le téléchargement de produits sans rapport — elle récupère ce que vous avez demandé.
- Les mises à jour arrivent par les contrôles des changements. Une fois qu'un produit est local, le PDV ne le retélécharge pas pour vérifier s'il a changé. Il interroge un journal des changements léger (toutes les 60 secondes avec le préréglage par défaut) et ne récupère que ce qui a réellement changé — une boutique inactive répond par une unique réponse « rien n'a changé », presque gratuite.
Quelle est la taille des lots ?
Par défaut, le PDV demande 50 produits à la fois. Ce n'est plus une constante fixe — c'est l'un des deux cadrans définis par votre préréglage de synchronisation dans État de la boutique → Performances :
| Préréglage | Intervalle de contrôle | Enregistrements par requête |
|---|---|---|
| Eco | 5 min | 25 |
| Équilibré (par défaut) | 60 s | 50 |
| Temps réel | 10 s | 75 |
Les petits lots existent pour protéger votre serveur : les grandes pages demandent un temps serveur réel pour être construites et, sur un hébergement mutualisé, elles peuvent ralentir la boutique en ligne ou déclencher des plafonds de requêtes. Choisissez Eco pour un hébergement modeste, Temps réel pour les boutiques à plusieurs caisses sur un hébergement solide. Consultez État de la boutique pour les détails.
Suivre la progression du téléchargement
Ouvrez État de la boutique → Base de données pour voir, collection par collection, combien d'enregistrements se trouvent sur cet appareil par rapport à votre serveur, avec une barre de couverture. Le nombre sur le serveur est un total réellement communiqué par le serveur — tant que le PDV est en train de le confirmer, la ligne affiche vérification… plutôt qu'une estimation.
Une barre de produits partielle signifie simplement que l'amorçage n'est pas terminé ; il continuera à se remplir en arrière-plan. Si un produit précis semble manquer, recherchez-le — cela le récupère directement.
Si une collection semble bloquée, utilisez Effacer et retélécharger sur sa ligne dans État de la boutique → Base de données avant de recourir à la réinitialisation complète effacer toutes les données locales.
Ce qui a changé dans la v1.10.0
Les versions antérieures téléchargeaient le catalogue progressivement au fil de l'utilisation : chaque recherche ou défilement récupérait un nouveau lot de produits, et une interrogation complète s'exécutait toutes les 5 minutes. Ce modèle est abandonné. Dans la v1.10.0 :
- Le catalogue se remplit grâce à un amorçage planifié en arrière-plan — vous n'avez pas besoin de rechercher ni de faire défiler pour que les produits se téléchargent.
- Une recherche récupère les produits qui lui correspondent, et non un lot suivant arbitraire.
- Les contrôles des changements s'exécutent à l'intervalle du préréglage que vous avez choisi (60 secondes par défaut) au moyen de requêtes conditionnelles, au lieu d'une interrogation complète fixe toutes les 5 minutes.
- La progression du téléchargement est visible collection par collection dans État de la boutique → Base de données.
Les développeurs trouveront l'ensemble des mécanismes dans Fonctionnement du moteur de synchronisation.
F.A.Q.
Dois-je faire quelque chose pour télécharger mes produits ?
Non. L'amorçage du catalogue télécharge vos produits automatiquement en arrière-plan. Une recherche ou un filtrage récupère immédiatement des produits précis s'ils ne sont pas encore locaux, mais ce n'est pas la navigation ordinaire qui achève le téléchargement — c'est l'amorçage en arrière-plan.
En combien de temps les modifications de produits parviennent-elles au PDV ?
Avec le préréglage Équilibré par défaut, le PDV vérifie les changements toutes les 60 secondes (les contrôles sont légèrement aléatoirisés afin que plusieurs caisses ne sollicitent pas le serveur en même temps). Seuls les produits modifiés sont récupérés. Si plusieurs caisses doivent voir plus vite les modifications des autres, utilisez le préréglage Temps réel.
Je ne vois pas tous mes produits dans le PDV
Plusieurs possibilités :
- L'amorçage en arrière-plan n'est peut-être tout simplement pas terminé — vérifiez la ligne des produits dans État de la boutique → Base de données.
- Le PDV masque par défaut les articles en rupture de stock. Cela peut être modifié dans les paramètres d'affichage des produits.
- L'API REST de WooCommerce ne prend en charge que les types de produits standard (simple, variable, groupé, externe). Les types de produits personnalisés peuvent ne pas s'afficher dans le PDV.