VibeFox Mondial Relay for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x. Die Kasse funktioniert mit den Themes Classic und Hummingbird.

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

Mondial-Relay-Konto: Markencode (Enseigne) und Private Key erhalten Sie mit einem Geschäftskonto bei Mondial Relay: siehe den Bereich für Profis auf mondialrelay.fr, Ihren Kundenbereich „Connect“ oder Ihren Vertriebskontakt. Für die Kartenauswahl genügt der Markencode. Die Liste der nächstgelegenen Stationen benötigt beides. Für Tests stellt Mondial Relay den Markencode BDTEST13 mit dem Private Key PrivateK bereit.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel gilt für eine 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.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox Mondial Relay 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. Geben Sie Ihren Markencode (Enseigne) und für den Listenmodus den Private Key ein. Füllen Sie Country prices aus und klicken Sie auf Save.

Bei der Installation legt das Modul den Versanddienstleister Mondial Relay Point Relais mit dem Liefertext Delivery to a Mondial Relay Point Relais of your choice an. Der Versanddienstleister wird allen Kundengruppen und den Zonen von Frankreich, Belgien, Luxemburg, Spanien, Portugal und den Niederlanden zugewiesen. Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen 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 Mondial Relay > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern leert außerdem die zwischengespeicherten Listen der Abholpunkte.

Warnungen oben auf der Seite zeigen Probleme, die den Versanddienstleister ausblenden: ein fehlender Markencode, ein fehlender Private Key im Listenmodus, kein Preis für Frankreich, Belgien oder Spanien sowie ein gelöschter Versanddienstleister. Werte, die sich nicht speichern lassen, werden nach Save gemeldet: Ein Zahlenfeld mit einem Wert, der keine Zahl ist (oder negativ ist), behält seinen vorherigen Wert. Ein Name mit mehr als 64 Zeichen oder ein Min weight (kg), der größer als Max weight (kg) ist, wird abgelehnt, und es wird nichts gespeichert. Wenn die Gewichtseinheit des Shops nicht zu den vom Modul unterstützten gehört, weist eine Warnung darauf hin, dass Produktgewichte als kg angenommen werden.

Allgemein

Enable/Disable: schaltet Mondial Relay ein oder aus. Es ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Name: der Name des Versanddienstleisters, den Kunden an der Kasse sehen. Standard: Mondial Relay Point Relais. Pflichtfeld, bis zu 64 Zeichen.

Tax status: None bedeutet, dass die Preise in der Tabelle endgültig sind. Die Option Taxable mit dem Namen einer Steuerregel bedeutet, dass PrestaShop die Versandsteuer dieser Regel zu den Preisen addiert.

Mondial-Relay-Konto

Brand code (Enseigne): Pflichtfeld, bis zu 8 Buchstaben und Ziffern, zum Beispiel BDTEST13 für Tests. Wird von der Karte der Abholpunkte und vom Web Service verwendet. Ohne ihn können Kunden keinen Point Relais wählen, daher wird der Versanddienstleister an der Kasse nicht angezeigt.

Private Key: nur für die Auswahl List of nearest points erforderlich. Nach dem Speichern bleibt das Feld leer und zeigt Saved - leave empty to keep it. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten. Um den gespeicherten Schlüssel zu löschen, aktivieren Sie Remove the saved Private Key und klicken Sie auf Save. Wenn Markencode und Private Key eingetragen sind, wird die Verbindung zum Web Service von Mondial Relay bei jedem Speichern der Einstellungen getestet, und eine Meldung zeigt, ob sie gültig sind.

Auswahl des Abholpunkts

Selector: wie der Kunde einen Point Relais wählt.

Mondial Relay map (official widget, brand code only): der offizielle Mondial Relay Parcel Shop Picker, der erst geladen wird, wenn der Kunde ihn öffnet, von widget.mondialrelay.com. Dies ist der Standard.

List of nearest points (Web Service, needs the Private Key): ein Auswahlmenü mit den nächstgelegenen Stationen zur Lieferpostleitzahl, geladen von Ihrem Server. Schlägt der Web Service fehl, wird stattdessen die Karte angeboten.

Tarife (in der Standardwährung Ihres Shops, ohne Steuern)

Country prices: Preis nach Zielland und Paketgewicht. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Papierkorbsymbol, um eine zu entfernen. Wählen Sie * Default als Land für alle übrigen Länder. Jede Zeile hat eine Spalte Price sowie Gewichtsspalten: XS bis 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg und XL über 5 kg. Eine leere oder mit 0 belegte Gewichtsspalte verwendet die Spalte Price. Ist auch Price leer, ist die Lieferung für dieses Gewicht kostenlos. Füllen Sie daher Price aus, wenn Sie nur einige Gewichtsspalten verwenden. Dezimalstellen mit Punkt oder Komma (4.90 oder 4,90). Zeilen ohne Preis werden beim Speichern entfernt, und Werte, die keine Zahlen sind, werden gemeldet und leer gelassen.

