Productsynchronisatie
WCPOS bewaart op elk apparaat een lokale kopie van je producten, zodat de catalogus direct doorzoekbaar is en offline blijft werken. In deze handleiding lees je hoe producten op het apparaat terechtkomen en hoe ze actueel blijven.
v1.10.0 introduceert een nieuwe synchronisatie-engine. Als je POS ouder is dan v1.10.0, zie dan Wat er is gewijzigd in v1.10.0 hieronder.
Hoe producten op het apparaat terechtkomen
- Een catalogusaanvulling loopt op de achtergrond. Vanaf de eerste start downloadt de POS je catalogus volgens een schema in kleine batches, zonder dat je iets hoeft te doen. Je kunt beginnen met verkopen zodra de eerste producten binnen zijn — afrekenen wacht niet op een volledige download.
- Wat je bekijkt, wordt op aanvraag gedownload. Zoeken, filteren op categorie of een barcode scannen haalt de overeenkomende producten rechtstreeks op als ze nog niet lokaal staan. Een zoekopdracht sleept geen ongerelateerde producten meer mee — er wordt opgehaald waar je om vroeg.
- Updates komen binnen via wijzigingscontroles. Zodra een product lokaal staat, downloadt de POS het niet opnieuw om te zien of het is gewijzigd. De POS raadpleegt een licht wijzigingslogboek (elke 60 seconden bij de standaardvoorinstelling) en haalt alleen op wat daadwerkelijk is gewijzigd — een inactieve winkel antwoordt met een enkele, vrijwel gratis reactie "er is niets gewijzigd".
Hoe groot zijn de batches?
Standaard vraagt de POS 50 producten tegelijk op. Dat is geen vaste constante meer — het is een van de twee knoppen die worden ingesteld door je synchronisatievoorinstelling in Winkelstatus → Prestaties:
| Voorinstelling | Controle-interval | Records per verzoek |
|---|---|---|
| Eco | 5 min | 25 |
| Gebalanceerd (standaard) | 60 s | 50 |
| Realtime | 10 s | 75 |
Kleine batches bestaan om je server te beschermen: grote pagina's kosten de server echte rekentijd en op gedeelde hosting kunnen ze de webwinkel vertragen of tegen limieten aanlopen. Kies Eco bij bescheiden hosting en Realtime voor winkels met meerdere kassa's op sterke hosting. Zie Winkelstatus voor meer informatie.
De downloadvoortgang controleren
Open Winkelstatus → Database om per verzameling te zien hoeveel records er op dit apparaat staan ten opzichte van je server, met een dekkingsbalk. Het aantal op server is een echt door de server gerapporteerd totaal — zolang de POS dat nog bevestigt, toont de rij bezig met controleren… in plaats van een schatting.
Een gedeeltelijk gevulde productenbalk betekent simpelweg dat de aanvulling nog niet klaar is; die loopt op de achtergrond gewoon door. Lijkt een specifiek product te ontbreken, zoek er dan naar — daarmee wordt het rechtstreeks opgehaald.
Als een verzameling lijkt vast te lopen, gebruik dan Wissen en opnieuw downloaden op de rij ervan in Winkelstatus → Database voordat je grijpt naar de volledige reset alle lokale gegevens wissen.
Wat er is gewijzigd in v1.10.0
Eerdere versies downloadden de catalogus geleidelijk tijdens het gebruik: elke zoekopdracht of scrollbeweging haalde weer een batch producten op en elke 5 minuten liep er een volledige controle. Dat model is afgeschaft. In v1.10.0:
- De catalogus wordt gevuld via een geplande aanvulling op de achtergrond — je hoeft niet te zoeken of te scrollen om producten te laten downloaden.
- Een zoekopdracht haalt de producten op die eraan voldoen, niet een willekeurige volgende batch.
- Wijzigingscontroles lopen op het interval van de door jou gekozen voorinstelling (standaard 60 seconden) met voorwaardelijke verzoeken, in plaats van een vaste volledige controle om de 5 minuten.
- De downloadvoortgang is per verzameling zichtbaar in Winkelstatus → Database.
Ontwikkelaars vinden de volledige werking in Hoe de synchronisatie-engine werkt.
Veelgestelde vragen
Moet ik iets doen om mijn producten te downloaden?
Nee. De catalogusaanvulling downloadt je producten automatisch op de achtergrond. Zoeken of filteren haalt specifieke producten direct op als ze nog niet lokaal staan, maar gewoon rondbladeren is niet wat de download voltooit — dat doet de aanvulling op de achtergrond.
Hoe snel bereiken productwijzigingen de POS?
Bij de standaardvoorinstelling Gebalanceerd controleert de POS elke 60 seconden op wijzigingen (de controles worden licht gespreid, zodat meerdere kassa's de server niet tegelijk benaderen). Alleen gewijzigde producten worden opgehaald. Als meerdere kassa's elkaars wijzigingen sneller moeten zien, gebruik dan de voorinstelling Realtime.
Ik zie niet al mijn producten in de POS
Daar zijn enkele mogelijke oorzaken voor:
- De aanvulling op de achtergrond is mogelijk simpelweg nog niet klaar — bekijk de rij met producten in Winkelstatus → Database.
- De POS verbergt standaard artikelen die niet op voorraad zijn. Dit kan worden aangepast in de instellingen voor productweergave.
- De WooCommerce REST API ondersteunt alleen de standaardproducttypen (eenvoudig, variabel, gegroepeerd, extern). Aangepaste producttypen worden mogelijk niet weergegeven in de POS.