VibeFox GLS ParcelShop for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x. Die Auswahl des ParcelShops funktioniert in den Themes Classic und Hummingbird.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

GLS: Das Modul verwendet und benötigt kein GLS-Konto und keinen API-Schlüssel. Die ParcelShop-Karte ist öffentlich. Für den Versand der Pakete an die gewählten ParcelShops benötigen Sie einen Vertrag mit GLS.

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls aus.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox GLS ParcelShop in der Modulliste und klicken Sie dort auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Legen Sie Ihre Preise fest: mindestens eine Zeile in Country prices (zum Beispiel * Default) oder einen Fallback cost (siehe Konfiguration), und klicken Sie auf Save.

Bei der Installation legt das Modul den Versanddienstleister GLS ParcelShop mit dem Liefertext Delivery to a GLS ParcelShop of your choice an. Der Versanddienstleister wird allen Kundengruppen und den Zonen der Länder der GLS-Karte zugewiesen (in einem Standardshop meist Europe und Europe (non-EU)). Zonen, Kundengruppen, Liefertext und Logo können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox GLS ParcelShop > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert.

Warnungen oben auf der Seite weisen auf Konfigurationsprobleme hin: Der Versanddienstleister wurde nicht gefunden, die Gewichtseinheit des Shops ist dem Modul nicht bekannt (legen Sie kg, g, lb oder oz unter International > Localization, Local units fest), es ist kein Preis festgelegt oder einige bzw. alle ausgewählten Countries (ignore zones mode) werden von der GLS-Karte nicht abgedeckt. Eine ungültige oder negative Zahl wird mit einer Meldung abgelehnt, die das Feld nennt, und der bisherige Wert bleibt erhalten. Die übrigen Felder werden trotzdem gespeichert.

General

Der Abschnitt listet die Länder auf, die von der GLS-Karte abgedeckt werden. Der Versanddienstleister wird für andere Zielländer nicht angeboten.

Enable/Disable: schaltet GLS ParcelShop ein oder aus. Dies ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Name: der Name der Versandart, den der Kunde sieht (der Name des Versanddienstleisters). Standard: GLS ParcelShop. Pflichtfeld, höchstens 64 Zeichen.

Tax status: die Steuerregel des Versanddienstleisters. None bedeutet, dass der Versand nicht besteuert wird. Wählen Sie eine Steuerregel, damit der Versand besteuert wird.

Prices

Preise geben Sie in der Standardwährung Ihres Shops ohne Steuern ein. Dezimalstellen können mit Komma oder Punkt angegeben werden (4,99 oder 4.99). Der Preis wird dem Kunden in der Warenkorbwährung angezeigt.

Calculation type: legt fest, wie der Preis angewendet wird.

Country prices: eine Tabelle mit einer Zeile pro Zielland. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Papierkorbsymbol, um eine Zeile zu entfernen. Jede Zeile hat ein Country, einen Price und fünf Gewichtsspalten: XS bis 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg und XL über 5 kg. Verwendet wird die Spalte für das Gewicht des Warenkorbs. Eine Gewichtsspalte, die auf 0 bleibt, verwendet die Spalte Price. Die Zeile * Default wird für Länder ohne eigene Zeile verwendet. Neue Zeilen beginnen mit * Default und 0 in allen Spalten. Eine Zeile, in der alle Preise 0 sind, ergibt kostenlose Lieferung. Wählen Sie daher das Land aus und tragen Sie die Preise ein, bevor Sie speichern. Wenn ein Wert in der Tabelle keine gültige Zahl ist, wird die gesamte Tabelle nicht gespeichert, und die Meldung nennt die fehlerhaften Werte.

Fallback cost: der Preis, der verwendet wird, wenn die Tabelle keine Zeile für das Zielland und keine Zeile * Default hat. Lassen Sie das Feld leer, um den Versanddienstleister für solche Länder auszublenden.

Free shipping from: der Warenkorb-Zwischensummenbetrag (nach Rabatten, ohne Steuern), ab dem die Lieferung mit GLS ParcelShop kostenlos ist. Lassen Sie das Feld leer, wenn die Lieferung nie kostenlos sein soll.

Availability

Minimum weight (kg): blendet den Versanddienstleister aus, wenn der Warenkorb weniger wiegt. Das Gewicht wird aus der Gewichtseinheit Ihres Shops umgerechnet. Leer oder 0 bedeutet keine Grenze.

