VibeFox PostNord for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

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

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

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

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. 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.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure. Später finden Sie VibeFox PostNord in der Modulliste und klicken dort auf Configure.

3. Fügen Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

Bei der Installation legt das Modul zwei Versanddienstleister an. PostNord liefert an einen Servicepunkt, mit dem Lieferzeittext Delivery to a PostNord service point. Er ist eingeschaltet. PostNord Home delivery liefert an die Adresse, mit dem Text PostNord home delivery. Er ist ausgeschaltet, bis Sie Home delivery aktivieren. Beide Dienstleister sind den Zonen Schweden, Dänemark, Norwegen und Finnland sowie allen Kundengruppen zugewiesen. Zonen, Kundengruppen, Lieferzeittext, Logo und Größenbeschränkungen können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer vom Modul.

Konfiguration

Alle Einstellungen finden Sie auf der Modulseite: Modules > Module Manager > VibeFox PostNord > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern leert außerdem die zwischengespeicherten Servicepunktlisten.

Oberhalb der Einstellungen warnt die Seite, wenn noch kein API-Schlüssel oder noch kein Preis hinterlegt ist, wenn ein PostNord-Versanddienstleister gelöscht wurde oder wenn die Gewichtseinheit des Shops dem Modul unbekannt ist. Die Produktgewichte werden dann als kg behandelt. Verwenden Sie kg, g, lb oder oz unter International > Localization (Local units).

Allgemein

Enable/Disable: schaltet den Servicepunkt-Versanddienstleister ein oder aus. Das ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Name: der Name des Servicepunkt-Versanddienstleisters an der Kasse, zum Beispiel „PostNord MyPack Collect“. Standard: PostNord. Pflichtfeld.

Home delivery: bietet zusätzlich die PostNord-Heimlieferung an. Das ist der zweite Versanddienstleister ohne Servicepunkt. Standardmäßig ausgeschaltet.

Home delivery name: der Name des Heimlieferungs-Versanddienstleisters an der Kasse, zum Beispiel „PostNord MyPack Home“. Standard: PostNord Home delivery. Pflichtfeld.

Tax status: None bedeutet, dass die unten stehenden Preise endgültig sind. Taxable: gefolgt von einer Steuerregel bedeutet, dass PrestaShop die Versandsteuer dieser Regel auf die Preise aufschlägt. Sie gilt für beide Versanddienstleister.

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 ins Protokoll geschrieben. Nach dem Speichern bleibt das Feld leer und zeigt Saved - leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Remove the saved API key: Aktivieren Sie das Kästchen und klicken Sie auf Save, um den gespeicherten Schlüssel zu löschen.

