VibeFox Omniva for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Omniva: Ein API-Konto ist nicht nötig. Omniva hat keine öffentliche Preis-API. Die Omniva-OMX-API steht nur Vertragskunden zur Verfügung und wird von diesem Plugin nicht genutzt, daher geben Sie Ihre eigenen (Vertrags-)Preise ein. Registrieren Sie die Pakete in Ihrem Omniva-Geschäftskonto.

Parcel machine list: Das Plugin lädt die offene Standortdatei von Omniva von omniva.ee herunter (kein Schlüssel und kein Vertrag nötig). Ihr Server muss ausgehende HTTPS-Anfragen an www.omniva.ee stellen können.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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 auch den Ordner vfd_omniva per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Omniva, 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 (siehe Lizenzschlüssel).

5. Prüfen Sie die Preise nach Land und Paketgröße, die Paketgrößen und die Statuszeile Parcel machine list.

6. Fügen Sie VibeFox Omniva Ihrer Zone für Estland, Lettland und/oder Litauen unter WooCommerce > Settings > Shipping > Shipping zones hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie die Länder.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Omniva. 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 für diese Zone sehen. Leer lassen, um die globale Method title zu verwenden.

Oben auf der Seite zeigen Hinweise Probleme an. Ein roter Hinweis erscheint, wenn kein Preis gesetzt ist oder die Paketautomatenliste nicht geladen werden konnte und keine gespeicherte Kopie vorhanden ist; dann wird die Methode an der Kasse nicht angezeigt. Ein gelber Hinweis erscheint, wenn die Liste im Moment nicht aktualisiert werden konnte und die gespeicherte Kopie verwendet wird. Zahlen, die nicht gelesen werden können, werden nach dem Speichern gemeldet und nicht gespeichert.

Allgemein

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

Method title: der Name der Versandmethode, den Kunden sehen. Der Title einer Zonenmethode überschreibt ihn. Standard: Omniva parcel machine.

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

Preise (in Ihrer Shopwährung; Dezimalzahlen können als 3.50 oder 3,50 geschrieben werden)

Price by parcel size: je eine Zeile für Estland, Lettland und Litauen mit den Spalten S, M, L, XL und Free from. Geben Sie den Preis jeder Omniva-Paketgröße für das Zielland ein. Ein leeres Feld bedeutet, dass diese Größe für das Land nicht angeboten wird: Die Methode wird ausgeblendet, wenn das Paket sie benötigt. 0 bedeutet kostenlos. Free from ist die Warenkorbsumme (nach Rabatten, wie im Warenkorb angezeigt), ab der die Lieferung in dieses Land kostenlos ist; leer lassen für keinen kostenlosen Versand. Bis Sie eigene Preise speichern, beginnt die Tabelle mit 3.50 für Estland und 4.00 für Lettland und Litauen. Sind WooCommerce-Steuern aktiv, entfernt ein kleiner Button -% neben jedem Preis die MwSt. Ihres Shop-Landes aus dem eingegebenen Preis (für Preise, die Sie inklusive MwSt. kennen).

Calculation: wie die Paketgröße und der Preis ermittelt werden.

Parcel sizes (cm): die maximalen Abmessungen jeder Größe als Smallest side, Middle side und Largest side. Produktabmessungen werden auf die gleiche Weise sortiert und Seite an Seite verglichen; Werte werden beim Speichern sortiert. Produktabmessungen werden von der Shopeinheit in cm umgerechnet. Produkte ohne Abmessungen passen in Größe S. Passt nichts, wird die Methode ausgeblendet. Standardwerte: S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64. Prüfen Sie sie anhand der aktuellen Omniva-Paketgrößen.

Verfügbarkeit

Minimum weight (kg): blendet die Methode aus, wenn der Warenkorb leichter ist. Leer oder 0 bedeutet kein Limit.

Maximum weight (kg): blendet die Methode aus, wenn der Warenkorb (oder bei Per item ein Artikel) schwerer ist. Omniva-Paketautomaten nehmen Pakete bis 30 kg an. Standard: 30. 0 bedeutet kein Limit. Die Gewichtseinheit des Shops wird in kg umgerechnet.

Minimum cart total: zeigt die Methode nur ab dieser Warenkorbsumme. Leer lassen, um sie immer anzuzeigen.

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

