Zum Hauptinhalt springen

Warum wird meine Pickware-Lizenz in einer lokalen Entwicklungsumgebung nicht erkannt?

Shopware 6 — Warum die Lizenzierung von Pickware in einer lokalen Entwicklungsumgebung fehlschlagen kann und wie die Zuordnung über die APP_URL funktioniert.

Wenn du deinen Shopware 6 Shop lokal weiterentwickelst und die Pickware Erweiterung dort installierst, kann es vorkommen, dass die Verknüpfung mit deinem Pickware Account nicht abgeschlossen bzw. die Lizenz nicht erkannt wird. Das liegt daran, wie die Lizenzierung technisch abläuft.

Wie funktioniert die Lizenzierung?

Beim Verknüpfen der Pickware Erweiterung mit deinem Pickware Account wirst du in deinem Browser zu der in deinem Account hinterlegten Domain (der sogenannten APP_URL) weitergeleitet. Über diesen Redirect erhält die Erweiterung eine Lizenz-ID, die gespeichert und zur Validierung der Lizenz genutzt wird.

Entscheidend ist dabei ausschließlich die Domain, die dein Browser tatsächlich aufruft — nicht, ob diese Domain auch von außen (aus dem Internet) erreichbar ist.

Typischer Stolperstein: Abweichende Domain beim lokalen Zugriff

Damit die Lizenzierung funktioniert, muss die Domain, die du in deinem Browser aufrufst, exakt der APP_URL entsprechen, die in deinem Pickware Account für den Shop hinterlegt ist. Greifst du lokal beispielsweise über localhost oder eine andere Adresse auf deinen Shop zu, während in deinem Account eine andere Domain (z. B. sw6-stage.deinshop.de) hinterlegt ist, schlägt die Lizenzierung fehl.

Über einen entsprechenden Eintrag in der lokalen hosts-Datei deines Rechners kannst du festlegen, dass dein Browser beim Aufruf der hinterlegten Domain auf deine lokale Umgebung zugreift, sodass die Adresse in der Browser-Adresszeile mit der im Account hinterlegten Domain übereinstimmt.

Rein lokale Umgebungen ohne öffentlich erreichbare Domain

Für Staging- und Testumgebungen mit einer öffentlich erreichbaren (Sub-)Domain kannst du stattdessen eine kostenlose Staging-Lizenz nutzen, siehe Staging-Lizenz für Pickware einrichten.

Eine zusätzliche Lizenz für lokale Umgebungen gibt es nicht: Pro bezahlter Live-Lizenz gibt es genau eine kostenlose Staging-Lizenz. Ersetze die lokale Umgebung deshalb am besten durch die Staging-Umgebung. Als Agentur kannst du alternativ eine Partnerlizenz aus deinem Partner-Account nutzen.

Datenbank aus dem Live-Shop oder einer Staging-Umgebung kopiert

Hast du die Datenbank deiner lokalen Entwicklungsumgebung aus dem Live-Shop oder einer Staging-Umgebung kopiert, enthält sie auch deren Lizenzeintrag. Er liegt in der Tabelle pickware_license_bundle_plugin_installation. Die lokale Umgebung lässt sich dann nicht mit deinem Pickware Account verbinden.

Achtung: Lösche den Eintrag nur in der Datenbank deiner lokalen Umgebung, nie im Live-Shop.

Lösche in der Datenbank deiner lokalen Umgebung den Eintrag in der Tabelle pickware_license_bundle_plugin_installation. Verbinde die Erweiterung danach unter Einstellungen → Erweiterungen → Pickware über Jetzt verbinden erneut. Die Erweiterung legt den Eintrag dabei neu an.

Damit das bei künftigen Kopien nicht erneut passiert, lass diese Tabelle beim Kopieren der Datenbank aus. Weitere Lizenzfehler und ihre Lösungen findest du in Was kann ich tun, wenn Pickware meine Lizenz nicht erkennt?

Weitere Hilfe

Besteht das Problem weiterhin, obwohl die im Browser aufgerufene Domain mit der im Pickware Account hinterlegten APP_URL übereinstimmt, wende dich mit der betroffenen Domain und den genauen Fehlermeldungen an den Pickware Support, damit die Ursache anhand der Server-Logs geprüft werden kann.

Hat dies deine Frage beantwortet?