Wenn Sie an Kunden in Frankreich oder den Benelux-Ländern verkaufen, ist die Lieferung an Abholstellen kein nettes Extra in Ihrer Liste der Versanddienstleister, für einen großen Teil der Käufer in diesen Märkten ist sie die Standardmethode, mit der sie ein Paket erhalten möchten. Mondial Relay ist das führende Abholstellennetz in Frankreich, Belgien, Spanien, den Niederlanden, Luxemburg und Portugal. Das gesamte Versprechen hängt an einem einzigen Bildschirm: dem Karten-Widget, in dem Kunden das Geschäft, den Locker oder den Tabakladen auswählen, bei dem sie ihr Paket abholen. Genau dieses Widget ist auch der Punkt, an dem viele PrestaShop-Integrationen unbemerkt scheitern. Dieser Leitfaden erklärt gezielt, wie Sie Mondial Relay Abholstellen in der PrestaShop-Kasse zum Laufen bringen, Händlerkonto, Zuordnung der Versanddienste, Widget zur Auswahl der Abholstelle, Etiketten und die typische Stolperfalle mit der Tracking-URL. Wenn es erst einmal darum geht, den passenden Versanddienstleister-Mix zu wählen oder die allgemeinen Grundlagen von Versandmodulen zu verstehen, übernehmen die Cluster-Links unten diesen Teil, damit diese Seite bei ihrer einen Aufgabe bleiben kann.
Warum Abholstellen ein eigenes Integrationsproblem sind
"Livraison en point relais" bedeutet, dass das Paket nicht an die Haustür des Kunden geht, sondern an eine lokale Abholstelle, ein Geschäft, einen Tabakladen, ein Blumengeschäft oder einen automatisierten Locker. Zwei Folgen machen die Einbindung in PrestaShop grundsätzlich anders als bei einem klassischen Versanddienstleister für Hauszustellung wie Colissimo:
- Die Kasse braucht ein zusätzliches Datenelement. Ein normaler Versanddienstleister benötigt nichts außer der Lieferadresse. Ein Abholstellen-Versanddienstleister braucht die ID der ausgewählten Abholstelle, die in der Kasse erfasst und an der Bestellung gespeichert wird. Sonst haben Sie eine bezahlte Bestellung ohne Ziel. Diese eine Anforderung ist die Ursache der meisten "es funktioniert nicht"-Tickets.
- Der Kunde trifft seine Auswahl in einem Drittanbieter-Widget. Die Abholstellenkarte ist eine externe JavaScript-Komponente, die in Ihre Kasse eingebunden wird. Sie muss die Postleitzahl der Lieferadresse kennen, bevor sie Abholstellen anzeigen kann. Dadurch reagiert sie empfindlich darauf, wo Ihr Theme den Versand-Schritt im Verhältnis zum Adress-Schritt platziert.
Der geschäftliche Nutzen ist wirklich stark. Die Abgabe an einer Abholstelle kostet den Versanddienstleister weniger einzelne Stopps, deshalb liegen Abholstellen-Tarife spürbar unter den Tarifen für Hauszustellung, und die Schleife aus fehlgeschlagenen Zustellversuchen und "Wir haben Sie leider nicht angetroffen" entfällt vollständig. Die Einsparungen greifen aber nur, wenn das Widget konvertiert. Deshalb dreht sich der Großteil dieses Leitfadens um genau dieses Widget.
Vor der Installation: Mondial Relay-Konto und Servervoraussetzungen
In PrestaShop können Sie nichts konfigurieren, bevor Sie einen professionellen Mondial Relay-Vertrag haben, denn die API-Zugangsdaten stammen daraus:
- Händlervertrag auf mondialrelay.com. Sie erhalten eine Brand ID (Enseigne), einen 8-stelligen Code, sowie einen privaten Schlüssel zum Signieren von Anfragen und die API-Zugangsdaten.
- PHP-SOAP-Erweiterung. Die klassische API von Mondial Relay basiert auf SOAP. Prüfen Sie mit php -m, ob soap aufgelistet ist. Falls nicht, muss Ihr Hoster die Erweiterung aktivieren (typischerweise das Paket php-soap). Ohne sie wirft die Etikettenerstellung bei jeder Bestellung einen SOAP-Fehler.
- HTTPS. Das Abholstellen-Widget wird über HTTPS geladen, und moderne Browser blockieren gemischte Inhalte. Ein gültiges SSL-Zertifikat ist daher nicht verhandelbar. Was Sie bei jedem produktiven PrestaShop-Shop ohnehin haben sollten.
- Eine unterstützte PrestaShop-Version. Das offizielle Mondial Relay-Modul zielt auf aktuelle Versionen von 1.7.x und 8.x. Unter 1.6 arbeiten Sie mit einem älteren Modul-Build oder einem Drittanbieter-Versandmodul, prüfen Sie das, bevor Sie sich festlegen, denn der Widget-Code unterscheidet sich je nach Generation.
Modul installieren und konfigurieren
Mondial Relay veröffentlicht ein offizielles kostenloses Modul, das sowohl auf PrestaShop Addons (gelistet als "Mondial Relay Official") als auch im eigenen Händlerportal verfügbar ist. Laden Sie in beiden Fällen die ZIP-Datei herunter und laden Sie sie in Ihrem Backoffice über Module → Modul-Manager → Modul hochladen hoch. Öffnen Sie nach der Installation die Konfiguration und füllen Sie die Felder aus, die für die Lieferung an Abholstellen wirklich wichtig sind:
| Einstellung | Was es ist | Warum es Probleme macht, wenn es falsch ist |
|---|---|---|
| Brand ID / Enseigne | Ihr 8-stelliger Kontocode | Die API lehnt jeden Aufruf ab; nichts funktioniert |
| Privater Schlüssel | Signiert API-Anfragen | Authentifizierungsfehler beim Widget und bei Etiketten |
| Gewichtskoeffizient | Rechnet das PrestaShop-Gewicht in die Einheit um, die Mondial Relay erwartet | Prüfen Sie, welche Einheit das Feld erwartet, bevor Sie es anfassen: Die Versand-API von Mondial Relay erwartet häufig Gramm, während das Kataloggewicht in PrestaShop normalerweise Kilogramm ist, in diesem Fall lautet die Umrechnung 1000, nicht 0.001. Wenn Sie die Richtung falsch setzen, kehren Sie jedes Gewicht um und lösen Ablehnungen wegen "ungültigem Gewicht" aus |
| Angebotene Services | Die Abholstellen-, XL-Abholstellen-, Locker- und Heimzustellservices, die Ihr Vertrag freischaltet (einige Integrationen verwenden Codes wie 24R, 24L, 24X, HOM, diese variieren jedoch je nach Modul und API-Generation) | Jeder aktivierte Service wird zu einem PrestaShop-Versanddienst; schalten Sie nur die Services ein, die Ihr Modul und Ihr Vertrag tatsächlich bereitstellen und die Sie auch versenden |
| Widget-Sprache | FR / EN / NL / ES | Kosmetisch, aber eine rein französische Karte in einem englischen Shop wirkt defekt |
Der Gewichtskoeffizient ist die häufigste stille Fehlkonfiguration, der Versanddienstleister sieht in der Kasse korrekt aus, danach scheitern Bestellungen bei der Etikettenerstellung. Klären Sie die erwartete Einheit und die Umrechnungsrichtung am ersten Tag.
Die vom Modul angelegten Versanddienste prüfen
Während der Konfiguration erstellt das Modul automatisch PrestaShop-Versanddienste für jeden aktivierten Service. Lassen Sie sie nicht auf den Standardwerten stehen, öffnen Sie Versand → Versanddienste und prüfen Sie jeden einzelnen:
- Zonen. Aktivieren Sie einen Abholstellen-Versanddienst nur für Länder, die Mondial Relay tatsächlich bedient. Einem deutschen Kunden eine französische Abholstellenoption anzuzeigen, ist reines Rauschen in der Kasse. Dort ist ein anderes Netz relevant. Wenn Sie tatsächlich über einen Vertrag in mehrere Mondial Relay-Länder versenden, folgt die Mehrländer-Zonenlogik demselben Muster, das wir in der GLS-Integration für länderübergreifenden Versand behandeln.
- Gewichtsbereiche. Abholstellen akzeptieren technisch bis zu 30 kg, aber der Platz in den Regalen bedeutet praktisch eher eine Obergrenze von etwa 20 kg, setzen Sie den Gewichtsbereich des Versanddienstes so, dass übergroße Bestellungen keine Abholstelle angeboten bekommen, die das Paket später ablehnt.
- Preisbereiche. Hier entscheiden Sie, ob die Abholstellenlieferung ab einem Schwellenwert kostenlos oder als Pauschale berechnet wird. Das ist eine Preisstrategie-Entscheidung, keine Mondial Relay-Frage, die Abwägungen arbeiten wir in kostenlosem Versand vs. Pauschale vs. berechnetem Versand und wann kostenloser Versand Ihre Marge auffrisst durch.
Wenn Versanddienste und Zonen für Sie noch Neuland sind, beginnen Sie mit den Plattformgrundlagen in Versandmodule in PrestaShop einrichten und dem umfassenderen Leitfaden zur Versandkonfiguration, diese Seite setzt voraus, dass Sie wissen, wo sich die Versanddiensteseite befindet.
Das Widget zur Auswahl der Abholstelle, der Teil, an dem alles steht oder fällt
Wenn ein Kunde einen Mondial Relay-Versanddienst auswählt, bindet das Modul ein JavaScript-Widget ein, das eine Karte nahegelegener Abholstellen rund um die Postleitzahl der Lieferadresse rendert. Kunden filtern nach Typ (Geschäft, Locker, Postfiliale), Öffnungszeiten oder Entfernung und wählen dann mit einem Klick eine Abholstelle aus. Entscheidend ist, dass diese Auswahl als Abholstellen-ID zurück in das Kassenformular fließt und an der Bestellung gespeichert bleibt. Die gesamte Integration gelingt oder scheitert an dieser Stelle. Deshalb lohnt es sich, die Fehlerbilder zu kennen, bevor sie beim Kunden landen.
Widget erscheint nicht
Fast immer ein JavaScript-Konflikt. Öffnen Sie die Browser-Konsole auf der Kassenseite. Die üblichen Verdächtigen: eine jQuery-Version, die das Widget nicht unterstützt, ein Content-Security-Policy-Header, der die externen Skripte des Widgets blockiert, oder ein Theme, das Skripte asynchron lädt, sodass das Widget initialisiert wird, bevor seine Abhängigkeit vorhanden ist. Die Lösung ist die Ladereihenfolge. Die Abhängigkeiten des Widgets müssen vorhanden sein, bevor es läuft.
Kartenbereich bleibt leer
Die Kartenkacheln hängen von einem Schlüssel des Kartenanbieters ab. Wenn das Panel gerendert wird, aber leer bleibt, fehlt der konfigurierte Schlüssel, ist abgelaufen oder hat nicht die richtige API aktiviert (und Googles Maps JavaScript API verlangt inzwischen, dass die Abrechnung auch innerhalb des kostenlosen Nutzungskontingents aktiviert ist). Tragen Sie in der Modulkonfiguration einen gültigen Schlüssel erneut ein.
Keine Abholstellen für eine gültige Adresse
Die API liefert Abholstellen innerhalb eines Radius um die übermittelte Postleitzahl. Eine falsch formatierte oder nicht existierende Postleitzahl liefert null Ergebnisse, was für den Kunden wie "Sie liefern nicht hierhin" aussieht. Validieren Sie das Postleitzahlenfeld in Ihrem Adressformular, damit ein Tippfehler sofort auffällt, statt die Karte still zu leeren.
Widget erscheint an der falschen Stelle, oder die ausgewählte Abholstelle wird nicht gespeichert
Das Widget muss die Lieferadresse kennen, bevor es Abholstellen anzeigen kann. Die standardmäßige schrittweise PrestaShop-Kasse erledigt das in der richtigen Reihenfolge. Wenn Sie jedoch eine One-Page-Kasse verwenden, stehen Versanddienst und Adresse gleichzeitig auf dem Bildschirm, und das Hook-Timing kann das Widget auslösen, bevor die Adresse feststeht, oder die ausgewählte Abholstellen-ID schafft es nie in das abgeschickte Formular. Die Lösung ist fast immer das Hook-Timing, nicht Template-Chirurgie: Der Widget-Hook muss nach der Erfassung der Adresse laufen und die Abholstellen-ID in die Bestellung schreiben. Das ist die häufigste Kollision, die wir zwischen Abholstellen-Widgets und individuellen Kassen sehen. Wenn Sie einen One-Page-Ablauf einsetzen, ist genau diese Wechselwirkung die Art von Kompatibilitätsdetail, für die unsere Arbeit an der Kasse bei mypresta.rocks gemacht ist: damit ein Abholstellen-Widget seine ID auch nach jedem Theme- und PrestaShop-Update zuverlässig schreibt, statt sie still zu verlieren.
Etiketten erstellen
Sobald eine Bestellung mit einem Abholstellen-Versanddienst eingeht, erstellen Sie das Versandetikett. Das Modul bietet Ihnen je nach Volumen zwei Wege:
- In PrestaShop, pro Bestellung. Auf der Bestelldetailseite erstellt ein Mondial Relay-Tab ein Etikett direkt über die API und liefert ein PDF zurück. Das reicht für geringe tägliche Mengen, bei denen Sie Bestellungen einzeln abarbeiten.
- Mondial Relay Connect, in Stapeln. Bei höherem Volumen importiert Connect (connect.mondialrelay.com) Bestellungen gesammelt, erstellt Etiketten stapelweise und plant Abholungen. Das Modul kann Bestelldaten in einem Connect-kompatiblen Format exportieren.
Zu den Etikettenformaten gehören A4 (eins pro Seite), A5 (zwei pro Seite) und 10×15 cm für Thermodrucker. Wenn Sie einen Thermodrucker wie einen Zebra GK420d verwenden, wählen Sie das Format 10×15 cm, damit Sie kein A4 schneiden und verschwenden.
Die Stolperfalle mit der Tracking-URL
Mondial Relay vergibt eine Sendungsnummer, und das Modul sollte sie in der Bestellung speichern und den Status auf "Versendet" setzen, wenn das Etikett erstellt wird. Der häufige Fehler liegt in der Sendungsverfolgungs-URL am Versanddienst selbst. Sie ist oft nicht korrekt gesetzt, sodass der Link "Paket verfolgen" des Kunden ins Leere läuft. Prüfen Sie sie manuell: Versand → Versanddienste, bearbeiten Sie den Mondial Relay-Versanddienst und setzen Sie die Sendungsverfolgungs-URL auf die Mondial Relay-Seite zur Sendungsverfolgung (suivi de colis), wobei @ als Platzhalter dient, den PrestaShop durch die echte Nummer ersetzt. Ein funktionierender Link zur Sendungsverfolgung ist der günstigste Weg, "Wo ist meine Bestellung?"-E-Mails zu reduzieren, das umfassendere Vorgehen dazu finden Sie in Sendungsnummern und Lieferbenachrichtigungen.
Abholstelle vs. Hauszustellung: die Wahl für Kunden richtig darstellen
Der Grund, Abholstellen anzubieten, liegt nicht nur in Ihren Kosten, ein relevanter Teil der Käufer in Frankreich und den Benelux-Ländern bevorzugt diese Zustellart aktiv. Wenn Sie sie gut darstellen, steigt der Anteil der Kunden, die sich selbst für die günstigere Option entscheiden. Wir nennen hier bewusst keine exakte Marktanteilszahl, weil belastbare Werte von Jahr zu Jahr schwanken und je nach Land unterschiedlich sind. Behandeln Sie Abholstellen in diesen Märkten als wirklich etablierte Wahl, nicht als Randoption, und messen Sie Ihr eigenes Verhältnis von Abholstellen- zu Hauszustellungen, sobald es live ist.
| Dimension | Abholstelle | Hauszustellung |
|---|---|---|
| Kosten des Versanddienstleisters | Niedriger, gebündelte Zustellungen | Höher, einzelne Stopps |
| Risiko fehlgeschlagener Zustellung | Keines, Kunde holt ab | "Nicht angetroffen"-Karten, erneute Zustellung |
| Zusätzliche Kassendaten | Abholstellen-ID erforderlich | Nur Adresse |
| Aufwand für den Kunden | Fährt zur Abholung | Erhält die Lieferung an der Tür |
| Am besten geeignet für | Käufer in FR/Benelux, die Abholung bevorzugen; kostensensible Bestellungen | Sperrige Artikel; Kunden, die Lieferung bis zur Haustür wünschen |
Bieten Sie beides an, zeigen Sie den Preisunterschied im Versanddienst-Schritt klar an und lassen Sie den Kunden wählen, die Nutzung der Abholstellen regelt sich von selbst, wenn sie sichtbar günstiger ist. Wenn Sie stärker anstoßen möchten: Nehmen Sie Name, Adresse und Öffnungszeiten der gewählten Abholstelle in die Bestellbestätigungs-E-Mail auf (Menschen vergessen, welche Stelle sie gewählt haben), und denken Sie daran, dass Mondial Relay ein Paket nur für ein begrenztes Zeitfenster bereithält. Eine Erinnerung einige Tage vor Ablauf dieser Frist verhindert Rücksendungen an den Absender. Wenn Abholstellen mitbestimmen, wie schnell Kunden ihre Bestellung realistisch erhalten können, gehört das zur größeren Frage, die wir in der Versandstrategie für kleine Shops behandeln.
Retouren über Abholstellen
Abholstellen nehmen auch Retouren an: Der Kunde gibt das Paket an einer beliebigen Stelle ab, und es wird zurück in Ihr Lager geleitet, deutlich günstiger, als eine Abholung zu Hause zu organisieren. Der Haken in PrestaShop: Das Modul erstellt Rücksendeetiketten nicht nativ. Der praktische Ablauf besteht darin, das Rücksendeetikett auf der Connect-Plattform zu erstellen, wenn ein Kunde eine RMA anfragt, das PDF herunterzuladen und es an die E-Mail zur Retourenfreigabe anzuhängen, damit der Kunde es ausdruckt, aufklebt und bei einer beliebigen Abholstelle abgibt.
Schnelle Fehlerbehebung
- "SOAP error" bei der Etikettenerstellung: Die PHP-SOAP-Erweiterung fehlt, oder die API ist vorübergehend nicht erreichbar. Prüfen Sie, ob die Erweiterung geladen ist, und versuchen Sie es erneut.
- "Invalid weight": Gramm-Kilogramm-Verwechslung, prüfen Sie, welche Einheit das Feld erwartet und in welche Richtung umgerechnet wird. Wenn PrestaShop-Gewichte in kg vorliegen und Mondial Relay Gramm erwartet, lautet der Koeffizient 1000.
- Versanddienst fehlt in der Kasse: Prüfen Sie, ob er aktiviert, den richtigen Zonen zugewiesen ist und ob das Bestellgewicht innerhalb des Gewichtsbereichs des Versanddienstes liegt.
- Abholstelle wird nicht an der Bestellung gespeichert: Das Widget übergibt die ausgewählte Abholstellen-ID nicht in das Kassenformular, ein JavaScript-/Hook-Timing-Problem, kein Datenproblem.
- Etikett zeigt den falschen Absender: Die Absenderadresse stammt aus Ihrem Mondial Relay-Vertrag, nicht aus PrestaShop, korrigieren Sie sie im Händlerportal.
Häufig gestellte Fragen
Was brauche ich, bevor ich das Modul konfigurieren kann?
Einen professionellen Mondial Relay-Vertrag, der Ihnen Ihre Brand ID (Enseigne), einen 8-stelligen Code, und einen privaten Schlüssel zum Signieren von API-Anfragen liefert. Außerdem muss die PHP-SOAP-Erweiterung aktiviert sein (prüfen Sie das mit php -m), weil die klassische API SOAP-basiert ist, sowie HTTPS im Shop, damit das Abholstellen-Widget nicht als gemischter Inhalt blockiert wird.
Der Gewichtskoeffizient macht meine Etiketten immer wieder kaputt. Welcher Wert ist richtig?
Prüfen Sie, welche Einheit das Feld erwartet, bevor Sie es ändern. Die Versand-API von Mondial Relay erwartet häufig Gramm, während das Kataloggewicht in PrestaShop normalerweise Kilogramm ist. In diesem Fall lautet die Umrechnung 1000, nicht 0.001. Wenn Sie die Richtung falsch setzen, wird jedes Gewicht umgekehrt, und bei der Etikettenerstellung entstehen Ablehnungen wegen "invalid weight", obwohl in der Kasse alles korrekt aussah.
Das Abholstellen-Widget erscheint nicht in der Kasse. Wo suche ich?
Öffnen Sie zuerst die Browser-Konsole. Fast immer ist es ein JavaScript-Problem: eine nicht unterstützte jQuery-Version, ein Content-Security-Policy-Header, der die externen Skripte des Widgets blockiert, oder ein Theme, das Skripte asynchron lädt, sodass das Widget vor seiner Abhängigkeit läuft. Die Lösung ist die Ladereihenfolge, nicht Template-Chirurgie. Die Abhängigkeiten müssen vorhanden sein, bevor das Widget initialisiert wird.
Der Kunde hat eine Abholstelle gewählt, aber in der Bestellung ist keine gespeichert. Warum?
Die ausgewählte Abholstellen-ID gelangt nicht vom Widget in das abgeschickte Kassenformular. In der standardmäßigen schrittweisen Kasse wird die Adresse vor dem Versanddienst-Schritt erfasst, deshalb funktioniert es dort. In einer One-Page-Kasse kann der Hook auslösen, bevor die Adresse feststeht. Es ist ein Hook-Timing-Problem. Der Widget-Hook muss nach der Erfassung der Adresse laufen und die Abholstellen-ID an die Bestellung schreiben.
Welche Sendungsverfolgungs-URL sollte der Mondial Relay-Versanddienst verwenden?
Setzen Sie sie manuell unter Versand → Versanddienste, indem Sie den Mondial Relay-Versanddienst bearbeiten und die Sendungsverfolgungs-URL auf die Mondial Relay-Seite zur Sendungsverfolgung (suivi de colis) setzen, mit @ als Platzhalter, den PrestaShop durch die echte Nummer ersetzt. Dieses Feld bleibt am häufigsten falsch, wodurch der Link "Paket verfolgen" des Kunden ins Leere führt.
Wo Mondial Relay in Ihren Versanddienstleister-Mix passt
Für einen auf Frankreich oder die Benelux-Länder ausgerichteten Shop gehört die Lieferung an Abholstellen zu den Versandoptionen mit dem größten Hebel: Sie senkt die Kosten pro Paket, beseitigt fehlgeschlagene Zustellungen und entspricht der Art, wie diese Kunden ihre Bestellungen tatsächlich abholen möchten. Die Einrichtung ist Arbeit für einen Nachmittag, und der Teil, der sich bezahlt macht, ist ein sauber funktionierendes Auswahl-Widget samt Abholstellen-ID, die zuverlässig durch die Kasse fließt. Wenn Sie zusätzlich Kunden bedienen, die neben Abholstellen einen nationalen Haustür-Versanddienstleister wünschen, kombinieren Sie Mondial Relay in Frankreich mit Colissimo oder für eine größere europäische Reichweite mit DHL, DPD und UPS. Und wenn Polen auf Ihrer Karte steht, ist das dortige unverzichtbare Pendant für Abholungen InPost Paczkomaty, gleiche Abholstellenlogik, anderes Land, dieselbe Sorgfalt beim Kassen-Widget.