WooCommerce Schnittstelle - Installation & Einrichtung

Mit dieser Schnittstelle können Sie Xentral mit dem WordPress-basierten Online-Shop WooCommerce verbinden, um Aufträge in Xentral zu importieren.

Features der Schnittstelle

Aufträge abholen und Auftragsstatus an WooCommerce zurückmelden
Artikel von Xentral an WooCommerce übertragen

Welche Funktionen im Einzelnen möglich sind, können unter Administration → Online Shops → Shopfunktionen überprüfen.

Einrichtung WooCommerce

Unter Administration → Einstellungen → Online-Shops → NEU kann nach dem Importer für WooCommerce gesucht werden.

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.

API Key → "Consumer Key" aus dem WooCommerce-Backend
API Secret → "Consumer Secret" aus dem WooCommerce-Backend
API URL → URL Ihres Shop-Frontends

API-Zugangsdaten in WooCommerce generieren

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.

Im Anschluss werden die API-Zugangsdaten generiert, die Sie in Xentral eintragen müssen.
Der Consumer Key entspricht dem API Key in Xentral, das Consumer Secret dem API Secret.

Wichtig: 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.

Verbindungsdaten prüfen

Sobald die Daten eingetragen wurden, können Sie die Verbindung zwischen beiden System über folgenden Button prüfen.

Wenn die Verbindung erfolgreich war, erhalten Sie die Meldung "success". Sollte die Verbindung nicht erfolgreich hergestellt werden, dann wird Ihnen in einer Meldung die Ursache daüfr mitgeteilt.

Aufträge importieren

Abholmodus

Es können Aufträge anhand des Status und der Nummer aus WooCommerce übertragen werden.

nach Status → Holt alle Aufträge des angegebenen Status ab (siehe nächster Punkt)
nach Nummer → 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

Abzuholende Auftragsstatus einstellen

Hier kann man mehrere Auftragsstati angeben, die importiert werden sollen. Diese sind dann mit Semikolon zu trennen.

Statusname Bestellung offen → Aufträge in diesem Status werden vom Shop nach Xentral importiert
Statusname Bestellung in Bearbeitung → Diesen Status erhält die Bestellung, nachdem sie von Xentral abgeholt worden ist
Statusname Bestellung fertig → diesen Status erhält die Bestellung, nachdem der Auftrag in Xentral versendet worden ist

Sollten diese Angaben nicht passen, dann bitte folgende Status eintragen:

Es ist darauf zu achten, dass der Status von offenen Aufträgen und in Bearbeitung nicht identisch sein sollten. Die Bezeichnungen sind hierbei aber nur beispielhaft. Es müssen die Statusmeldungen der Aufträge angegeben werden, wie sie auch im tatsächlichen WooCommerce-Shop verwendet werden. Dies hängt primär von der eingestellten Sprache ab.

Preisberechnungsgrundlage einstellen

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 "Preisberechnungsgrundlage bei Auftragsimport" vorgenommen werden.

Nettopreis zurückrechnen → Der Preis der einzelnen Positionen wird so berechnet, als sei die in der API übergebenen Gesamtsumme der Nettopreis
Bruttopreis zurückrechnen → Der Preis der einzelnen Positionen wird so berechnet, als sei die in der API übergebenen Gesamtsumme der Bruttopreis

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.

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.

Artikel exportieren

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 Prozessstarter Artikel Übertragen muss aktiv sein.

Übertragung SEO-spezifischen Informationen von Xentral nach Woocommerce

Meta description und Title werden nur in Verbindung mit dem WC-Plugin „Yoast SEO“ übertragen.