Inhaltsverzeichnis

Features der Schnittstelle
Anbindung
Shop Einstellungen
Workflows
Sonderfälle / Sonstige Informationen
- Rabattartikel
- Übertragung SEO-spezifischen Informationen von xentral nach WooCommerce

Mit dieser Schnittstelle kannst du 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, kannst du unter Administration → Shop Schnittstelle → Übersicht → Shopfunktionen überprüfen.

Hinweis: Bis Version 21.1 unter Administration → Online-Shops / Marktplätze → Shopfunktionen.

Anbindung

Hier erfährst du, wie du deinen WooCommerce Shop an xentral anbinden kannst.

API-Zugangsdaten in WooCommerce generieren

Zunächst musst du im Backend deines WooCommerce-Shops einen REST-API Account anlegen. Das machst du unter Einstellungen → Erweitert → REST-API → Schlüssel hinzufügen. 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 du in xentral eintragen musst. Der Consumer Key entspricht dem API Key in xentral, das Consumer Secret dem API Secret.

Wichtig: Diesen Daten siehst du nicht mehr, sobald du die Seite schließt. Trage die Daten also direkt in der WooCommerce-Schnittstelle in xentral ein. Wie das geht, erfährst du im nächsten Abschnitt.

Schnittstelle in xentral anlegen

Unter Administration → Shop Schnittstelle → Übersicht → NEU legst du einen neuen Shop an und wählst das Modul WooCommerce aus.

Hinweis: Bis Version 21.1 unter Administration → Einstellungen → Online-Shops / Marktplätze → NEU.

Nachdem du WooCommerce ausgewählt hast, kannst du 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 deines Shop-Frontends

Sobald du die Daten eingetragen hast, kannst du die Verbindung zwischen beiden System über folgenden Button prüfen.

Wenn die Verbindung erfolgreich war, erhältst du die graue Meldung "success". Sollte die Verbindung nicht erfolgreich hergestellt werden, dann wird dir in einer roten Meldung die Ursache dafür mitgeteilt. In diesem Fall sind wahrscheinlich die Zugangsdaten falsch und müssen noch einmal überprüft werden.

Schnellstart

Um schnellstmöglich loszulegen sind nur ein paar Einstellungen und Aktionen erforderlich. Was für einen Quickstart mit Auftragsimport, Lagerzahlenabgleich und Rückmeldung von Trackingnummern notwendig ist erfährst du hier.

Shop Einstellungen

In diesem Abschnitt werden dir die möglichen Einstellungen in der Shop-Schnittstelle erklärt.

Schnittstelle

Wenn du die Einstellungen der WooCommerce Schnittstelle öffnest, landest du zunächst im Tab Details → Schnittstelle.

Einstellungen:

Bezeichnung → Name frei wählbar für den Shop (wird z.B. im Artikel und im Import-Menü angezeigt)
Aktiv → Haken setzen, damit die Schnittstelle aktiv ist. Nicht mehr benötigte Schnittstellen kannst du auf inaktiv setzen
Projekt → Verknüpfung des Shops auf ein Projekt. Im Projekt kannst du die Logistikeinstellungen vornehmen
Abholmodus → Hier hast du die Optionen nach Status oder Nummer abzuholen. Der Abholmodus ab Nummer ist nur zum Testen und nicht für den regulären Import. Für den regulären Import stelle bitte nach Status ein
Import-Modus → Legt fest, ob die Aufträge aus dem Shop manuell (per Knopfdruck) oder automatisch importiert werden sollen
- Demo (zum Testen) → Der Auftragsstatus im Shop nicht umgestellt, keine Artikel oder Lagerzahlen übertragen
- Manuell (mit Importzentrale) → Die Aufträge werden erst abgeholt, wenn der Button Aufträge abholen geklickt wird
- Automatisch (per Prozessstarter) → Die Aufträge werden regelmäßig automatisch vom Shop abgeholt. Hierfür wird der Prozessstarter Shopimporter benötigt
Nur 1 Auftrag pro Anfrage → Es wird nur 1 Auftrag pro Anfrage vom Shop übertragen
Aufträge in Zwischentabelle → Beim Abholen der Aufträge werden die Aufträge nicht direkt angelegt, sondern erstmal zum Durchschauen in einer Zwischentabelle gespeichert. Hier kannst du entscheiden, welche Aufträge angelegt und welche erst später importiert werden sollen
Anzahl abholen begrenzen → Möglichkeit, um eingehende Aufträge auf einmal zu begrenzen. Steht nichts (0) drin gilt die Default-Begrenzung von 100
Protokollierung im Logfile → Durch Setzen des Hakens aktivierst du den Logfile und die Informationen werden in diesem protokolliert
Rabattbezeichnung immer aus Artikel beziehen → Wenn du den Haken setzt, wird die Bezeichnung aus dem Rabattartikel in xentral übernommen, sonst wird der Gutscheincode aus dem Auftrag übernommen
API Key → "Consumer Key" aus dem WooCommerce-Backend
API Secret → "Consumer Secret" aus dem WooCommerce-Backend
API URL → URL deines Shop-Frontends
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
Preisberechtigungsgrundlage bei Auftragsimport → Da es beim Auftragsimport aus WooCommerce sein kann, dass über die API keine Informationen darüber bereitgestellt werden, ob es sich beim Gesamtbetrag um dem Brutto- oder Nettopreis handelt, kannst du das mit dieser Einstellung auswählen
- 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

Aktion:

Verbindung prüfen → Prüft die Verbindung zwischen beiden Systemen
Aufträge abholen → Holt die Aufträge aus deinem Shop ab. Hinweis: Außerdem solltest du darauf achten, dass die Statusmeldungen für „Bestellung offen“, „Bestellung in Bearbeitung“ und „Bestellung fertig“ eindeutig sind. Es darf nicht der selbe Status an mehreren Stellen verwendet werden.

Shopimport Zwischentabelle → Springt zur Zwischentabelle der Aufträge vom Shop. Die Zwischentabelle wird nur im manuellen Importmodus befüllt und wenn die Option 'Aufträge in Zwischentabelle' aktiviert ist.In der Zwischentabelle wählst du in der linken Spalte zwischen "Import", "Müll" und "Später" aus.
- Import: Auftrag wird direkt importiert
- Müll: Auftrag landet im Müll und kann kein zweites Mal importiert werden
- Später: Auftrag kann zu einem späteren Zeitpunkt importiert werden
Alte Aufträge importieren → Alte Aufträge werden in die Zwischentabelle geladen, wo du wieder entscheiden kannst ob die Aufträge importiert werden sollen