VibeFox Sameday Easybox for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

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

Sameday API-Benutzername und Passwort: Der API-Zugang ist Teil eines Sameday-Geschäftskontos in Rumänien, Ungarn oder Bulgarien. Fragen Sie Ihren Sameday-Kundenbetreuer oder das Sameday-Integrationsteam. Die Zugangsdaten sind oft dieselben wie für das eAWB-Portal (eawb.sameday.ro, .hu oder .bg). Für die Demo-API stellt Sameday separate Testzugangsdaten bereit. Ohne API-Benutzername und Passwort wird der Transporteur nicht angeboten, weil der Kunde keinen Locker auswählen könnte.

Kreise im Adressformular: Die Sameday-Schätzung benötigt den Kreis der Lieferadresse. PrestaShop hat standardmäßig keine Kreise für Rumänien, Ungarn und Bulgarien. Das Modul kann sie für Sie hinzufügen (siehe Abschnitt Lockers easybox weiter unten). Ohne sie stammen die Preise aus Ihrer Tabelle oder aus den Ersatzkosten.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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 aus.

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

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

4. Geben Sie Ihren Sameday-API username und Ihr API password ein, wählen Sie das Sameday country und klicken Sie auf Save. Die Seite sollte „Mit Sameday verbunden ... Lockers easybox“ anzeigen. Pickup point und Easybox service werden aus Ihrem Konto ausgefüllt.

5. Legen Sie Ihre Preise fest: Exchange rate of the estimate, wenn die Währung Ihres Shops von der Sameday-Währung abweicht, sowie eine Zeile Country prices (zum Beispiel * Default) oder ein Fallback cost.

6. Wenn die Seite meldet, dass der Shop keine Kreise für Ihr Sameday-Land hat, klicken Sie im Abschnitt Lockers easybox auf Add counties.

Bei der Installation legt das Modul den Transporteur Sameday easybox mit dem Lieferzeittext Delivery to a Sameday easybox locker an. Er ist allen Kundengruppen und der Zone Rumänien zugeordnet. Zonen, Kundengruppen, Lieferzeit und Logo können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer vom Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Seite Configure des Moduls, in sechs Abschnitten. Die Schaltfläche Save eines Abschnitts speichert die gesamte Seite.

Oberhalb der Einstellungen zeigt die Seite den Verbindungsstatus: den Sameday-Host, die Anzahl der easybox-Locker und wann die Liste aktualisiert wurde, oder dass Sameday Benutzername oder Passwort abgelehnt hat. Außerdem listet sie Konfigurationsprobleme auf, zum Beispiel fehlende Zugangsdaten, keinen Preis, keinen Wechselkurs für die Schätzung, keine Kreise, eine dem Modul unbekannte Gewichtseinheit des Shops oder dass der Transporteur nicht gefunden wurde.

Alle Preise und Grenzwerte akzeptieren ein Komma oder einen Punkt als Dezimaltrennzeichen (4,99 oder 4.99). Eine ungültige oder negative Zahl wird nicht gespeichert: Eine Warnung nennt das Feld, und der bisherige Wert bleibt erhalten.

Allgemein

Enable/Disable: schaltet den Transporteur ein oder aus. Das entspricht dem Status des Transporteurs unter Shipping > Carriers.

Name: der Name der Versandart, den der Kunde sieht (der Transporteurname). Standard: Sameday easybox.

Tax status: None bedeutet, dass der Preis endgültig ist. Taxable mit einer Steuerregel lässt PrestaShop die Versandsteuer auf den Preis aufschlagen.

Sameday-Konto (API)

Beim Speichern meldet sich das Modul bei Sameday an und lädt Ihre Dienste, Abholpunkte und die Liste der easybox-Locker. Die Liste wird täglich aktualisiert.

API username: Ihr Sameday-API-Benutzername.

API password: Ihr Sameday-API-Passwort. Es wird nie wieder angezeigt: Lassen Sie das Feld leer, um das gespeicherte beizubehalten. Wird der Benutzername geleert, wird auch das Passwort entfernt. Lehnt Sameday es ab, wird es 10 Minuten lang nicht erneut versucht.

