Mit dieser Schnittstelle kannst du Xentral mit Etsy verbinden, um Bestellungen von dort nach Xentral zu importieren und die im Shop verkauften Artikel in Xentral zu verwalten.
Die Anbindung geschieht über eine API-Schnittstelle (Shopimporter). Derzeit befindet sich das Modul Etsy noch im Beta-Stadium und ist noch nicht vollständig programmiert bzw. eine dev-Version.
Wichtig
Bitte beachte, dass Etsy das Authentifizierungsverfahren geändert hat und Xentral das neue OAuth Verfahren von Etsy nicht unterstützt. Aus diesem Grund ist eine Anbindung an Etsy nur möglich, wenn bereits ein API User bei Etsy existiert, der folgende Zugangsdaten bereitstellt: Keystring, Shared Secret, API Token und API Token Secret. Wo du diese Daten finden kannst, erklären wir in diesem Abschnitt dieses Artikels. Etsy gibt keine neuen API User Requests mehr frei, sodass die Anbindung ohne einen bereits bestehenden User nicht möglich ist.
Die Shopschnittstelle bietet dir verschiedene Features:
-
Aufträge aus Etsy zu xentral importieren
-
Rechnungen zu importieren Aufträgen an Etsy übertragen
Rechnungen und Lieferscheine können in Xentral mit eigenem Nummernkreis erstellt werden. Die Belege werden im Versandprozess automatisch erstellt und versendet bzw. am Versanddrucker ausgedruckt.
Im Folgenden wird erklärt, wie du die Schnittstelle an Xentral anbinden kannst.
Zunächst musst du in Etsy einen Benutzer bzw. eine App erstellen. Klicke dazu auf dieser Seite im unteren Bereich auf "Create a New App".
Dabei kannst du den ganz normalen Verkäufernutzer verwenden, es wird kein extra DEV Nutzer benötigt. Nach Abschluss der Erstellung erhälst einen API Key und einen API Token. Diese Informationen trägst du zusammen mit Benutzer und Passwort in den Einstellungen des Importers in Xentral ein (siehe nächster Schritt).
Für eine Schnittstelle zu einem Etsy-Shop musst du unter Administration → Shop Schnittstelle → Übersicht → +NEU das Modul Etsy auswählen:
Nachdem du Etsy ausgewählt hast, trage im nächsten Schritt die nötigen Daten für die Verbindung der beiden Systeme ein:
-
Benutzer: Benutzername des Benutzers in Etsy, der für die Schnittstelle angelegt wurde
-
Passwort: Passwort des Benutzers in Etsy, der für die Schnittstelle angelegt wurde.
Anmerkung
Trage hier das eigentliche Passwort des Benutzers ein, nicht den API Key. Den API Integration Key (API-Zugangsschlüssel) aus Etsy kannst du ggf. anlegen, doch für die Anbindung verwendest du immer Benutzername und Passwort
-
Keystring: Trage hier den Keystring ein
-
Shared Secret: Trage hier das Shared Secret ein
-
API Token: Trage hier den verwendeten API Token ein
-
API Token Secret: Trage hier das verwendete API Token Secret ist ein
Sobald du die Daten eingetragen hast, kannst die Verbindung zwischen beiden System über die Schaltfläche Verbindung prüfen testen.
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.
In diesem Abschnitt werden dir die möglichen Einstellungen in der Shop-Schnittstelle erklärt.
Einstellungen für die Etsy Schnittstelle findest du im Tab Details → Schnittstelle.
Einstellungen
-
Bezeichnung: Gib hier die Bezeichnung für deine Etsy Schnittstelle ein
-
Aktiv: Durch Anhaken wird die Shop-Schnittstelle aktiv
-
Projekt: Gib hier das passende Projekt ein
-
Abholmodus: Aus dem Drop-Down Menü wählst du den richtigen Abholmodus aus
-
Import-Modus: Aus dem Drop-Down Menü ist der richtige Import-Modus auszuwählen
-
Nur 1 Auftrag pro Abfrage: Durch Anhaken wird pro Abfrage nur ein Auftrag geholt
-
Aufträge in Zwischentabelle: Durch Anhaken werden die Aufträge in eine Zwischentabelle übertragen, die Freigabe der Zwischentabelle ist manuell vorzunehmen
-
Anzahl abholen begrenzen: Die Anzahl der abgeholten Aufträge wird hier begrenzt, 0 bedeutet hier, dass maximal 100 Aufträge abgeholt werden
-
Protokollierung im Logfile: Durch Anhaken findet eine Protokollierung im Logfile statt
-
Bestellungen überspringen: Falls Bestellungen übersprungen werden sollen, gibst du diese hier an
-
Benutzer: Benutzername des Benutzers in Etsy, der für die Schnittstelle angelegt wurde
-
Passwort: Passwort des Benutzers in Etsy, der für die Schnittstelle angelegt wurde.
Anmerkung
Trage hier das eigentliche Passwort des Benutzers ein, nicht den API Key. Den API Integration Key (API-Zugangsschlüssel) aus Etsy kannst du ggf. anlegen, doch für die Anbindung verwendest du immer Benutzername und Passwort.
-
Redirect überschreiben: Soll überschrieben werden, gibst du das hier an
-
Keystring: Trage hier den Keystring ein
-
Shared Secret: Trage hier das Shared Secret ein
-
API Token: Trage hier den verwendeten API Token ein
-
API Token Secret: Trage hier das verwendete API Token Secret ist ein
Du kannst verschiedene Aktionen in der Shopschnittstelle vornehmen, indem du auf die jeweilige Schaltfläche klickst:
-
Verbindung prüfen: Nach Eintragung der Daten kann die Verbindung zwischen beiden Systemen über diese Schaltfläche getestet werden. Bei erfolgreicher Verbindung erscheint die Meldung "Verbindung: success"
-
Aufträge prüfen: Diese Schaltfläche prüft alle importierten Aufträge von Etsy
-
Shopimport Zwischentabelle: Diese Schaltfläche erstellt die Zwischentabelle mit den von Etsy importierten Aufträgen
-
Artikel übertragen: Mit einem Klick auf diese Schaltfläche werden die Artikel der Aufträge von Etsy nach Xentral übertragen
-
Artikelliste abholen: Diese Schaltfläche hat momentan keine Funktion.
Informationen zu diesem Tab findest du hier.
Informationen zu diesem Tab findest du hier.
Informationen zum Versandartenmapping findest du hier.
Informationen zu diesem Tab findest du hier.
Über die Verwendung von Smarty erfährst du mehr in diesem Helpdesk Artikel: Smarty im Shopimporter.