VibeFox Australia Post for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Australia Post PAC API-Schlüssel (nur für Live-Tarife): Live-Tarife nutzen die Postage Assessment Calculator (PAC) API von Australia Post. Der Schlüssel ist kostenlos: Registrieren Sie sich im Australia Post Developer Centre (developers.auspost.com.au) für einen PAC API-Schlüssel. Außerdem benötigen Sie die vierstellige australische Postleitzahl, von der Sie versenden. Wenn Sie nur feste Preise je Land verwenden, brauchen Sie keinen API-Schlüssel.

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_australia_post per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Australia Post 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. Wählen Sie die Rate source. Für Live-Tarife geben Sie den PAC API-Schlüssel, Ihre Versand-Postleitzahl und, falls die Shop-Währung nicht AUD ist, den Umrechnungskurs in AUD ein (siehe Konfiguration).

6. Fügen Sie VibeFox Australia Post unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone hinzu oder aktivieren Sie Ignore shipping zones und wählen Sie die Länder aus.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Australia Post. 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 der Kunde für diese Zone sieht. Leer lassen, um den globalen Method title zu verwenden.

Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Australia-Post-Tarife gelöscht. Wenn Live-Tarife gewählt sind, aber der API-Schlüssel, die Versand-Postleitzahl oder der AUD-Kurs fehlt, wird nach dem Speichern eine Warnung angezeigt.

General

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

Method title: der Name der Versandart, den der Kunde an der Kasse sieht. Eine Zone kann ihn durch einen eigenen Titel ersetzen. Standard: Australia Post.

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

Rate source: wie der Preis berechnet wird.

Fehlerdetails werden im Protokoll gespeichert, niemals dem Kunden angezeigt.

Australia Post API (Live-Tarife) (für feste Preise nicht erforderlich)

PAC API key: Ihr kostenloser Australia-Post-PAC-API-Schlüssel. Er wird im Header AUTH-KEY an Australia Post gesendet.

Ship-from postcode: die vierstellige australische Postleitzahl, von der die Pakete versendet werden, zum Beispiel 2000.

Domestic service: wird für Lieferungen innerhalb Australiens verwendet (bis 22 kg, 105 cm pro Seite): Parcel Post (Standard) oder Express Post.

International service: wird für Lieferungen außerhalb Australiens verwendet (bis 20 kg): International Standard (Standard), International Express oder International Courier.

Remove GST: teilt die inländischen API-Preise durch 1,1. Inländische Preise von Australia Post enthalten 10 % GST. Aktivieren Sie die Option, wenn WooCommerce die Steuer selbst auf den Versand aufschlägt (Tax status = Taxable), damit die GST nicht doppelt berechnet wird. Internationales Porto ist GST-frei und wird nie geändert.

AUD → (your currency) rate: Australia-Post-Preise sind in AUD. Wenn die Shop-Währung nicht AUD ist, geben Sie ein, wie viele Einheiten Ihrer Währung einem AUD entsprechen, zum Beispiel 0.61. Ohne diesen Wert werden Live-Tarife nicht verwendet. Ist die Shop-Währung AUD, lassen Sie das Feld leer. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Paket für Live-Tarife

Der Warenkorb wird als ein einziges Paket versendet. Produktgewichte und -abmessungen werden von Ihren Shop-Einheiten in kg und cm umgerechnet. Die folgenden Werte gelten für Produkte ohne Gewicht oder Abmessungen.

Default product weight (kg): wird für jedes Produkt ohne Gewicht verwendet, in der Anfrage an Australia Post und bei der Prüfung von Min cart weight / Max cart weight. Standard: 1.

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

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

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

Feste Preise (werden bei festen Preisen und als Ersatz für Live-Tarife verwendet)

Country prices: eine Tabelle mit zweistelligen Ländercodes (AU, NZ, US usw.) und Preisen in Ihrer Shop-Währung. Klicken Sie auf + Add row, um ein Land hinzuzufügen, und auf die Schaltfläche zum Entfernen, um eines zu löschen. Verwenden Sie * für alle übrigen Länder. Ein Land ohne Preis (und ohne Zeile mit *) erhält keinen festen Tarif, daher wird die Methode dafür ausgeblendet. Die Tabelle ist leer, bis Sie Preise eintragen.

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

Bedingungen

Min cart weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze.

Max cart weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. Standard: 22. 0 bedeutet keine Grenze. Pakete von Australia Post: 22 kg im Inland, 20 kg international.

