Magento mit easySales verbinden: die vollständige Integrationsanleitung
Verbinden Sie einen Magento-1- oder Magento-2-Shop mit easySales: Formular ausfüllen, Modul installieren, Token einfügen und wissen, was in welche Richtung wie oft synchronisiert wird.
Was die Magento-Verbindung Ihnen bringt
easySales liest Ihren Magento-Katalog — Produkte, Preise, Bestände, Kategorien und Attribute — und baut daraus die Angebote auf den Marktplätzen auf, über die Sie verkaufen, und hält sie aktuell. Bestellungen kommen in die Gegenrichtung zurück, in eine einzige Liste, in der Sie sie abrechnen und Versandlabels erzeugen, ohne Ihrem Shop etwas hinzuzufügen.
Der erste Import ist nicht der Punkt. Der Punkt ist, dass die Verbindung danach weiterarbeitet: Bestände bewegen sich, während Sie verkaufen, Bestellstatus laufen nach Magento zurück, und Angebote schalten sich ab, sobald etwas ausverkauft ist.
Bevor Sie beginnen
Administratorzugang zu Ihrem Magento-Shop
Sie müssen Stores → Configuration (Magento 2) oder System → Configuration (Magento 1) erreichen, um den Token einzufügen.
Eine Möglichkeit, Dateien auf den Server zu laden
SFTP, SSH oder der Dateimanager Ihres Hosters. Magento 2 braucht zusätzlich SSH für einen Befehl; Magento 1 nicht.
Eindeutige SKUs im gesamten Katalog
Über die SKU ordnet easySales ein Magento-Produkt dem eigenen zu. Zwei Produkte mit derselben SKU lassen sich nicht beide importieren.
Bestand als Zahl hinterlegt
Produkte, deren Bestand Text oder leer ist, werden übersprungen.
Ihre Steuersätze zur Hand
Beim Verbinden legen Sie eine Standard-Produktsteuer und eine Versandsteuer fest.
Schritt 1 — Die Website in easySales anlegen
Gehen Sie zu Integrationen → Websites und klicken Sie auf Website verbinden.
Nichts an diesem Formular ist Magento-spezifisch — es ist dasselbe Formular, das jede Shop-Plattform nutzt. Drei der Felder lassen sich später nicht mehr ändern, es lohnt sich also, sie gleich beim ersten Mal richtig zu setzen.
| Feld | Wirkung |
|---|---|
| Website-Name | Ihre eigene Bezeichnung für den Shop. Sie erscheint überall dort, wo easySales Ihre Shops auseinanderhalten muss — was zählt, sobald Sie einen zweiten verbinden. |
| Website-URL |
Die Adresse Ihres Shops. Wählen Sie http:// oder https:// passend zu dem, was die Seite tatsächlich ausliefert, und nehmen Sie www auf, wenn die Seite es erzwingt — eine Weiterleitung an dieser Stelle bedeutet einen fehlgeschlagenen Verbindungstest.
|
| Land | Das Land des Shops. Es bestimmt, welche Steuersätze das nächste Feld anbietet. Später nicht mehr änderbar. |
| Preis-MwSt. | Der Steuersatz für Produkte, die ohne einen solchen ankommen. Wird aus den Sätzen Ihres Landes gewählt, nicht eingetippt. |
| Versand-MwSt. | Der Steuersatz für die Lieferung, wenn die Bestellung keinen mitbringt. |
| Sprache | Die Sprache des Shops. Später nicht mehr änderbar. |
| Währung | Die Währung, in der Ihre Magento-Preise geführt werden. Später nicht mehr änderbar. |
| Benutzerdefinierter Status für neue Bestellung | Optional. Legt jede importierte Bestellung direkt in einen Ihrer eigenen Status statt in den Standard. |
| Bestandsquelle | Wo die maßgebliche Bestandsmenge liegt. Siehe den Hinweis unter der Tabelle. |
| Standard-Pakettyp | Umschlag oder Paket, als Vorgabe beim Erzeugen von Versandlabels für diese Bestellungen. |
| Rechnungsserie | Die Rechnungsserie für Bestellungen aus diesem Shop, wenn Magento keine mitliefert. |
Schritt 2 — Magento wählen, dann die Version
Unter dem Formular liegt ein Raster mit Plattform-Logos. Wählen Sie Magento, und es erscheint eine zweite Zeile mit der Frage, welche Version Ihr Shop einsetzt.
Beide Versionen werden unterstützt, und beide Module stehen zum Download bereit:
| Version | Installation über | Bestellübermittlung | Dokumente zurücklesen |
|---|---|---|---|
| Magento 2 |
Hochladen nach app/code/, dann setup:upgrade
|
Ja, mit aktuellem Modul | Ja |
| Magento 1.7 – 1.9 | Magento Connect Manager | Nein | Nein |
Schritt 3 — Das Modul installieren
Die Wahl der Version öffnet einen dreistufigen Assistenten: Modul herunterladen, Modul hochladen, Konfiguration.
Magento 2
Laden Sie das Archiv herunter, entpacken Sie es und laden Sie den Ordner auf Ihren Server unter app/code/ hoch. Das Ergebnis muss exakt dieser Pfad sein:
app/code/EasySales/Integrari/
Verbinden Sie sich anschließend per SSH und aktivieren Sie das Modul:
php bin/magento setup:upgrade
Leeren Sie zum Schluss den Cache über System → Cache Management → Flush Magento Cache.
Magento 1
Das Magento-1-Modul wird stattdessen über Magento Connect installiert. Gehen Sie in der Administration Ihres Shops zu System → Magento Connect → Magento Connect Manager, geben Sie Ihre Zugangsdaten erneut ein und laden Sie das heruntergeladene Archiv über Direct package file upload hoch.
Leeren Sie danach den Cache über System → Cache Management und — dieser Schritt ist wirklich nötig — melden Sie sich aus der Magento-Administration ab und wieder an. Das Menü des Moduls erscheint erst danach.
Schritt 4 — Das Modul innerhalb von Magento konfigurieren
Öffnen Sie die Moduleinstellungen in der Administration Ihres Shops. Bei Magento 2 liegen sie unter Stores → Configuration im easySales-Bereich, bei Magento 1 unter System → Configuration, nahe am Ende der Liste.
Fügen Sie den Token aus dem Schritt Konfiguration des Assistenten in das Feld Website-Token ein.
| Einstellung | Wirkung |
|---|---|
| Website-Token | Muss exakt mit dem im easySales-Assistenten angezeigten Token übereinstimmen. Er authentifiziert jeden Aufruf zwischen den beiden Systemen. |
| Store-Bereich | Welche Magento Store View ihre Produkte und Bestellungen exportiert. Standardmäßig die erste — setzen Sie sie bewusst, wenn Sie mehrere betreiben. |
| Bestandsquelle in Magento | Aus welcher Magento-Bestandsquelle easySales die Mengen liest. |
| Rechnungsserie | Die Serie, die mit jeder Bestellung an easySales übergeben wird. |
| EAN / Marke / Lagerplatz | Welches Magento-Produktattribut die jeweilige Angabe enthält. Leer lassen, wenn Sie sie nicht nutzen. |
| Gewicht und Maße | Welche Attribute Gewicht und Maße enthalten und in welchen Einheiten. Nötig, wenn Ihre Kuriere nach Volumen abrechnen. |
Speichern Sie in Magento und klicken Sie anschließend in easySales auf Speichern. easySales ruft Ihren Shop auf, um den Token zu prüfen, und meldet Ihnen das Ergebnis.
Schritt 5 — Die Verbindung bestätigen
Ein verbundener Shop erscheint als Karte unter Integrationen → Websites — mit seiner Plattform, seinem Token, der von ihm gemeldeten Modulversion und einem Schalter Aktiv.
Antwortet der Shop nicht, scheitert das Speichern mit einer roten Meldung Verbindung fehlgeschlagen, statt still zu speichern. Das bedeutet fast immer eines von drei Dingen: Der Token in Magento stimmt nicht mit dem in easySales überein, das Modul ist nicht aktiviert, oder der Shop ist unter der eingetragenen Adresse nicht aus dem Internet erreichbar.
Was synchronisiert wird, und wie oft
Sie planen davon nichts, und es gibt keine Einstellung für ein Aktualisierungsintervall.
| Was | Richtung | Wie oft |
|---|---|---|
| Bestellungen | Magento → easySales | Jede Minute |
| Bestände | Magento → easySales | Alle 30 Minuten |
| Preise | Magento → easySales | Alle 30 Minuten |
| Produkte | Magento → easySales | Alle 6 Stunden |
| Kategorien und Attribute | Magento → easySales | Alle 6 Stunden |
| Bestellstatus, Sendung, Versandlabel | easySales → Magento | Jede Minute |
| Bestandsmenge | easySales → Magento | Jede Minute |
Was nach Magento zurückfließt
Drei Dinge, und nur drei: der Bestellstatus (mit Sendung und Sendungsverfolgung, sobald eine Bestellung abgeschlossen ist), die Bestandsmenge und — bei Magento 2 mit aktuellem Modul — ganze neue Bestellungen.
Produktnamen, Beschreibungen, Bilder, Preise und Kategorien werden nicht zurückgeschrieben. easySales liest sie aus Magento und überschreibt sie nicht, sodass Magento der einzige Ort bleibt, an dem Sie Ihren Katalog pflegen.
Die Verbindung gesund halten
Behalten Sie die Modulversion im Blick. Die Karte zeigt die Version, die Ihr Shop gemeldet hat. Erscheint eine neuere, färbt sich die Karte rot und zeigt Aktualisierung erforderlich. Bei Magento 2 installieren Sie das neue Archiv über das alte und führen setup:upgrade erneut aus; bei Magento 1 deinstallieren Sie zuerst die alte Erweiterung im Magento Connect Manager und installieren dann die neue. Die Einstellungen bleiben in beiden Fällen erhalten.
Fehler tauchen an einer Stelle auf. Produkte → Online-Shops → Website-Fehler listet alles, was sich in einer der beiden Richtungen nicht speichern ließ, mit einer Wiederholen- und einer Verwerfen-Aktion je Zeile und einem Sammelversand je Shop.
Die SKU ist der Schlüssel — halten Sie sie stabil
easySales ordnet Magento-Produkte über die SKU zu, und diese Zuordnung ist dauerhaft. Ändern Sie die SKU eines Produkts in Magento, importiert easySales es als neues Produkt — das alte bleibt bestehen, samt seinen Angeboten.
Wenn Sie Dubletten finden müssen, nutzen Sie die Download-Schaltfläche unter Produkte → Online-Shops → Produkte und prüfen Sie den Export auf wiederholte SKUs.