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.