Minimum order amount: zeigt die Methode nur, wenn die Zwischensumme des Warenkorbs diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Excluded shipping classes: blendet die Methode aus, wenn ein Artikel im Warenkorb eine dieser WooCommerce-Versandklassen hat.

Free shipping: aktiviert kostenlosen Versand ab dem unten angegebenen Betrag.

Free shipping from: die Zwischensumme des Warenkorbs, ab der der Versand kostenlos ist. In diesem Fall wird keine API-Anfrage gestellt.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Methode für die unten angegebenen Länder an, unabhängig davon, welche Zone passt.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die Ihr Shop liefert. Wird nur zusammen mit Ignore shipping zones verwendet.

Erweitert

Debug log: protokolliert die Tarifberechnungen unter WooCommerce > Status > Logs, Quelle „vfd-australia-post“. API-Fehler werden immer protokolliert. Der API-Schlüssel und die Postleitzahlen der Kunden werden nicht protokolliert.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins dessen Einstellungen, Zonenmethoden und zwischengespeicherte Tarife. Das Deaktivieren des Plugins löscht nie etwas.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst das Warenkorbgewicht, den Minimum order amount und die Excluded shipping classes. Gilt kostenloser Versand, beträgt der Tarif 0 und es wird keine Anfrage an Australia Post gesendet.

Im Modus mit festen Preisen wird der Preis aus der Tabelle übernommen. In den Live-Modi sendet das Plugin an Australia Post das Paketgewicht und bei Inlandslieferungen die Versand- und Zielpostleitzahlen sowie die Paketgröße; bei internationalen Lieferungen das Zielland. Ein inländischer Live-Tarif wird erst angefragt, nachdem der Kunde eine vierstellige Postleitzahl eingegeben hat. Ist das Paket über den Grenzwerten von Australia Post (22 kg oder 105 cm im Inland, 20 kg international), wird keine Anfrage gesendet. Der AUD-Preis wird mit Ihrem Kurs umgerechnet, und die GST wird bei inländischen Preisen entfernt, wenn Remove GST aktiv ist.

Jede erfolgreiche Antwort wird 1 Stunde zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf Australia Post warten muss. API-Fehler werden dem Kunden nie angezeigt: Die Methode wird ausgeblendet oder im Ersatzmodus wird der feste Preis verwendet.

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

Das Plugin berechnet nur Tarife. Es erstellt keine Versandetiketten, eParcel- oder MyPost-Business-Sendungen oder Manifeste, verfolgt keine Pakete und ermöglicht Kunden nicht die Wahl von Paketstationen oder Postfilialen. Der Warenkorb wird immer als ein Paket berechnet. Briefe, Satchels und Vertragstarife (eParcel) sind nicht enthalten.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Australia Post. 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 gültig 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 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 einen aktiven Schlüssel wird Australia Post Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen die Methode 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 Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Australia Post erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Landes des Kunden hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen des Warenkorbs, den Minimum order amount und die Excluded shipping classes. Im Modus mit festen Preisen prüfen Sie, ob das Land oder * einen Preis hat.

Live-Tarife erscheinen nicht: Aktivieren Sie das Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs (Quelle „vfd-australia-post“). Dort steht der Grund: kein API-Schlüssel oder keine Versand-Postleitzahl, noch keine vierstellige Lieferpostleitzahl, ein Paket über den Grenzwerten, kein AUD-Umrechnungskurs oder die Fehlermeldung von Australia Post. Mit Live rates, fixed price if the API gives no rate erhalten Kunden weiterhin den festen Preis, während Sie das Problem beheben.

Mein Shop ist nicht in AUD: Tragen Sie den Umrechnungskurs (wie viele Einheiten Ihrer Währung einem AUD entsprechen) unter AUD → (your currency) rate ein. Feste Preise gelten immer in Ihrer Shop-Währung.

Die GST wird auf den Versand doppelt berechnet: Inländische Preise von Australia Post enthalten 10 % GST. Wenn Tax status auf Taxable steht, aktivieren Sie Remove GST.

Der Preis ist zu hoch oder zu niedrig: Prüfen Sie die Produktgewichte und -abmessungen sowie die Standardwerte unter Parcel for live rates. Bei Item (price × quantity) werden feste Preise mit der Anzahl der Artikel multipliziert.

Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Australia-Post-Tarife gelöscht.

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

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonenmethoden und zwischengespeicherte Tarife 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.

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