Sameday country: das Land Ihres Sameday-Kontos: Romania (api.sameday.ro) (Standard), Hungary (api.sameday.hu) oder Bulgaria (api.sameday.bg). Dessen Locker werden angeboten, und der Transporteur wird nur für dieses Zielland angezeigt. Wenn Sie das Land ändern, wird der Transporteur auch der Zone des neuen Landes zugeordnet.

Test mode: verwendet die Sameday-Demo-API (sameday-api.demo.zitec.com) mit Demo-Zugangsdaten.

Preise

Die Reihenfolge der Anwendung lautet: zuerst die Sameday-Schätzung (wenn Pickup point und Easybox service festgelegt sind), dann die Preistabelle nach Land, dann die Ersatzkosten. Tabellenpreise geben Sie in der Standardwährung des Shops ein. Kunden, die in einer anderen Währung zahlen, sehen den umgerechneten Preis.

Pickup point: Ihr Sameday-Abholpunkt, an dem Sameday die Pakete abholt. Nach erfolgreicher Anmeldung ist es eine Liste der Abholpunkte Ihres Kontos, und der Standard wird automatisch gewählt. Wird für die Sameday-Schätzung benötigt. Wählen Sie - not set (price table only) -, um nur die Preistabelle zu verwenden.

Easybox service: der Sameday-Dienst für die Easybox-Zustellung, meist „Locker NextDay“ (Code LN), der automatisch gewählt wird. Wird für die Sameday-Schätzung benötigt.

Exchange rate of the estimate: Sameday berechnet die Schätzung in der Währung Ihres Sameday-Landes: RON, HUF oder BGN (EUR für bulgarische Shops, die in Euro verkaufen). Wenn Ihr Shop in einer anderen Währung verkauft, geben Sie den Wert von 1 Einheit der Sameday-Währung in Ihrer Shopwährung ein, zum Beispiel 0.20. Der Kurs muss über 0 liegen. Ohne ihn wird die Schätzung nicht verwendet und die Preistabelle gilt. Lew und Euro werden automatisch zum festen Kurs umgerechnet.

Table price: Per order berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl der Artikel. Dies gilt für den Tabellenpreis und die Ersatzkosten. Die Sameday-Schätzung gilt immer für das ganze Paket.

Country prices: ein Preis je Zielland und Paketgewicht. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Papierkorb-Symbol, um eine zu entfernen. Jede Zeile hat eine Spalte Price und Gewichtsspalten: XS bis 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg und XL über 5 kg. Eine Gewichtsspalte mit 0 verwendet die Spalte Price. Die Zeile * Default gilt für Länder ohne eigene Zeile. Eine neue Zeile beginnt als * Default mit allen Preisen auf 0, was kostenlosen Versand bedeutet. Wählen Sie das Land und geben Sie die Preise ein, bevor Sie speichern, oder entfernen Sie die Zeile. Steht dasselbe Land in zwei Zeilen, bleibt beim Speichern nur die erste erhalten, und eine Warnung weist darauf hin. Ist eine Zelle keine gültige Zahl, wird die Tabelle nicht gespeichert.

Fallback cost: wird verwendet, wenn es keine Sameday-Schätzung gibt und die Länder-Tabelle keine Zeile für das Ziel hat. Lassen Sie das Feld leer, um den Transporteur in diesem Fall nicht anzubieten.

Free shipping from: die Warenkorb-Zwischensumme (Produkte, die einen Versand benötigen, nach Rabatten, ohne Steuer), ab der die easybox-Lieferung kostenlos ist. Wird sie erreicht, wird der Transporteur kostenlos angeboten, und es wird kein Preis abgefragt. Lassen Sie das Feld leer, um nie kostenlosen Versand anzubieten.

Verfügbarkeit

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

