OpenCart mit easySales verbinden: vollständige Integrationsanleitung

Warum OpenCart mit easySales verbinden

Sie verkaufen über OpenCart und möchten einen zentralen Ort, um Bestellungen zu verwalten, Rechnungen zu erstellen, AWBs an Kuriere zu übergeben und dieselben Produkte als Angebote auf Marktplätzen wiederzuverwenden? easySales erledigt all das über ein einziges Dashboard.

Nach der Verbindung übernimmt easySales Produkte und Optionen aus OpenCart und zentralisiert eingehende Bestellungen. Von dort aus erstellen Sie Rechnungen, generieren AWBs mit jedem unterstützten Kurier und verwandeln diese Produkte in Angebote auf eMAG, Allegro, Kaufland, Trendyol und über 80 weiteren Kanälen. Bestand und Bestellstatus bleiben in beide Richtungen synchron.

Sie starten den Assistenten in easySales, laden das OpenCart-Modul herunter, das zu Ihrer Shop-Version passt, installieren es in Ihrer OpenCart-Verwaltung und fügen anschließend das Token aus easySales wieder in das Modul ein — kein Code, kein FTP-Zugang, keine Theme-Änderungen.

So funktioniert der OpenCart-Connector

easySales verbindet sich mit OpenCart über ein kleines .ocmod.zip-Modul, das Sie aus Ihrem easySales-Konto herunterladen und über Ihre OpenCart-Verwaltung installieren. Das Modul stellt einen privaten Endpunkt bereit, den easySales aufruft, um Ihren Katalog und Ihre Bestellungen zu lesen, und registriert zwei Webhooks, sodass Bestell- und Bestandsänderungen nahezu in Echtzeit bei easySales ankommen.

Das Modul baut nie selbst eine Verbindung nach außen auf. easySales spricht es an, authentifiziert über ein pro Website generiertes Token von easySales. OpenCart-Datenbankzugangsdaten, Admin-Passwörter und Gateway-Geheimnisse bleiben innerhalb Ihrer OpenCart-Installation.

Welche OpenCart-Versionen easySales unterstützt

easySales liefert für jede große OpenCart-Version einen eigenen Modul-Build, damit die Integration zur API und zum Verwaltungslayout Ihres Shops passt:

• OpenCart 1.5.6.4
• OpenCart 2.0.0.0 – 2.1.0.2
• OpenCart 2.2.0.0
• OpenCart 2.3.0.0 – 2.3.0.2
• OpenCart 3.0.0 – 3.0.2.0
• OpenCart 4.0 – 4.1.0.3

Der Assistent wählt den Build aus, wenn Sie Ihre Version auswählen. Wenn Sie eine Patch-Version zwischen zwei dieser Versionen einsetzen (zum Beispiel 2.3.0.1), gilt der Build für die nächstniedrigere Version. Geforkte OpenCart-Distributionen und ältere 1.5.x-Patch-Level werden nicht offiziell unterstützt — das Modul lässt sich möglicherweise installieren, die Admin-Pfade können jedoch abweichen.

Interaktive Tour

Keine Lust zu lesen? Machen Sie die interaktive Tour.

Voraussetzungen — was Sie vor dem Start vorbereiten sollten

Einige Anforderungen verhindern, dass Produkte beim Import übersprungen werden.

Schritt 1 — Den Assistenten in easySales starten und das Modul herunterladen

Gehen Sie in easySales zu Integrationen → Online-Shops → Website verbinden, wählen Sie dann OpenCart und Ihre Shop-Version aus. Der Assistent öffnet sich im Schritt Modul herunterladen.

Klicken Sie auf die Schaltfläche zum Herunterladen, um das Modul-Archiv zu erhalten (easysales.ocmod.zip oder einen versionsspezifischen Dateinamen wie 2market-oc3x.ocmod.zip). Lassen Sie diesen Tab geöffnet — Sie kehren in Schritt 3 hierher zurück, um die Konfiguration abzuschließen.

