mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-15 04:27:14 +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 /
|
||
|
|
<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>
|