Dawanda Schnittstelle - Installation & Einrichtung

Um Dawanda in Xentral integrieren zu können, sind mehrere Schritte nötig. Xentral bindet externe Shops/Plattformen, auch wenn diese extra APIs anbieten immer über einen Xentral Shop-Importer an. Das ist die genormte Schnittstelle für Xentral. In dieser Schnittstelle wird dann oft bei z.B. Shopware oder Gambio auf die echte API vom Shop zugegriffen. Aber die Kommunikation mit Xentral geschieht immer über den Importer.

Features der Schnittstelle

  • Aufträge abholen
  • Auftragsstatus bei Versand umstellen inkl. Meldung Trackingnummer, inkl. Übertragung Text (Text mit Trackingnummer)
  • Rückmeldung "Bewertung" (im Zuge der Trackingnummern Rückmeldung)
Die Rechnung und oder Lieferschein kann durch Xentral mit eigenen Nummernkreisen erstellt werden. Die Belege werden im Versandprozess automatisch erstellt und versendet bzw. am Versanddrucker ausgedruckt.

Installation (für Techniker)

Hinweis: Für die Installation benötigen Sie einen Dawandaimporter => Diesen bitte bei uns anfragen.

1. Anlegen eines neuen Shops in Xentral

Administration → Einstellungen → Online-Shops → Neu Shop benennen, Projekt angeben und die für Sie zutreffenden Optionen anhaken.:wawision:wawision_dawanda_001.png?direct :wawision:wawision_dawanda_002.png?direct Hinweis: Mehr Informationen zu den Einstellungen finden Sie hier: Online-Shop-Anbindung: Einstellungen Die Zugangsdaten eintragen:
:wawision:wawision_dawanda_003.png?direct
URL: Der Pfad zu unserem Dawanda Importer - diesen tragen wir erst später ein, wenn wir den shopimporter auf den Server übertragen haben.
Importkey: Erstellen Sie mit Hilfe eines Passwortgenerators ein 32-stelliges Passwort und tragen es hier ein.
ImportToken: Erstellen Sie hier ein 6-stelliges Passwort
Demo Modus: Zum Testen am Anfang empfiehlt es sich unbedingt diese Option zu aktivieren, sodass der Status des importierten Auftrags nicht verändert wird.

2. Bearbeiten der user.inc.php Datei

Entpacken Sie den von uns erhaltenen Dawanda-Importer und benennen Sie den Ordner in dawandaimporter um. Danach öffnen Sie den 'dawandaimporter' Ordner und gehen in den Unterordner 'conf'.
Benennen Sie die 'user.inc.php.tpl' Datei um in 'user.inc.php'.
Öffnen Sie diese 'user.inc.php' Datei in einem Texteditor, tragen Sie Ihre Daten ein und speichern Sie die Änderungen.
ImportKey: Das 32-stellige Passwort, das Sie in Xentral erstellt haben.
ImportToken: Das 6-stellige Passwort, das Sie in Xentral erstellt haben.
ImportApiKey: Direkt in Dawanda (Footer Webseite) unter DaWanda API → NEW DaWanda API → Register /Access your API-Key (im Bild blau dargestellt → an dieser Stelle bitte den DaWanda API KEy eintragen)
Hier ist die Datei mit Beispieldaten gefüllt:
:wawision:wawision_dawanda_004.png?direct

3. Kopieren des 'dawandaimporter' Ordners auf Ihren Server

Kopieren Sie danach den 'dawandaimporter' in den 'www' Ordner im Xentrals-Ordner.
Somit ist der 'dawandaimporter' Ordner ein Unterordner des 'www' Ordners.
1. Option: Mit einem FTP Programm übertragen
Öffnen Sie Ihr FTP Programm und geben Sie die dort Zugangsdaten zu Ihrem Server ein. Schieben Sie den 'dawandaimporter' in den www Ordner von Xentral.
2.Option: Mit SSH übertragen
Hinweis: Die folgenden Code-Snippets sind gefüllt mit Beispieldaten => Gleichen Sie diese an Ihre Daten und Ihre Serverstruktur an. Kopieren Sie den 'dawandaimporter' in den 'www' Ordner auf Ihrem Server.
scp -r dawandaimporter benutzer@IhreServerAdresse:html/wawision/www
Verbinden Sie sich mit SSH auf Ihrem Server:
ssh benutzer@IhreServerAdresse
Checken Sie ob der Ordner den richtigen Benutzer:Benutzergruppe des 'www' Ordners hat:
ls -lh
Falls nicht, müssen Sie hier die Rechte angleichen:
sudo chown -R www-data:www-data dawandaimporter/

Schritt 4: Verbindung von Xentral zum Shop-Importer

Danach können Sie in Xentral in den Online-Shop-Optionen unter URL den Pfad zum 'dawandaimporter' angeben.
Zur Überprüfung geben Sie den Pfad in den Browser ein => Es sollte eine komplett leere Seite angezeigt werden.
Dieser könnte so für unser Beispiel aussehen "http://www.firma.de/www/dawandaimporter":
:entwickler:shopschnittstelle_installieren_zugangsdaten.png?direct
Unter Administration => Einstellungen => Online-Shops => Ihr Shop => Export klicken Sie auf 'Verbindung prüfen'.
Wenn alles geklappt hat, sollte 'Verbindung: success' erscheinen.

Schritt 5: Einstellungen des Shops in Xentral anpassen

Alle Informationen zu den Shop-Einstellungen finden Sie hier: Online-Shop-Anbindung: Einstellungen

Schritt 6: Testen des Shop-Imports im Demo-Modus

Es ist wichtig, dass der Shop-Import ausgiebig getestet wird bevor Xentral alle Aufträge des Shops importieren soll. Laden Sie sich deswegen im Demo-Modus jeweils 1 Auftrag vom Shop nach Xentral und schauen bei diesem, ob alles passt.
Probieren Sie hier alle möglichen Varianten, inklusive Gutscheine, Rabatte, etc. aus.
Erst wenn alle Aufträge richtig nach Xentral übertragen werden, macht es Sinn den Demo-Modus wieder zu deaktivieren und größere Mengen an Aufträgen auf einmal zu importieren.

Aufträge zu Xentral übertragen

Das Importieren von Bestellungen aus Online Shops ist hier beschrieben

Versandkostenmapping von DaWanda

Die Versandkosten werden im Standard automatisch nach Xentral mit importiert.

FAQs

War der Artikel hilfreich?
Vielen Dank für Ihr Feedback!

Made with ❤ at zwetschke.de