Schritt 2 — Das Modul in OpenCart hochladen und installieren

Gehen Sie in Ihrer OpenCart-Verwaltung zu Extensions → Installer. Klicken Sie auf Upload, wählen Sie das soeben heruntergeladene .ocmod.zip-Archiv aus und warten Sie auf die grüne Bestätigung „success“.

Öffnen Sie als Nächstes Extensions → Extensions, filtern Sie im oberen Dropdown nach Modules, suchen Sie easySales in der Liste und klicken Sie auf die grüne Schaltfläche Install (+). Klicken Sie nach der Installation auf die blaue Schaltfläche Edit (Stift), um die Moduleinstellungen zu öffnen — Sie sehen ein Feld Token. Lassen Sie diesen Tab geöffnet; Sie fügen das Token aus easySales im nächsten Schritt hier ein.

Schritt 3 — Die Website in easySales konfigurieren und das Token in OpenCart einfügen

Kehren Sie zu Ihrem easySales-Tab zurück — der Assistent befindet sich jetzt im Schritt Konfiguration und zeigt Ihr generiertes Token an. Kopieren Sie das Token, wechseln Sie zurück zu OpenCart und fügen Sie es in das Feld Token auf der Bearbeitungsseite des EasySales-Moduls ein. Setzen Sie Status auf Enabled, lassen Sie die übrigen Standardwerte unverändert und klicken Sie dann in OpenCart auf Save.

Schließen Sie zurück in easySales die Konfiguration der Website ab. Das Formular unterhalb des Assistenten erfasst alles, was easySales braucht, um die Integration zu steuern.

Website-Name und URL

• Website-Name — eine Bezeichnung Ihrer Wahl. Nur innerhalb von easySales sichtbar.
• Website-URL — Ihr OpenCart-Storefront. Verwenden Sie die exakte URL, unter der OpenCart läuft, einschließlich https:// und des Präfixes www, falls Ihre Domain es verwendet. Wenn OpenCart in einem Unterverzeichnis liegt (example.com/shop), geben Sie es mit an.

MwSt. und MwSt. für den Versand

Wenn Sie umsatzsteuerpflichtig sind, geben Sie den Satz für Ihre Produkte und einen separaten Satz für den Versand ein (z. B. 21 für den aktuellen rumänischen Standardsatz). Lassen Sie das Feld leer, wenn Sie nicht umsatzsteuerpflichtig sind. Die Steuerklassen von OpenCart werden nicht automatisch erkannt — der hier festgelegte Satz ist der, den easySales auf Rechnungen und ausgehenden Marktplatz-Angeboten verwendet.

Sprache und Währung

Wählen Sie die Sprache des Storefronts (Rumänisch, Bulgarisch, Ungarisch, Polnisch oder Englisch) und die Währung (RON, BGN, HUF, PLN oder EUR). Diese dienen als Standardwerte für importierte Produkte und als Fallback, wenn eine Bestellung keine explizite Währung mitführt. Sie überschreiben einzelne Bestellungen nie — jede Bestellung behält die von OpenCart gemeldete Währung.

Bestandsquelle für Produkte

Die wichtigste Entscheidung im Formular. Sie legt fest, wo der maßgebliche Bestandswert liegt:

• Website — OpenCart ist die Quelle der Wahrheit. easySales liest den Bestand aus OpenCart und überschreibt ihn nie.
• easySales — easySales ist die Quelle der Wahrheit. Bestandsänderungen innerhalb von easySales (Verkäufe, manuelle Bearbeitungen, Marktplatz-Abzüge) werden an OpenCart übertragen.
• Verbundene Integration — Ihr Bestand liegt in einem Drittsystem, das bereits an easySales angebunden ist (Rechnungssoftware wie SmartBill, Oblio, Fakturownia oder FacturisOnline; ein ERP wie NexusERP oder Sedona; ein Fulfillment-Partner wie Fulfillro oder Huboxx; und viele weitere). easySales liest den Bestand aus dieser Integration und überträgt ihn an OpenCart. Verbinden Sie zuerst die Integration und deklarieren Sie ihr Lager — andernfalls können Sie diese Option nicht auswählen.

