Verbinden Sie Ihren
PrestaShop-Shop mit GSE-Web
Ihr Katalog und Ihr verfügbarer Bestand gehen an den Shop. Bestellungen, die einen von Ihnen gewählten Status erreichen, kommen in GSE-Web als bestätigte Ausgangsbelege mit reserviertem Bestand an.
Kurz gesagt
Der PrestaShop-Connector verbindet einen PrestaShop-Shop über den nativen Webservice des Shops mit einem Lager von GSE-Web: In PrestaShop muss nichts installiert werden. GSE-Web veröffentlicht den Bestand im Shop, der Shop sendet seine Bestellungen. Ein Administrator der Organisation richtet ihn im Menü ADMIN › „Integrationen“ ein.
- Was an den Shop geht: die Produktseiten einfacher Produkte, Sets und Produkte mit Varianten (Name, Referenz, Verkaufspreis ohne Steuern, Barcode), wenn Sie es wünschen, und der verfügbare Bestand des veröffentlichten Lagers, wenn Sie „Verfügbaren Bestand veröffentlichen“ ankreuzen.
- Was in GSE-Web ankommt: Jede Bestellung, die einen der von Ihnen gewählten Bestellstatus erreicht, wird zu einem bestätigten Ausgangsbeleg mit reserviertem Bestand, wenn Sie „Bestellungen empfangen“ ankreuzen; der Käufer wird zum Privatkunden. Auf Wunsch werden auch Beschreibung und Fotos der verknüpften Produkte aus dem Shop übernommen.
- Wann: Der Bestand geht wenige Sekunden nach jeder Änderung in GSE-Web an den Shop. PrestaShop benachrichtigt GSE-Web nicht: Bestellungen werden alle 5 Minuten gelesen, sie kommen also nicht in Echtzeit an.
- Was nie geschieht: Im Shop wird nichts gelöscht (ein aus dem Verkauf genommenes Produkt wird dort deaktiviert), GSE-Web schreibt nie die Zeilen einer Bestellung und erstattet nie etwas zurück. Es setzt nur den von Ihnen gewählten Bestellstatus bei Lieferung oder Stornierung eines Belegs, wenn Sie es wünschen.
- Abschalten: Pausieren, Trennen oder Schließen des Moduls jederzeit, ohne Verlust; beim Fortsetzen werden die zwischenzeitlich eingegangenen Bestellungen nachgeholt.
- Der Connector ist mit dem Webservice von PrestaShop 8 und 9 kompatibel. PrestaShop ist eine Marke ihres Herausgebers; GSE-Web wird weder von PrestaShop herausgegeben noch von PrestaShop empfohlen.
Voraussetzungen
Prüfen Sie diese Punkte, bevor Sie die Connector-Seite öffnen: Der Verbindungstest kontrolliert sie und lehnt klar ab, was fehlt.
Der aktivierte Webservice und die URL-Umschreibung
Im PrestaShop-Back-Office: Erweiterte Einstellungen › Webservice, „Webservice von PrestaShop aktivieren“. Der Webservice liegt unter /api/ und verlangt URL-Umschreibung (Apache: mod_rewrite und AllowOverride All).
Ein Webservice-Schlüssel mit den richtigen Berechtigungen
32 Buchstaben und Ziffern, Status aktiviert. Lesen auf shops, languages, currencies, countries, configurations, categories, tax_rule_groups, images, orders, order_states, addresses, customers; Lesen, Anlegen und Ändern auf products und combinations; Lesen und Anlegen auf product_options und product_option_values; Lesen und Ändern auf stock_availables und order_carriers; Anlegen auf order_histories. Der Test nennt jede fehlende Berechtigung.
Eine öffentliche HTTPS-Adresse
Der Shop muss über HTTPS im Internet erreichbar sein; ein Unterverzeichnis ist erlaubt (https://www.mein-shop.de/shop). Eine http://-Adresse oder eine Adresse in einem privaten Netz wird abgelehnt.
Getestete Versionen, ein einziger Shop
Der Connector ist mit PrestaShop 8.2.8, 9.1.0 und 9.1.2 getestet. Andere Versionen werden akzeptiert, der Verbindungsbildschirm zeigt dann jedoch eine Warnung: Kontaktieren Sie uns, wenn Sie auf ein Problem stoßen. Ein Schlüssel, der mehrere Shops sieht, wird abgelehnt: Multishop wird nicht unterstützt.
Die Module für Ihre Organisation freigeschaltet
„Integrationen“, dann „PrestaShop“. Die Freischaltung beantragen Sie bei KLS-Concept. Ohne „Integrationen“ erscheint der Menüeintrag nicht.
Ein ADMIN-Konto mit Zwei-Faktor-Authentifizierung
Die Eingabe des Shop-Schlüssels wird abgelehnt, solange die Zwei-Faktor-Authentifizierung für Ihr Konto nicht aktiviert ist, unter „Meine Informationen“. Aktivieren Sie sie, bevor Sie die Felder ausfüllen.
Ein echtes Lager, dieselbe Währung, eine Steuergruppe
Das veröffentlichte Lager ist ein echtes Lager (ein Übungslager wird abgelehnt). Die Währung des Shops muss die Ihrer Organisation sein, und die Bestandsverwaltung muss im Shop aktiviert sein. Damit GSE-Web Produktseiten anlegen kann, braucht der Shop eine Steuerregelgruppe: Ein neuer Shop hat keine.
Einrichtung Schritt für Schritt
Sechs Schritte, in der Reihenfolge der Seite.
Die Connector-Seite öffnen
Menü ADMIN › „Integrationen“. Die PrestaShop-Karte steht in der Kategorie „E-Commerce“. Klicken Sie auf „Einrichten“ (die Schaltfläche heißt „Verwalten“, sobald der Shop gespeichert ist).
Karte „Shop“
Füllen Sie „Adresse des Shops“ (HTTPS, zum Beispiel https://www.mein-shop.de), „Webservice-Schlüssel“ (erstellt unter Erweiterte Einstellungen › Webservice) und „Veröffentlichtes Lager“ (ein echtes Lager) aus.
Der Schlüssel ist nur schreibbar: Einmal gespeichert, wird er nie wieder angezeigt, die Seite zeigt nur seinen Anfang und sein Ende. Die Adresse eines bereits aktivierten Shops lässt sich nicht ändern: Trennen Sie ihn zuerst.
Karte „Einstellungen“
Jede Einstellung hat einen Standardwert:
- „Produktseiten im Shop anlegen und aktualisieren“: standardmäßig nicht angekreuzt. Dann verknüpft GSE-Web nur die bereits im Shop vorhandenen Produkte über die Referenz. Angekreuzt, verlangt es eine „Steuerregelgruppe für angelegte Produkte“ und eine „Standardkategorie für angelegte Produkte“ (eine bestehende Seite behält ihre eigenen).
- „Verfügbaren Bestand veröffentlichen“: standardmäßig nicht angekreuzt; ankreuzen, damit GSE-Web den Bestand in den Shop schreibt. Verlangt, dass die Bestandsverwaltung im Shop aktiviert ist.
- „Bestellungen empfangen“: standardmäßig nicht angekreuzt; ankreuzen, um Bestellungen zu importieren. Angekreuzt, verlangt es „Bestellstatus, die einen Beleg erzeugen“ (mindestens einer, zum Beispiel „Zahlung akzeptiert“). Die Status sind für jeden Shop spezifisch; ein unbekannter Status wird nie importiert.
- „Bestellstatus, die den Beleg stornieren“: optional. Leer storniert der Shop keinen Beleg.
- „Höchstalter einer nachgeholten Bestellung (Tage)“: standardmäßig 30, von 1 bis 90. Nach einer Pause oder Schließung wird eine ältere Bestellung nicht von selbst importiert.
- „Lieferungen und Stornierungen an den Shop melden“: standardmäßig nicht angekreuzt; ankreuzen, damit Lieferungen und Stornierungen zurückgemeldet werden. Angekreuzt, mit „Status bei Lieferung des Belegs“ (typischerweise „Versendet“) und „Status bei Stornierung des Belegs“ (typischerweise „Storniert“). Ist kein Status gewählt, wird nichts gemeldet.
- „Beschreibung und Fotos aus dem Shop übernehmen“: standardmäßig nicht angekreuzt. Der Shop bleibt Herr dieser Inhalte; GSE-Web schreibt sie nie in den Shop.
- Kein Preismodus einzustellen: GSE-Web veröffentlicht seinen Verkaufspreis ohne Steuern, der Shop berechnet seinen Bruttopreis mit der gewählten Steuerregelgruppe.
Speichern
Klicken Sie auf „Speichern“. „Verbindung testen“ und „Aktivieren“ verwenden die gespeicherte Konfiguration: Die Seite verlangt, jede Änderung zuerst zu speichern.
Die Verbindung testen, dann aus den Listen des Shops wählen
„Verbindung testen“ befragt den Shop: Schlüssel akzeptiert, Berechtigungen des Schlüssels (mit der Liste der fehlenden), Währung gleich der der Organisation, Bestandsverwaltung, ein einziger sichtbarer Shop. Der Test zeigt, was der Shop angegeben hat (PrestaShop-Version, Zeitzone, Währung, Sprachen), und lädt die Auswahllisten: Steuerregelgruppen, Kategorien, Bestellstatus. Wählen Sie dort Ihre Status, speichern Sie und testen Sie erneut.
Aktivieren
„Aktivieren“ wiederholt den Test, verlangt die von Ihren Einstellungen geforderten Auswahlen (Status; Steuergruppe und Kategorie, wenn Sie Produktseiten anlegen) und startet dann den Abgleich. Bestellungen, die vor der Aktivierung aufgegeben wurden, werden nicht importiert.
Was abgeglichen wird, und wer maßgeblich ist
Jedes Feld hat nur einen Herrn. In einer Bestellung des Shops schreibt GSE-Web nur ihren Liefer- oder Stornostatus, nie ihre Zeilen.
📦 GSE-Web ist maßgeblich
- ✓Produktname (alle Sprachen des Shops)
- ✓Referenz (SKU im Shop)
- ✓Verkaufspreis ohne Steuern
- ✓Barcode
- ✓Im Verkauf oder deaktiviert
- ✓Bestand, pro Produkt oder pro Kombination
🛒 Der Shop ist maßgeblich
- ✓Beschreibung (auf Wunsch in GSE-Web übernommen)
- ✓Fotos (auf Wunsch in GSE-Web übernommen)
- ✓Kategorien, Aktionen, Merkmale
- ✓Steuern (Regelgruppen)
- ✓Bestellungen und ihre Status
- ✓Rückerstattungen
Die Regeln
- Einfache Produkte, Sets und Produkte mit Varianten. Ein einfaches Produkt wird als Standardprodukt von PrestaShop veröffentlicht. Ein Set ebenso, mit der Anzahl der aus den Komponenten des veröffentlichten Lagers montierbaren Sets als Bestand. Ein Produkt mit Varianten wird als Produkt mit Kombinationen veröffentlicht: Die Achsen (Größe, Farbe …) werden zu Optionsgruppen, jede Variante ist eine Kombination mit ihrer Referenz, ihrem Bestand und einem Preisunterschied zum Basispreis.
- Der Name aus GSE-Web ist maßgeblich. Eine Namensänderung schreibt ihn in alle aktiven Sprachen des Shops neu: In PrestaShop vorgenommene Übersetzungen werden überschrieben.
- Ein aus dem Verkauf genommenes Produkt wird in GSE-Web im Shop deaktiviert; dort wird es nie gelöscht. Eine aus dem Verkauf genommene Variante wird auf Bestand 0 gesetzt. Beim Anlegen einer Seite lehnt der Shop Bestellungen ohne Bestand ab; eine bestehende Seite behält die Einstellung des Händlers.
- Verkaufspreis ohne Steuern, unverändert mit 4 Nachkommastellen veröffentlicht. Der Shop berechnet seinen Bruttopreis mit der für angelegte Seiten gewählten Steuerregelgruppe: Weicht ihr Satz von der Mehrwertsteuer des Produkts in GSE-Web ab, weicht der im Shop angezeigte Bruttopreis von dem in GSE-Web ab.
- Veröffentlichter Bestand = verfügbarer Bestand des veröffentlichten Lagers (physisch minus reserviert), auf die Einheit abgerundet, nie negativ. Er geht wenige Sekunden nach jeder Änderung an den Shop: Wareneingang, Warenausgang, Umlagerung, Inventur, gesetzte oder freigegebene Reservierung auf einem Beleg. Der vollständige Durchlauf liest ihn außerdem alle 5 Minuten neu. Bei einer Variante wird der Bestand pro Kombination geschrieben.
- Eine Bestellung = ein bestätigter Ausgangsbeleg des veröffentlichten Lagers, mit angehaktem „Produkte für diesen Beleg reservieren.“: Die gesamte bestellte Menge wird reserviert, auch über den Bestand hinaus (der Fehlbestand steht als „Wartet auf Wareneingang“ auf dem Beleg). Die Lieferadresse wird übernommen. Nie ein Teilbeleg: macht eine Zeile Probleme (unbekanntes Produkt, unbekannte Variante, nicht veröffentlichbares Set, Käufer ohne E-Mail, andere Währung), wird kein Beleg angelegt, und ein offener Punkt erklärt es.
- Erkennung durch Lesen, ohne Webhook. PrestaShop benachrichtigt GSE-Web nicht: Alle 5 Minuten liest GSE-Web die neuen oder geänderten Bestellungen. Eine Statusänderung wird also im nächsten Durchlauf gesehen, nie in Echtzeit.
- Ein Käufer = ein Privatkunde, über seine E-Mail von einer Bestellung zur nächsten wiedergefunden. Ein bereits in GSE-Web vorhandener Geschäftspartner wird nicht zugeordnet: Es wird ein Privatkunde angelegt.
- Eine Bestellung, die einen von Ihnen gewählten Stornostatus erreicht: Der Beleg wird storniert und seine Reservierungen werden freigegeben, außer er ist bereits von jemandem in Bearbeitung. In diesem Fall überlässt ein offener Punkt die Entscheidung dem Team.
- Nach dem Import im Shop geänderte Bestellung: Die Änderung wird nicht auf den Beleg übertragen; ein offener Punkt bittet Sie, ihn zu prüfen. Die Bestellung eines Sets wird zu einem Ausgangsbeleg auf seine Komponenten; die Bestellung einer Variante ergibt einen Beleg auf die Variante.
- Rückmeldung von Lieferungen und Stornierungen (Einstellung standardmäßig nicht angekreuzt: der ADMIN kreuzt sie an): Ein gelieferter oder abgeschlossener Beleg erhält zuerst seine Sendungsnummer (wenn seine Sendung eine trägt), dann wechselt die Bestellung in den gewählten Status; GSE-Web löst die E-Mail des Shops nicht aus: PrestaShop benachrichtigt den Käufer nicht über diese Änderung. Ein in GSE-Web stornierter Beleg setzt den gewählten Stornostatus, ohne Rückerstattung: Sie erfolgt in PrestaShop. Eine Bestellung, die der Shop bereits versendet oder geliefert hat, wird nicht rückgängig gemacht: Ein offener Punkt meldet es. Teilweise geliefert oder in Vorbereitung: nichts, bis der Beleg vollständig ist.
- Übernahme von Beschreibung und Fotos (Einstellung standardmäßig nicht angekreuzt): Bei jedem Durchlauf wird für jedes verknüpfte Produkt die Beschreibung des Shops als reiner Text übernommen (eine leere Beschreibung löscht nie die von GSE-Web); die Fotos werden in der Reihenfolge des Shops hinzugefügt und entfernt, wenn sie im Shop verschwinden. Höchstens 20 Fotos pro Produkt. Nicht übernommen werden: Kategorien, Aktionen, Merkmale, Inhalte einzelner Varianten sowie im Shop geänderte Namen, Preise und Barcodes.
Im Alltag
Die Seite des Connectors liest sich von oben nach unten: Status, Shop, Einstellungen, Schaltflächen, dann die offenen Punkte und das Protokoll.
Die Karte „Status“
Sie zeigt den Stand der Verbindung, Name und Währung des Shops, das Datum des letzten Abgleichs, den letzten Fehler und die Zahl der offenen Punkte. Auf der Karte der Seite „Integrationen“ passt der Status in ein Etikett.
- Noch nicht aktiv „Eingerichtet, noch nicht aktiviert“.
- Verbunden „Aktiv — Bestand wird bei jeder Änderung gesendet, Bestellungen werden alle 5 Minuten gelesen“. Der Status folgt den gespeicherten Einstellungen: ohne „Bestellungen empfangen“ heißt es „… Bestellungen werden nicht empfangen“, ohne „Verfügbaren Bestand veröffentlichen“ „… Bestand nicht veröffentlicht“.
- Pausiert „Pausiert — nichts wird gesendet oder importiert“.
- Angehalten — prüfen „Vom Server angehalten — Webservice-Schlüssel prüfen und testen“.
„Jetzt abgleichen“
Der Bestand wird automatisch wenige Sekunden nach jeder Änderung an den Shop gesendet. PrestaShop benachrichtigt GSE-Web nicht: Bestellungen werden alle 5 Minuten gelesen. Diese Schaltfläche startet sofort den vollständigen Abgleich (Produktseiten, Lesen der Bestellungen, Lieferungen). Die Meldung sagt, ob der Durchlauf beendet ist, ob er offene Punkte ergeben hat oder warum er nicht gestartet wurde.
Die Karte „Was zwischen GSE-Web und dem Shop ausgetauscht wird“
Unter den Einstellungen sagt eine Karte für jeden Austausch, in welche Richtung er geht: von GSE-Web zum Shop (Produktseiten, Bestand, Varianten, Lieferungen und Stornierungen), vom Shop zu GSE-Web (Bestellungen, Stornierungen, Beschreibung und Fotos) und was nie übertragen wird (Bestellzeilen, Rückerstattungen, Kategorien, Steuerregeln, spezifische Preise, im Shop geänderte Namen, Preise und Barcodes). Eine Zeile, die an eine nicht angekreuzte Einstellung gebunden ist, ist mit „Deaktiviert“ markiert.
Das „Protokoll“
Jeder Durchlauf steht dort mit Art und Ergebnis. Arten: „Produktseiten“, „Bestand“, „Bestand in Echtzeit“ (Versand, sobald sich ein Bestand ändert, nur eingetragen, wenn sich eine Menge geändert hat), „Übernahme aus dem Shop“, „Abruf der Bestellungen“, „Rückmeldung der Belege“, „Verbindungstest“. Ergebnisse: „Erfolgreich“, „Teilweise“, „Fehlgeschlagen“, „Läuft“, „Unterbrochen“. Ein Klick auf einen Durchlauf öffnet sein Detail, Element für Element. Durchläufe ohne Änderung lassen sich ausblenden.
Die „Offenen Punkte“
Eine Zeile, die nicht durchgeht, blockiert den Abgleich nie: sie wird zu einem offenen Punkt, und der Rest läuft weiter. Punkte zu Produktseiten und Bestand verschwinden von selbst, sobald ihre Ursache behoben ist. Punkte zu Bestellungen haben zwei Schaltflächen.
- „Erneut ausführen“ liest die Bestellung erneut im Shop und wiederholt den Import, unabhängig von ihrem Alter. Für Punkte der Rückmeldung (Ausführung, Stornierung im Shop) wird sie nicht angeboten: der nächste Durchlauf versucht es von selbst erneut.
- „Ignorieren“ legt den Punkt ab: ein ignorierter Punkt kommt nicht in die Liste zurück. „Alle ignorieren“, oben in der Liste, legt nach einer Bestätigung alle offenen Punkte auf einmal ab, auch die nicht angezeigten.
Produktseiten
- Ursache
- Das Produkt hat keinen Typ, den der Connector veröffentlichen kann.
- Was tun
- Verwenden Sie ein einfaches Produkt, ein Set oder ein Produkt mit Varianten.
- Ursache
- Das Produkt hat in GSE-Web keinen Verkaufspreis.
- Was tun
- Tragen Sie den Verkaufspreis ein. Der Punkt verschwindet im nächsten Durchlauf.
- Ursache
- Die Referenz wird von mehreren Produkten des Shops getragen, beginnt mit einer eckigen Klammer, entspricht einem Produkt anderen Typs (Paket, virtuell, mit Kombinationen) oder ist bereits mit einem anderen Produkt von GSE-Web verknüpft.
- Was tun
- Machen Sie die Referenz im Shop oder in GSE-Web eindeutig; GSE-Web ordnet nie zufällig zu.
- Ursache
- Der Shop hat die Seite abgelehnt (Referenz zu lang, leerer Name, ungültige Angabe).
- Was tun
- Korrigieren Sie die Seite in GSE-Web: Der Punkt verschwindet im nächsten Durchlauf.
- Ursache
- Die verknüpfte Seite wurde in PrestaShop gelöscht.
- Was tun
- Legen Sie sie neu an oder nehmen Sie das Produkt aus dem veröffentlichten Umfang, dann gleichen Sie neu ab.
- Ursache
- Das Produkt wurde von einfach zu Varianten (oder umgekehrt): Die Verknüpfung zur alten Seite wird entfernt.
- Was tun
- Deaktivieren oder löschen Sie die alte Seite in PrestaShop, dann ignorieren Sie den Punkt.
- Ursache
- Das Set hat keine Komponente, eine Komponente ist archiviert, oder ihre Einheit weicht von ihrer Basiseinheit ab.
- Was tun
- Korrigieren Sie die Zusammensetzung des Sets in GSE-Web.
- Ursache
- Das Produkt hat keine veröffentlichbare Variante.
- Was tun
- Legen Sie mindestens eine Variante mit Preis an.
- Ursache
- Das Elternprodukt fehlt, ist archiviert, außerhalb des Umfangs, noch nicht veröffentlicht, oder seine Achsen sind ungültig.
- Was tun
- Veröffentlichen Sie das Elternprodukt und korrigieren Sie seine Achsen, dann gleichen Sie neu ab.
- Ursache
- Die Seite wurde angelegt, aber PrestaShop hat die Einstellung „Bestellungen ohne Bestand ablehnen“ nicht akzeptiert.
- Was tun
- Setzen Sie diese Einstellung in PrestaShop, falls gewünscht, dann ignorieren Sie den Punkt.
- Ursache
- Ein Foto im Shop wurde nicht gefunden, hat ein nicht unterstütztes Format, ist zu groß (über 5 MB), der Shop ist nicht erreichbar, oder das Produkt hat mehr als 20.
- Was tun
- Korrigieren Sie das Foto im Shop; der Rest des Produkts wird trotzdem übernommen.
Bestand
- Ursache
- Der verfügbare Bestand ist keine ganze Zahl; PrestaShop verwaltet nur ganze Mengen.
- Was tun
- Keine Aktion nötig; die Menge wird auf die Einheit abgerundet.
- Ursache
- Der Shop hat die gesendete Menge abgelehnt.
- Was tun
- Prüfen Sie die Seite im Shop; der Versand wird im nächsten Durchlauf wiederholt.
Gespeicherte Auswahl (Shop)
- Ursache
- Die gewählte Gruppe wurde in PrestaShop gelöscht oder deaktiviert.
- Was tun
- Pausieren Sie die Verbindung, testen Sie, wählen Sie eine andere Gruppe, speichern und setzen Sie fort.
- Ursache
- Die gewählte Kategorie wurde in PrestaShop gelöscht.
- Was tun
- Pausieren Sie die Verbindung, testen Sie, wählen Sie eine andere Kategorie, speichern und setzen Sie fort.
- Ursache
- Es ist kein Status gewählt, oder der gewählte wurde aus dem Shop gelöscht.
- Was tun
- Wählen Sie den Status unter „Einstellungen“ (in der Pause), speichern und setzen Sie fort.
- Ursache
- Es ist kein Status gewählt, oder der gewählte wurde aus dem Shop gelöscht.
- Was tun
- Wählen Sie den Status unter „Einstellungen“ (in der Pause), speichern und setzen Sie fort.
Bestellungen
- Ursache
- Eine Zeile der Bestellung trägt eine Referenz, die in GSE-Web nicht existiert.
- Was tun
- Legen Sie das Produkt mit derselben Referenz an, dann „Erneut ausführen“.
- Ursache
- Die bestellte Kombination ist GSE-Web unbekannt, oder die Referenz eines Produkts mit Varianten wurde ohne Kombination bestellt.
- Was tun
- Legen Sie die Variante in GSE-Web an, dann „Erneut ausführen“.
- Ursache
- Der Shop liefert für diesen Käufer keine E-Mail.
- Was tun
- Korrigieren Sie die Kundenakte in PrestaShop, dann „Erneut ausführen“.
- Ursache
- Der mit dieser E-Mail verknüpfte Privatkunde wurde in GSE-Web archiviert.
- Was tun
- Heben Sie die Archivierung des Kunden auf, dann „Erneut ausführen“.
- Ursache
- Die Währung der Bestellung ist nicht die der Organisation; es erfolgt keine Umrechnung.
- Was tun
- Bearbeiten Sie diese Bestellung von Hand in GSE-Web, dann ignorieren Sie den Punkt.
- Ursache
- Sie ist älter als „Höchstalter einer nachgeholten Bestellung“.
- Was tun
- „Erneut ausführen“ importiert sie, unabhängig von ihrem Alter.
- Ursache
- Der Beleg ist bereits von jemandem in Bearbeitung: GSE-Web storniert ihn nicht stillschweigend.
- Was tun
- Entscheiden Sie mit dem Lagerteam, ob die Vorbereitung gestoppt werden muss.
- Ursache
- Die Zeilen der Bestellung haben sich seit Anlegen des Belegs geändert.
- Was tun
- Prüfen Sie den Beleg und korrigieren Sie ihn bei Bedarf von Hand.
- Ursache
- Ein Fehler verhindert das Anlegen des Belegs.
- Was tun
- Lesen Sie die Ursache im Detail des Punkts, beheben Sie sie, dann „Erneut ausführen“.
- Ursache
- Das bestellte Set hat keine Komponente, eine Komponente ist archiviert, oder ihre Einheit weicht ab.
- Was tun
- Korrigieren Sie die Zusammensetzung des Sets, dann „Erneut ausführen“.
- Ursache
- Der Shop hat den von GSE-Web gesetzten Status abgelehnt.
- Was tun
- Prüfen Sie die Bestellung im Shop; der nächste Durchlauf versucht es erneut.
- Ursache
- Der Beleg wurde in GSE-Web storniert, aber der Shop hatte die Bestellung bereits versendet oder geliefert: GSE-Web macht sie nicht rückgängig.
- Was tun
- Klären Sie die Situation mit dem Kunden (Rückerstattung, Retoure) direkt im Shop.
- Ursache
- Die Bestellung hat in PrestaShop keinen Spediteur oder mehrere: Die Sendungsnummer konnte nicht geschrieben werden. Der Status selbst wird gesetzt.
- Was tun
- Tragen Sie die Sendungsnummer bei Bedarf in PrestaShop ein.
Pause, Fortsetzen und Änderungen
Der Connector lässt sich jederzeit abschalten und wieder einschalten. Manche Änderungen folgen einer Regel, an die die Seite erinnert und die der Server durchsetzt.
„Pausieren“
Es wird nichts mehr gesendet oder importiert, und nichts geht verloren. Der im Shop angezeigte Bestand bleibt der zuletzt gesendete.
„Fortsetzen“
Der Shop wird erneut geprüft (Schlüssel, Berechtigungen, Währung, Steuergruppe, Kategorie und gewählte Status), dann startet das Nachholen: Während der Pause aufgegebene Bestellungen werden importiert, wenn sie weniger als N Tage alt sind („Höchstalter einer nachgeholten Bestellung“, standardmäßig 30). Ältere werden zu offenen Punkten.
Den Webservice-Schlüssel ändern
Bei aktiver Verbindung sind Shop-Adresse und Schlüssel gesperrt. Gehen Sie in dieser Reihenfolge vor: „Pausieren“, ändern, „Speichern“, „Verbindung testen“, „Fortsetzen“.
Die Adresse des Shops ändern
Zuerst „Trennen“: Die bereits verknüpften Produkte und Bestellungen beziehen sich auf den alten Shop. Geben Sie dann die neue Adresse und ihren Schlüssel ein.
Denselben Shop wieder verbinden
Bereits verknüpfte Produkte, Bestellungen und Kunden werden wiedergefunden: Für eine bereits importierte Bestellung wird kein zweiter Beleg angelegt.
Steuergruppe, Kategorie oder Status ändern
Nur in der Pause. Beim Fortsetzen werden diese Auswahlen erneut gegen den Shop geprüft: PrestaShop akzeptiert stillschweigend eine nicht existierende Steuergruppe oder Kategorie, die Kontrolle übernimmt GSE-Web. Eine im Shop gelöschte Steuergruppe oder Kategorie wird zu einem offenen Punkt, und es wird keine Produktseite angelegt.
„Trennen“
Der Schlüssel wird gelöscht und der Abgleich stoppt. Weder im Shop noch in GSE-Web wird etwas gelöscht: bereits importierte Belege und Kunden bleiben.
Schließung des Moduls
Schließt KLS-Concept das Modul für Ihre Organisation, stoppt alles, ohne dass etwas gelöscht wird. Bei der Wiederöffnung holt der nächste Durchlauf die Bestellungen nach und veröffentlicht den Bestand erneut.
Sicherheit und Daten
Was der Connector aufbewahrt, und wie.
Verschlüsselter Schlüssel
Der Webservice-Schlüssel wird auf dem Server verschlüsselt (AES-256-GCM). Er wird nie wieder angezeigt und nie in Protokolle geschrieben.
Zwei-Faktor-Authentifizierung
Sie ist Pflicht, um die Zugangsdaten eines Shops einzugeben oder zu ersetzen.
Nur öffentlicher HTTPS-Shop
Der Connector ruft nur die eingegebene HTTPS-Adresse auf, auf einem öffentlichen Host, dessen Adresse geprüft wird; keine Weiterleitung wird verfolgt. Übernommene Fotos werden nur von einer öffentlichen HTTPS-Adresse geladen, ohne je den Schlüssel zu übermitteln.
Auf Seiten von GSE-Web nichts zu öffnen
PrestaShop sendet nichts an GSE-Web: GSE-Web befragt den Shop. Es muss keine Adresse von GSE-Web dem Shop zugänglich gemacht und kein Modul im Shop installiert werden.
Daten des Käufers
Seine Kontaktdaten werden in seine Kundenakte übernommen, die Lieferadresse auf den Beleg. Die Verknüpfung mit dem Shop behält nur einen Fingerabdruck seiner E-Mail.
Nichts im Export
Die verschlüsselten Zugangsdaten sind nicht im Portabilitätsexport der Organisation enthalten.
Fehlerbehebung
Die Meldung der Seite, ihre Ursache und was zu tun ist. Der Code in eckigen Klammern hilft dem Support, den Fall wiederzufinden. Die App zeigt diese Meldungen auf Englisch (oder Französisch) an; die Übersetzung hier dient dem Verständnis, der Code in eckigen Klammern ordnet sie zu.
„Vom Server angehalten — Webservice-Schlüssel prüfen und testen“
Nach fünf Authentifizierungsablehnungen in Folge (Schlüssel in PrestaShop deaktiviert oder gelöscht) stoppt der Server die Verbindung, um nicht weiter zu versuchen. Prüfen Sie den Schlüssel unter Erweiterte Einstellungen › Webservice, geben Sie ihn bei Bedarf erneut ein, „Speichern“, „Verbindung testen“, dann „Aktivieren“.
- Was tun
- Geben Sie die HTTPS-Adresse des Shops ein, zum Beispiel https://www.mein-shop.de, ohne Zugangsdaten oder Parameter.
[PRESTASHOP_SHOP_URL_INVALID]
- Was tun
- Verwenden Sie die öffentliche Adresse des Shops.
[PRESTASHOP_SHOP_URL_PRIVATE_HOST]
- Was tun
- Prüfen Sie, dass der Schlüssel vollständig kopiert ist (32 Zeichen) und unter Erweiterte Einstellungen › Webservice aktiv ist.
[PRESTASHOP_SHOP_AUTH_FAILED]
- Was tun
- Testen Sie die Verbindung: Die Seite listet die fehlenden Berechtigungen des Schlüssels auf.
[PRESTASHOP_SHOP_ACCESS_DENIED]
- Was tun
- Haken Sie unter Erweiterte Einstellungen › Webservice für diesen Schlüssel die aufgelisteten Berechtigungen an und testen Sie erneut.
[PRESTASHOP_RIGHTS_MISSING]
- Was tun
- Aktivieren Sie den Webservice unter Erweiterte Einstellungen › Webservice und prüfen Sie, dass die URL-Umschreibung funktioniert.
[PRESTASHOP_WEBSERVICE_UNAVAILABLE]
- Was tun
- Es erfolgt keine Umrechnung: Gleichen Sie die Standardwährung des Shops an die der Organisation an.
[PRESTASHOP_SHOP_CURRENCY_MISMATCH]
- Was tun
- Aktivieren Sie die Bestandsverwaltung in PrestaShop oder entfernen Sie das Häkchen bei „Verfügbaren Bestand veröffentlichen“.
[PRESTASHOP_STOCK_MANAGEMENT_DISABLED]
- Was tun
- Erstellen Sie einen auf einen einzigen Shop beschränkten Schlüssel.
[PRESTASHOP_MULTISHOP_UNSUPPORTED]
- Was tun
- Wählen Sie nach dem Verbindungstest eine Steuerregelgruppe. Ein neuer Shop hat keine: Legen Sie eine in PrestaShop an (International › Steuern › Steuerregeln).
[PRESTASHOP_TAX_GROUP_REQUIRED]
- Was tun
- Testen Sie die Verbindung und wählen Sie dann eine Kategorie aus der Liste.
[PRESTASHOP_CATEGORY_REQUIRED]
- Was tun
- Wählen Sie einen Status (zum Beispiel „Zahlung akzeptiert“) oder entfernen Sie das Häkchen bei „Bestellungen empfangen“.
[PRESTASHOP_IMPORT_STATES_REQUIRED]
- Was tun
- Klicken Sie auf „Trennen“, dann geben Sie die neue Adresse und ihren Schlüssel ein.
[PRESTASHOP_SHOP_CHANGE_REQUIRES_DISCONNECT]
- Was tun
- „Pausieren“, ändern, „Speichern“, „Verbindung testen“, „Fortsetzen“.
[PRESTASHOP_SHOP_SETTINGS_CHANGE_REQUIRES_PAUSE]
- Was tun
- „Pausieren“, Schlüssel ändern, „Speichern“, „Verbindung testen“, „Fortsetzen“.
[PRESTASHOP_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Was tun
- Geben Sie den Webservice-Schlüssel ein.
[PRESTASHOP_CREDENTIALS_REQUIRED]
- Was tun
- Öffnen Sie „Meine Informationen“, aktivieren Sie die Zwei-Faktor-Authentifizierung und kehren Sie zurück.
[PRESTASHOP_CONNECTION_TWO_FACTOR_REQUIRED]
- Was tun
- Wählen Sie ein echtes Lager als „Veröffentlichtes Lager“.
[PRESTASHOP_WAREHOUSE_EXERCISE_REFUSED]
- Was tun
- Prüfen Sie, dass der Shop online ist; versuchen Sie es in einigen Augenblicken erneut.
[PRESTASHOP_SHOP_UNREACHABLE]
- Was tun
- Versuchen Sie es erneut; besteht die Meldung fort, wenden Sie sich mit dem Code unten an den Support.
[PRESTASHOP_SHOP_RESPONSE_INVALID]
- Was tun
- Warten Sie einige Minuten; der nächste Durchlauf setzt fort.
[PRESTASHOP_SHOP_RATE_LIMITED]
- Was tun
- Warten Sie das Ende des laufenden Durchlaufs ab.
[INTEGRATIONS_CONNECTION_BUSY]
- Was tun
- Geben Sie den Webservice-Schlüssel erneut ein, testen Sie, dann aktivieren Sie.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
Häufige Fragen
Werden Produkte mit Varianten unterstützt?
Ja. Ein Produkt mit Varianten wird als Produkt mit Kombinationen veröffentlicht, jede Variante als Kombination mit ihrer Referenz, ihrem Bestand und einem Preisunterschied zum Basispreis. Die Achsen werden zu Optionsgruppen des Shops.
Lassen sich mehrere Shops verbinden?
Nein. Eine Organisation verbindet einen Shop, und ein Lager von GSE-Web, das „Veröffentlichte Lager“, versorgt diesen Shop. Der Multishop von PrestaShop wird nicht unterstützt: Ein Schlüssel, der mehrere Shops sieht, wird abgelehnt.
Werden Lieferungen an den Shop zurückgemeldet?
Ja, wenn „Lieferungen und Stornierungen an den Shop melden“ angekreuzt ist (standardmäßig ist sie es nicht: der ADMIN muss sie ankreuzen) und wenn Sie den zu setzenden Status gewählt haben. Ein gelieferter oder abgeschlossener Beleg setzt die Bestellung auf den gewählten Status, mit der Sendungsnummer, wenn die Sendung eine trägt; GSE-Web löst die E-Mail des Shops nicht aus, PrestaShop benachrichtigt den Käufer nicht über diese Änderung. Ein stornierter Beleg setzt den gewählten Stornostatus, ohne Rückerstattung.
Werden Bilder und Beschreibungen der Produkte ausgetauscht?
Sie verlassen GSE-Web nie: Fotos und Beschreibung werden in PrestaShop verwaltet. Wenn Sie jedoch „Beschreibung und Fotos aus dem Shop übernehmen“ ankreuzen, kopiert GSE-Web sie bei jedem Durchlauf auf die Seite des verknüpften Produkts.
Werden Kategorien, Aktionen und Merkmale übernommen?
Nein. Sie bleiben in PrestaShop verwaltet. Von GSE-Web angelegte Seiten erhalten eine einzige Standardkategorie, die Sie wählen.
Kommen Bestellungen in Echtzeit an?
Nein. PrestaShop bietet keinen nativen Webhook: GSE-Web liest neue oder geänderte Bestellungen alle 5 Minuten. Eine Bestellung kann also bis zu 5 Minuten nach Erreichen des gewählten Status erscheinen. Der Bestand dagegen geht wenige Sekunden nach jeder Änderung von GSE-Web an den Shop.
Was passiert, wenn ich pausiere oder das Modul geschlossen wird?
Nichts wird gesendet oder importiert, und nichts wird gelöscht. Der Bestand im Shop bleibt so, wie er beim letzten Versand war. Beim Fortsetzen werden die in der Zwischenzeit aufgegebenen Bestellungen nachgeholt, im Rahmen des gewählten Höchstalters.
Welche PrestaShop-Versionen werden unterstützt?
Der Connector ist mit PrestaShop 8.2.8, 9.1.0 und 9.1.2 getestet. Andere Versionen werden akzeptiert, mit einer Warnung im Verbindungsbildschirm: Kontaktieren Sie uns, wenn Sie auf ein Problem stoßen.
Wird der Name meiner Produkte im Shop geändert?
Wenn das Anlegen und Aktualisieren der Produktseiten aktiviert ist, ja: Der Name aus GSE-Web ist maßgeblich und wird in alle aktiven Sprachen des Shops neu geschrieben, was in PrestaShop vorgenommene Übersetzungen überschreibt. Ohne diese Option berührt GSE-Web die Seiten nicht.
Wird ein Käufer erkannt, der bereits in meinen Geschäftspartnern steht?
Nein. Der Connector legt pro Käufer einen Privatkunden an und findet ihn bei späteren Bestellungen über seine E-Mail wieder.
Werden vor der Aktivierung aufgegebene Bestellungen importiert?
Nein. Nur Bestellungen, die nach der Aktivierung gelesen werden, werden importiert.
Wie erhalte ich den Connector?
Die Module „Integrationen“ und „PrestaShop“ werden von KLS-Concept Organisation für Organisation freigeschaltet. Schreiben Sie uns über die Kontaktseite und nennen Sie die Version Ihres PrestaShop.
Verbinden Sie Ihren PrestaShop-Shop
Bitten Sie um die Freischaltung des Connectors für Ihre Organisation, oder stellen Sie uns Ihre Fragen zu Ihrem Fall.