mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-27 07:00:29 +01:00
22 lines
21 KiB
Plaintext
22 lines
21 KiB
Plaintext
<p><span style="font-size:28px;"><strong>Shopify Schnittstelle - Installation & Einrichtung</strong></span><br /> </p>Mit dieser Schnittstelle können Sie Xentral mit Shopify verbinden, um Bestellungen von dort in Xentral zu importieren und Ihre im Shop verkauften Artikel in Xentral zu verwalten. Die Anbindung geschieht über eine API-Schnittstelle (Shopimporter).<p dir="ltr">Die Erstellung und der Versand von Lieferscheinen und Rechnungen wird über Xentral abgewickelt, ebenso wie das Retourenmanagement. Aktualisierte Auftragsstati, die Sendungsverfolgungsnummern versandter Lieferungen und Lagerzahlen der Artikel meldet Xentral automatisch per Prozessstarter an den Shop zurück.</p> <div class="video-box youtube-video"><span class="wiki-text"><iframe allowfullscreen="" frameborder="0" src="https://www.youtube.com/embed/49PICIq3XP8"></iframe><br /> </span><br /> <h1><span class="wiki-text">Features der Schnittstelle</span></h1><ul><li><span class="wiki-text">Aufträge abholen</span></li><li><span class="wiki-text">Auftragsstatus bei Versand umstellen inkl. Meldung der Trackingnummer an Shopify</span></li><li>Synchronisation aktueller Lagerzahlen bei Bestandsänderungen</li><li><span class="wiki-text">Rückmeldung von Stornierungen an Shopify</span></li><li><span class="wiki-text">Artikel von Xentral zu Shopify exportieren und von Shopify zu Xentral importieren, inklusive Varianten- und Matrixartikel</span></li><li><span class="wiki-text">Artikeleigenschaften und -freifelder zu Shopify exportieren</span></li><li><span class="wiki-text">Meldung aktueller Lagerzahlen</span><br /><br /> </li></ul><h1><span class="wiki-text">Anbindung in Shopify</span></h1><span class="wiki-text">Um Shopify und Xentral verbinden zu können, müssen Sie zunächst den API Key bei Shopify finden oder neu anzulegen. Melden Sie sich hierfür zunächst als Administrator in Ihrem Shopify Backend an.<br /><br />Klicken Sie im Anschluss rechts auf Apps. Danach geht es weiter zu Private Apps verwalten (Manage private apps).<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=1" /><br /><br />Um einen neuen Key anzulegen, klicken Sie rechts oben auf Eine neue private App erstellen (Create new private app). Nachdem Sie auf Speichern gedrückt haben, sehen Sie die neuen API-Zugangsdaten.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2" /></span><h2><br /><span class="wiki-text">Rechte für Xentral App setzen</span></h2><span class="wiki-text">Es kann sein, dass Sie aufgefordert werden, einen Status zu setzen, um der Schnittstelle zu Xentral bestimmte Funktionen zu erlauben.Es müssen dann mindestens folgende Bereiche mit lesenden und schreibenden (read and write) Berechtigungen eingestellt werden:</span><ul><li><span class="wiki-text"><span class="wiki-text">Store content like articles, blogs, comments, pages, and redirects</span></span></li><li><span class="wiki-text">Customer details and customer groups</span></li><li><span class="wiki-text">Inventory</span></li><li><span class="wiki-text">Orders, transactions and fulfillments</span></li><li><span class="wiki-text">Products, variants and collections</span></li></ul><br /><span class="wiki-text"><strong><span style="background-color:null;">Wichtig:</span></strong> Bitte beachten Sie, dass der Xentral App in Shopify weitere Rechte vergeben werden müssen, wenn ein höherer Funktionsumfang gewünscht ist. So erfordert das Listen von Artikeln von Xentral zu Shopify z.B. lesende und schreibende Rechte im Bereich '<strong>Product information</strong>'; für das Erstellen von Gutschriften sind volle Rechte im Bereich '<strong>Draft orders</strong>' notwendig.<br /><br />Im Zweifel ist es ratsam, alle in Frage kommenden Rechte zu vergeben, damit die Schnittstelle uneingeschränkt arbeiten kann.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=3" /><br /> </span><h1><br /><span class="wiki-text">Anbindung in Xentral</span></h1><span class="wiki-text">Unter Administration → Einstellungen → Online-Shops → NEU kann ein neuer Shop angelegt und das Modul Shopify ausgewählt werden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=4" /><br /><br /><br />Nachdem Sie Shopify ausgewählt haben, können Sie im nächsten Schritt die nötigen Daten für die Verbindung der beiden Systeme eintragen. Den API-Key und das Passwort haben Sie im Shopify-Backend beim Anlegen der App für die Schnittstelle erhalten.</span><ul><li><span class="wiki-text">Shopify URL → Meist in Form von <a href="https://ihre-domain.myshopify.com">https://ihre-domain.myshopify.com</a></span></li><li><span class="wiki-text">Shopify API-Key</span></li><li><span class="wiki-text">Shopify Passwort</span></li></ul><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=5" /><br /><br />Sobald die Daten eingetragen wurden, können Sie die Verbindung zwischen beiden System über den Button Verbindung prüfen testen.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, da Xentral den Verbindungstest unter Umständen anhand eines simulierten Requests zur Auftragsabholung durchführt.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=6" /><br /> </span><h1><span class="wiki-text">Aufträge zu Xentral importieren</span></h1><span class="wiki-text">Das Importieren von Bestellungen aus Online Shops wird <a href="https://xentral.com/helpdesk/kurzanleitung-import-von-bestellungen-aus-online-shops?">in diesem Artikel</a> beschrieben.<br /><br />Es werden von Shopify aktuell nur Aufträge mit dem Status <strong>"paid"</strong> importiert. Oft werden die Bestellungen im gleichen Zuge bezahlt, zum Beispiel mit PayPal. Um doppelte Abrechnungen zu vermeiden sollte pro Zahlungsweise einheitlich definitert werden, ob die Zahlungsabwicklung bereits in Shopify oder in Xentral durchgeführt wird. Die Einstellungen nehmen Sie im <a href="https://xentral.com/helpdesk/kurzanleitung-einrichtung-online-shop-schnittstelle#nav-zahlungsweisen-mapping">Zahlungsweisen Mapping</a> vor.<br /><br />Die Option "Bei Import Optionen in Shopify zu Artikelbeschreibung übernehmen" ermöglicht es, Eigenschafts-Optionen, z.B. Personalisierungen beim Import in die Artikelbeschreibung in den Auftrag zu übernehmen.</span><br /> <h2><span class="wiki-text">Stornierungen zurückmelden</span></h2>Wenn in den Einstellungen die Option <strong>"Stornierung rückmelden"</strong> aktiviert ist, dann werden Stornos von Aufträgen aus dem Shop an Shopify gemeldet. Die Storno-Rückmeldung setzt nur Status <strong>"refunded"</strong> in Shopify, da die Ausbezahlung der Gutschrift über Xentral läuft. Die Rückerstattung läuft nicht über Shopify.<br /><br />Die Storno-Mail von Shopify wird nicht ausgelöst. Teilstornos oder nachträgliche Preisnachlässe werden nicht beachtet.<br /><br />So sieht die stornierte Bestellung dann aus:<br /><br /><span class="wiki-text"><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=3554" style="width: 1000px; height: 126px;" /></span><br /><br />Weil die Gutschrift über Xentral erstellt wird, wird die Bestellung als "refundend" markiert.<br /><br /><span class="wiki-text"><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=3555" style="width: 650px; height: 751px;" /><br /> </span><br /> <h1><span class="wiki-text">Versandkostenmapping von Shopify</span></h1><span class="wiki-text">Die Versandkosten werden automatisch beim Auftragsimport zu Xentral mit importiert.<br /><br />In Xentral werden die Aufträge mit Portokosten um einen Portoartikel und dessen Preis ergänzt. Den also Portoartikel zu verwendenden Artikel aus dem Artikelstamm können Sie in der Schnittstelle unter Einstellungen hinterlegen.Portofreie Bestellungen werden ebenfalls mit dem Portoartikel importiert, jedoch erhält dieser Artikel dann einen Preis von 0,00 EUR, sodass die Bestellung für den Kunden portofrei ist.<br /> </span><br /> <h1><span class="wiki-text">Zahlweisenmapping von Shopify</span></h1><span class="wiki-text">Die in den Shop-Aufträgen verwendeten Zahlweisen werden automatisch zu Xentral mitimportiert. Ist eine Zahlweise nicht bekannt, wird diese in der Schnittstelle unter Details → Zahlweisen angelegt und kann dann mit einer hinterlegten Zahlweise in Xentral verknüpft werden.<br /><br />Nähere Informationen zum Zahlweisen Mapping finden Sie im Artikel <a href="index.php?module=wiki&action=list&cmd=onlineshops" target="_blank">Online Shops: Einstellungen</a>.</span><p><span class="wiki-text">Die Typbezeichnung für <strong>Shopify Payments</strong> lautet <strong>shopify_payments</strong>.</span><br /><br /> </p><h1><span class="wiki-text">Kategorie Übertragung von Xentral nach Shopify</span></h1><p><span class="wiki-text">Xentral überträgt die Informationen der Artikel-Kategorien zu Shopify. Dort wird die Kategorie als Produkttyp angelegt (Alle Produkte → Produkt bearbeiten).<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=7" /><br /><br /><br />Dadurch haben Sie die Möglichkeit Ihre Kategorien in Shopify flexibel aufzubauen und zu gliedern. Die Zuordnung zur Kategorie erfolgt dann über die korrekte Zuordnung des Produkttypen (Kategorien → Kategorie bearbeiten).<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=8" /><br /> </span></p><h1><span class="wiki-text">Artikelmapping nach Xentral</span></h1><p><span class="wiki-text">Um die aus Shopify kommenden Artikel (Produkte) richtig auf die Xentral-Artikel zu mappen, muss im Artikelstamm von Xentral die ProduktID als <strong>Fremdnummer</strong> (Stammdaten → Artikel → Fremdnummern) angelegt werden, <strong>nicht die SKU!</strong> Zusätzlich ist dieses Mapping wichtig für den Artikelexport und -import zwischen Xentral nach Shopify.<br /><br />Bei Artikeln <strong>ohne Variante</strong> muss die <strong>shopifyproductid</strong> beim Artikel gepflegt werden. Diese erhalten Sie, wenn Sie den Artikel aufrufen und den markierten Bereich aus der URL im Browser kopieren.<br /><br />Zusätzlich sollte auch die <strong>SKU (Artikelnummer) </strong>des Artikels im Fremdnummern-Mapping in Xentral gepflegt werden.<br /><br /><strong>Shopify URL</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=9" /><br /><br /><strong>Ansicht in Xentral</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=10" /><br /><br /><br />Bei Artikeln <strong>mit Variante</strong> muss man zwischen <strong>Parent und Child</strong> Artikel unterscheiden. Bei <strong>parent</strong> Artikeln muss die <strong>shopifyproductid </strong>(grüner Kasten) gepflegt werden.<br /><br /><strong>Shopify URL</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=11" /><br /><br /><strong>Ansicht in Xentral</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=12" /><br /><br /><br />Bei <strong>child</strong> Artikeln muss die <strong>shopifyvariantid</strong> (blauer Kasten) und <strong>SKU</strong> (Artikelnummer) gepflegt werden.<br /><br /><strong>Shopify URL</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=11" /><br /><br /><strong>Ansicht in Xentral</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=13" /><br /> </span></p><h1><span class="wiki-text">Gutscheinartikel von Shopify</span></h1><p><span class="wiki-text">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.<br /><br />Dazu muss der Gutschein-Artikel in Shopify so eingstellt sein, dass er <u>nicht automatisch kommissionier</u>t wird. Sonst werden die Aufträge in Shopify als versendet markiert und nicht mehr von Xentral abgeholt.<br /><br />In Xentral darf der Artikel kein Lagerartikel sein. Nicht-Lagerartikel können, wenn gewollt, auf dem Lieferschein ausgeblendet werden.<br /> </span><br /> </p><h1><span class="wiki-text">Tracking E-Mail in Shopify</span></h1><p><span class="wiki-text">Der Versand der Tracking-Mail wird über die Shopify Schnittstelle standardmäßig deaktiviert. Sollen die Tracking-E-Mails direkt von Shopify versendet werden, kann in der Schnittstelle diese Option aktiviert werden: <strong>Tracking E-Mails über Shopify versenden</strong>.<br /><br />Die Aktivierung muss nur erfolgen, wenn über Xentral <strong>keine</strong> Tracking E-Mails versendet werden (Deaktivierung in den Projekteinstellungen). Das ist sinnvoll, wenn Sie die Trackingmails ausschließlich über Shopify versenden wollen. Für andere Shops kann die Tracking E-Mail im Projekt aktiviert und somit weiterhin über Xentral versendet werden.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=14" /><br /> </span></p><h1><span class="wiki-text">Metafelder in Shopify</span></h1>Die Metafelder in Shopify sind vergleichbar mit den Eigenschaften eines Artikels aus Xentral.<br /><br />Bis auf einige Ausnahmen sind die Metafelder allerdings nicht ohne zusätzliche Tools sichtbar. Aus technischer Betrachtung bestehen Metafelder aus einem Schlüssel, einem Wert, einem Typ und einem Scope.<ul><li><strong>Schlüssel</strong> → Der Schlüssel gibt den Namen des Metafeldes an, im Beispiel das blaue <strong>metatitle_de</strong></li><li><strong>Wert</strong> → Der Wert ist der Inhalt des Metafeldes. In diesem Beispiel <strong>"Meta DE"</strong></li><li><strong>Typ</strong> → Der Typ gibt an ob es sich beim Inhalt des Metafeldes um einen Text (string) oder eine Zahl (integer) handelt. Im Standard legt Xentral alle Metafelder als Text an</li><li><strong>Scope</strong> → Der Scope gibt an, wie weit die Information des Metafeldes reicht. Bei Artikeln mit mehreren Varianten bedeutet ein Metafeld mit dem Scope <strong>global</strong>, dass der Wert für alle Varianten des Artikels gleich ist. Ein Scope der Einstellung <strong>variant</strong> bedeutet, dass das Metafeld für alle Varianten einen eigenen Wert hat. In diesem Beispiel das graue <strong>global</strong><br /> </li></ul>In Xentral kann im Artikelstamm kann im Bereich "Texte und Beschreibungen" z.B. der Meta-Title befüllt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2964" style="width: 1200px; height: 259px;" /><br /><br /><br />Wird der Artikel zu Shopify exportiert, sieht der Meta Title so aus. In Shopify kann diese Oberfläche durch zusätzliche Apps angezeigt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2966" style="width: 1200px; height: 407px;" /><br /><br /><br />Metafelder müssen nicht zusätzlich in Shopify angelegt werden. Wird ein Wert in ein Metafeld übertragen, das noch nicht existiert, kümmert sich der Importer um alles.<br /><br /><span style="font-size:16px;"><strong>Beispiel</strong></span><br />Es soll für einen Artikel das Metafeld <strong>"Farbe"</strong> angelegt/übertragen werden und der Wert der dazu übertragen werden soll ist <strong>"Pink"</strong>. Dann reicht es aus die Daten so im Artikel zu hinterlegen.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2968" style="width: 1200px; height: 255px;" /><br /><br />Voraussetzung ist, das in der Shopschnittstelle die Option <strong>"Eigenschaften übertragen"</strong> aktiviert ist.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2969" style="width: 600px; height: 405px;" /><br /><br /><br />Bei Varianten funktioniert die Übertragung in Metafelder gleich. Bei der jeweiligen Variante wird eine Eigenschaft angelegt und ihr ein Wert gegeben. Der einzige Unterschied besteht darin, dass Eigenschaften die bei Varianten angelegt werden den Scope <strong>variant</strong> erhalten. Dadurch hat dann jede Variante in dem Metafeld ihren eigenen Wert.<br /> <h2>Vordefinierte Metafelder</h2>Einige Metafelder hat Xentral vordefiniert. Bei diesen Feldern werden Stammdaten aus Xentral zu Metafeldern in Shopify übertragen.<br /> <table border="1" cellpadding="1" cellspacing="1" height="484" width="500"><tbody>
|
|
<tr><td><strong>Feld in Xentral</strong></td><td><strong>Schlüssel / Feldname</strong></td><td><strong>Scope</strong></td>
|
|
</tr>
|
|
<tr><td>Zolltarifnummer</td><td>harmonized_system_code</td><td>global</td>
|
|
</tr>
|
|
<tr><td>Metatitel DE</td><td>metatitle_de</td><td>global</td>
|
|
</tr>
|
|
<tr><td>Metabeschreibung DE</td><td>metadescription_de</td><td>global</td>
|
|
</tr>
|
|
<tr><td>Meta Keywords DE</td><td>metakeywords_de</td><td>global</td>
|
|
</tr>
|
|
<tr><td>Artikelbezeichnung EN</td><td>title</td><td>ml_en</td>
|
|
</tr>
|
|
<tr><td>Artikelbeschreibung EN</td><td>description</td><td>ml_en</td>
|
|
</tr>
|
|
<tr><td>Metatitel EN</td><td>meta_title</td><td>ml_en</td>
|
|
</tr>
|
|
<tr><td>Metabeschreibung EN</td><td>meta_description</td><td>ml_en</td>
|
|
</tr>
|
|
<tr><td>Meta Keywords EN</td><td>metakeywords</td><td>ml_en</td>
|
|
</tr>
|
|
</tbody></table><br />Der Scope <strong>ml_en</strong> wird hierbei direkt von Xentral erschaffen. Shopify bietet die Möglichkeit, einen beliebigen Scope zu erstellen. Damit die Daten für die englische Übersetzung zentral gesammelt sind, setzt Xentral dafür kurzerhand einen eigenen Scope auf.<br /><br /> <h2>Metafelder über Freifelder übertragen</h2>Alternativ können Metafelder auch über Freifelder zu Shopify übertragen werden. Dann muss in der Schnittstelle das Freifeldmapping im Importer eingestellt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2970" style="width: 1200px; height: 269px;" /><br /> <h2>Metafelder in andere Sprachen übersetzen</h2>Um Metafelder sowie ihre enthaltenen Werte auch in andere Sprachen übersetzen. In Xentral kann eine Eigenschaft zu diesem Zweck auch für eine andere Sprache (z.B. Französisch) angelegt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2972" style="width: 1200px; height: 297px;" /><br /><br /><br />Beim Artikelexport werden dann zwei neue Metafelder in Shopfiy angelegt.<br /><br /><span style="color:null;">Das obere Metafeld beinhaltet die Übersetzung des Eigenschaftenwertes. Der Scope gibt dabei an, von welcher Sprache zu welcher übersetzt wurde. Der Schlüssel ist "Pink", die Übersetzung ist der Wert des Metafeldes.</span><br /><span style="color:null;">Das untere Metafeld beinhaltet die Übersetzung der Eigenschaftenbezeichnung. Der Scope gibt wieder an, von welcher Sprache in welche übersetzt wurde. Vorangestellt steht ein <strong>k</strong>.</span><br /><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2974" style="width: 400px; height: 502px;" /><br /><br /><br />Bei Freifeldern wird die Übersetzung anders realisiert. Hier ist der Scope entweder <strong>global</strong>, wenn ein einfacher Artikel übertragen wird, oder <strong>variant</strong>, wenn mehrere Varianten übertragen werden. Der Schlüssel ändert sich anhand der eingestellten Sprache.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopify&fileid=2975" style="width: 400px; height: 232px;" /><br /> </div> |