Sie betreiben mehrere Lager? Wechseln Sie in den Modus Erweitertes Lager. Statt den Shop an eine einzige Bestandsquelle zu binden, wählen Sie ein oder mehrere easySales-Lager und legen fest, wie deren Bestand aggregiert, priorisiert oder pro Kanal aufgeteilt wird. Die Standardeinrichtung, wenn derselbe Katalog aus mehreren Standorten versendet wird oder verschiedene Kanäle aus unterschiedlichen Lagern beliefert werden.

Standard-Pakettyp

Wird bei der AWB-Erstellung verwendet, wenn die Bestellung kein Paket angibt. Wählen Sie den Typ, der zu den meisten Ihrer Bestellungen passt.

Schritt 4 — OpenCart-Modifications aktualisieren und in easySales abschließen

Dies ist der OpenCart-spezifische Schritt, an dem die meisten neuen Verbindungen scheitern, und er muss das Letzte sein, was Sie tun.

Öffnen Sie Extensions → Modifications in Ihrer OpenCart-Verwaltung und klicken Sie oben rechts auf die blaue Schaltfläche Refresh. OpenCart kompiliert ocmod-Overrides beim Aktualisieren — solange Sie nicht darauf klicken, ist das Modul zwar installiert, seine Hooks sind jedoch nicht aktiv.

Kehren Sie nun zu easySales zurück und klicken Sie auf Speichern, um die Verbindung abzuschließen. easySales testet die Verbindung, registriert die Webhooks auf Ihrer OpenCart-Website und beginnt mit dem Import Ihres Katalogs.

Was nach dem Speichern automatisch passiert

easySales übernimmt die Webhook-Einrichtung und den Erstimport.

1. Auf Ihrer OpenCart-Website werden zwei Webhooks registriert: einer für Bestelländerungen und einer für Bestandsänderungen. Jede in OpenCart erstellte, aktualisierte oder stornierte Bestellung erreicht easySales nahezu in Echtzeit, und dasselbe gilt für Bestandsaktualisierungen.
2. Ihr Produktkatalog wird importiert — Produkte und ihre Optionskombinationen erscheinen unter Online-Shops → Produkte, wo Sie sie durchsuchen, bearbeiten und in Angebote für Marktplätze verwandeln können.
3. Eingehende OpenCart-Bestellungen erscheinen in Ihrem Bildschirm Bestellungen, wo Sie Rechnungen und AWBs erstellen und Automation Flows ausführen.
4. Der Bestand synchronisiert sich entsprechend der von Ihnen gewählten Quelle. Wenn Sie easySales gewählt haben, laufen die Bestandsübertragungen fortlaufend und Ihr OpenCart-Storefront spiegelt den zentralisierten Bestand wider.

Feinabstimmung Ihrer OpenCart-Verbindung

Öffnen Sie nach dem Speichern den Tab Einstellungen der OpenCart-Website. Zwei Gruppen von Einstellungen lohnen einen kurzen Blick.

Bestellverhalten

• Abgeschlossene Bestellungen erneut öffnen zulassen — standardmäßig können Endstatus wie „Complete“ nicht zu „Processing“ zurückgesetzt werden. Aktivieren Sie dies, wenn Sie Bestellungen erneut öffnen müssen.
• Stornierte Bestellungen erneut öffnen zulassen — dieselbe Logik für stornierte Bestellungen (nützlich, wenn eine vorübergehend stornierte, unbezahlte Bestellung schließlich bezahlt wird).

Synchronisation

• Bestellungen abrufen — automatischer Import neuer OpenCart-Bestellungen.
• Bestellstatus auf OpenCart aktualisieren — Statusänderungen aus easySales zurück an OpenCart übertragen, damit beide Systeme synchron bleiben.
• Produktbestand auf OpenCart aktualisieren — easySales-Bestände an Ihr OpenCart-Storefront übertragen. Deaktivieren Sie dies, wenn OpenCart Ihre Bestandsquelle ist.

