About
TopCONNECTOR - Dateninterface
âTopCONNECTORâ ermöglicht die bequeme Verbindung zu unserem Webservice und dient somit als Dreh und Angelpunkt fĂŒr die Nutzung sĂ€mtlicher Plugins, die auf Grundlage unserer Produktdaten basieren.
Installation
EinfĂŒhrung
In unserem Manual zeigen wir Ihnen Schritt fĂŒr Schritt, wie Sie das Plugin installieren und einrichten können. In unterschiedlichen Shopware-Umgebungen können trotz umfangreicher Softwaretests immer wieder kleine Bugs auftreten. Solche Bugfixes erledigen wir schnell und unkompliziert, in der Regel noch am selben Tag.
Support
Sollten bei der Einrichtung Ihres âTopCONNECTORâ Probleme oder Fragen auftauchen, kontaktieren Sie uns bitte unter: shopware@topdata.de.
Wichtiger Hinweis
Bei jeder Installation bzw. jedem Update eines Plugins in Ihrem Shopware-Shop, handelt es sich um eine Ănderung der Software. Trotz sĂ€mtlicher von uns oder Shopware durchgefĂŒhrter MaĂnahmen zur QualitĂ€tssicherung können wir nicht ausschlieĂen, dass es wĂ€hrend der Installation oder des Updates in AusnahmefĂ€llen zu Problemen kommen kann.
Wir empfehlen Ihnen daher grundsÀtzlich:
- Neue Plugins bzw. Updates von bereits installierten Plugins zunÀchst in einer geeigneten Testumgebung zu testen
- Diese nicht direkt in die Live-Umgebung einzuspielen
- Ein regelmĂ€Ăiges Backup Ihrer Live-Umgebung wird ebenfalls dringend empfohlen
Systemvoraussetzungen
- Linux-basiertes Betriebssystem mit Apache 2.2 oder 2.4
- Webserver mit mod_rewrite Modul und Möglichkeit auf .htaccess Zugriff
- PHP 7.2.x / 7.3.x (7.2.20 und 7.3.7 sind nicht kompatibel)
- MySQL >= 5.7 (auĂer 8.0.20 und 8.0.21)
- Möglichkeit Cronjobs einzurichten
- Mindestens 4 GB freier Speicherplatz
- Es wird ein Shell-Zugang benötigt, um den Import zu starten
- Empfohlen: memory_limit > 512M
Die Einrichtung Ihres âTopCONNECTORâ Schritt fĂŒr Schritt
- Downloaden Sie âTopCONNECTORâ kostenlos im Shopware-Community Store
- Bitte fĂŒhren Sie den Bestellvorgang durch in dem Sie âTopCONNECTORâ in den Warenkorb legen und den Bestellprozess an der Kasse abschliessen
- Laden Sie âTopCONNECTORâ im Adminbereich Ihres Shopware-Shops unter dem MenĂŒpunkt âEinkĂ€ufeâ und installieren Sie das Plugin anschlieĂend unter dem MenĂŒpunkt âMeine Pluginsâ
- Im nĂ€chsten Schritt aktivieren Sie Ihren âTopCONNECTORâ
- AbschlieĂend konfigurieren Sie Ihren âTopCONNECTORâ ganz nach Wunsch
Webservice Zugangsdaten
Nach der Installation des Plugins mĂŒssen Sie die API-Zugangsdaten eingeben, um eine Verbindung zum TopData Webservice herzustellen.
Einstellungen - System - Plugins - TopdataConnector MenĂŒ (⊠auf der rechten Seite) - Konfiguration
TopData stellt Ihnen folgende Daten zur VerfĂŒgung:
- API Benutzer-ID
- API Passwort
- API Security Key
Demo Zugangsdaten
Wenn Sie das Plugin mit Demo-Zugangsdaten testen möchten, können Sie folgende Daten verwenden:
- API Benutzer-ID: 6
- API Passwort: nTI9kbsniVWT13Ns
- API Security Key: oateouq974fpby5t6ldf8glzo85mr9t6aebozrox
Automatischer Import per Scheduled Task
Das Plugin stellt einen Scheduled Task (topdata.connector_import_task) fĂŒr den tĂ€glichen automatischen Import bereit. StandardmĂ€Ăig ist dieser deaktiviert, um unerwartete Serverauslastungen zu vermeiden.
Aktivierung des automatischen Imports
Um den tÀglichen Import zu aktivieren:
- Loggen Sie sich in die Shopware Administration ein.
- Navigieren Sie zu Erweiterungen > Meine Erweiterungen.
- Ăffnen Sie die Konfiguration fĂŒr das Topdata Connector Plugin.
- Setzen Sie Automatischen Import aktivieren auf aktiv und speichern Sie.
Erforderliche Prozesse zur Laufzeit
Shopware benötigt Hintergrundprozesse (Worker), damit Scheduled Tasks ausgefĂŒhrt werden:
- Scheduler-Prozess (stöĂt fĂ€llige Tasks an):
bin/console scheduled-task:run - Messenger-Consumer (fĂŒhrt Task-Handler aus):
bin/console messenger:consume async
FĂŒr einen manuellen Start verwenden Sie: bin/console topdata:connector:import --all
Einstellungen Ihres âTopCONNECTORâ
Konfigurieren Sie âTopCONNECTORâ in AbhĂ€ngigkeit Ihrer BedĂŒrfnisse:
-
VerkaufskanÀle
WĂ€hlen Sie, fĂŒr welche VerkaufskanĂ€le die Einstellungen gelten sollen -
API-User-ID
Tragen Sie die von uns erhaltene API-User-ID ein -
API-Key
Tragen Sie den von uns erhaltenen API-Key ein -
API-Salt
Tragen Sie den von uns erhaltenen API-Salt ein -
API-Sprache
WĂ€hlen Sie die gewĂŒnschte Sprache -
Verbindung prĂŒfen
ĂberprĂŒfen der Verbindung zum Webservice -
Bitte wÀhlen Sie Ihre Produkt-Mapping-Variante aus
Entscheiden Sie, wie Ihre Artikel mit unserer Produktdatenbank verknĂŒpft werden sollen -
OEM-Feld
Geben Sie den Namen des von Ihnen festgelegten OEM Eigenschaften-/Zusatzfeldes an -
EAN-Feld
Geben Sie den Namen des von Ihnen festgelegten EAN Eigenschaften-/Zusatzfeldes an -
Lieferanten-Artikelnummer-Feld
Geben Sie den Namen des von Ihnen festgelegten Lieferanten Artikelnummer Eigenschaften-/Zusatzfeldes an
Wozu dient der âTopCONNECTORâ?
âTopCONNECTORâ ist die Kernkomponente unserer Daten-Plugins und sorgt fĂŒr die Verbindung zwischen Ihrem Shopware-Shop und unserem Webservice. FĂŒr die FunktionalitĂ€t unserer Daten-Plugins ist die vorherige Installation von âTopCONNECTORâ zwingend nötig.
Ist fĂŒr âTopCONNECTORâ eine Mitgliedschaft bei TopData nötig?
Nein, die Nutzung von âTopCONNECTORâ ist kostenfrei. Das Plugin steht im Shopware-Community-Store fĂŒr Sie bereit.
Demo-Installation von âTopCONNECTORâ
Sie können eine Demoversion von âTopCONNECTORâ installieren, um unsere Daten-Plugins zu testen.
Downloaden Sie die gewĂŒnschten Plugins sowie den âTopCONNECTORâ kostenlos im Shopware-Community Store
Installieren Sie âTopCONNECTORâ und die gewĂŒnschten Plugins gemÀà unserer Installationsanleitung
Richten Sie âTopCONNECTORâ mit folgenden Demo-Zugangsdaten ein:
- API-User-ID: 6
- API-Key: nTI9kbsniVWT13Ns
- API-Salt: oateouq974fpby5t6ldf8glzo85mr9t6aebozrox
WĂ€hlen Sie im âTopCONNECTORâ die Mapping-Option: âStandard OEM EANâ
Die Nutzung der Daten-Plugins setzt voraus, dass folgende Drucker und/oder deren Verbrauchsmaterialien mit hinterlegter EAN und/oder OEM Nummer in Ihrem Shop vorhanden sind:
- HP Deskjet 1000 (CH340B)
- HP Deskjet 1055
- HP Deskjet 2000 (CH390A)
- HP Deskjet 2544 AIO (D3A78B)
- HP ENVY 4506
- Samsung CLP 360 (CLP-360/SEE)
- Samsung CLX 3300
- Samsung Xpress SL-C 410 W
- Samsung Xpress C 460 W (SL-C460W/SEE)
- Canon Pixma IP 3100
- Epson Stylus SX 438 W (C11CB21305)