Test mode: nutzt die Testumgebung von PostNord (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

Der Abschnittstitel zeigt die Standardwährung Ihres Shops. Die Preise gelten in dieser Währung ohne Steuer und sind für beide Versanddienstleister gleich. PostNord hat keine öffentliche Preis-API, deshalb legen Sie Ihre eigenen Preise fest, in der Regel Ihre Preise aus dem PostNord-Vertrag. Die Reihenfolge ist: Schwelle für kostenlosen Versand, dann die Ländertabelle und zuletzt die Ausweichkosten.

Calculation type: Per order berechnet den Preis einmal. Per item (price x 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 Papierkorb-Symbol, 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, und ein Price von 0 bedeutet kostenlosen Versand. Das Land * All other countries deckt alle Länder ohne eigene Zeile ab. Dezimalwerte mit Komma oder Punkt (9,99 oder 9.99). Eine neue Zeile beginnt als * All other countries mit allen Preisen auf 0. Wählen Sie das Land und geben Sie die Preise ein, bevor Sie speichern, oder entfernen Sie die Zeile. Eine leere Zelle wird als 0 gespeichert. Eine Zelle, die keine Zahl ist, wird als 0 gespeichert, mit einer Meldung.

Fallback cost: wird verwendet, wenn die Ländertabelle für das Ziel keine Zeile und keine *-Zeile hat. Lassen Sie das Feld leer, um die Versanddienstleister für solche Länder auszublenden.

Free shipping from: die Warenkorb-Zwischensumme (Produkte mit Versand, nach Rabatten, ohne Steuer), ab der PostNord kostenlos ist. Sie wird vor der Ländertabelle geprüft, gilt also auch für ein Land ohne Preiszeile. Lassen Sie das Feld leer, wenn nie kostenloser Versand angeboten werden soll.

Verfügbarkeit

Min weight (kg): blendet die Versanddienstleister aus, wenn der Warenkorb weniger wiegt. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet. 0 bedeutet keine Grenze.

Max weight (kg): blendet die Versanddienstleister 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. Ein Min weight (kg) größer als Max weight (kg) wird mit einer Fehlermeldung abgelehnt, und nichts wird gespeichert.

Minimum subtotal: zeigt die Versanddienstleister nur an, wenn die Warenkorb-Zwischensumme (Produkte mit Versand, nach Rabatten, ohne Steuer) mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Ignore shipping zones: ist die Option aktiv, wird PostNord für die unten stehenden Länder angeboten, auch wenn die Zonen seiner Versanddienstleister sie nicht enthalten. Die Versanddienstleister sind mit allen aktiven Zonen verknüpft, und eine später angelegte Zone wird sofort verknüpft. Wenn Sie die Option wieder ausschalten, erhalten die Versanddienstleister die Zonen zurück, die sie vorher hatten. Ist sie aus, werden die Versanddienstleister nur in ihren eigenen Zonen angeboten.

Countries (Ignore shipping zones): die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder zuzulassen. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiv ist.

Beträge und Gewichte akzeptieren Komma oder Punkt. Ein Wert, der keine Zahl von 0 oder mehr ist, wird nicht gespeichert, und es erscheint eine Meldung.

Erweitert

Debug log: schreibt Tarifberechnungen und API-Aufrufe in logs/vfd_ptnd_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. API-Fehler werden immer protokolliert. Der API-Schlüssel wird nie protokolliert. Schalten Sie das Protokoll aus, wenn Sie fertig sind.

Log: zeigt die Größe und die neuesten Einträge des Debug-Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Remove data on uninstall: ist die Option aktiv, löscht die Deinstallation des Moduls die PostNord-Einstellungen und Versanddienstleister. Ist sie aus, werden bei der Deinstallation nur die Versanddienstleister ausgeschaltet. In Bestellungen gespeicherte Servicepunkte bleiben immer erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Preis jedes PostNord-Versanddienstleisters. Nur physische Produkte zählen: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft das Warenkorbgewicht und die minimale Zwischensumme. Gilt kostenloser Versand, beträgt der Preis 0. Andernfalls kommt der Preis aus der Ländertabelle und danach aus den Ausweichkosten. Gibt es keinen Preis, wird der Versanddienstleister ausgeblendet. Der Preis wird in der Standardwährung Ihres Shops berechnet und danach in der Warenkorbwährung des Kunden angezeigt.

Für den Servicepunkt-Versanddienstleister und eine Lieferadresse in Schweden, Dänemark, Norwegen oder Finnland fragt Ihr Server die PostNord Business Location API nach den 10 Servicepunkten ab, die der Lieferpostleitzahl am nächsten liegen. Dabei sendet er das Lieferland, die Lieferpostleitzahl und das Vertragsland. Das Timeout der API beträgt 10 Sekunden. Listen werden 6 Stunden je Postleitzahl zwischengespeichert, Antworten „keine Punkte“ 1 Stunde. API-Fehler werden 5 Minuten zwischengespeichert, damit ein PostNord-Ausfall nicht jede Aktualisierung des Lieferschritts verlangsamt. Der Lieferschritt wartet nie auf PostNord: Ist die Liste noch nicht im Cache, wird sie nachgeladen, nachdem der Kunde den Versanddienstleister ausgewählt hat.

Für andere Ziele können die Versanddienstleister mit Ihren Preisen trotzdem angeboten werden, ohne Auswahl. Der Versanddienstleister für die Heimlieferung zeigt nie eine Auswahl an.

Wenn Sie einen Versanddienstleister unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul übernimmt die neue Version automatisch.

Das Modul fragt keine Live-Preise von PostNord ab und erstellt keine Versandetiketten, bucht keine Sendungen (EDI), liefert keine Sendungsnummern und verschickt keine Tracking-E-Mails. Eine Kartenansicht gibt es nicht. Für den Versand verwenden Sie PostNord Portal, Skicka Direkt Business oder ein Etikettenprogramm; diese Werkzeuge benötigen die gespeicherte Servicepunkt-ID.

Abholpunkte

Wenn der Kunde den Servicepunkt-Versanddienstleister auswählt, erscheint darunter eine Liste PostNord service point mit den nächsten Punkten, nach Städten gruppiert mit Entfernung. Bevor eine Postleitzahl eingegeben ist, sieht der Kunde den Text „Geben Sie Ihre Postleitzahl ein, um einen PostNord-Servicepunkt auszuwählen.“. Die Auswahl wird mit dem Warenkorb gespeichert und übersteht Aktualisierungen des Lieferschritts.

Ist die Liste geladen, ist die Auswahl eines Punkts erforderlich. Ohne Auswahl bleibt Continue mit der Meldung „Bitte wählen Sie einen PostNord-Servicepunkt aus.“ stehen. Der gewählte Punkt wird auf dem Server gegen die PostNord-Liste für die Lieferadresse geprüft. Ein Punkt, der zu einer anderen Postleitzahl gewählt wurde, wird nicht verwendet.

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

Bestellseite im Back-Office: ein Block PostNord service point mit Name, Adresse und Service point ID. Wurde kein Punkt gewählt, steht dort „nicht ausgewählt - PostNord liefert an den Servicepunkt, der der Versandadresse am nächsten liegt“.

Bestellbestätigung und Bestelldetails des Kunden: PostNord service point: mit Name und Adresse.

Bestell-E-Mails: die Bestellbestätigung an den Kunden und die Benachrichtigung über neue Bestellungen an den Shop zeigen Name, Adresse und ID des Punkts neben dem Namen des Versanddienstleisters. Die Benachrichtigung an den Shop zeigt außerdem „not selected“, wenn kein Punkt gewählt wurde.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PostNord ist der erste Block auf Modules > Module Manager > VibeFox PostNord > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, 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-postnord 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. Nachdem sich die Adresse des Shops geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel werden die PostNord-Versanddienstleister Kunden an der Kasse nicht angezeigt, und es wird kein Versandpreis berechnet. Der PrestaShop-Shop weiß nicht, dass Sie im Back Office angemeldet sind, daher werden die Versanddienstleister auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

PostNord erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable (oder Home delivery) eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Landes und die Kundengruppe des Kunden abdeckt, oder aktivieren Sie Ignore shipping zones. Prüfen Sie, ob für das Land ein Preis hinterlegt ist (Länderzeile, *-Zeile oder Fallback cost), außerdem die Gewichtsgrenzen und Minimum subtotal. Produkte können auf der Produktseite auch auf bestimmte Versanddienstleister beschränkt sein.

Der Picker 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. Aktivieren Sie das Debug log, laden Sie die Kasse neu und sehen Sie sich das Feld Log auf der Modulseite an. Die Bestellung kann trotzdem abgeschlossen werden; PostNord liefert dann an den nächstgelegenen Servicepunkt.

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

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

Servicepunkte wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save. Das leert die zwischengespeicherten Listen.

Die Seite meldet, dass ein PostNord-Versanddienstleister nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn neu anzulegen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox PostNord und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Das Deaktivieren des Moduls löscht nur die zwischengespeicherten Servicepunktlisten. Bei der Deinstallation werden die zwischengespeicherten Listen immer entfernt. Ist Remove data on uninstall aktiv, werden die Versanddienstleister gelöscht (Bestellungen behalten ihre Historie), und die Einstellungen sowie das Protokoll werden entfernt. Ist die Option aus, werden die Versanddienstleister nur ausgeschaltet und alle Einstellungen bleiben erhalten. Wenn Sie das Modul erneut installieren, erhalten die gespeicherten Versanddienstleister wieder den Status, den sie hatten. In Bestellungen gespeicherte Servicepunkte bleiben immer erhalten.

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