easybox-Sameday-Integration im Shopify-Checkout: So bauen Sie die Paketstation-Karte ein

Sie möchten, dass Ihr Kunde am Ende der Bestellung eine Karte öffnet, die nächste easybox-Sameday-Paketstation sucht und sie mit einem Klick auswählt. Bei WooCommerce ist das fast trivial. Bei Shopify liegen die Dinge anders: Die Checkout-Seite ist deutlich geschlossener, und wer versucht, einfach Kartencode hineinzuinjizieren, stößt gegen eine Wand.

Die gute Nachricht: Es geht – hängt aber von Ihrem Shopify-Plan ab und vor allem davon, wo Sie die Karte platzieren. In diesem Leitfaden zeige ich Ihnen die drei realen Varianten, wie die Sameday-Paketstationskarte funktioniert und – der Teil, den viele vergessen – wie die vom Kunden gewählte Station tatsächlich auf dem Frachtbrief landet. Ohne Versprechen von „perfektem Plug-and-Play“.

Warum sich der Shopify-Checkout anders verhält als WooCommerce

Hier liegt der Kern des Problems. Die alte Datei checkout.liquid, in die man beliebigen Code einfügen konnte, wurde abgeschafft. In den Standard-Shopify-Plänen ist die native Checkout-Seite praktisch abgeriegelt: Sie können dort kein JavaScript oder eine Karte frei injizieren.

Der einzige Weg, echte Komponenten direkt in die Checkout-Seite einzubauen, sind Checkout UI Extensions – und die sind nur bei Shopify Plus verfügbar. Die Seiten Thank You und Order Status akzeptieren Extensions auf allen Plänen, aber dort ist es bereits zu spät: Der Kunde hat schon bezahlt und wählt keine Versandmethode mehr.

Die praktische Schlussfolgerung: Für die meisten Shops, die nicht auf Plus sind, gehört die Paketstationskarte NICHT in die native Checkout-Seite. Sie gehört davor oder in eine dedizierte App.

Die drei tatsächlichen Orte für die Karte

Es gibt drei Ansätze, die in der Praxis wirklich funktionieren:

• Auf der Warenkorb- oder Produktseite (am häufigsten genutzt): ein Karten-Widget, mit dem der Kunde die easybox auswählt, bevor er den Checkout betritt. Funktioniert auf jedem Shopify-Plan.
• In der Checkout-Seite, aber nur bei Shopify Plus: eine Checkout UI Extension, die einen Button „easybox auswählen“ anzeigt und die Karte in einem Modal öffnet.
• Über eine App aus dem App Store, die die easybox als Abholpunkt (Pickup Point) hinzufügt und dabei den nativen Shopify-Mechanismus für Pickup Points nutzt.

Für einen Shop, der nicht auf Plus läuft, ist die ehrliche Empfehlung die Warenkorb-Variante: Der Kunde wählt die Station, und Sie blockieren den weiteren Weg zum Checkout, bis die Auswahl getroffen ist. Das ist die robusteste und am günstigsten zu wartende Lösung.

Wie die Sameday-Karte aussieht und woher die Stationen kommen

Sameday stellt sowohl ein Widget/Plugin mit interaktiver Karte als auch eine eigene API zur Verfügung (dieselbe, die zur Erstellung des Frachtbriefs verwendet wird). Sie haben zwei Wege: das fertige Widget nutzen oder eine eigene Karte bauen.

Wenn Sie den individuellen Weg gehen, sind die Schritte:

• Authentifizierung per Token: Sie erhalten die API-Zugangsdaten aus Ihrem Kurierkonto und fordern ein Token an.
• Sie fragen die Liste der easybox-Stationen beim Geolokations-Endpunkt ab. Jede Station kommt mit ID, Name, Adresse, Stadt und Koordinaten.
• Sie platzieren die Punkte auf einer Karte (Leaflet oder Google Maps) oder überlassen dies dem Sameday-Widget.

Zwei wichtige Details: Achten Sie darauf, auch die Next-Gen-Stationen (die neuen) mitzunehmen, und cachen Sie die Liste – sie ändert sich selten, es macht also keinen Sinn, sie bei jedem Seitenaufruf neu abzufragen.

Der Teil, den viele vergessen: die Station zum Frachtbrief bringen

Die Karte ist nur die halbe Arbeit. Wenn die vom Kunden gewählte Station nicht beim Kurier ankommt, haben Sie ein schönes, aber nutzloses Widget gebaut.

Der Mechanismus bei Shopify:

• Wenn der Kunde die Station wählt, speichern Sie deren ID, Namen und Adresse.
• Auf der Warenkorbseite speichern Sie diese als Cart-Attribute über den Aufruf /cart/update.js (zum Beispiel easybox_id, easybox_name) oder als Line-Item-Property.
• So erscheinen sie auf der Bestellung und Sie sehen sie im Admin bei jeder Order.
• Beim Versand sendet die Frachtbrief-Erstellung von Sameday den Stationscode als Zustellpunkt für den easybox-Dienst.

Die Kurier-Konnektoren für Rumänien – Innoship, EasySales, ShippyPro und andere – lesen dieses Attribut automatisch aus und erstellen den Frachtbrief. Ohne diesen Schritt bleibt die gewählte Station nur Text auf der Bestellung und sagt dem Kurier gar nichts.

Fertige App vs. individuelle Lösung

Es gibt keine einzig richtige Antwort – es hängt vom Shop ab.

• App aus dem App Store: Sie starten schnell, zahlen ein monatliches Abo, haben aber weniger Kontrolle über das Kartendesign und binden sich an einen Anbieter.
• Individuelle Lösung (Widget + API): volle Kontrolle, perfekt in Ihr Branding integriert, erfordert aber Entwicklung und Wartung (Token, API-Updates, Synchronisation der Stationen).

Für viele Shops ist die gewinnende Kombination einfach: eine rumänische Kurier-App (Innoship oder EasySales) für den Frachtbrief, plus ein Paketstationen-Widget auf der Warenkorbseite. Seien Sie skeptisch gegenüber jedem Versprechen von „installiert sich in fünf Minuten und läuft perfekt“ – testen Sie immer mit echten Bestellungen, bevor Sie es Kunden zugänglich machen.

Bei MPO Web Studio bauen wir genau diese Art von Integration, remote, für Shops im ganzen Land. Wir können Ihnen gerne eine kostenlose Demo direkt auf Ihrem Workflow vorbereiten, damit Sie die Karte in Aktion sehen, bevor Sie sich entscheiden. Eine Nachricht auf WhatsApp genügt, und wir klären das.