VibeFox NZ Post for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Zugang zur API von NZ Post (nur für Live-Tarife): Live-Tarife nutzen die ShippingOptions API von NZ Post. Beantragen Sie den API-Zugang im Developer Resource Centre auf der Website von NZ Post. NZ Post stellt eine Client ID und ein Client Secret bereit, zuerst für die Testumgebung (UAT) und danach für die Produktion, nach deren Go-live-Checkliste. Für Tarife innerhalb Neuseelands benötigen Sie außerdem ein Geschäftskundenkonto bei NZ Post: die Kontonummer und deren Auth Code (oder Site Code). Wenn Sie nur feste Preise verwenden, benötigen Sie keinen API-Zugang.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.

Installation

Der Download ist eine einzige ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 vfd_nz_post-oc3-(version).ocmod.zip und das Paket für OpenCart 4 vfd_nz_post.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_nz_post-oc3-(version).ocmod.zip. Die Erweiterung fügt keine OCMOD-Modifikationen hinzu, daher müssen Sie Extensions > Modifications nicht aktualisieren. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox NZ Post und klicken Sie auf Install (die grüne +-Schaltfläche).

3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen.

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

5. Für Live-Tarife füllen Sie den Abschnitt NZ Post API (live rates) aus. Optional geben Sie feste Preise ein, die ohne Live-Tarife und als Ersatz verwendet werden (siehe Konfiguration). Aktivieren Sie Enable NZ Post und klicken Sie auf Save.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_nz_post.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox NZ Post, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 4 und 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Nach der Installation ist die Methode deaktiviert, bis Sie Enable NZ Post aktivieren und speichern. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die von Ihnen gespeicherten NZ-Post-Einstellungen wieder verwendet.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Shipping > VibeFox NZ Post > Edit. Die Abschnitte sind links aufgeführt. Eine Schaltfläche Save unten speichert die gesamte Seite ohne Neuladen. Jedes Speichern löscht außerdem die zwischengespeicherten NZ-Post-Tarife und Zugriffstoken. Nur Admin-Benutzer mit der Berechtigung zum Ändern dieser Erweiterung können die Einstellungen speichern.

Nichts wird gespeichert, und ein Fehler wird angezeigt, wenn Method title leer ist, länger als 64 Zeichen ist oder < > ; = # { } enthält, wenn ein Zahlenfeld Text oder eine negative Zahl enthält, wenn der NZD-Kurs 0 ist, wenn Min cart weight (kg) größer als Max cart weight (kg) ist oder wenn Sort order keine ganze Zahl ist. Warnungen erscheinen über den Einstellungen, wenn Live-Tarife mit den gespeicherten Werten nicht funktionieren können: nur eines von Client ID und Client Secret, kein NZD-Umrechnungskurs oder unvollständige Daten für Inlandstarife. Eine Warnung erscheint auch, wenn der Shop keine Gewichtsklasse mit der Einheit kg oder keine Längenklasse mit der Einheit cm hat: Gewichte und Abmessungen werden dann nach dem Einheitennamen ihrer Klasse umgerechnet (kg, g, lb, oz; cm, mm, m, in), andere Einheiten werden als kg und cm gelesen.

Allgemein

Die Einstellungen gelten für jede Geo-Zone. Sie können die Methode unter Availability auf eine Geo-Zone oder auf Länder beschränken.

Enable NZ Post: schaltet die Methode an der Kasse ein oder aus. Standard: aus.

Method title: der Name der Versandart, den der Kunde im Warenkorb und an der Kasse sieht. Standard: NZ Post. Pflichtfeld, höchstens 64 Zeichen.

Tax class: die Steuerklasse der Versandkosten oder No tax (Standard; die Versandkosten werden nicht besteuert). Wenn der Shop GST auf den Versand aufschlägt, stellen Sie API prices unten auf Excluding GST, damit GST nicht doppelt berechnet wird.

Sort order: die Position von NZ Post unter den Versandarten an der Kasse. Eine ganze Zahl.

NZ Post API (Live-Tarife) (lassen Sie die Client ID leer, um nur feste Preise zu verwenden)

Environment: Production (api.nzpost.co.nz) (Standard) oder Testing / UAT (api.uat.nzpost.co.nz). Verwenden Sie die Umgebung, für die Ihre Client ID ausgestellt wurde.

Client ID: die OAuth2-Client-ID Ihrer NZ-Post-API-Anwendung. Wenn Sie sie leeren, wird auch das gespeicherte Client Secret gelöscht.