Klicken Sie unten auf der Seite auf Speichern, um Ihre Änderungen zu übernehmen.

Optionen, Locker und andere OpenCart-Besonderheiten

Einige OpenCart-spezifische Verhaltensweisen, die man kennen sollte:

• Produktoptionen. OpenCart-Produkte führen Optionen (Größe, Farbe usw.) mit optionalen SKUs pro Option. easySales importiert jede verkäufliche Kombination als separate Variante, die über die SKU mit dem übergeordneten Produkt verknüpft ist. Wenn Ihr Shop Optionen ohne SKUs verwendet, werden diese Produkte als ein einzelner Eintrag importiert — legen Sie SKUs pro Option fest, bevor Sie die Verbindung herstellen, falls Sie sie auf Marktplätzen einzeln verfolgen möchten.
• Locker. Wenn Ihr Shop ein unterstütztes Locker-Modul verwendet — Sameday EasyBox, InPost und andere Locker-Netzwerke in den von uns bedienten Märkten — liest easySales die Locker-ID automatisch aus den benutzerdefinierten Feldern der Bestellung. Keine Konfiguration erforderlich. Der Locker wird dann bei der AWB-Erstellung als Lieferpunkt verwendet.
• Benutzerdefinierte Zahlungsmethoden. Mit OpenCart können Sie über Extensions beliebige Zahlungsmethoden hinzufügen. easySales ordnet Standardmethoden (Banküberweisung, Nachnahme, Karte über die gängigen Gateways) automatisch zu. Nicht standardmäßige Methoden kommen als Unknown an — wenden Sie sich an den Support, damit wir die Zuordnung für Ihr spezifisches Gateway erweitern.
• Bild-URLs. OpenCart liefert Bilder aus image/catalog/... relativ zum Stammverzeichnis Ihres Storefronts. Das Modul schreibt diese beim Export in absolute URLs um. Wenn Produktbilder nicht in easySales erscheinen, ist die häufigste Ursache, dass Dateien auf der Festplatte fehlen — OpenCart speichert den Pfad auch dann, wenn die Datei nicht mehr vorhanden ist.
• Modifications-Cache. Wenn Sie OpenCart-Admin-Extensions oder Themes ändern, nachdem das easySales-Modul installiert wurde, aktualisieren Sie Extensions → Modifications erneut. OpenCart deaktiviert ocmod-Overrides bei bestimmten Admin-Updates stillschweigend.
• Modul-Updates. Wenn eine neue Modulversion veröffentlicht wird, zeigt easySales in den Einstellungen der Website eine rote Warnung an. Laden Sie den neuen Build herunter, entfernen Sie das alte Modul aus Ihrer OpenCart-Verwaltung (Extensions → Extensions → Modules → Uninstall) und installieren Sie dann das neue Archiv, indem Sie erneut Schritt 2 befolgen. Speichern Sie sowohl in OpenCart als auch in easySales und aktualisieren Sie anschließend Extensions → Modifications.
• Präfix der Rechnungsserie. Wenn Sie eine bestimmte Rechnungsserie auf Dokumenten wünschen, die nachgelagert von OpenCart erstellt werden, legen Sie sie in der OpenCart-Verwaltung unter Settings → Option → Checkout → Invoice Prefix fest. easySales liest diesen Wert zusammen mit der Bestellung aus.

Sie sind verbunden — wie geht es weiter

Sobald Bestellungen eintreffen, ist der nächste Schritt die Automatisierung. Richten Sie Flows ein, um Rechnungen zu erstellen, AWBs zu generieren und Sendungsbenachrichtigungen zu versenden. Wenn Sie auch auf Marktplätzen verkaufen, verwandeln Sie Ihren OpenCart-Katalog in Angebote und lassen Sie easySales sie ausspielen.