Shopify Schnittstelle - Installation & Einrichtung

  • Shopify
Um Shopify in Xentral integrieren zu können, sind mehrere Schritte nötig. Xentral bindet externe Shops, auch wenn diese extra APIs anbieten immer über einen Xentral Shop-Importer an. Das ist die genormte Schnittstelle für Xentral. In dieser Schnittstelle wird dann auf die echte API vom Shop zugegriffen. Aber die Kommunikation mit Xentral geschieht immer über den Importer.

Features der Schnittstelle
  • Aufträge abholen (derzeit werden nur Aufträge mit dem Status paid importiert)
  • Auftragsstatus bei Versand umstellen inkl. Meldung Trackingnummer
  • Artikel einzeln von Xentral nach Shopify oder von Shopify nach Xentral übertragen
  • Meldung aktueller Lagerzahlen
Die Rechnung und oder Lieferschein kann durch Xentral mit eigenen Nummernkreisen erstellt werden. Die Belege werden im Versandprozess automatisch erstellt und versendet bzw. am Versanddrucker ausgedruckt.

Shopify API Key

Um den API Key bei Shopify zu finden oder neu anzulegen, melden Sie sich als Administrator in Ihrem Shopify Backend an.
Clicken Sie auf Apps: :entwickler:shopify_apikey_weg1.png?200 Clicken Sie auf Manage private apps: :entwickler:shopify_apikey_weg2.png?900 Anschließend sehen Sie auf der rechten Seite die API credentials: :entwickler:shopify_apikey_weg3.png?900 Um einen neuen Key anzulegen, klicken Sie auf Create new private app (rechts oben im Fenster).
Nachdem Sie auf speichern gedrückt haben sehen Sie die neuen API credentials.

Status setzen (falls nötig)

Es kann sein, dass Sie aufgefordert werden, einen Status zu setzen, für gewisse Gebiete.
Es müssen dann mindestens folgende Bereiche mit lesenden und schreibenden (read and write) Status eingestellt werden:
:entwickler:shopfiy_schnittstele_admin_apiberechtigungen.png

Installation in Xentral

Sie können über Administration → Online Shops → NEU einen Shop für Shopify anlegen. Danach tragen Sie die folgenden Daten in der Maske ein und speichern:
  • Shopify URL
  • Shopify API-Key
  • Shopify Passwort
:entwickler:shopify_inline_importer.png Um die Verbindung zu prüfen, sollte mindestens ein Auftrag in Shopify vorhanden sein, der die Kriterien für eine Abholung nach Xentral erfüllt.

Aufträge zu Xentral übertragen

Das Importieren von Bestellungen aus Online Shops ist hier beschrieben

Versandkostenmapping von Shopify

Die Versandkosten werden automatisch nach Xentral mit importiert. Nach Xentral werden die Aufträge mit Portokosten ganz normal mit einem Portoartikel und dessen Preis importiert.Portofreie Bestellungen werden mit dem Portoartikel importiert, jedoch ist dieser mit 0,00 EUR aufgeführt, somit ist die Bestellung für den Kunden portofrei.

Zahlweisenmapping von Shopify

Die Zahlweisen werden automatisch nach Xentral mit importiert.Ist eine Zalweise nicht bekannt, wird diese in Xentral angelegt und muss mit einem einer hinterlegten Zahlweise in Xentral verknüpft werden. Info: Die Typbezeichnung für Shopify Payments ist folgende:
  • shopify_payments → ist die Typbezeichnung die Shopify für Shopify-Payments liefert

Kategorie Übertragung von Xentral nach Shopify

Wir übertragen die Informationen der Kategorie in Shopify als Produkttyp. :entwickler:kategoriename_shopify.png?nolink Dadurch haben Sie die Möglichkeit Ihre Kategorien in Shopify flexibel aufzubauen. Die Zuordnung zur Kategorie erfolgt dann über die korrekte Angabe des Produkttypen. :entwickler:kategorie_zuordnung_shopify.png?nolink

Produktmapping nach Xentral

Um die aus Shopify kommenden Produkte richtig auf die Xentral-Artikel zu mappen, muss im Artikelstamm von Xentral die ProduktID als Fremdnummer vergeben werden. Nicht die SKU! Zusätzlich ist dieses Mapping wichtig für Exporte von Xentral nach Shopify. Ohne ein korrektes Mapping klappt kein Export von Xentral nach Shopify. Bei Artikeln ohne Variante muss die shopifyproductid beim Artikel gepflegt werden. Diese erhalten Sie, wenn Sie den Artikel aufrufen und den markierten Bereich der URL kopieren. Zusätzlich sollte die SKU (Artikelnummer) gepflegt werden. Shopify URL :entwickler:shopifyproductid.png?nolink Ansicht in Xentral :entwickler:shopifyproductid2.png?nolink Bei Artikeln mit Variante muss man zwischen Parent und Child Artikel unterscheiden. Bei parent Artikeln muss die shopifyproductid (grüner Kasten) gepflegt werden. Shopify URL :entwickler:shopify_variante.png?nolink Ansicht in Xentral :entwickler:shopifyproductid3.png?nolink Bei child Artikeln muss die shopifyvariantid (blauer Kasten) und SKU (Artikelnummer) gepflegt werden. Shopify URL :entwickler:shopify_variante.png?nolink Ansicht in Xentral :entwickler:shopify_variante2.png?nolink

Gutscheinartikel von Shopify

Artikel können in Shopify als Gutscheine (Gift Cards) angelegt werden, um Betragsminderungen in Aufträgen durch Gutscheine darzustellen. Diese können beim Autragsimport in Xentral übernommen werden. Dazu muss der Gutschein-Artikel in Shopify so eingstellt sein, dass er nicht automatisch kommissioniert wird. Sonst werden die Aufträge in Shopify als versendet markiert und nicht mehr von Xentral abgeholt. In Xentral darf der Artikel kein Lagerartikel sein. Nicht-Lagerartikel können, wenn gewollt, auf dem Lieferschein ausgeblendet werden.

E-Mail Funktion in Shopify (Tracking E-Mail)

Die Tracking E-Mail Funktion wird über die Shopify Schnittstelle standardmässig deaktiviert. Für eine Aktivierung der E-Mail Funktion (Tracking E-Mails über Shopify versenden nach Tracking Rückmeldung+Statusumstellung zum Shop)
  • Tracking E-Mails über Shopify versenden
Praxistip: Die Aktivierung muss nur erfolgen, wenn über Xentral KEINE Tracking E-Mails versendet werden (Deaktivierung in den Projekteinstellungen). D.h. Sie möchten die Tracking E-Mails ausschliesslich über Shopify versenden. (für andere Shops etc. kann im Projekt die Tracking E-Mail über Xentral aktiviert werden). :entwickler:shopify_mail_funktion.png?direct

Demo- und Testfunktionen

Info/Praxistipp: Es werden derzeit nur Aufträge mit dem Status paid importiert. Oft werden die Bestellungen im gleichen Zuge bezahlt, zBsp. mit paypal. Um doppelte Abrechnungen zu vermeiden sollte je Zahlungsweise ein fester Prozess implementiert werden.

FAQs

War der Artikel hilfreich?
Vielen Dank für Ihr Feedback!

Made with ❤ at zwetschke.de