So funktioniert die Shopify-Integration
Die Shopify-Integration hält die Lagerbestände in Ihrem Shopify-Shop mit Pabau synchron. Wenn Einzelhandelsprodukte an der Pabau-Kasse verkauft werden, überträgt der Connector die neuen Bestandssummen der Produkte an Ihren Shopify-Shop, sodass die Re
Die Shopify-Integration hält die Lagerbestände in Ihrem Shopify-Shop mit Pabau synchron. Wenn Einzelhandelsprodukte an der Pabau-Kasse verkauft werden, überträgt der Connector die neuen Bestandssummen der Produkte an Ihren Shopify-Shop, sodass die Regalmenge, die Ihre Online-Kunden sehen, immer widerspiegelt, was die Praxis tatsächlich verlassen hat.
Dies ist ein Connector innerhalb des Data Sync-Tools von Pabau. Wenn Sie neu bei Data Sync sind, lesen Sie zunächst How Data Sync works in Pabau für die allgemeinen Konzepte (Trigger, Mapping, das Übertragungsprotokoll und Wiederholungsversuche). Diese Anleitung behandelt alles, was speziell für Shopify gilt.
HINWEIS: Die Shopify-Integration wird schrittweise ausgerollt. Falls Sie sie noch nicht in Ihrem App Marketplace sehen, wenden Sie sich an den Support, um sie für Ihr Konto freischalten zu lassen. Sie benötigen Administratorzugriff in Pabau, um die Einrichtung vorzunehmen, sowie die Berechtigung, Apps im Shopify-Shop zu installieren.
Was der Connector macht
- Überträgt für jedes verkaufte Produkt die Bestandssumme nach dem Verkauf an Ihren Shopify-Shop, sobald ein Verkauf mit Einzelhandelsprodukten an der Kasse abgeschlossen wird.
- Schreibt die Bestandszahl an den spezifischen Shopify-Standort, den Sie zugeordnet haben — Shopify verwaltet Bestände pro Standort, sodass der Connector immer genau weiß, welches Regal er aktualisiert.
- Gleicht Pabau-Produkte automatisch anhand der SKU mit Shopify-Varianten ab und merkt sich die Verknüpfung, sobald sie hergestellt wurde.
- Erfasst jede Änderung im eigenen Anpassungsverlauf von Shopify als Bestandskorrektur, die von der Pabau-App vorgenommen wurde, sodass Ihr Shopify-Prüfpfad vollständig bleibt.
HINWEIS: Dienstleistungen bewegen niemals den Bestand — nur Einzelhandelsprodukte in einem Verkauf werden synchronisiert. Stornierte Verkäufe werden übersprungen. Die Synchronisierung in die andere Richtung (Shopify-Verkäufe reduzieren den Pabau-Bestand), der Import des Produktkatalogs, Geschenkgutscheine und die Kundensynchronisierung sind für spätere Phasen geplant und werden in dieser Anleitung nicht behandelt.
Bevor Sie beginnen
Die Verbindung nutzt Shopifys eigene Anmeldung (OAuth) — es müssen keine API-Schlüssel kopiert werden. Sie benötigen:
- Die permanente .myshopify.com-Domain Ihres Shops (zum Beispiel
my-clinic.myshopify.com) — nicht Ihre individuelle Storefront-Domain. Sie finden sie in der URL Ihres Shopify-Admin-Bereichs. - Eine Shopify-Anmeldung mit der Berechtigung, Apps in diesem Shop zu installieren.
- Produkte, die in Pabau und Shopify dieselbe SKU tragen — anhand der SKU werden die beiden Kataloge abgeglichen.
Schritt 1: Verbinden Sie Ihren Shopify-Shop
Sie können an zwei Stellen beginnen:
- Einstellungen > App Marketplace — wählen Sie die Kachel Shopify. Sie gelangen direkt in die unten beschriebene Data-Sync-Einrichtung.
- Data Hub > Data Sync — wählen Sie Connector hinzufügen, dann Shopify und anschließend Einrichten.
Die Einrichtung fragt zunächst nach der .myshopify.com-Domain Ihres Shops — die Genehmigungsseite von Shopify ist für jeden Shop spezifisch, daher muss Pabau wissen, zu welchem Shop Sie weitergeleitet werden sollen. Geben Sie die Domain ein und wählen Sie dann Shopify verbinden. Ein Shopify-Fenster öffnet sich, in dem Sie sich anmelden und den Zugriff genehmigen; nach der Genehmigung schließt sich das Fenster, und Pabau erstellt automatisch die Verbindung und öffnet sie anschließend, damit Sie die unten beschriebenen Standorteinstellungen, Trigger und Feldzuordnungen überprüfen können.
TIPP: Falls Ihr Browser das Pop-up-Fenster blockiert, erlauben Sie Pop-ups für Pabau und wählen Sie erneut Shopify verbinden.
Schritt 2: Wählen Sie Ihren Shopify-Standort
Shopify verfolgt Bestände pro Standort, daher muss dem Connector mitgeteilt werden, welchen Shopify-Standort Ihr Pabau-Bestand repräsentiert. Auf der Registerkarte Einstellungen:
- Praxen mit einem Standort — geben Sie Ihre Shopify-Standort-ID im Feld Shopify-Standort ein. Sie finden die ID in Ihrem Shopify-Admin-Bereich unter Einstellungen > Standorte (es ist die Zahl am Ende der URL des Standorts).
- Praxen mit mehreren Standorten — verwenden Sie die Standortzuordnung, um jede Pabau-Filiale mit dem Shopify-Standort zu verknüpfen, dessen Bestand sie aktualisieren soll.
WICHTIG: Ein Verkauf in einer Pabau-Filiale ohne zugeordneten Shopify-Standort wird niemals geraten — stattdessen schlägt die Übertragung im Protokoll mit einem klaren Grund fehl, sodass der Bestand nie versehentlich im falschen Shop geändert wird. Wenn Sie diesen Fehler sehen, fügen Sie die Filiale der Standortzuordnung hinzu und senden Sie erneut.
Schritt 3: Trigger
Auf der Registerkarte Trigger gibt es ein Ereignis zu steuern:
invoice.create→ Bestandsdaten an Shopify übertragen (standardmäßig aktiviert) — jeder abgeschlossene Kassenverkauf mit Einzelhandelsprodukten sendet die neuen Bestandssummen dieser Produkte an den zugeordneten Shopify-Standort.
Schritt 4: Feldzuordnung
Erweitern Sie auf der Registerkarte Mapping den Bereich Produkte, um zu sehen, wie Pabau-Produktfelder auf Shopify abgebildet werden:
- SKU → SKU (erforderlich — siehe unten, wie der Abgleich funktioniert)
- Produktname → Titel
- Verkaufspreis → Preis
- Bestandsmenge → Bestandsmenge — dies ist die Zeile, die die Bestandsübertragung steuert; wird sie deaktiviert, stoppt die Bestandssynchronisierung.
Die Richtungssteuerung der Gruppe und die Einstellung Konfliktlösung bei Daten sind für die künftigen bidirektionalen Phasen des Connectors vorgesehen; derzeit ist die aktive Strecke ausgehend (Pabau → Shopify), und Pabau ist standardmäßig die maßgebliche Datenquelle.
Wie Produkte abgeglichen werden
Wenn ein Verkauf übertragen wird, ermittelt der Connector, welcher Shopify-Variante jedes verkaufte Produkt entspricht:
- Ein Produkt, das bereits synchronisiert wurde, wird immer derselben Shopify-Variante zugeschrieben — die gespeicherte Verknüpfung ist maßgeblich.
- Andernfalls, wenn die SKU des Produkts genau einer Variante in Ihrem Shopify-Shop entspricht, wird diese Variante automatisch verknüpft und für das nächste Mal gespeichert.
- Stimmt die SKU mit mehr als einer Variante überein oder mit gar keiner, wird für dieses Produkt nichts geschrieben — der Connector rät niemals.
Kann keines der verkauften Produkte zugeordnet werden, schlägt die Übertragung mit einer Meldung fehl, die die Produkte benennt, damit Sie sie verknüpfen (oder ihnen übereinstimmende SKUs geben) und erneut senden können. Wenn nur einige zugeordnet werden können, werden diese trotzdem synchronisiert.
Was Sie in Shopify sehen
Nachdem ein Verkauf synchronisiert wurde, wird die verfügbare Menge des zugeordneten Standorts für jedes verkaufte Produkt auf die Bestandssumme von Pabau nach dem Verkauf gesetzt. Im Anpassungsverlauf des Produkts in Shopify erscheint die Änderung als Bestandskorrektur, die von der App Pabau vorgenommen wurde — sodass Sie immer erkennen können, welche Änderungen aus der Praxis stammen und welche direkt in Shopify vorgenommen wurden.
Der Connector ist bei gleichzeitigen Änderungen vorsichtig: Wenn sich nichts geändert hat, wird nichts geschrieben, und wenn jemand die Shopify-Menge genau in dem Moment ändert, in dem ein Verkauf synchronisiert wird, lehnt Shopify die veraltete Schreibung ab, und Pabau versucht es automatisch mit aktuellen Zahlen erneut.
Die Verbindung testen
Verwenden Sie Verbindung testen auf der Registerkarte Einstellungen, um zu bestätigen, dass Pabau Ihren Shop erreichen kann — dabei wird ein echter, authentifizierter Aufruf an die Shopify Admin API gesendet.
HINWEIS: Testereignis senden ändert absichtlich niemals den Bestand in Ihrem Shop — ein Testschreibvorgang würde echten Bestand bewegen. Ein Testereignis durchläuft die Pipeline und erscheint im Protokoll als erklärender Nicht-Vorgang; um zu sehen, wie sich der Bestand tatsächlich ändert, führen Sie einen kleinen echten Verkauf durch (Sie können ihn anschließend erstatten).
Das Übertragungsprotokoll lesen
Wählen Sie am Connector Protokolle, um jede Übertragung zu sehen — einschließlich der genauen Anfrage, die Pabau gesendet hat, der Antwort, die Shopify zurückgegeben hat, sowie einer Korrelations-ID für Support-Tickets. Fehler folgen den Standardregeln von Data Sync: vorübergehende Probleme (Ratenbegrenzungen, Netzwerkfehler, Shopify-Serverfehler) werden automatisch nach einem zunehmenden Zeitplan wiederholt, während dauerhafte Ablehnungen den Grund anzeigen, damit Sie die Daten korrigieren und mit Neueste Daten synchronisieren erneut senden können. Die vollständige Anleitung zu Status, Wiederholungsversuchen und erneutem Senden finden Sie in How Data Sync works in Pabau.
Datenschutz und Ihre Shopify-Daten
Die Pabau-App abonniert die Datenschutz-Webhooks von Shopify, sodass eine über Shopify gestellte Kundendatenanfrage oder Löschanfrage — sowie die Entfernung der App aus Ihrem Shop — automatisch gemäß der DSGVO bearbeitet wird. Eine in Pabau erfolgte Löschung wird niemals von Shopify ausgelöst: medizinische Datensätze werden gemäß den eigenen Datenaufbewahrungsregeln von Pabau aufbewahrt.
Trennen der Verbindung
Um die Synchronisierung zu stoppen, öffnen Sie die Registerkarte Einstellungen des Connectors und trennen Sie den Shopify-Shop, oder pausieren bzw. löschen Sie den Connector über seine Karte in Data Hub > Data Sync. Sie können die Pabau-App auch aus Ihrem Shopify-Admin-Bereich deinstallieren — Pabau wird benachrichtigt, und die Verbindung wird beendet. Der Übertragungsverlauf wird zu Prüfzwecken aufbewahrt.
Verwandte Artikel
- How Data Sync works in Pabau