<p><span style="font-size:28px;"><strong>Shopify Schnittstelle - Installation &amp; Einrichtung</strong></span><br />&nbsp;</p>Mit dieser Schnittstelle k&ouml;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 &uuml;ber eine API-Schnittstelle (Shopimporter).<p dir="ltr">Die Erstellung und der Versand von Lieferscheinen und Rechnungen wird &uuml;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&uuml;ck.</p><br /><div class="video-box youtube-video"><span class="wiki-text"><iframe allowfullscreen="" frameborder="0" src="https://www.youtube.com/embed/49PICIq3XP8"></iframe><br />&nbsp;</span><br />&nbsp;<h1><span class="wiki-text">Features der Schnittstelle</span></h1><ul><li><span class="wiki-text">Auftr&auml;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&auml;nderungen</li><li><span class="wiki-text">R&uuml;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 />&nbsp;</li></ul><h1><span class="wiki-text">Anbindung in Shopify</span></h1><span class="wiki-text">Um Shopify und Xentral verbinden zu k&ouml;nnen, m&uuml;ssen Sie zun&auml;chst den API Key bei Shopify finden oder neu anzulegen. Melden Sie sich hierf&uuml;r zun&auml;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&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;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&uuml;ckt haben, sehen Sie die neuen API-Zugangsdaten.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=2" /></span><h2><br /><span class="wiki-text">Rechte f&uuml;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&uuml;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&uuml;ssen, wenn ein h&ouml;herer Funktionsumfang gew&uuml;nscht ist. So erfordert das Listen von Artikeln von Xentral zu Shopify z.B. lesende und schreibende Rechte im Bereich &#39;<strong>Product information</strong>&#39;; f&uuml;r das Erstellen von Gutschriften sind volle Rechte im Bereich &#39;<strong>Draft orders</strong>&#39; notwendig.<br /><br />Im Zweifel ist es ratsam, alle in Frage kommenden Rechte zu vergeben, damit die Schnittstelle uneingeschr&auml;nkt arbeiten kann.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=3" /><br />&nbsp;</span><h1><br /><span class="wiki-text">Anbindung in Xentral</span></h1><span class="wiki-text">Unter Administration &rarr; Einstellungen &rarr; Online-Shops &rarr; NEU kann ein neuer Shop angelegt und das Modul Shopify ausgew&auml;hlt werden.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=4" /><br /><br /><br />Nachdem Sie Shopify ausgew&auml;hlt haben, k&ouml;nnen Sie im n&auml;chsten Schritt die n&ouml;tigen Daten f&uuml;r die Verbindung der beiden Systeme eintragen. Den API-Key und das Passwort haben Sie im Shopify-Backend beim Anlegen der App f&uuml;r die Schnittstelle erhalten.</span><ul><li><span class="wiki-text">Shopify URL &rarr; 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&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=5" /><br /><br />Sobald die Daten eingetragen wurden, k&ouml;nnen Sie die Verbindung zwischen beiden System &uuml;ber den Button Verbindung pr&uuml;fen testen.Um die Verbindung zu pr&uuml;fen, sollte mindestens ein Auftrag in Shopify vorhanden sein, der die Kriterien f&uuml;r eine Abholung nach Xentral erf&uuml;llt, da Xentral den Verbindungstest unter Umst&auml;nden anhand eines simulierten Requests zur Auftragsabholung durchf&uuml;hrt.<br /><br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=6" /><br />&nbsp;</span><h1><span class="wiki-text">Auftr&auml;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&auml;ge mit dem Status <strong>&quot;paid&quot;</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&uuml;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 &quot;Bei Import Optionen in Shopify zu Artikelbeschreibung &uuml;bernehmen&quot; erm&ouml;glicht es, Eigenschafts-Optionen, z.B. Personalisierungen beim Import in die Artikelbeschreibung in den Auftrag zu &uuml;bernehmen.</span><br />&nbsp;<h2><span class="wiki-text">Stornierungen zur&uuml;ckmelden</span></h2>Wenn in den Einstellungen die Option <strong>&quot;Stornierung r&uuml;ckmelden&quot;</strong> aktiviert ist, dann werden Stornos von Auftr&auml;gen aus dem Shop an Shopify gemeldet. Die Storno-R&uuml;ckmeldung setzt nur Status <strong>&quot;refunded&quot;</strong> in Shopify, da die Ausbezahlung der Gutschrift &uuml;ber Xentral l&auml;uft. Die R&uuml;ckerstattung l&auml;uft nicht &uuml;ber Shopify.<br /><br />Die Storno-Mail von Shopify wird nicht ausgel&ouml;st. Teilstornos oder nachtr&auml;gliche Preisnachl&auml;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&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=3554" style="width: 1000px; height: 126px;" /></span><br /><br />Weil die Gutschrift &uuml;ber Xentral erstellt wird, wird die Bestellung als &quot;refundend&quot; markiert.<br /><br /><span class="wiki-text"><img alt="" src="./index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=3555" style="width: 650px; height: 751px;" /><br />&nbsp;</span><br />&nbsp;<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&auml;ge mit Portokosten um einen Portoartikel und dessen Preis erg&auml;nzt. Den also Portoartikel zu verwendenden Artikel aus dem Artikelstamm k&ouml;nnen Sie in der Schnittstelle unter Einstellungen hinterlegen.Portofreie Bestellungen werden ebenfalls mit dem Portoartikel importiert, jedoch erh&auml;lt dieser Artikel dann einen Preis von 0,00 EUR, sodass die Bestellung f&uuml;r den Kunden portofrei ist.<br />&nbsp;</span><br />&nbsp;<h1><span class="wiki-text">Zahlweisenmapping von Shopify</span></h1><span class="wiki-text">Die in den Shop-Auftr&auml;gen verwendeten Zahlweisen werden automatisch zu Xentral mitimportiert. Ist eine Zahlweise nicht bekannt, wird diese in der Schnittstelle unter Details &rarr; Zahlweisen angelegt und kann dann mit einer hinterlegten Zahlweise in Xentral verkn&uuml;pft werden.<br /><br />N&auml;here Informationen zum Zahlweisen Mapping finden Sie im Artikel <a href="index.php?module=wiki&amp;action=list&amp;cmd=onlineshops" target="_blank">Online Shops: Einstellungen</a>.</span><p><span class="wiki-text">Die Typbezeichnung f&uuml;r <strong>Shopify Payments</strong> lautet <strong>shopify_payments</strong>.</span><br />&nbsp;</p><p><span class="wiki-text">Kategorie &Uuml;bertragung von Xentral nach Shopify</span></p><p><span class="wiki-text">Xentral &uuml;bertr&auml;gt die Informationen der Artikel-Kategorien zu Shopify. Dort wird die Kategorie als Produkttyp angelegt (Alle Produkte &rarr; Produkt bearbeiten).<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=7" /><br /><br /><br />Dadurch haben Sie die M&ouml;glichkeit Ihre Kategorien in Shopify flexibel aufzubauen und zu gliedern. Die Zuordnung zur Kategorie erfolgt dann &uuml;ber die korrekte Zuordnung des Produkttypen (Kategorien &rarr; Kategorie bearbeiten).<br /><br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=8" /><br />&nbsp;</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 &rarr; Artikel &rarr; Fremdnummern) angelegt werden, <strong>nicht die SKU!</strong> Zus&auml;tzlich ist dieses Mapping wichtig f&uuml;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&auml;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&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=9" /><br /><br /><strong>Ansicht in Xentral</strong><br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;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&uuml;ner Kasten) gepflegt werden.<br /><br /><strong>Shopify URL</strong><br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=11" /><br /><br /><strong>Ansicht in Xentral</strong><br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;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&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=11" /><br /><br /><strong>Ansicht in Xentral</strong><br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=13" /><br />&nbsp;</span></p><h1><span class="wiki-text">Gutscheinartikel von Shopify</span></h1><p><span class="wiki-text">Artikel k&ouml;nnen in Shopify als Gutscheine (Gift Cards) angelegt werden, um Betragsminderungen in Auftr&auml;gen durch Gutscheine darzustellen. Diese k&ouml;nnen beim Autragsimport in Xentral &uuml;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&auml;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&ouml;nnen, wenn gewollt, auf dem Lieferschein ausgeblendet werden.<br />&nbsp;</span><br />&nbsp;</p><h1><span class="wiki-text">Tracking E-Mail in Shopify</span></h1><p><span class="wiki-text">Der Versand der Tracking-Mail wird &uuml;ber die Shopify Schnittstelle standardm&auml;&szlig;ig deaktiviert. Sollen die Tracking-E-Mails direkt von Shopify versendet werden, kann in der Schnittstelle diese Option aktiviert werden: <strong>Tracking E-Mails &uuml;ber Shopify versenden</strong>.<br /><br />Die Aktivierung muss nur erfolgen, wenn &uuml;ber Xentral <strong>keine</strong> Tracking E-Mails versendet werden (Deaktivierung in den Projekteinstellungen). Das ist sinnvoll, wenn Sie die Trackingmails ausschlie&szlig;lich &uuml;ber Shopify versenden wollen. F&uuml;r andere Shops kann die Tracking E-Mail im Projekt aktiviert und somit weiterhin &uuml;ber Xentral versendet werden.<br /><br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=shopimporter_shopify&amp;fileid=14" /><br />&nbsp;&nbsp;</span></p></div>