Ignore shipping zones: bietet Omniva für die unten genannten Länder an, ohne es einer Zone hinzuzufügen. Ist es aus, werden die Länder durch die Versandzonen definiert, in denen die Methode hinzugefügt ist. Empfohlen ist, es ausgeschaltet zu lassen.

Countries (without zones): die Zielländer für diesen Modus. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiv ist. Leer lassen für alle Versandländer. In jedem Modus wird Omniva nur dort angeboten, wo es Paketautomaten gibt: Estland, Lettland und Litauen.

Paketautomaten

Post offices: bietet zusätzlich Omniva-Postfilialen in derselben Liste an. Omniva listet Postfilialen für Estland. Standardmäßig aus.

City order: zeigt zuerst die größten Städte (Tallinn, Riga, Vilnius und andere), danach den Rest alphabetisch. Standardmäßig an. Ist es aus, werden die Städte alphabetisch sortiert.

Parcel machine list: eine Statuszeile mit der Anzahl der Paketautomaten je Land (und Postfilialen, falls aktiviert) und dem Zeitpunkt des letzten Downloads von omniva.ee. Klicken Sie auf Update the list now, um die Liste sofort herunterzuladen; antwortet omniva.ee nicht, bleibt die gespeicherte Kopie erhalten.

Erweitert

Debug log: protokolliert Details der Preisberechnung und der Paketautomatenliste unter WooCommerce > Status > Logs (Quelle vfd-omniva). Fehler, etwa eine nicht verfügbare Paketautomatenliste, werden immer protokolliert. Kundendaten werden nicht protokolliert.

Remove data on uninstall: ist es aktiviert, entfernt das Löschen des Plugins die Einstellungen, die Zonenmethoden und die gespeicherte Paketautomatenliste. Das Deaktivieren des Plugins löscht nie Einstellungen. Der in Bestellungen gespeicherte Paketautomat bleibt erhalten.

So funktioniert es an der Kasse

Gibt der Kunde eine Lieferadresse in Estland, Lettland oder Litauen ein, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft das Warenkorbgewicht, die minimale Warenkorbsumme und die ausgeschlossenen Versandklassen und ermittelt dann die Paketgröße anhand der Produktabmessungen. Passt das Paket in keine Größe, hat die Größe keinen Preis für das Land oder ist kein Paketautomat verfügbar, wird die Methode ausgeblendet, sodass der Kunde nie eine Kasse sieht, die sich nicht abschließen lässt. Erreicht die Warenkorbsumme das Free from des Landes, beträgt der Preis 0. Die Paketgröße wird in der Versandzeile der Bestellung als Omniva parcel size gespeichert.

Die Paketautomatenliste wird einmal täglich von omniva.ee heruntergeladen und in der WordPress-Datenbank gespeichert, nicht im Plugin-Ordner. Schlägt der Download fehl, funktioniert die gespeicherte Kopie weiter, und der nächste Versuch erfolgt nach 15 Minuten, damit die Kasse bei jeder Aktualisierung nicht auf omniva.ee wartet. Das Download-Timeout beträgt 15 Sekunden.

Die Methode funktioniert an der klassischen Kasse und in den Blöcken Warenkorb und Kasse. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel. Die Preise gelten in Ihrer Shopwährung. Das Plugin rechnet keine Währungen um.

Das Plugin fragt keine Omniva-Preise ab, meldet keine Sendungen an, druckt keine Etiketten, ruft keinen Kurier und verfolgt keine Pakete. Registrieren Sie die Pakete in Ihrem Omniva-Geschäftskonto. Kurierzustellung an die Haustür ist nicht Teil dieser Methode.

Abholstellen

Wählt der Kunde Omniva, erscheinen unter der Methode zwei Listen: -- Select city -- und -- Select parcel machine --. Es werden nur Städte und Paketautomaten des Lieferlandes angezeigt; wechselt der Kunde das Land, ändern sich auch die Listen. In Estland sind die Städte Landkreise, wobei Tallinn, Tartu und Pärnu separat aufgeführt sind; in Lettland und Litauen sind es Städte und Gemeinden. Die Stadt der Lieferadresse wird vorausgewählt, wenn sie einer Stadt in der Liste entspricht. Jeder Paketautomat wird mit Name und Adresse angezeigt. Die Auswahl wird während des Bestellvorgangs gespeichert, sodass sie beim Aktualisieren der Kasse nicht verloren geht.