Maximum weight (kg): Pakete, die schwerer sind, erhalten keine easybox-Lieferung. Standard: 30. Prüfen Sie die Grenze Ihres Sameday-Vertrags und die easybox-Fachgrößen. Leer oder 0 bedeutet keine Grenze. Ein Mindestgewicht über dem Höchstgewicht wird nicht gespeichert: Eine Warnung weist darauf hin, und die bisherigen Werte bleiben erhalten.

Minimum cart subtotal: bietet den Transporteur nur an, wenn die Warenkorb-Zwischensumme (Produkte, die einen Versand benötigen, nach Rabatten, ohne Steuer) diesen Betrag erreicht.

Ignore shipping zones: Ist die Option aktiv, wird der Transporteur für die unten gewählten Länder angeboten (das Sameday-Land, wenn die Liste leer ist), auch wenn deren Zone nicht für den Transporteur eingerichtet ist. Der Transporteur wird dann jeder aktiven Zone zugeordnet, auch später angelegten Zonen. Wenn Sie die Option wieder ausschalten, erhält der Transporteur die Zonen zurück, die er vorher hatte. Ist sie aus, wird der Transporteur nur in seinen Zonen unter Shipping > Carriers angeboten.

Countries (ignore zones mode): die Zielländer für diesen Modus. Andere Länder als das Sameday-Land werden übersprungen, und die Seite warnt davor. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiv ist.

Lockers easybox

Locker list: zeigt, wie viele easybox-Locker in wie vielen Städten geladen sind und seit wann. Refresh the locker list now lädt sie erneut. Die Liste wird beim Speichern der Einstellungen aktualisiert und, sobald sie älter als einen Tag ist, nach einer Kassenanfrage. Für eine feste tägliche Aktualisierung rufen Sie die hier angezeigte Cron URL einmal täglich über einen Cron-Job Ihres Servers auf. Die URL enthält ein geheimes Token. Ohne das Token antwortet sie mit einem Fehler und kontaktiert Sameday nicht.

Counties: die Sameday-Schätzung benötigt den Kreis der Adresse. Wenn PrestaShop für Ihr Sameday-Land keine Kreise (States) hat, klicken Sie auf Add counties. Das Modul fügt die Kreise von Rumänien, Ungarn oder Bulgarien und das Kreisfeld dem Adressformular dieses Landes hinzu. Bereits vorhandene Kreise werden nicht doppelt angelegt. Sind sie eingerichtet, zeigt die Seite ihre Anzahl an.

Erweitert

Debug log: schreibt Tarifberechnungen, API-Aufrufe und Locker-Auswahlen in die Datei logs/vfd_sdeb_debug.log.php im Modulordner, die aus dem Web nicht lesbar ist. API-Fehler werden immer protokolliert. Kein Passwort, Token oder personenbezogene Kundendaten werden protokolliert. Das Feld Log unten zeigt das Ende der Datei mit einer Schaltfläche Clear log. Schalten Sie das Protokoll aus, wenn Sie fertig sind.

Remove data on uninstall: Ist die Option aktiv, löscht die Deinstallation des Moduls die Einstellungen und den Transporteur. Ohne sie schaltet die Deinstallation nur den Transporteur aus. Die Lockerliste und die Caches werden immer entfernt. Der in Bestellungen gespeicherte Locker bleibt immer erhalten.

So funktioniert es an der Kasse

Wenn der Shop den Versand für einen Warenkorb berechnet, fragt PrestaShop das Modul nach dem Preis des Transporteurs Sameday easybox. Das Modul prüft die Bedingungen: Zielland des Sameday-Kontos, API-Zugangsdaten und eine verwendbare Lockerliste, die Länder von Ignore shipping zones, das Warenkorbgewicht und die Mindest-Zwischensumme. Produkte, die keinen Versand benötigen (virtuelle Produkte), werden nicht mitgezählt. Gilt kostenloser Versand, sieht der Kunde den Transporteur kostenlos.

