VibeFox PostNord 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.

PostNord-API-Schlüssel (für die Servicepunkt-Auswahl): legen Sie auf developer.postnord.com ein kostenloses Konto an, fügen Sie eine Anwendung hinzu und kopieren Sie deren API-Schlüssel. Ohne Schlüssel funktioniert die Versandart weiterhin, aber Kunden können keinen Servicepunkt auswählen.

PostNord-Vertrag: Um Pakete zu versenden, benötigen Sie Ihren üblichen PostNord-Kundenvertrag, zum Beispiel MyPack Collect oder MyPack Home.

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

Installation

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

2. Klicken Sie auf Activate.

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

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

5. Fügen Sie den PostNord-API key ein, wählen Sie Ihr Agreement country und füllen Sie die Country prices aus (siehe Konfiguration).

6. Fügen Sie VibeFox PostNord in WooCommerce > Settings > Shipping > Shipping zones den Versandzonen für Schweden, Dänemark, Norwegen oder Finnland hinzu. Legen Sie in den Einstellungen der Methode den Title und den Delivery type fest. Oder aktivieren Sie Ignore shipping zones.

Konfiguration

Alle Einstellungen außer Titel und Versandart stehen auf einer Seite: WooCommerce > Settings > Shipping > VibeFox PostNord. Sie gelten für jede Versandzone. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster zwei Felder:

Title (zone): der Name dieser Option an der Kasse, zum Beispiel „PostNord MyPack Collect“. Leer lassen, um den globalen Name zu verwenden.

Delivery type (zone): Same as global setting (Standard), Service point / parcel locker oder Home delivery. Fügen Sie einer Zone zwei PostNord-Methoden hinzu, um beide anzubieten.

Oberhalb der Einstellungen warnt die Seite, wenn noch kein API-Schlüssel oder kein Preis hinterlegt ist. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Servicepunktlisten geleert.

Allgemein

Enable/Disable: Ist das Häkchen entfernt, wird die Methode überall ausgeblendet, auch in den Versandzonen.

Name: der Name der Versandart an der Kasse. Eine Zonenmethode kann ihn mit dem eigenen Title überschreiben. Standard: PostNord.

Delivery type: der Standardwert für alle PostNord-Methoden; jede Zonenmethode kann ihren eigenen wählen.

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

PostNord-API (Servicepunkt-Auswahl)

API key: der API-Schlüssel Ihrer Anwendung auf developer.postnord.com. Er wird nur von Ihrem Server an PostNord gesendet, nie an den Browser, und wird nie protokolliert.

Test mode: nutzt die PostNord-Testumgebung (atapi2.postnord.com). Nur für Schlüssel, die für die Testumgebung ausgestellt wurden.

Agreement country: das Land Ihres PostNord-Kundenvertrags: Schweden, Dänemark, Norwegen oder Finnland. Es bestimmt, welche Servicepunkte angeboten werden. Same as the delivery country (Standard) verwendet das Land des Kunden.

Preise

Die Preise gelten in der Shopwährung. PostNord hat keine öffentliche Preis-API, daher legen Sie Ihre eigenen Preise fest, in der Regel Ihre PostNord-Vertragspreise. Die Reihenfolge ist: zuerst die Länder-Tabelle, dann die Ausweichkosten; kostenloser Versand gilt nur dort, wo einer der beiden einen Preis ergibt.

Calculation type: Per order berechnet den Preis einmal. Per item (price × number of items) multipliziert ihn mit der Anzahl der Artikel im Warenkorb.

Country prices: ein Preis je Zielland und Warenkorbgewicht. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Jede Zeile hat einen Price und Gewichtsspalten: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg und XL über 5 kg. Eine Gewichtsspalte mit 0 verwendet die Spalte Price. Das Land * All other countries deckt alle Länder ab, die keine eigene Zeile haben. Dezimalzahlen mit Komma oder Punkt (9,99 oder 9.99). Eine neue Zeile beginnt als * All other countries mit allen Preisen bei 0, was kostenlosen Versand bedeutet. Wählen Sie das Land und geben Sie die Preise ein, bevor Sie speichern, oder entfernen Sie die Zeile. Eine Zelle, die keine Zahl enthält, wird als 0 gespeichert, mit einer Meldung.

Fallback cost: wird verwendet, wenn die Länder-Tabelle für das Ziel keine Zeile und keine *-Zeile hat. Leer lassen, um die Methode für solche Länder auszublenden.

Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer), ab der PostNord kostenlos ist. Es gilt nur dort, wo ein Preis festgelegt ist: eine Länderzeile, die *-Zeile oder die Ausweichkosten. Leer lassen, um nie kostenlosen Versand anzubieten.

Verfügbarkeit

Min weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. Produktgewichte werden aus Ihrer Gewichtseinheit im Shop umgerechnet. 0 bedeutet keine Grenze.

Max weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Standard: 30. 0 bedeutet keine Grenze. Prüfen Sie die Gewichtsgrenze Ihres PostNord-Dienstes: Paketboxen nehmen weniger an als Servicepunkte.

Minimum subtotal: zeigt die Methode nur, wenn die Warenkorb-Zwischensumme mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Disabled 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 PostNord für die unten genannten Länder mit den globalen Einstellungen angeboten, auch wenn die Methode keiner Versandzone hinzugefügt wurde. Ist sie aus, nur in den Versandzonen, denen Sie die Methode hinzugefügt haben.

Countries (Ignore shipping zones): die Zielländer für diesen Modus. Leer lassen, um alle Versandländer zu verwenden. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiv ist.