Fallback cost: gilt für Länder ohne Zeile in der Tabelle. Lassen Sie das Feld leer, um den Versanddienstleister für diese Länder auszublenden.

Calculation type: wie der Preis berechnet wird.

Per order (weight of the whole parcel): ein Preis für den Warenkorb, wobei die Gewichtsspalte nach dem Gesamtgewicht des Warenkorbs gewählt wird. Dies ist der Standard.

Per item (each item priced by its own weight): jedes Produkt wird nach seinem eigenen Gewicht bepreist, mit seiner Menge multipliziert, und die Preise werden addiert.

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, ohne Steuern), ab der die Lieferung kostenlos ist. Leer lassen, wenn es keinen kostenlosen Versand gibt.

Verfügbarkeit

Min weight (kg): blendet den Versanddienstleister aus, wenn der Warenkorb leichter ist. 0 bedeutet kein Limit.

Max weight (kg): blendet den Versanddienstleister aus, wenn der Warenkorb schwerer ist. Mondial Relay nimmt Pakete bis 30 kg in Points Relais an. Standard: 30. 0 bedeutet kein Limit. Ein leeres Feld bedeutet 30 kg. Der Wert kann nicht niedriger sein als Min weight (kg).

Minimum subtotal: zeigt den Versanddienstleister nur, wenn die Zwischensumme des Warenkorbs (versandpflichtige Produkte, nach Rabatten, ohne Steuern) mindestens diesen Betrag erreicht. Leer lassen, um ihn immer anzuzeigen.

Ignore shipping zones: bietet den Versanddienstleister für die unten genannten Länder an, oder für alle unterstützten Länder, wenn die Liste leer ist, auch dort, wo die Versandzonen des Versanddienstleisters sie nicht enthalten. Solange die Option aktiviert ist, wird der Versanddienstleister mit jeder aktiven Zone verknüpft, auch mit Zonen, die Sie später anlegen. Wenn Sie sie ausschalten, erhält der Versanddienstleister die Zonen zurück, die er zuvor hatte.

Countries (ignore zones): die Zielländer für diesen Modus. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist. Die Liste enthält nur Länder mit Points Relais.

Erweitert

Debug log: schreibt Tarifberechnungen und Web-Service-Aufrufe in logs/vfd_mrel_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Schlüssel und Kundendaten werden nie protokolliert.

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

Remove data on uninstall: Wenn aktiviert, löscht die Deinstallation des Moduls die Einstellungen und den Versanddienstleister. Ist die Option aus, wird bei der Deinstallation nur der Versanddienstleister deaktiviert. Die in Bestellungen gespeicherten Abholpunkte bleiben erhalten.

So funktioniert es an der Kasse

Der Versanddienstleister wird nur für Länder mit Points Relais angeboten: Frankreich, Belgien, Luxemburg, Spanien, Portugal und die Niederlande. Er wird ausgeblendet, wenn Kunden keinen Point wählen könnten: ohne Markencode oder im Listenmodus ohne Private Key.

Im Versandschritt fragt PrestaShop das Modul nach dem Preis. Berücksichtigt werden nur physische Produkte: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft das Warenkorbgewicht und die Mindestzwischensumme. Der Preis stammt aus der Zeile des Landes (oder der Zeile *): die Gewichtsspalte, sonst Price. Ohne Zeile wird die Ersatzgebühr verwendet. Gibt es keinen Preis, wird der Versanddienstleister ausgeblendet. Erreicht die Zwischensumme Free shipping from, wird der Preis 0. Der Preis wird in Ihrer Standardwährung berechnet und danach in der Warenkorbwährung des Kunden angezeigt.

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 fragt keine Live-Tarife ab: Mondial Relay hat keine öffentliche Tarif-API. Es erstellt keine Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Erstellen Sie die Sendungen in Ihrem Mondial-Relay-Bereich „Connect“ mit der Point-Relais-Nummer, die in der Bestellung angezeigt wird. Die Lieferung nach Hause (Domicile) wird nicht angeboten.

Abholpunkte

Wenn der Kunde im Lieferschritt den Versanddienstleister Mondial Relay auswählt, erscheint darunter ein Feld Mondial Relay pickup point.

Kartenmodus: Die Schaltfläche Choose a Point Relais öffnet die offizielle Karte von Mondial Relay in einem Fenster für das Lieferland, die Postleitzahl und das Paketgewicht. Nachdem der Kunde einen Point ausgewählt hat, wird er als Selected: angezeigt, und die Schaltfläche wechselt zu Change Point Relais. Das Kartenwidget wird von widget.mondialrelay.com und seine Kartenbibliothek von unpkg.com erst geladen, wenn der Kunde die Karte öffnet. Erwähnen Sie dies in Ihrer Datenschutzerklärung.