Maximum weight (kg): blendet den Versanddienstleister aus, wenn der Warenkorb mehr wiegt. Standard: 20. GLS ParcelShops nehmen in der Regel Pakete bis 20 kg an. Prüfen Sie daher Ihren Vertrag mit GLS. Leer oder 0 bedeutet keine Grenze. Ist das Minimum größer als das Maximum, werden beide Gewichte mit einer Meldung abgelehnt, und die bisherigen Werte bleiben erhalten.

Minimum cart subtotal: bietet den Versanddienstleister nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuern) diesen Betrag erreicht. Lassen Sie das Feld leer, wenn es kein Minimum geben soll.

Ignore shipping zones: Ist die Option aktiviert, wird der Versanddienstleister allen Zonen zugeordnet, auch deaktivierten, und für die unten ausgewählten Länder angeboten, selbst wenn sie nicht in seinen Zonen liegen. Später angelegte Zonen werden ebenfalls zugeordnet. Wenn Sie die Option deaktivieren, erhält der Versanddienstleister die Zonen zurück, die er vorher hatte, und wird nur dort angeboten. Standard: deaktiviert.

Countries (ignore zones mode): die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder der GLS-Karte zu verwenden. Länder, die von der GLS-Karte nicht abgedeckt werden, werden übersprungen. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Advanced

Debug log: schreibt Tarifberechnungen und ParcelShop-Auswahlen in logs/vfd_glps_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert. Es werden keine personenbezogenen Daten der Kunden protokolliert. Schalten Sie das Protokoll aus, wenn Sie fertig sind.

Log: zeigt die Größe und die letzten Einträge des Debug-Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Remove data on uninstall: Ist die Option aktiviert, werden beim Deinstallieren des Moduls die Einstellungen, der Versanddienstleister und das Protokoll gelöscht. Ist sie deaktiviert, bleibt alles für eine erneute Installation erhalten. Der in Bestellungen gespeicherte ParcelShop bleibt immer erhalten.

So funktioniert es im Bestellvorgang

Wenn PrestaShop den Lieferschritt anzeigt, fragt es das Modul nach dem Preis für GLS ParcelShop. Nur physische Produkte zählen: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht in der Warenkorb-Zwischensumme enthalten. Das Modul prüft zuerst die Bedingungen: Das Zielland wird von der GLS-Karte abgedeckt (und ist unter Countries (ignore zones mode) ausgewählt, wenn dieser Modus aktiv ist), das Warenkorbgewicht und die Mindest-Zwischensumme des Warenkorbs. Erreicht die Warenkorb-Zwischensumme Free shipping from, ist die Lieferung kostenlos. Andernfalls wird der Preis aus der Zeile des Landes (oder der Zeile * Default) und der Gewichtsspalte entnommen oder aus Fallback cost. Wird kein Preis gefunden, wird der Versanddienstleister ausgeblendet.

Wählt der Kunde GLS ParcelShop, erscheint unter dem Versanddienstleister ein Feld GLS ParcelShop mit der Schaltfläche Select GLS ParcelShop. Sie öffnet die offizielle GLS-ParcelShop-Karte für das Zielland. Nach der Auswahl eines ParcelShops werden sein Name und seine Adresse angezeigt, und die Schaltfläche wechselt zu Change ParcelShop. Die Auswahl wird im Warenkorb gespeichert und bleibt daher erhalten, wenn der Lieferschritt aktualisiert wird oder die Seite neu geladen wird. Wenn die Lieferadresse in ein anderes Land geändert wird, muss der Kunde erneut einen ParcelShop wählen.

Klickt der Kunde im Lieferschritt auf Continue, prüft das Modul, ob ein ParcelShop gewählt wurde und ob er im Zielland liegt. Andernfalls sieht der Kunde Please select a GLS ParcelShop. oder The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. und bleibt im Lieferschritt. Kann der ParcelShop nicht gespeichert werden, sieht der Kunde The ParcelShop could not be saved. Please try again. Wenn das Skript der GLS-Karte nicht geladen werden kann, sieht der Kunde eine Meldung, dass er die Seite neu laden oder eine andere Versandart wählen soll.

Die GLS-Karte läuft im Browser des Kunden. Im Bestellvorgang lädt das Modul das Kartenskript von map.gls-croatia.com, und die Karte lädt die ParcelShop-Daten und Kartenkacheln von GLS. GLS erhält die üblichen Anfragedaten des Besuchers (IP-Adresse, Browser). Von Ihrem Server wird nichts an GLS gesendet.

Wenn Sie den Versanddienstleister unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul übernimmt die neue Version automatisch.

