mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-27 07:00:29 +01:00
1 line
8.9 KiB
Plaintext
1 line
8.9 KiB
Plaintext
<strong><span style="font-size:28px;">WooCommerce Schnittstelle - Installation & Einrichtung</span></strong><br /><br />Mit dieser Schnittstelle können Sie Xentral mit dem WordPress-basierten Online-Shop WooCommerce verbinden, um Aufträge in Xentral zu importieren. <br /> <h1>Features der Schnittstelle</h1><ul><li>Aufträge abholen und Auftragsstatus an WooCommerce zurückmelden</li><li>Artikel von Xentral an WooCommerce übertragen</li></ul>Welche Funktionen im Einzelnen möglich sind, können unter Administration → Online Shops → Shopfunktionen überprüfen.<br /> <h1>Einrichtung WooCommerce</h1><img src="http://helpdesk.wawision.de/images/wiki-import/entwickler/woocommerce_importer_suchen.png" /><span class="wiki-text">Unter Administration → Einstellungen → Online-Shops → NEU kann nach dem Importer für <span class="highlight" rel="WooCommerce">WooCommerce</span> gesucht werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_woocommerce&fileid=802" style="width: 1200px; height: 257px;" /></span><br /><br />Nachdem Sie WooCommerce ausgewählt haben, können Sie im nächsten Schritt die nötigen Daten für die Verbindung der beiden Systeme eintragen.<br /><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_woocommerce&fileid=801" style="width: 1200px; height: 373px;" /><br /><img src="http://helpdesk.wawision.de/images/wiki-import/entwickler/woocommerce_verbindung_pruefen2.png" /><ul><li><strong>API Key</strong> → "Consumer Key" aus dem WooCommerce-Backend</li><li><strong>API Secret </strong>→ "Consumer Secret" aus dem WooCommerce-Backend</li><li><strong>API URL</strong> → URL Ihres Shop-Frontends<br /> </li></ul><h2>API-Zugangsdaten in WooCommerce generieren</h2>Zunächst müssen Sie im Backend Ihres WooCommerce-Shops einen REST-API Account anlegen. Das können Sie unter Einstellungen → Erweitert → REST-API → Schlüssel hinzufügen tun. Der Benutzer sollte ein Administrator sein. Die Xentral API benötigt in jedem Fall die Berechtigungen Lesen und Schreiben.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_woocommerce&fileid=800" style="width: 1200px; height: 247px;" /><br /><br /><img src="http://helpdesk.wawision.de/images/wiki-import/entwickler/woocommerce_restapi_account_anlegen2.png" />Im Anschluss werden die API-Zugangsdaten generiert, die Sie in Xentral eintragen müssen.<br />Der Consumer Key entspricht dem API Key in Xentral, das Consumer Secret dem API Secret.<br /><br /><span style="color:#c0392b;"><strong>Wichtig:</strong></span> Diesen Daten sehen Sie nicht mehr, sobald Sie die Seite schließen. Tragen Sie die Daten also direkt in der WooCommerce-Schnittstelle in Xentral ein.<br /><br /><img src="http://helpdesk.wawision.de/images/wiki-import/entwickler/woocommerce_api_key_und_api_secret_generieren.png" /><h2>Verbindungsdaten prüfen</h2>Sobald die Daten eingetragen wurden, können Sie die Verbindung zwischen beiden System über folgenden Button prüfen.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_woocommerce&fileid=803" style="width: 1200px; height: 373px;" /><br /><br /><img src="http://helpdesk.wawision.de/images/wiki-import/entwickler/woocommerce_verbindung_pruefen.png" />Wenn die Verbindung erfolgreich war, erhalten Sie die Meldung <strong>"success"</strong>. Sollte die Verbindung nicht erfolgreich hergestellt werden, dann wird Ihnen in einer Meldung die Ursache daüfr mitgeteilt.<h1><br />Aufträge importieren</h1><h2>Abholmodus</h2>Es können Aufträge anhand des Status und der Nummer aus WooCommerce übertragen werden.<ul><li><strong>nach Status</strong> → Holt alle Aufträge des angegebenen Status ab (siehe nächster Punkt)</li><li><strong>nach Nummer</strong> → Hier kann eine Bestellnummer eingegeben werden. Wichtig: Die Bestellnummer ist nicht die gleiche wie in der Bestellungs-Übersicht in Woocommerce. Sie finden die Nummer heraus, indem Sie auf die gewünschte Bestellung klicken und dann die order-Nummer aus der URL nehmen: z.B. ... wp-admin/post.php?post=105075&action=edit</li></ul> <h2>Abzuholende Auftragsstatus einstellen</h2>Hier kann man mehrere Auftragsstati angeben, die importiert werden sollen. Diese sind dann mit Semikolon zu trennen.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_woocommerce&fileid=804" style="width: 1200px; height: 408px;" /><br /> <ul><li><img src="http://helpdesk.wawision.de/images/wiki-import/entwickler/woocommerce_status.png?nolink" /><strong>Statusname Bestellung offen</strong> → Aufträge in diesem Status werden vom Shop nach Xentral importiert</li><li><strong>Statusname Bestellung in Bearbeitung</strong> → Diesen Status erhält die Bestellung, nachdem sie von Xentral abgeholt worden ist</li><li><strong>Statusname Bestellung fertig</strong> → diesen Status erhält die Bestellung, nachdem der Auftrag in Xentral versendet worden ist</li></ul><br />Sollten diese Angaben nicht passen, dann bitte folgende Status eintragen:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_woocommerce&fileid=2743" style="width: 738px; height: 364px;" /><br /><br /><span class="wiki-text">Es ist darauf zu achten, dass der Status von offenen Aufträgen und in Bearbeitung nicht identisch sein sollten. </span> <span class="wiki-text">Die Bezeichnungen sind hierbei aber nur beispielhaft. Es müssen die Statusmeldungen der Aufträge angegeben werden, wie sie auch im tatsächlichen <span class="highlight" rel="WooCommerce">WooCommerce</span>-Shop verwendet werden. Dies hängt primär von der eingestellten Sprache ab.</span><br /> <h2><span class="wiki-text">Preisberechnungsgrundlage einstellen</span></h2><span class="wiki-text">Beim Auftragsimport aus WooCommerce kann es sein, dass über die API keine Informationen darüber bereitgestellt werden, ob es sich beim Gesamtbetrag um dem Brutto- oder Nettopreis handelt. In der Schnitstelle kann deswegen die Einstellung <strong>"Preisberechnungsgrundlage bei Auftragsimport" </strong>vorgenommen werden.</span><ul><li><span class="wiki-text"><strong>Nettopreis zurückrechnen</strong> </span>→ <span class="wiki-text">Der Preis der einzelnen Positionen wird so berechnet, als sei die in der API übergebenen Gesamtsumme der <strong>Nettopreis</strong></span></li><li><span class="wiki-text"><strong>Bruttopreis zurückrechnen</strong> </span>→ <span class="wiki-text">Der Preis der einzelnen Positionen wird so berechnet, als sei die in der API übergebenen Gesamtsumme der <strong>Bruttopreis</strong></span></li></ul>Um auf den tatsächlichen Artikelpreis zu kommen mit dem Woocommerce rechnet ist es daher notwendig von der Gesamtsumme einer Position über die Menge auf die Einzelkosten zurückzurechnen. Über den Nettopreis funktioniert die Berechnung genauer, weil Rundungen bei der Steuer keine Rolle spielen und damit nicht so schnell eine Diskrepanz auftritt. Wenn das nicht möglich ist, weil zum Beispiel der Shop über die API keine Nettopreise zurückgibt, dann kann man auf die Bruttopreise zurückfallen.<br /><br />Welche Option für welchen Shop die Richtige ist, weiß man leider erst nach dem ersten Auftragsimport, da im Backend des Shops nicht ersichtlich ist was über die API zurückgegeben wird und welches Plugin sich eventuell auf die Rückmeldung auswirkt.<br /><br /><img src="http://helpdesk.wawision.de/images/wiki-import/entwickler/woocommerce_status_definition.png?nolink" /><h1>Artikel exportieren</h1>Um Artikel von Xentral zu WooCommerce zu übertragen, können Sie in der Schnittstelle im Reiter Artikel Übertragen Alle Artikel mit Shopverknüpfung exportieren oder einzelne Artikel der Übertragung hinzufügen. Damit die Artikel Übertragung stattfinden kann, muss die Einstellung Artikel Übertragung erlauben gesetzt sein und der <a href="https://xentral.com/helpdesk/prozessstarter#nav-prozessstarter--artikel-zum-shop-exportieren">Prozessstarter Artikel Übertragen</a> muss aktiv sein.<h2 id="zusaetzliches"><br />Übertragung SEO-spezifischen Informationen von Xentral nach Woocommerce</h2><div class="level4"><p>Meta description und Title werden nur in Verbindung mit dem WC-Plugin „Yoast SEO“ übertragen.</p></div> |