Herstellung der Verbindung für den Austausch / die Synchronisierung


Seit 2022 hat Shopify die Konfigurationsweise der Konnektivität zwischen externen Anwendungen und dem Online-Shop geändert. Bisher erfolgte die MetaKocka-Verbindung über „Private Apps“. Diese Methode wurde von Shopify im Jahr 2022 eingestellt und durch einen neuen Zugriffstyp namens „Custom Apps“ ersetzt. Alle Funktionen und Berechtigungen (Permissions) bleiben jedoch unverändert.


Alle Shopify-Shops, die bisher mit MetaKocka verbunden waren, werden weiterhin ohne Änderungen funktionieren. Die Änderung betrifft nur jene Online-Shops, die neu mit MetaKocka verbunden werden sollen und bisher keine dedizierte „Private Apps“-Verbindung mit MetaKocka hatten.


1. 

WICHTIGE MITTEILUNG FÜR 2024


Shopify hat zum 24. Januar 2024 seine Richtlinien zur Erfassung personenbezogener Kundendaten in Shopify-Shops geändert. Kunden, die ihren Shopify-Online-Shop vor diesem Datum eingerichtet haben, können MetaKocka weiterhin uneingeschränkt nutzen. Für Kunden, die ihren Shopify-Shop nach diesem Datum erstellt haben, gelten jedoch neue Regeln: Damit eine Custom/Private App auf Kundendaten zugreifen kann (einschließlich MetaKocka, das Bestellungen und damit auch Kundendaten überträgt), muss der Shopify-Tarif höher als das Basic-Paket sein.

Alle Kunden, die ihren Shop nach dem genannten Datum erstellt haben und weiterhin das Shopify Basic-Paket oder eine niedrigere Version nutzen, erhalten keine Kundendaten mehr, wodurch Bestellungen nicht erfolgreich übertragen werden. Für diese Kunden suchen wir bereits nach Lösungen, um Kundendaten auf alternative Weise aus Shopify-Shops zu beziehen.



Weitere Informationen finden Sie unter folgendem Link:https://beta-help.shopify.com/en/manual/apps/app-types/custom-apps

Der entscheidende Hinweis von Shopify lautet:


Obwohl Shopify auf seinen Webseiten angibt, dass Kunden, die ihre Konten vor dem genannten Datum erstellt haben, nicht betroffen sind, gab es dennoch Fälle, in denen Shopify die Rückgabe von Kundendaten bei der Kommunikation bzw. beim Abruf von Bestellungen eingestellt hat.

Kunden, die dieses Problem haben und daher keine Bestellungen übertragen können, werden gebeten, direkt mit dem Shopify-Support Kontakt aufzunehmen. Teilen Sie ihnen mit, dass Sie bereits vor dem 24.01.2024 Kunde waren, dass Sie eine Custom App verwenden, und fordern Sie, dass Shopify die Übertragung von Kundendaten bei der Bestellübermittlung über die REST Admin API / GraphQL API wieder ermöglicht.

Der Fehler beim Bestellabruf erscheint in folgender Form. In diesem Fall haben Sie folgende Möglichkeiten:

1. Falls Ihr Shop vor dem 24.01.2024 erstellt wurde, senden Sie eine Anfrage an den Shopify-Support mit einer Fehlerbeschreibung. Unten finden Sie einen Textvorschlag. Falls Ihr Shop nach dem 24.01.2024 erstellt wurde, besteht derzeit nur die Option (2).



Dear Shopify,

