De Shopify-integratie houdt de voorraadniveaus in je Shopify-winkel gelijk aan Pabau. Wanneer retailproducten worden verkocht bij het Pabau-kassapunt, stuurt de connector de nieuwe voorraadtotalen van de producten naar je Shopify-winkel, zodat de voorraad die je online klanten zien altijd overeenkomt met wat er daadwerkelijk de kliniek heeft verlaten.
Dit is een connector binnen de Data Sync-tool van Pabau. Ben je nieuw met Data Sync, lees dan eerst How Data Sync works in Pabau voor de algemene concepten (triggers, mapping, het bezorgingslogboek en herhalingen). Deze gids behandelt alles wat specifiek is voor Shopify.
LET OP: De Shopify-integratie wordt geleidelijk uitgerold. Zie je hem nog niet in je App Marketplace, neem dan contact op met support om hem voor jouw account te laten activeren. Je hebt beheerdertoegang in Pabau nodig om dit in te stellen, en toestemming om apps te installeren op de Shopify-winkel.
Wat de connector doet
- Stuurt de voorraadtotaal na verkoop van elk verkocht product naar je Shopify-winkel wanneer een verkoop met retailproducten wordt afgerond bij het kassapunt.
- Schrijft het voorraadcijfer naar de specifieke Shopify-locatie die je hebt gekoppeld — Shopify houdt voorraad per locatie bij, dus de connector weet altijd precies welke plank wordt bijgewerkt.
- Koppelt Pabau-producten automatisch aan Shopify-varianten op basis van SKU, en onthoudt de koppeling zodra deze is gemaakt.
- Registreert elke wijziging in Shopify's eigen aanpassingshistorie als een Inventory correction uitgevoerd door de Pabau-app, zodat je Shopify-auditspoor compleet blijft.
LET OP: Diensten verplaatsen nooit voorraad — alleen retailproductregels op een verkoop worden gesynchroniseerd. Geannuleerde verkopen worden overgeslagen. Synchronisatie in de andere richting (Shopify-verkopen die Pabau-voorraad verlagen), productcatalogusimport, cadeaubonnen en klantsynchronisatie staan gepland voor latere fasen en worden niet behandeld in deze gids.
Voordat je begint
De verbinding gebruikt Shopify's eigen inlogmethode (OAuth) — er zijn geen API-sleutels om te kopiëren. Je hebt nodig:
- Het permanente .myshopify.com-domein van je winkel (bijvoorbeeld
my-clinic.myshopify.com) — niet je aangepaste winkeldomein. Je vindt dit in je Shopify-beheer-URL. - Een Shopify-login met toestemming om apps te installeren op die winkel.
- Producten die dezelfde SKU hebben in Pabau en Shopify — de SKU is hoe de twee catalogi worden gekoppeld.
Stap 1: Verbind je Shopify-winkel
Je kunt op twee manieren beginnen:
- Setup > App Marketplace — selecteer de Shopify-tegel. Dit brengt je direct naar de Data Sync-instellingen hieronder.
- Data Hub > Data Sync — selecteer Add connector, kies Shopify, en selecteer Set up.
Bij het instellen wordt eerst gevraagd naar het .myshopify.com-domein van je winkel — Shopify's goedkeuringspagina is specifiek per winkel, dus Pabau moet weten naar welke winkel je moet worden doorgestuurd. Voer het domein in en selecteer Connect Shopify. Er opent een Shopify-venster waarin je inlogt en de toegang goedkeurt; zodra je goedkeurt, sluit het venster en maakt Pabau automatisch de verbinding, en opent deze zodat je de locatie-instellingen, triggers en veldmapping hieronder kunt bekijken.
TIP: Als je browser het pop-upvenster blokkeert, sta pop-ups toe voor Pabau en selecteer opnieuw Connect Shopify.
Stap 2: Kies je Shopify-locatie
Shopify houdt voorraad per locatie bij, dus de connector moet weten welke Shopify-locatie overeenkomt met je Pabau-voorraad. Op het tabblad Settings:
- Klinieken met één locatie — voer je Shopify-locatie-ID in het veld Shopify location in. Je vindt de ID in je Shopify-beheer onder Settings > Locations (het is het nummer aan het einde van de URL van de locatie).
- Klinieken met meerdere filialen — gebruik de Location map om elk Pabau-filiaal te koppelen aan de Shopify-locatie waarvan de voorraad moet worden bijgewerkt.
BELANGRIJK: Een verkoop bij een Pabau-filiaal zonder gekoppelde Shopify-locatie wordt nooit geraden — de bezorging mislukt in het logboek met een duidelijke reden, zodat voorraad nooit stilzwijgend naar de verkeerde winkel wordt geschreven. Zie je die fout, voeg dan het filiaal toe aan de locatiekaart en verstuur opnieuw.
Stap 3: Triggers
Op het tabblad Triggers is er één gebeurtenis om te beheren:
invoice.create→ Push stock levels to Shopify (standaard ingeschakeld) — elke afgeronde verkoop bij het kassapunt met retailproducten stuurt de nieuwe voorraadtotalen van die producten naar de gekoppelde Shopify-locatie.
Stap 4: Veldmapping
Op het tabblad Mapping vouw je Products uit om te zien hoe Pabau-productvelden worden gekoppeld aan Shopify:
- SKU → SKU (verplicht — zie hieronder hoe de koppeling werkt)
- Productnaam → Title
- Retailprijs → Price
- Voorraadniveau → Inventory quantity — dit is de regel die de voorraadpush aanstuurt; deze uitschakelen stopt de voorraadsynchronisatie.
De richtingsinstelling van de groep en de instelling Data conflict resolution bestaan voor de tweerichtingsfases van de connector; vandaag is het actieve traject uitgaand (Pabau → Shopify), en is Pabau standaard de bron van waarheid.
Hoe producten worden gekoppeld
Wanneer een verkoop wordt verstuurd, bepaalt de connector met welke Shopify-variant elk verkocht product overeenkomt:
- Een product dat al eens is gesynchroniseerd, wordt altijd naar dezelfde Shopify-variant geschreven — de opgeslagen koppeling is bepalend.
- Anders, als de SKU van het product exact overeenkomt met precies één variant in je Shopify-winkel, wordt die variant automatisch gekoppeld en onthouden voor de volgende keer.
- Als de SKU overeenkomt met meer dan één variant, of met geen enkele variant, wordt er niets geschreven voor dat product — de connector raadt nooit.
Als geen van de verkochte producten kan worden gekoppeld, mislukt de bezorging met een bericht dat de producten benoemt, zodat je ze kunt koppelen (of overeenkomende SKU's kunt geven) en opnieuw kunt versturen. Als slechts een deel kan worden gekoppeld, worden de gekoppelde producten toch gesynchroniseerd.
Wat je ziet in Shopify
Nadat een verkoop is gesynchroniseerd, wordt de Available-hoeveelheid van de gekoppelde locatie voor elk verkocht product ingesteld op het voorraadtotaal na verkoop van Pabau. In de adjustment history van het product in Shopify verschijnt de wijziging als een Inventory correction uitgevoerd door de Pabau-app — zo kun je altijd zien welke wijzigingen vanuit de kliniek kwamen en welke rechtstreeks in Shopify zijn gemaakt.
De connector is voorzichtig bij gelijktijdige bewerkingen: als er niets is veranderd, wordt er helemaal niets geschreven, en als iemand op precies hetzelfde moment de Shopify-hoeveelheid bewerkt terwijl een verkoop wordt gesynchroniseerd, wijst Shopify de verouderde schrijfactie af en probeert Pabau automatisch opnieuw met actuele cijfers.
De verbinding testen
Gebruik Test connection op het tabblad Settings om te bevestigen dat Pabau je winkel kan bereiken — dit voert een echte, geauthenticeerde aanroep uit tegen je Shopify Admin API.
LET OP: Send test event wijzigt bewust nooit de voorraad in je winkel — een testschrijfactie zou echte voorraad verplaatsen. Een testgebeurtenis doorloopt de pipeline en komt in het logboek terecht als een verklarende no-op; om te zien dat voorraad daadwerkelijk verandert, voer je een kleine echte verkoop uit (je kunt deze daarna terugbetalen).
Het bezorgingslogboek lezen
Selecteer Logs op de connector om elke bezorging te zien — inclusief het exacte verzoek dat Pabau heeft verstuurd, het antwoord dat Shopify heeft teruggestuurd, en een correlatie-ID voor supporttickets. Fouten volgen de standaard Data Sync-regels: tijdelijke problemen (snelheidslimieten, netwerkfouten, Shopify-serverfouten) worden automatisch opnieuw geprobeerd volgens een oplopend schema, terwijl permanente afwijzingen de reden tonen zodat je de data kunt corrigeren en opnieuw kunt versturen met Sync latest data. Zie How Data Sync works in Pabau voor de volledige gids over statussen, herhalingen en opnieuw versturen.
Privacy en jouw Shopify-data
De Pabau-app abonneert zich op Shopify's privacy-webhooks, zodat een klantgegevensverzoek of verwijdering die via Shopify wordt aangevraagd — en het verwijderen van de app uit je winkel — automatisch wordt afgehandeld in overeenstemming met de AVG. Verwijdering die in Pabau wordt gehonoreerd, wordt nooit aangestuurd vanuit Shopify: medische dossiers worden bewaard volgens Pabau's eigen regels voor gegevensbewaring.
Verbinding verbreken
Om de synchronisatie te stoppen, open je het tabblad Settings van de connector en verbreek je de verbinding met de Shopify-winkel, of pauzeer of verwijder je de connector vanaf de kaart in Data Hub > Data Sync. Je kunt ook de Pabau-app verwijderen uit je Shopify-beheer — Pabau wordt hiervan op de hoogte gesteld en de verbinding stopt. De bezorgingshistorie wordt bewaard voor audit.
Gerelateerde artikelen
- How Data Sync works in Pabau