VibeFox Sameday Easybox for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

Sameday-Benutzername und Passwort für die API: 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 eigene Testzugangsdaten bereit. Ohne API-Benutzername und API-Passwort wird die Methode nicht angeboten, weil der Kunde keinen Locker auswählen könnte.

VibeFox-Lizenzschlüssel: Kauf auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können den Ordner vfd_sameday_easybox auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox oder klicken Sie auf der Seite Plugins unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie Ihren Sameday-API username und Ihr API password ein, wählen Sie das Sameday country und speichern Sie. Die Seite sollte "Connected to Sameday ... easybox lockers" anzeigen. Pickup point und Easybox service werden aus Ihrem Konto ausgefüllt.

6. Legen Sie Ihre Preise fest: Exchange rate of the estimate, wenn die Shopwährung von der Sameday-Währung abweicht, und eine Zeile unter Country prices (zum Beispiel * Default) oder einen Fallback cost.

7. Fügen Sie VibeFox Sameday Easybox in WooCommerce > Settings > Shipping > Shipping zones der Versandzone Ihres Sameday-Landes hinzu oder aktivieren Sie Ignore shipping zones.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name, den Kunden in dieser Zone sehen. Lassen Sie das Feld leer, um den globalen Name zu verwenden.

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, fehlenden Preis oder fehlenden Wechselkurs für die Schätzung.

Alle Preise und Grenzwerte akzeptieren ein Komma oder einen Punkt als Dezimaltrennzeichen (4,99 oder 4.99). Eine ungültige Zahl wird mit einer Meldung abgelehnt.

Allgemein

Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus.

Name: der Name der Versandmethode, den der Kunde sieht. Eine Zone kann ihn mit einem eigenen Title überschreiben. Default: Sameday easybox.

Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht.

Sameday-Konto (API)

Beim Speichern meldet sich das Plugin bei Sameday an und lädt Ihre Services, 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. 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 die Methode wird nur für dieses Zielland angezeigt.

Test mode: nutzt die Sameday-Demo-API mit Demo-Zugangsdaten.

Preise

Die Reihenfolge ist: die Sameday-Kostenschätzung (wenn Pickup point und Easybox service gesetzt sind), dann die Länderpreistabelle, dann die Ersatzkosten. Tabellenpreise werden in der Shopwährung eingegeben.

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

Easybox service: der Sameday-Service für die easybox-Zustellung, meist "Locker NextDay" (Code LN), der automatisch gewählt wird. Wird für die Sameday-Kostenschätzung benötigt.

Exchange rate of the estimate: Sameday berechnet Schätzungen in der Währung Ihres Sameday-Landes: RON, HUF oder BGN (EUR für bulgarische Shops, die in Euro verkaufen). Verkauft Ihr Shop in einer anderen Währung, geben Sie den Wert von 1 Einheit der Sameday-Währung in Ihrer Shopwährung ein, zum Beispiel 0.20. Ohne diesen Wert 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 versendbaren Artikel. Das gilt für den Tabellenpreis und die Ersatzkosten. Die Sameday-Kostenschä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 Kreuz, 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, die auf 0 steht, 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. 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, damit die Methode dann nicht angeboten wird.

Free shipping from: die Warenkorbzwischensumme (nach Rabatten, ohne Steuern), ab der die easybox-Zustellung kostenlos ist. Es gilt nur, wenn ein Preis gefunden wird: eine Länderzeile, die Zeile * Default oder die Ersatzkosten (dann wird keine Schätzung angefragt) oder die Sameday-Kostenschätzung. Leer lassen, um nie kostenlosen Versand anzubieten.

Verfügbarkeit

Minimum weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. Das Gewicht wird aus Ihrer Gewichtseinheit im Shop umgerechnet. Leer oder 0 bedeutet kein Limit.

Maximum weight (kg): Pakete, die schwerer sind, werden nicht für die easybox-Zustellung angeboten. Default: 30. Prüfen Sie das Limit Ihres Sameday-Vertrags und die easybox-Fächergrößen. Leer oder 0 bedeutet kein Limit.

Minimum cart subtotal: bietet die Methode nur an, wenn die Warenkorbzwischensumme (nach Rabatten, ohne Steuern) diesen Betrag erreicht.

Excluded shipping classes: blendet die Methode aus, wenn der Warenkorb ein Produkt aus einer dieser WooCommerce-Versandklassen enthält.

Ignore shipping zones: ist die Option aktiv, wird die Methode für die unten gewählten Länder angeboten, auch wenn sie nicht der passenden Versandzone hinzugefügt wurde. Ist sie aus, wird sie nur in den Zonen angeboten, denen sie hinzugefügt wurde.

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

Erweitert

Debug log: schreibt Tarifberechnungen, API-Aufrufe und Locker-Auswahlen in WooCommerce > Status > Logs (Quelle "vfd-sameday-easybox"). API-Fehler werden immer protokolliert. Kein Passwort, Token oder personenbezogene Kundendaten werden protokolliert. Schalten Sie das Protokoll nach Abschluss der Arbeiten wieder aus.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins die Einstellungen und die Zoneninstanzen dieser Methode. Das Deaktivieren des Plugins löscht nie etwas. Der in Bestellungen gespeicherte Locker bleibt immer erhalten.

