ShopiFy - Schnittstelle

Generelle Info zum Auslesen von Shopify-Bestellungen

hier sind einige Infos betreffend der Schnittstelle zu Shopify angeführt:

Generell werden Bestellungen nur nach folgenden Kriterien von wineNET aus Shopify ausgelesen:

• Offen (= nicht archiviert)
• Erstellt in den letzten 2 Tagen (und nicht jünger als 10 Minuten)
• Financial-Status: Authorized, Paid, Pending
• Fulfillment-Status: In Progress, Unfulfilled, Scheduled

Shopify-Anbindung bearbeiten

Einrichtung in Shopify

Für die Einrichtung wird ein User benötigt, mit dem eine App angelegt und diese im Store installiert werden kann. Erstellung der App (via Dev-Dashboard) Über das Dev-Dashboard kann eine neue App angelegt werden:

• Rechts oben auf 'Create App' klicken
• Unter 'Start from Dev Dashboard' bei 'App name' einen sprechenden Namen vergeben (z.B. 'wineNET Kellerbuch')
• Unter 'Scopes' folgendes eintragen:

  read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_orders,write_orders,read_products,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders

• Auf 'Release' klicken
• Im Popup 'Release this new version?' muss nichts ausgefüllt werden - einfach auf 'Release' klicken

Die OAuth-Credentials können links im Menü unter dem Namen der App unter 'Settings' eingesehen werden.

Installation der App im Store (via Dev-Dashboard)

Nun muss die App über das Dev-Dashboard im Store installiert werden:

• Links im Menü auf den Namen der App klicken
• Unter 'Installs' auf 'Install app' klicken
• In dem neuen Fenster den gewünschten Store anklicken
• Auf 'Install' klicken

Nun kann mit der Einrichtung der Schnittstelle im wineNET fortgefahren werden.

Access-Scopes

Falls die Access-Scopes angepasst werden müssen, muss im Dev-Dashboard eine neue Version der App erstellt und installiert werden:

• Links im Menü unter dem Namen der App auf 'Versions' klicken
• Rechts oben auf 'Create version' klicken
• Die 'Scopes' wie gewünscht anpassen und auf 'Release' klicken
• Im Popup 'Release this new version?' muss nichts ausgefüllt werden - einfach auf 'Release' klicken
• Links im Menü den Namen der App anklicken und unter 'Installs' auf 'Install app' klicken
• In dem neuen Fenster den gewünschten Store anklicken
• Auf 'Install' klicken

Per Default können mit dem Scope 'read_orders' nur die Bestellungen der letzten 60 Tage ausgelesen werden. Sollte also alle Bestellungen benötigt werden, wird der Scope 'read_all_orders' benötigt. Allerdings muss dieser für die App erst freigeschaltet werden:

• Shopify-Partners aufrufen
• Links im Menü auf 'App distribution' klicken
• In der Tabelle den NAMEN der anzupassenden App anklicken
• Links im Menü auf 'API access requests' klicken
• Unter 'Read all orders scope' auf 'Request access' klicken
• Ins Textfeld etwas eingeben (min. 10 Zeichen) und auf 'Request access' klicken

Nun ist der Scope für die App verfügbar und es kann eine neue Version der App mit diesem Scope erstellt werden.