Listenmodus: Ein Auswahlmenü - Choose a Point Relais - zeigt die 10 nächstgelegenen Stationen zur Lieferpostleitzahl mit ihrer Entfernung. Der gewählte Point wird mit seinen Öffnungszeiten angezeigt. Die Liste wird von Ihrem Server geladen, daher läuft im Browser kein Skript eines Drittanbieters. Listen werden 12 Stunden zwischengespeichert, eine leere Antwort 1 Stunde, und eine fehlgeschlagene Anfrage wird 5 Minuten lang gemerkt. Das Timeout des Web Service beträgt 10 Sekunden. Ohne Postleitzahl sieht der Kunde Enter your postcode to see the nearest pickup points. Wird kein Point gefunden oder ist die Liste nicht verfügbar, sieht der Kunde eine Meldung wie „Die Liste der Abholstationen ist im Moment nicht verfügbar. Bitte nutzen Sie die Karte.“, und es wird ihm die Karte angeboten.

Der gewählte Point wird sofort im Warenkorb gespeichert. Ein Point ist erforderlich. Ohne Point sieht der Kunde Please choose a Mondial Relay pickup point. und kann nicht zur Zahlung fortfahren. Ein Point in einem anderen Land als der Lieferadresse wird abgelehnt. Im Listenmodus wird der Point außerdem mit der Liste für die Adresse abgeglichen.

Wenn die Bestellung aufgegeben wird, bleibt der Point bei der Bestellung. Die Bestellseite im Back-Office zeigt den Block Mondial Relay pickup point mit Name, Adresse und Point Relais number (zum Beispiel FR-066974). Der Kunde sieht den Point auf der Bestellbestätigungsseite und in den Bestelldetails in seinem Konto. In der Bestellbestätigungs-E-Mail und in der E-Mail über neue Bestellungen des Moduls E-Mail-Benachrichtigungen wird der Point nach dem Namen des Versanddienstleisters ergänzt.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Mondial Relay ist der erste Block auf Modules > Module Manager > VibeFox Mondial Relay > Configure, oberhalb der Einstellungen. Fügen 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 gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-shipping-mondialrelay 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 richten sich nach 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 Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird der Versanddienstleister Mondial Relay Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Der PrestaShop-Storefront 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 an der Kasse testen. Eine Erinnerung erscheint in Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen bleiben unberührt.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber für Updates und Support ist eine Verlängerung nötig. Der Status wird automatisch erneut geprüft, während Sie im Back-Office arbeiten: an den ersten 14 Tagen nach der Eingabe des Schlüssels einmal täglich, 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

Mondial Relay erscheint nicht an der Kasse: 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 und die Kundengruppe des Kunden abdeckt, oder schalten Sie Ignore shipping zones ein. Prüfen Sie die Warnungen oben auf der Modulseite: Der Versanddienstleister wird ohne Markencode, im Listenmodus ohne Private Key, für ein Land ohne Preis, außerhalb der Gewichts- und Zwischensummengrenzen und für Länder ohne Points Relais ausgeblendet. Produkte können auf der Produktseite auch auf bestimmte Versanddienstleister beschränkt sein.

Test des Web Service nach dem Speichern fehlgeschlagen: Die Meldung zeigt den Fehler von Mondial Relay, zum Beispiel einen ungültigen Markencode oder einen ungültigen Sicherheitsschlüssel. Prüfen Sie Markencode und Private Key bei Mondial Relay.

Die Liste der Abholpunkte ist leer oder nicht verfügbar: Der Kunde braucht zuerst eine Lieferpostleitzahl. Schlägt der Web Service fehl, wird stattdessen die Karte angeboten. Aktivieren Sie Debug log, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Modulseite nach dem Grund.

Die Karte öffnet sich nicht: Die Karte wird von widget.mondialrelay.com und unpkg.com geladen. Prüfen Sie, ob ein Datenschutz- oder Skriptblocker sie nicht sperrt. Lässt sich die Karte nicht laden, sieht der Kunde: „Die Mondial-Relay-Karte konnte nicht geladen werden. Bitte versuchen Sie es später erneut oder wählen Sie eine andere Versandart.“

Die Bestellseite meldet No Point Relais was saved for this order: Die Bestellung wurde ohne Point des Lieferlands aufgegeben. Der Grund wird im Protokoll festgehalten. Bitten Sie den Kunden um den Point Relais, bevor Sie die Sendung erstellen.

Die Seite meldet, dass der Versanddienstleister Mondial Relay nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn erneut anzulegen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Mondial Relay und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Die zwischengespeicherten Listen der Abholpunkte 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 Points von Warenkörben ohne Bestellung werden entfernt. Ist die Option aus, wird der Versanddienstleister nur deaktiviert, und alle Einstellungen bleiben erhalten. Die erneute Installation des Moduls stellt den vorherigen Status des Versanddienstleisters wieder her. Die in Bestellungen gespeicherten Abholpunkte bleiben immer erhalten.

Mondial Relay ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit Mondial Relay verbunden und wird von Mondial Relay nicht unterstützt.