Andernfalls fragt das Modul bei Sameday eine Schätzung an, sobald der Kunde eine Stadt und einen Kreis eingegeben hat. Es sendet Ihren Abholpunkt und Ihren Dienst, das Paketgewicht sowie Straße, Stadt, Kreis und Postleitzahl der Kundenadresse. Name, E-Mail-Adresse und Telefonnummer werden nicht gesendet. Bukarest wird als „Sector 1“ übermittelt, wie beim offiziellen Sameday-Plugin. Die Schätzung wird in Ihre Shopwährung umgerechnet. Gibt es keine Schätzung (nicht eingerichtet, noch keine Stadt oder Kreis, Fehler, kein Wechselkurs), kommt der Preis aus der Länder-Tabelle und danach aus den Ersatzkosten. Gibt es keinen Preis, wird der Transporteur ausgeblendet.

Probleme mit Sameday unterbrechen die Kasse nie. Die Schätzung wird 1 Stunde zwischengespeichert. Ein Fehler wird 10 Minuten zwischengespeichert. Nach einer Zeitüberschreitung oder einem Serverfehler wird 5 Minuten lang keine Schätzung angefragt. Anfragen laufen nach 15 Sekunden ab. Die Lockerliste wird während der Kasse von Ihrem Server gelesen, nicht von Sameday.

Der Transporteur funktioniert im Versandschritt des Themes Classic (PrestaShop 8) und des Themes Hummingbird (PrestaShop 9).

Das Modul erstellt keine AWBs (Sendungen), druckt keine Etiketten, verfolgt keine Pakete und verarbeitet keine Nachnahme. Es gibt keine Heimzustellung durch einen Kurier und kein Sameday-Kartenwidget. Erstellen Sie den AWB im Sameday-eAWB-Portal oder in Ihrem üblichen Tool mit der Locker-ID, die in der Bestellung angezeigt wird.

Abholpunkte

Wenn der Kunde den Transporteur auswählt, erscheint darunter ein Block easybox locker mit zwei Listen: - Select city - und - Select easybox locker -. Die Stadt der Lieferadresse wird vorausgewählt, wenn dort Locker vorhanden sind. Jeder Locker zeigt Name und Adresse. Die Auswahl wird sofort im Warenkorb gespeichert, sodass sie erhalten bleibt, wenn der Versandschritt aktualisiert oder die Seite neu geladen wird.

Der Locker ist erforderlich. Ohne einen Locker kann der Kunde nicht fortfahren und sieht „Bitte wählen Sie einen Sameday-easybox-Locker.“ Klickt der Kunde auf Continue, prüft der Server, ob der gewählte Locker in der Liste steht. Eine gefälschte oder entfernte Locker-ID wird mit „Der gewählte easybox-Locker ist nicht mehr verfügbar. Bitte wählen Sie einen anderen easybox-Locker.“ abgelehnt. Kann die Liste nicht geladen werden, sieht der Kunde „Die easybox-Locker konnten nicht geladen werden. Bitte versuchen Sie es gleich noch einmal oder wählen Sie eine andere Versandart.“ Name und Adresse, die mit der Bestellung gespeichert werden, stammen aus der Liste, nicht aus dem Browser. Sobald die Bestellung aufgegeben ist, ändert sich ihr Locker nicht mehr.

Bestellseite im Admin-Bereich: ein Block Sameday easybox locker mit Name und Adresse sowie der Locker ID für den Sameday-AWB. Hat eine easybox-Bestellung keinen Locker, zeigt der Block „Für diese Bestellung wurde kein easybox-Locker ausgewählt.“

Seiten zur Bestellbestätigung und zum Bestellverlauf: Sameday easybox locker: mit Name und Adresse.