Ein Paketautomat ist erforderlich. An der klassischen Kasse sieht der Kunde Please select an Omniva parcel machine. In der Blockkasse ist Place order gesperrt, bis ein Paketautomat gewählt ist. An beiden Kassen prüft der Server den Paketautomaten erneut gegen die Liste, daher wird eine gefälschte ID oder ein Paketautomat eines anderen Landes abgelehnt.

Die ID, der Name, die Stadt und das Land des Paketautomaten werden in der Bestellung gespeichert. Sie werden auf dem Bestellbildschirm unter der Lieferadresse (mit der ID des Paketautomaten), auf der Bestellbestätigungsseite, unter My account > Orders und in den Bestell-E-Mails (HTML und reiner Text) als Omniva parcel machine angezeigt.

Um den Paketautomaten einer Bestellung zu ändern, öffnen Sie die Bestellung unter WooCommerce > Orders, klicken Sie neben dem Paketautomaten auf Change, wählen Sie eine Stadt und einen Paketautomaten des Lieferlandes der Bestellung und klicken Sie auf Save parcel machine. Eine Bestellnotiz protokolliert den alten und den neuen Paketautomaten.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Omniva. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, etwa 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 Website. 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 Website gibt ihren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

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

Läuft eine Lizenz ab, funktioniert das Plugin weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Omniva erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, das Lieferland Estland, Lettland oder Litauen ist und die Methode der Zone des Landes des Kunden hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Öffnen Sie die Einstellungsseite: Ein roter Hinweis erklärt, wenn kein Preis gesetzt oder keine Paketautomatenliste verfügbar ist. Prüfen Sie auch die Produktabmessungen (ein Paket größer als die XL-Größe oder eine Größe mit leerem Preisfeld blendet die Methode aus), die Gewichtslimits, die Minimum cart total und die Excluded shipping classes. Mit aktivem Debug log zeigt WooCommerce > Status > Logs (Quelle vfd-omniva), warum die Methode ausgeblendet wurde.

Keine Paketautomaten: Die Liste konnte nicht von omniva.ee geladen werden, und es gibt keine gespeicherte Kopie. Das Plugin versucht es alle 15 Minuten erneut. Klicken Sie auf Update the list now; schlägt es fehl, prüfen Sie, ob Ihr Server www.omniva.ee erreichen kann, und sehen Sie den Fehler unter WooCommerce > Status > Logs nach.

Ein neuer Paketautomat fehlt: Die Liste wird einmal täglich aktualisiert. Klicken Sie auf Update the list now, um sie sofort zu laden.

Der falsche Preis wird berechnet: Der Preis hängt von der Paketgröße ab, die anhand der Produktabmessungen ermittelt wird. Prüfen Sie die Abmessungen der Produkte, Calculation und Parcel sizes (cm). Mit aktivem Debug log zeigt das Protokoll die gewählte Größe und den Preis.

Der Kunde kann die Bestellung nicht abschließen: Es muss ein Paketautomat gewählt werden. Sieht der Kunde die Meldung „The Omniva parcel machine list is temporarily unavailable“, sind im Moment keine Paketautomaten verfügbar; siehe „Keine Paketautomaten“.

In welcher Währung sind die Preise: In Ihrer Shopwährung. Das Plugin rechnet keine Währungen um.

Für Entwickler: Der Filter vfd_omniva_locations_url ändert die Adresse der Standortdatei (CSV im Omniva-Format), und vfd_omniva_countries ändert die Liste der Zielländer (Standard EE, LV, LT).

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel beispielsweise bereits 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 Website 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 letzten bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Einstellungen und die gespeicherte Paketautomatenliste. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die Caches werden immer entfernt. Einstellungen, Zonenmethoden und die gespeicherte Paketautomatenliste werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Der in Bestellungen gespeicherte Paketautomat wird nie gelöscht, und bestehende Bestellungen behalten ihre Versandzeilen.

Omniva ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Omniva verbunden und wird nicht von Omniva unterstützt.