Beträge und Gewichte akzeptieren Komma oder Punkt. Eine ungültige Zahl wird nicht gespeichert, mit einer Meldung.

Erweitert

Debug log: schreibt Tarifberechnungen und API-Aufrufe nach WooCommerce > Status > Logs (Quelle „vfd-postnord“). API-Fehler werden immer protokolliert. Der API-Schlüssel wird nie protokolliert. Schalten Sie das Protokoll nach Abschluss wieder aus.

Remove data on uninstall: Ist die Option aktiv, entfernt das Löschen des Plugins die PostNord-Einstellungen und Zonenmethoden. Deaktivieren löscht nie Einstellungen. In Bestellungen gespeicherte Servicepunkte bleiben immer erhalten.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft die Bedingungen: Warenkorbgewicht, minimale Zwischensumme und deaktivierte Versandklassen. Der Preis stammt aus der Länder-Tabelle, danach aus den Ausweichkosten. Gibt es keinen Preis, wird die Methode ausgeblendet. Gilt kostenloser Versand, sieht der Kunde die Methode ohne Kosten.

Bei einer Servicepunkt-Methode und einer Lieferadresse in Schweden, Dänemark, Norwegen oder Finnland fragt Ihr Server die PostNord Business Location API nach den Servicepunkten, die der Lieferpostleitzahl am nächsten liegen. Gesendet werden Lieferland, Lieferpostleitzahl und Vertragsland. Das Zeitlimit der API beträgt 10 Sekunden. Listen werden je Postleitzahl 6 Stunden zwischengespeichert, „keine Punkte“-Antworten 1 Stunde lang. API-Fehler werden 5 Minuten lang zwischengespeichert, damit ein PostNord-Ausfall nicht jede Aktualisierung der Kasse verlangsamt.

Für andere Ziele kann die Methode weiterhin mit Ihren Preisen angeboten werden, ohne Auswahl.

Die Methode funktioniert in der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin ruft keine Live-Preise von PostNord ab und erstellt keine Versandetiketten, bucht keine Sendungen (EDI), liefert keine Sendungsnummern und verschickt keine Sendungsverfolgungs-E-Mails. Eine Kartenansicht gibt es nicht. Nutzen Sie für den Versand PostNord Portal, Skicka Direkt Business oder ein Etikettenplugin; die gespeicherte Servicepunkt-ID brauchen diese Werkzeuge.

Abholpunkte

Wenn der Kunde eine Servicepunkt-Methode auswählt, erscheint darunter eine Liste PostNord service point mit den nächstgelegenen Punkten, nach Städten gruppiert mit Entfernung. Bevor eine Postleitzahl eingegeben wurde, sieht der Kunde die Meldung "Enter your postcode to choose a PostNord service point.". Die Auswahl bleibt bei Aktualisierungen der Kasse erhalten.

Ist die Liste geladen, ist ein Punkt erforderlich. Ohne Auswahl bricht die Kasse mit "Please select a PostNord service point." ab. Der gewählte Punkt wird auf dem Server gegen die Liste geprüft, sowohl in der klassischen als auch in der Block-Kasse.

Die Auswahl blockiert nie einen Verkauf. Kann die Liste nicht geladen werden (noch kein API-Schlüssel, PostNord-API nicht erreichbar, keine Punkte in der Nähe der Postleitzahl), sieht der Kunde einen Hinweis und kann trotzdem bestellen. PostNord liefert dann an den Servicepunkt, der der Adresse am nächsten liegt.

Bestellbildschirm im Adminbereich: PostNord service point mit Name, Adresse und Service point ID, unter der Lieferadresse. Wurde kein Punkt gewählt, steht dort "not selected — PostNord delivers to the service point nearest to the shipping address".

Dankeseite und Bestellansicht unter Mein Konto: PostNord service point: mit Name und Adresse.

Bestell-E-Mails: Name, Adresse und ID des Punkts in HTML- und Textversion der E-Mails.

In der Datenbank wird der Punkt in den Bestell-Metadaten _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name und _vfd_ptnd_servicepoint_address gespeichert.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock steht oben unter WooCommerce > Settings > Shipping > VibeFox PostNord. Fügen Sie den Schlüssel bei 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 Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird PostNord Kunden an der Kasse nicht angezeigt. Angemeldete Shopbetreiber sehen die Methode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

PostNord erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone für das Land des Kunden hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie, ob für das Land ein Preis festgelegt ist (Länderzeile, *-Zeile oder Fallback cost), außerdem die Gewichtsgrenzen, Minimum subtotal und Disabled shipping classes.

Die Auswahl meldet, dass Servicepunkte nicht geladen werden können: Prüfen Sie den API key und die Einstellung Test mode. Ein Produktionsschlüssel funktioniert nicht mit der Testumgebung und umgekehrt. Schalten Sie das Debug log ein und sehen Sie unter WooCommerce > Status > Logs nach, Quelle "vfd-postnord". Die Bestellung kann trotzdem aufgegeben werden; PostNord liefert dann an den nächsten Servicepunkt.

Unerwartete Servicepunkte: Prüfen Sie das Agreement country. Es bestimmt, welche Servicepunkte angeboten werden.

Versand ist fälschlicherweise kostenlos: Prüfen Sie die Country prices auf Zeilen mit einem Price von 0, besonders eine mit + Add country hinzugefügte *-Zeile, die leer blieb, und prüfen Sie Free shipping from.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Wurde 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 zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Einstellungen und löscht nur die zwischengespeicherten Servicepunktlisten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt, zusammen mit den zwischengespeicherten Servicepunktlisten. 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 Servicepunkt.

PostNord ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit PostNord verbunden noch wird es von PostNord unterstützt.