Client Secret: das OAuth2-Client-Secret. Es wird gegen ein Zugriffstoken getauscht, das bis zu seinem Ablauf zwischengespeichert wird. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten.

Account number: Ihre Geschäftskundennummer (Abrechnungskonto) bei NZ Post. Sie ist für Tarife innerhalb Neuseelands erforderlich. Für Auslandstarife ist sie optional; mit ihr liefert NZ Post Ihre Vertragstarife. Wenn Sie sie leeren, wird auch der gespeicherte Auth Code gelöscht.

Auth code: der Auth Code des Kontos für Inlandstarife. Er wird nicht benötigt, wenn Sie einen Site Code eintragen. Wie das Client Secret wird er nach dem Speichern nicht erneut angezeigt.

Site code: die Alternative zum Auth Code: Ihr Abholstandort-Code (Site Code) bei NZ Post.

Ship-from suburb: der Stadtteil der Adresse, von der die Pakete versendet werden, zum Beispiel Petone. Für Inlandstarife erforderlich.

Ship-from city: die Stadt oder Gemeinde, von der die Pakete versendet werden, zum Beispiel Lower Hutt. Für Inlandstarife erforderlich.

Ship-from postcode: die vierstellige neuseeländische Postleitzahl, von der die Pakete versendet werden, zum Beispiel 5012. Für Inlandstarife erforderlich.

Services: optionale NZ-Post-Dienstcodes, durch Kommas getrennt, zum Beispiel CPOLP, ICOU. Nur diese Dienste werden bepreist. Lassen Sie das Feld leer, um den günstigsten Dienst zu verwenden, den NZ Post für das Paket zurückgibt.

API prices: Including GST (Standard) oder Excluding GST. Inlandspreise von NZ Post enthalten 15 % GST; internationales Porto ist steuerfrei. Wählen Sie Excluding GST, wenn die Methode eine Steuerklasse (General) hat, damit GST nicht doppelt berechnet wird.

NZD → (Währung des Shops) Kurs: NZ-Post-Preise sind in NZD. Wenn die Standardwährung Ihres Shops nicht NZD ist, geben Sie ein, wie viele Einheiten Ihrer Währung ein NZD wert ist, zum Beispiel 0.55. Ohne diesen Wert werden Live-Tarife nicht verwendet. Derselbe Kurs rechnet den Bestellwert um, der bei Auslandsanfragen übermittelt wird. Der Kurs muss größer als 0 sein. Wenn die Währung Ihres Shops NZD ist, lassen Sie das Feld leer.

Paket für Live-Tarife

Der Warenkorb wird als ein Paket an NZ Post gesendet. Gewichte und Abmessungen der Produkte werden von ihren Gewichts- und Längenklassen in kg und cm umgerechnet (mm bei Auslandsanfragen). Das Paket übernimmt die größte Länge und Breite der Produkte, und seine Höhe wächst, bis das Volumen aller Artikel hineinpasst. Die folgenden Werte gelten für Produkte ohne Gewicht oder Abmessungen.

Default product weight (kg): wird für jedes Produkt ohne Gewicht verwendet. Standard: 0.5.

Default parcel length (cm): wird verwendet, wenn kein Produkt im Warenkorb Abmessungen hat. Standard: 30.

Default parcel width (cm): wird verwendet, wenn kein Produkt im Warenkorb Abmessungen hat. Standard: 20.

Default parcel height (cm): wird verwendet, wenn kein Produkt im Warenkorb Abmessungen hat. Standard: 10.

Feste Preise (werden verwendet, wenn Live-Tarife nicht eingerichtet sind oder NZ Post keinen Tarif liefert)

Die Preise gelten in der Standardwährung des Shops, ohne Steuer.

Country prices: eine Zeile pro Zielland. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf die Schaltfläche ×, um sie zu entfernen. Wählen Sie * Default für eine Zeile, die alle übrigen Länder abdeckt. Jede Zeile hat einen Preis Any weight und optionale Gewichtsspalten: ≤ 1 kg, 1–2 kg, 2–3 kg, 3–5 kg und > 5 kg (Warenkorbgewicht). Eine ausgefüllte Gewichtsspalte ersetzt Any weight; eine leere oder mit 0 belegte Spalte verwendet Any weight. Ein Preis Any weight von 0 bedeutet kostenlosen Versand in dieses Land. Sowohl „9.99“ als auch „9,99“ werden akzeptiert. Zeilen ohne jeden Preis und negative Preise werden beim Speichern entfernt. Pro Land bleibt nur eine Zeile erhalten.