Das Modul ruft keine Live-Tarife von GLS ab, erstellt keine GLS-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Es führt keine Liste der ParcelShops auf Ihrem Server, daher kann es die ParcelShop-ID nicht gegen GLS prüfen. Übergeben Sie die ParcelShop-ID aus der Bestellung auf Ihrem üblichen Weg an GLS (MyGLS, Ihre GLS-Software oder ein anderes Modul).

Abholstellen

Bei der Bestellung wird der ParcelShop des Warenkorbs mit der Bestellung gespeichert: seine ID, sein Name mit der Adresse und sein Land. Er ändert sich danach nicht mehr mit dem Warenkorb.

Bestellseite im Admin-Bereich: Ein Block GLS ParcelShop zeigt Name und Adresse des ParcelShops mit der ParcelShop ID und dem Land. Hat eine GLS-ParcelShop-Bestellung keinen ParcelShop, zeigt der Block No ParcelShop was selected for this order.

Kundenseiten: Der ParcelShop wird auf der Bestellbestätigungsseite und auf der Bestelldetailseite im Kundenkonto angezeigt.

E-Mails: Der ParcelShop wird in der Bestellbestätigungs-E-Mail an den Kunden dem Namen des Versanddienstleisters hinzugefügt. Die E-Mail über eine neue Bestellung an den Händler (Modul Mail alerts) enthält ebenfalls die ParcelShop-ID.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox GLS ParcelShop ist der erste Block unter Modules > Module Manager > VibeFox GLS ParcelShop > Configure, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-shipping-gls-parcelshop und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shopadresse geändert hat oder nachdem Sie in Ihrem Konto einen Domainplatz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul weiter mit dem zuletzt bekannten Status.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einem Multistore-Setup. Wenn Sie den Schlüssel aus dem Shop entfernen, wird der Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird der Versanddienstleister GLS ParcelShop Kunden im Bestellvorgang nicht angezeigt, und es wird keine Rate berechnet. Das PrestaShop-Frontend weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Versanddienstleister auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber nicht im Bestellvorgang testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

GLS ParcelShop erscheint nicht im Bestellvorgang: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Landes des Kunden und die Kundengruppe abdeckt (oder aktivieren Sie Ignore shipping zones und prüfen Sie Countries (ignore zones mode)). Prüfen Sie, ob das Zielland eines der Länder der GLS-Karte ist und einen Preis hat (eine Länderzeile, die Zeile * Default oder Fallback cost). Prüfen Sie die Gewichtsgrenzen und die Minimum cart subtotal. Produkte können auf der Produktseite auch auf bestimmte Versanddienstleister beschränkt sein. Aktivieren Sie das Debug log und sehen Sie im Feld Log nach, woran es liegt.

Die Karte öffnet sich nicht: Der Kunde sieht "The GLS ParcelShop map could not be loaded...", wenn das GLS-Skript blockiert wird, zum Beispiel durch einen Werbe- oder Datenschutzblocker, eine Content Security Policy oder einen Ausfall bei GLS. Erlauben Sie map.gls-croatia.com in Ihrer Content Security Policy.

Die Lieferung ist für ein Land irrtümlich kostenlos: Prüfen Sie die Zeile dieses Landes unter Country prices. Eine Zeile, in der der Price und alle Gewichtsspalten 0 sind, ergibt kostenlose Lieferung.

Die Tabelle oder ein Feld wurde nicht gespeichert: Ein Wert ist keine gültige Zahl. Die Meldung oben auf der Seite nennt den Wert. Verwenden Sie Ziffern mit Komma oder Punkt als Dezimaltrennzeichen.

Die Seite meldet, dass der Versanddienstleister GLS ParcelShop nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager mit Reset zurück, damit er wieder angelegt wird. Reset behält den Status eines bestehenden Versanddienstleisters bei: Ein deaktivierter Versanddienstleister bleibt deaktiviert.

Eine Bestellung hat keinen ParcelShop, und das Protokoll meldet, dass der ParcelShop des Warenkorbs bereits in einer anderen Bestellung gespeichert ist: Aus einem Warenkorb wurden zwei Bestellungen. Die erste Bestellung behält den ParcelShop. Übergeben Sie die zweite Bestellung manuell an GLS.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox GLS ParcelShop und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt.Ist Remove data on uninstall aktiviert, wird der Versanddienstleister gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, das Protokoll sowie die ParcelShops von Warenkörben ohne Bestellung werden entfernt. Ist die Option deaktiviert, wird der Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Wenn Sie das Modul erneut installieren, erhält der gespeicherte Versanddienstleister seinen früheren Status zurück. Der in Bestellungen gespeicherte ParcelShop bleibt immer erhalten.

GLS ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit GLS verbunden noch wird es von GLS unterstützt.