Bestell-E-Mails: Name und Adresse des Lockers werden in der Bestellbestätigungs-E-Mail beim Transporteur ergänzt. Die neue Bestell-E-Mail an den Shop (Modul Mail alerts) enthält außerdem die Locker ID.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Sameday Easybox ist der erste Block unter Modules > Module Manager > VibeFox Sameday Easybox > Configure, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig 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-sameday-easybox 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. Nach einer Änderung der Shop-Adresse 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 gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Installation. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird der Transporteur Sameday easybox Kunden an der Kasse nicht angezeigt, und es wird kein Preis abgefragt oder berechnet. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Transporteur 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 unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus. Reset des Moduls löscht keine Daten, daher bleiben der Schlüssel und der Status erhalten.

Fehlerbehebung

Sameday easybox erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, API-Benutzername und Passwort eingegeben sind, die Konfigurationsseite „Mit Sameday verbunden“ anzeigt und das Zielland das Land Ihres Sameday-Kontos ist. Prüfen Sie, ob ein Preis verfügbar ist (Sameday-Schätzung, Länderzeile, Zeile * Default oder Fallback cost) sowie die Gewichts- und Zwischensummengrenzen. Prüfen Sie unter Shipping > Carriers, ob der Transporteur die Zone des Kundenlandes und die Kundengruppe abdeckt, oder schalten Sie Ignore shipping zones ein. Produkte können auch auf der Produktseite auf bestimmte Transporteure beschränkt sein. Schalten Sie Debug log ein, um den Grund im Feld Log zu sehen.

Sameday hat API-Benutzername oder Passwort abgelehnt: Prüfen Sie beides und speichern Sie erneut. Demo-Zugangsdaten funktionieren nur mit eingeschaltetem Test mode, Produktivzugangsdaten nur mit ausgeschaltetem. Bis dahin wird die gespeicherte Lockerliste angeboten, falls vorhanden, und die Sameday-Schätzung nicht verwendet.

Der Preis kommt aus meiner Tabelle, nicht von Sameday: Die Schätzung benötigt einen Pickup point, den Easybox service, Kreise im Adressformular und, wenn die Shopwährung von der Sameday-Währung abweicht, den Exchange rate of the estimate. Sie wird erst abgefragt, nachdem der Kunde eine Stadt und einen Kreis eingegeben hat. Ist Sameday nicht erreichbar oder liefert einen Fehler, wird die Tabelle oder die Ersatzkosten verwendet; der Grund steht im Protokoll.

Die Lockerliste ist veraltet oder fehlt: Klicken Sie auf Refresh the locker list now oder speichern Sie die Einstellungen. Schlägt eine Aktualisierung fehl, wird die bisherige Liste verwendet, und der Status weist darauf hin. Ist der Shop im Wartungsmodus, ist die Cron-URL wie der übrige Shop gesperrt, außer die IP des Cron-Servers ist erlaubt.

Der Versand ist fälschlicherweise kostenlos: Prüfen Sie Free shipping from und die Zeilen von Country prices mit einem Price von 0, besonders eine mit + Add country hinzugefügte und nicht ausgefüllte Zeile * Default.

Gewichtsgrenzen oder Gewichtsspalten passen nicht: Warnt die Seite, dass die Gewichtseinheit des Shops nicht bekannt ist, stellen Sie unter International > Localization (Local units) kg, g, lb oder oz ein.

Die Seite meldet, dass der Transporteur Sameday easybox nicht gefunden wurde: Der Transporteur wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn wieder anzulegen. Das Zurücksetzen behält die Einstellungen und den Status eines bestehenden Transporteurs.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Sameday Easybox und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Die gespeicherte Lockerliste, das Ergebnis der Kontoprüfung und alle Caches werden immer entfernt. Ist Remove data on uninstall aktiv, wird der Transporteur gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen sowie das Protokoll werden entfernt. Ist die Option aus, wird der Transporteur nur ausgeschaltet und alle Einstellungen bleiben erhalten. Wenn Sie das Modul erneut installieren, erhält der gespeicherte Transporteur seinen vorherigen Status zurück. Bestehende Bestellungen behalten den gespeicherten Locker.

Sameday und easybox sind Marken ihrer jeweiligen Inhaber. Dieses Modul ist nicht mit Sameday verbunden und wird nicht von Sameday unterstützt.