Fallback cost: wird verwendet, wenn weder die API noch die Länder-Tabelle einen Preis liefern. Lassen Sie das Feld leer, um die Methode in diesem Fall auszublenden.

Fixed price per: Order (Standard) berechnet den Preis einmal. Item (price × quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Dies gilt nur für feste Preise und den Ersatzpreis. Live-Tarife werden immer für das gesamte Paket berechnet.

Bedingungen

Min cart weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. 0 bedeutet keine Grenze (Standard).

Max cart weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Standard: 25 (NZ-Post-Kurierpakete gehen bis 25 kg); ein leeres Feld bedeutet ebenfalls 25. 0 bedeutet keine Grenze. Bei aktiviertem Ignore shipping zones bedeutet ein leeres Feld keine Grenze für Adressen außerhalb der Geo zone.

Minimum order amount: zeigt die Methode nur an, wenn die Zwischensumme der versandpflichtigen Produkte (nach dem Gutschein, vor Steuern) diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Free shipping from: die Zwischensumme (nach dem Gutschein, vor Steuern), ab der die Zustellung mit NZ Post kostenlos ist. Dann wird keine Anfrage an NZ Post gesendet. Lassen Sie das Feld leer, um nie kostenlosen Versand anzubieten.

Für diese Bedingungen zählen Produkte ohne Gewicht als 0.

Verfügbarkeit

Normalerweise wird die Methode in der unten ausgewählten Geo-Zone angeboten, oder überall, wenn keine ausgewählt ist.

Geo zone: bietet NZ Post nur für Adressen in dieser Geo-Zone an. All zones (Standard) bedeutet keine Beschränkung. Geo-Zonen verwalten Sie unter System > Localisation > Geo Zones.

Ignore shipping zones: bietet NZ Post auch außerhalb der Geo-Zone für die unten genannten Länder an. Ist die Option eingeschaltet, erhalten nur diese Länder die Methode, auch innerhalb der Geo-Zone. Standard: aus.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle im Shop aktivierten Länder zu verwenden. Dieses Feld wird nur verwendet, wenn Ignore shipping zones eingeschaltet ist.

Erweitert

Debug log: schreibt die Tarifberechnungen in storage/logs/vfd_nzpt_debug.log.php (in OpenCart 4 system/storage/logs/vfd_nzpt_debug.log.php). Die Datei ist nicht über das Web lesbar. API-Fehler werden immer protokolliert, auch wenn das Debug-Protokoll aus ist. Zugangsdaten, Token, die Kontonummer und Kundenadressen werden nicht protokolliert. Schalten Sie das Protokoll nach Abschluss aus. Erreicht die Datei 5 MB, wird sie nach vfd_nzpt_debug.old.log.php verschoben und ein neues Protokoll gestartet.

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

Remove data on uninstall: ist die Option aktiviert, werden bei der Deinstallation der Erweiterung die Einstellungen und das Protokoll gelöscht. Ist sie aus (Standard), bleiben sie für eine erneute Installation erhalten. Zwischengespeicherte Tarife werden immer gelöscht. Die NZ-Post-Angaben zu Bestellungen bleiben immer erhalten.

Import / Export

Export: Klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern. Das Client Secret und der Auth Code werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen, zum Beispiel in einem anderen Shop. Die Werte werden wie beim normalen Speichern geprüft. Das gespeicherte Client Secret und der Auth Code bleiben erhalten, solange Client ID und Kontonummer ausgefüllt sind.

So funktioniert es an der Kasse

Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem NZ-Post-Preis. Ist eine Geo zone festgelegt und liegt die Adresse außerhalb, wird NZ Post nur angeboten, wenn Ignore shipping zones eingeschaltet ist und das Land erlaubt ist. Nur Produkte mit Requires Shipping auf Yes zählen: Andere Produkte fügen kein Gewicht hinzu und werden nicht in den Bestellwert einbezogen. Danach prüft die Erweiterung die Bedingungen: erlaubte Länder (bei Ignore shipping zones), Warenkorbgewicht und Mindestbestellwert. Der Bestellwert ist der Preis der versandpflichtigen Produkte nach dem Gutscheinrabatt und vor Steuern. Geschenkgutscheine, Bonuspunkte und Shop-Guthaben werden nicht berücksichtigt. Gilt der kostenlose Versand, ist der Preis 0, und es wird keine Anfrage an NZ Post gesendet. Andernfalls sucht sie einen Preis: zuerst den Live-Tarif von NZ Post, dann die Länder-Tabelle, dann den Ersatzpreis. Gibt es keinen Preis, wird die Methode ausgeblendet.

Mit eingerichteten Live-Tarifen holt die Erweiterung mit Ihrer Client ID und Ihrem Client Secret ein Zugriffstoken und fragt bei NZ Post einen Preis an. Für eine Adresse in Neuseeland sendet sie Ihre Kontodaten, die Versandadresse, den Stadtteil, die Stadt und die Postleitzahl des Kunden sowie Paketgewicht und -größe. OpenCart hat kein Feld für den Stadtteil: Die Erweiterung verwendet Address 2, wenn dort ein Stadtteilname steht (ohne Ziffern), sonst die Stadt. Ein Inlandstarif wird erst angefragt, nachdem der Kunde eine Stadt und eine vierstellige Postleitzahl eingegeben hat. Für andere Länder sendet sie das Zielland, Paketgewicht und -größe sowie den Bestellwert in NZD.

Verwendet wird der günstigste erlaubte Dienst mit einem Preis, einschließlich Zuschlägen und verpflichtender Zusatzleistungen. Der Preis wird von NZD in die Standardwährung des Shops umgerechnet, auf deren Dezimalstellen gerundet und dem Kunden in seiner Währung mit der Steuer der gewählten Tax class angezeigt. Jede Antwort wird 1 Stunde zwischengespeichert. Eine fehlgeschlagene Anfrage wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf NZ Post warten muss. Das API-Zeitlimit beträgt 10 Sekunden. Das Zugriffstoken bleibt bis zu seinem Ablauf gültig, und ein abgelehntes Token wird automatisch erneuert.

Gibt NZ Post keinen Tarif zurück (API nicht eingerichtet, Fehler, unvollständige Adresse, Dienst nicht verfügbar, kein NZD-Kurs), sieht der Kunde keine Fehlermeldung. Verwendet wird der Preis aus der Länder-Tabelle, dann der Ersatzpreis. Gibt es keinen festen Preis, wird die Methode ausgeblendet. Der Grund wird im Protokoll festgehalten.

In OpenCart 4 klickt der Kunde im Block der Versandart auf der Kassenseite auf Choose und wählt im Fenster Shipping method options eine Option von NZ Post aus. Die Tarife sind dieselben wie in OpenCart 3.

Die Erweiterung berechnet nur Tarife. Sie erstellt keine Versandetiketten, erzeugt keine Manifeste, bucht keine Abholungen, verfolgt keine Pakete, prüft keine Adressen und lässt Kunden keine Abholstelle, kein Postfach (PO Box) und keinen Paketautomaten wählen. Der Warenkorb wird als ein Paket bepreist, und der Kunde sieht einen Tarif von NZ Post, keine Liste von Diensten.

Bestellungen

Wenn eine Bestellung mit NZ Post aufgegeben wird, speichert die Erweiterung, worauf der Versandpreis beruhte. Öffnen Sie die Bestellung unter Sales > Orders: Die Bestellseite zeigt ein Feld NZ Post mit NZ Post service (der bepreiste Dienst eines Live-Tarifs mit seinem Code) und Price source: Live rate (NZ Post ShippingOptions API), Fixed price oder Free shipping. Das Feld zeigt die Werte aus dem Zeitpunkt der Bestellung, auch wenn sich Tarife oder Einstellungen später ändern, und auch dann, wenn die Methode ausgeschaltet ist. Der Kunde sieht den Dienstnamen nicht.

In OpenCart 4 wird das Feld NZ Post oberhalb von History angezeigt. OpenCart 4 führt für den Checkout eine einzige Bestellung und aktualisiert sie jedes Mal, wenn der Kunde erneut bestätigt: Der gespeicherte Dienst und die Preisquelle werden dann mit aktualisiert. Wechselt der Kunde diese Bestellung zu einer anderen Versandart, werden die NZ-Post-Daten der Bestellung entfernt.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox NZ Post ist der erste Block auf Extensions > Extensions > Shipping > VibeFox NZ Post > Edit, 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 zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-shipping-nz-post und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Admin-Bereichs (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 Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Shop-Adresse aus der OpenCart-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 wird NZ Post Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Administrator, der im Admin im selben Browser angemeldet ist, sieht die Methode im Shop weiterhin, markiert als (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin nicht, daher wird die Methode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint eine Erinnerung im Dashboard des Admins. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen.

Wenn eine Lizenz abläuft, arbeitet die Erweiterung weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard des Admins oder die Seite Edit öffnen: 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 der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

NZ Post erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable NZ Post eingeschaltet ist. Prüfen Sie Geo zone (oder Ignore shipping zones und Countries), die Gewichtsgrenzen und Minimum order amount. Wenn NZ Post keinen Tarif liefert, wird die Methode nur mit einem Länderpreis oder einer Fallback cost angezeigt. Prüfen Sie, ob die Produkte Requires Shipping auf Yes haben.

Live-Tarife erscheinen nicht: Sehen Sie sich die Warnungen oben auf der Erweiterungsseite an. Schalten Sie dann das Debug log ein, laden Sie die Kasse neu und sehen Sie sich das Feld Log an. API-Fehler stehen dort immer. Das Protokoll nennt den Grund: fehlende Client ID oder Client Secret, ein abgelehntes Token, fehlende Konto- oder Versanddaten, noch keine Stadt oder Postleitzahl des Kunden, kein NZD-Kurs oder kein bepreister Dienst. Während Sie das Problem beheben, werden feste Preise verwendet.

Die Tokenanfrage schlägt fehl: Prüfen Sie die Client ID, das Client Secret und die Environment. UAT-Zugangsdaten funktionieren nicht mit der Produktion und umgekehrt.

Inlandstarife fehlen, Auslandstarife funktionieren: Tarife innerhalb Neuseelands benötigen die Account number, den Auth code oder den Site code sowie die vollständige Versandadresse mit vierstelliger Postleitzahl. Der Kunde muss eine Stadt und eine vierstellige Postleitzahl eingeben.

Mein Shop rechnet nicht in NZD: Geben Sie den NZD-Kurs ein (das Feld NZD → (Ihre Währung) Kurs). Feste Preise gelten immer in der Standardwährung des Shops.

GST wird auf den Versand doppelt berechnet: Inlandspreise von NZ Post enthalten 15 % GST. Wenn die Methode eine Tax class hat, stellen Sie API prices auf Excluding GST.

Tarife wirken nach einer Änderung veraltet: Klicken Sie auf der Erweiterungsseite auf Save. Dadurch werden die zwischengespeicherten NZ-Post-Tarife und Token gelöscht.

Auf der Seite steht „Warning: You do not have permission to modify VibeFox NZ Post!“: Ihre Admin-Benutzergruppe darf die Einstellungen möglicherweise nur ansehen. Geben Sie der Gruppe die Berechtigung zum Ändern für extension/shipping/vfd_nz_post (OpenCart 3) oder extension/vfd_nz_post/shipping/vfd_nz_post (OpenCart 4) unter System > Users > User Groups.

Für Entwickler: Der für eine Lieferadresse in Neuseeland übermittelte Stadtteil lässt sich mit dem OpenCart-Ereignis vfd_nz_post/delivery_suburb (Auslöser catalog/vfd_nz_post/delivery_suburb) ändern. Die Adresse der NZ-Post-API lässt sich mit der Einstellung vfd_nzpt_api_url (für Tests) ersetzen; sie hat kein Feld auf der Einstellungsseite.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox NZ Post auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt Enable NZ Post, Sort order, Tax class und Geo zone immer zurück. Die zwischengespeicherten Tarife und Token werden immer entfernt, und das Feld NZ Post wird auf der Bestellseite nicht mehr angezeigt. Ist Remove data on uninstall aktiviert, werden außerdem die NZ-Post-Einstellungen und das Debug-Protokoll gelöscht. Ist die Option aus, bleiben die übrigen Einstellungen erhalten und werden bei einer erneuten Installation wieder verwendet. Die gespeicherten NZ-Post-Angaben zu Bestellungen werden nie gelöscht und erscheinen nach einer erneuten Installation wieder. Bestehende Bestellungen behalten ihre Versandart und ihre Kosten.

In OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox NZ Post auf Uninstall (die orangefarbene −-Schaltfläche) und anschließend auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

NZ Post ist eine Marke des jeweiligen Inhabers. Diese Erweiterung ist nicht mit NZ Post verbunden und wird von NZ Post nicht unterstützt.