Ablauf an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft die Bedingungen: Zielland Ihres Sameday-Kontos, API-Zugangsdaten und eine nutzbare Locker-Liste, Warenkorbgewicht, Mindestwarenkorbwert und ausgeschlossene Versandklassen. Danach sucht es einen Preis: die Sameday-Kostenschätzung, die Länder-Tabelle, die Ersatzkosten. Gibt es keinen Preis, wird die Methode ausgeblendet. Gilt kostenloser Versand, sieht der Kunde die Methode kostenlos.

Andernfalls fragt das Plugin Sameday nach einer Schätzung, sobald der Kunde eine Stadt und einen Landkreis eingegeben hat. Es sendet Ihren Abholpunkt und Service, das Paketgewicht sowie die Straße, Stadt, den Landkreis und die Postleitzahl des Kunden. Name, E-Mail und Telefonnummer werden nicht gesendet. Bukarest wird als "Sector 1" gesendet, 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 kein Landkreis, Fehler, kein Wechselkurs), kommt der Preis aus der Länder-Tabelle, dann aus den Ersatzkosten. Gibt es keinen Preis, wird die Methode 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 Locker-Liste wird während der Kasse von Ihrem Server gelesen, nicht von Sameday.

Die Methode funktioniert an der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin 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 auf der Bestellung angezeigt wird.

Locker-Auswahl

Wenn der Kunde die Methode auswählt, erscheint darunter ein Block easybox locker mit zwei Listen: - Select city - und - Select easybox locker -. Die eigene Stadt des Kunden wird vorausgewählt, wenn dort Locker vorhanden sind. Jeder Locker zeigt seinen Namen und seine Adresse. Die Auswahl bleibt erhalten, wenn die Kasse aktualisiert wird oder die Seite neu geladen wird.

Der Locker ist Pflicht. Ohne ihn stoppt die Kasse mit "Please choose a Sameday easybox locker." Der Server prüft, dass der gewählte Locker in der Liste steht, sowohl an der klassischen Kasse als auch in der Block-Kasse. Eine gefälschte oder entfernte Locker-ID wird mit "The selected easybox locker is not available any more. Please choose another easybox locker." abgelehnt. Name und Adresse, die mit der Bestellung gespeichert werden, stammen aus der Liste, nicht aus dem Browser.

Bestellseite im Admin-Bereich: Sameday easybox locker mit Name und Adresse sowie der Locker ID für den Sameday-AWB, unterhalb der Lieferadresse. Hat eine easybox-Bestellung keinen Locker, zeigt die Seite "No easybox locker was selected for this order."

Dankeseite und Bestellansicht: Sameday easybox locker: mit Name und Adresse.

Bestell-E-Mails: Name und Adresse des Lockers in HTML- und Text-E-Mails. Admin-E-Mails enthalten außerdem die Locker ID.

In der Datenbank wird der Locker in den Bestell-Metadaten _vfd_sdeb_locker_id (die Sameday-Locker-ID für den AWB) und _vfd_sdeb_locker_name (Name und Adresse) gespeichert.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock steht oben unter WooCommerce > Settings > Shipping > VibeFox Sameday Easybox. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Seite. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Seite gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Sameday easybox Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, funktioniert das Plugin weiter, doch für Updates und Support ist eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Sameday easybox erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Benutzername und Passwort der API eingetragen sind, die Einstellungsseite "Connected to Sameday" 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), die Gewichts- und Zwischensummenlimits, Excluded shipping classes und ob die Methode der passenden Zone hinzugefügt ist (oder Ignore shipping zones aktiv ist). Aktivieren Sie Debug log, um den Grund in WooCommerce > Status > Logs zu sehen.

Sameday hat Benutzername oder Passwort der API abgelehnt: prüfen Sie beides und speichern Sie erneut. Demo-Zugangsdaten funktionieren nur bei aktivem Test mode, Live-Zugangsdaten nur bei deaktiviertem. Bis dahin wird die gespeicherte Locker-Liste angeboten, falls vorhanden, und die Sameday-Schätzung wird nicht verwendet.

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

Die Locker-Liste ist veraltet oder fehlt: speichern Sie die Einstellungen. Die Liste wird neu geladen, wenn sie leer ist, älter als eine Stunde ist oder das letzte Laden fehlgeschlagen ist. Schlägt eine Aktualisierung fehl, wird die vorherige Liste verwendet und der Status zeigt das an.

Der Versand ist irrtümlich kostenlos: prüfen Sie Country prices auf Zeilen mit einem Price von 0, besonders auf eine mit + Add country hinzugefügte Zeile * Default, die leer geblieben ist.

Grenzüberschreitende Locker: Entwickler können Zielländer mit dem Filter vfd_sdeb_countries hinzufügen. Die Locker-Liste ist immer die Ihres Kontos.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel schon auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Seite geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten und beendet nur die tägliche Aktualisierung der Locker-Liste. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt, zusammen mit der gespeicherten Locker-Liste, dem Ergebnis der Kontoprüfung und allen Caches. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen und den gespeicherten Locker.

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