You have changed your policy for retrieval of customer information via REST Admin API / GraphQL Admin API (we are using version 2023-10). Since 24th january of 2024 (base on https://beta-help.shopify.com/en/manual/apps/app-types/custom-apps), you are hiding customer information on responses for all plans that are Basic or lower. 

This is where we have a problem. Our Shopify store and account are older than that specific date, so we don't understand why are our customer data not visible in API responses. We are using Custom app (Private app) and we should, based on your public infromation (https://beta-help.shopify.com/en/manual/apps/app-types/custom-apps) should be able to receive our customer data.

We are asking you to fix this as soon as possible, since our selling proccess has stopped completely because of this problem on your part.

Kind regards,

<<company>>



2. „Shopify“ oder ein größeres Paket kaufen- https://www.shopify.com/pricing


Herstellung der Verbindung für den Austausch / die Synchronisation


Die Integration des Shopify-Onlineshops ermöglicht den Transfer von Bestellungen sowie die Synchronisation von Produkten, Lagerbeständen und Preisen.
Für übertragene Bestellungen werden Rechnungen für verkaufte Waren direkt bei FURS erstellt und bestätigt – ohne manuelle Eingabe oder zusätzliche Bearbeitung.



Für die Verbindung mit einem Shopify-Shop sind folgende Daten erforderlich:

  • URL
  • und Access Token


Ablauf in Bildern:

 

oder falls Sie die neuere UI verwenden

Wählen Sie die folgenden angekreuzten Berechtigungen aus:

Speichern Sie dann die Einstellungen:


Nachdem dies abgeschlossen ist, wird die Schaltfläche „Install app“ aktiviert, die die Verbindung ermöglicht (klicken Sie im angezeigten Fenster auf INSTALL):


Nachdem dies erledigt ist, wird die Verbindung aktiviert. An diesem Punkt müssen Sie den Admin API Access Token anzeigen und kopieren, den wir für die Anmeldung in MetaKocka benötigen. Dieser Schlüssel kann nur einmal angezeigt werden, daher ist es wichtig, ihn vorübergehend irgendwo zu speichern.




Hinzufügen einer neuen Verbindung und Einstellung in MetaKocka:



  1. Fügen Sie eine neue Verbindung zu Ihrem Shopify-Onlineshop hinzu
  2. Geben Sie einen gewünschten Namen für die Verbindung Ihres Onlineshops ein
  3. Unter Access Token (Custom App) fügen Sie den zuvor gespeicherten Schlüssel ein, den Sie in den Shopify-Einstellungen erstellt haben
  4. Die Example URL ist nur die Basis-URL Ihres Onlineshops, im Format: https://{webshop}.myshopify.com/ Beispiel: für den Shop „moja-trgovina.si“ geben Sie ein: https://moja-trgovina.myshopify.com/
  5. Bestimmen Sie, in welchem Dokument die Bestellungen übertragen werden sollen
  6. Wenn Sie eine Lagerbestands-Synchronisation wünschen, wählen Sie das Lager aus, aus dem die Daten abgerufen werden. Die Synchronisation erfolgt einseitig von MetaKocka zum Onlineshop
  7. Wenn Sie möchten, dass die Preise aus MetaKocka in den Onlineshop übertragen werden, wählen Sie das Preismodul für den Austausch aus
  8. Klicken Sie auf Speichern, um die Verbindung zu speichern
  9. Klicken Sie auf Testen der Verbindung




Wenn die Verbindung erfolgreich hergestellt wurde, stellen Sie noch AUTOMATISCHE BESTELLÜBERTRAGUNG ein



Synchronisation der Produkte 

Für die Übertragung eines Produkts in MetaKocka müssen folgende Einstellungen auf dem Produkt vorgenommen werden:

  • Der Publish Scope muss auf „global“ gesetzt sein. Wenn web, mobile usw. ausgewählt ist, erhalten Sie die Fehlermeldung: „Produkt „Wasser“ ist nicht zum Verkauf verfügbar“
  • Das Produkt muss zwingend einen Namen und eine einzigartige SKU-Nummer haben

Weitere Informationen zur Funktionsweise finden Sie hier

In MetaKocka wird die Produktsynchronisation über die Verbindungseinstellungen ausgelöst



Synchronisation des Lagerbestands 

Falls Probleme bei der Synchronisation des Lagerbestands auftreten (der Bestand wird nicht aktualisiert), prüfen Sie zunächst, ob die entsprechenden Berechtigungen für die zuvor hinzugefügte Shopify „Private Apps“ aktiviert sind.

Die für die Synchronisation des Lagerbestands relevanten Berechtigungen sind:

Es ist wichtig, dass diese Berechtigung auf „Read and write“ gesetzt ist.


Die Synchronisation des Lagerbestands erfolgt einseitig von MetaKocka zu Shopify und wird in den Einstellungen unter „Verbindungen“ ausgelöst.


1. Das Lager, aus dem der Bestand synchronisiert wird, muss festgelegt werden, bevor die vollständige Bestands-Synchronisation gestartet wird.




Feldzuordnung Produkt MetaKocka <> Shopify


MetaKockaShopifyAnmerkung
CodeSKU
ProduktnameName
MengeQuantity
PreisPriceDa der Preis bereits die Steuer enthält, wird er in MetaKocka immer als Brutto-Preis gespeichert. Beim Abruf werden auch Steuerdaten übermittelt. Falls keine Steuer festgelegt ist, wird dem Produkt eine Steuer von 0 zugewiesen.
Verkaufsfähig, EinkaufsfähigNicht definiertIn MetaKocka muss zwingend festgelegt werden, ob ein Produkt verkaufsfähig oder einkaufsfähig ist. Falls ein neues Produkt hinzugefügt wird, wird es automatisch als verkaufsfähig und einkaufsfähig markiert.
MaßeinheitNicht definiertFalls der Benutzer einen Standardwert für die Maßeinheit festgelegt hat, wird dieser verwendet. Andernfalls wird "Stück" eingetragen.

Die Daten in Shopify enthalten keine Mehrwertsteuer, daher wird der Versandbetrag in Shopify als Bruttobetrag in MetaKocka berücksichtigt, und der Standardsteuersatz des Unternehmens wird festgelegt.


Preis-Synchronisation

Die Preis-Synchronisation von MetaKocka nach Shopify überträgt Bruttopreise.


Die Synchronisation wird in den Einstellungen / Verbindungen ausgelöst. Zuerst wird das Preismodell festgelegt, aus dem die Preise synchronisiert werden sollen und anschließend wird die Preissynchronisation in Shopify gestartet.



Einstellung des Präfixes für Bestellungen


Falls Sie mehrere Online-Shops haben, empfehlen wir, für jede Bestellung ein Präfix festzulegen.
Anleitung (Quelle: https://www.speakinginbytes.com/2017/11/shopify-order-numbers/):



Steuerzuordnung

Falls der Online-Shop keine Steuerinformationen sendet, wird für die Produkte der Bestellung die Standardsteuer aus MetaKocka verwendet. Es ist jedoch auch möglich, die Steuern im Online-Shop einzustellen (sowohl für Produkte als auch für Versandkosten), und diese werden dann entsprechend den Steuerkennzeichen in MK übertragen. Die folgenden Mehrwertsteuersätze werden unterstützt:




Kennzeichen
MK Steuer
0.2222%
0.0959,5%


Beschränkungen der Übertragung auf Tags


Wenn eine Bestellung bestimmte 'Tags' hat, werden diese in MetaKocka übertragen. Dies wird in den erweiterten Einstellungen festgelegt:

 



Beim Übertragen der Bestellungen wird dieses Tag angezeigt.






Anleitung: Verbindungsmethoden und -einstellungen über Private Apps (Verbindungen bis einschließlich 2021)
Anleitung: Verbindungsmethoden und -einstellungen über Custom Apps (2022 und darüber hinaus)


Sind Sie noch kein MetaKocka-Nutzer? Registrieren Sie sich und testen Sie die Funktionalität 30 Tage kostenlos