VibeFox Purolator for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer. Die PHP-SOAP-Erweiterung ist nicht erforderlich.

Purolator E-Ship Web Services (nur für Live-Tarife): Registrieren Sie sich für E-Ship Web Services im Purolator E-Ship Resource Centre auf der Website von Purolator. Purolator stellt getrennte Schlüssel und Passwörter für die Entwicklungs- und die Produktivumgebung bereit. Außerdem benötigen Sie Ihre Purolator-Abrechnungskontonummer und die kanadische Postleitzahl, von der Sie versenden. Wenn Sie nur feste Preise verwenden, brauchen Sie keine API-Schlüssel.

VibeFox-Lizenzschlüssel: Kauf auf 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 und klicken Sie auf Install Now. Sie können auch den Ordner vfd_purolator per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Purolator, oder klicken Sie auf der Plugins-Seite 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. Für Live-Tarife füllen Sie den Abschnitt Purolator API (live rates) aus. Zum Testen aktivieren Sie Development environment mit dem Entwicklungsschlüssel. Füllen Sie Country prices oder Fallback price aus, wenn Sie feste Preise oder einen Ausweichpreis möchten (siehe Konfiguration).

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

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Purolator. Sie gelten für alle Versandzonen. Wenn Sie die Versandart 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.

Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Purolator-Tarife gelöscht. Wenn Live-Tarife mit den gespeicherten Werten nicht funktionieren können (fehlender Schlüssel, Passwort oder Konto, keine kanadische Versand-Postleitzahl, kein CAD-Kurs) oder wenn weder API-Zugangsdaten noch feste Preise vorhanden sind, erscheint oberhalb der Einstellungen eine Warnung.

Allgemein

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

Method title: der Name der Versandart, der im Warenkorb und auf der Kasse angezeigt wird. Eine Zone kann ihn überschreiben. Standard: Purolator.

Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht. Siehe auch Canadian sales taxes weiter unten.

Purolator-API (Live-Tarife)

Mit ausgefülltem API-Schlüssel, Passwort und Abrechnungskonto stammt der Preis aus dem Web-Service Purolator E-Ship Estimating. Wenn Purolator keinen Tarif liefert, wird der feste Preis verwendet, oder die Versandart wird ausgeblendet, wenn es keinen gibt.

API key: Ihr E-Ship-Web-Services-Schlüssel für die gewählte Umgebung.

API password: das Passwort zum Schlüssel.

Billing account number: Ihre Purolator-Kontonummer. Die Schätzungen nutzen die Tarife dieses Kontos. Die Entwicklungsumgebung akzeptiert das Testkonto aus der Purolator-Dokumentation.

Development environment: nutzt die Purolator-Entwicklungsumgebung (devwebservices.purolator.com) mit dem Entwicklungsschlüssel. Die Preise sind Testdaten. Schalten Sie sie in einem Live-Shop aus.

Ship-from postal code: die kanadische Postleitzahl, von der die Pakete versendet werden, zum Beispiel L4W 5M8.

Service in Canada: Cheapest available (Standard), Purolator Ground, Purolator Ground 9AM, Purolator Ground 10:30AM, Purolator Ground Evening, Purolator Express, Purolator Express 9AM, Purolator Express 10:30AM, Purolator Express 12PM oder Purolator Express Evening.

Service to the USA: Cheapest available (Standard), Purolator Ground U.S., Purolator Express U.S., Purolator Express U.S. 9AM, Purolator Express U.S. 10:30AM oder Purolator Express U.S. 12:00.

International service: Cheapest available (Standard), Purolator Express International, Purolator Express International 9AM, Purolator Express International 10:30AM oder Purolator Express International 12:00.

Wenn der gewählte Service für die Adresse nicht angeboten wird, wird der günstigste verfügbare verwendet.

Canadian sales taxes: Bei kanadischen Adressen enthält der Purolator-Gesamtpreis GST/HST/PST/QST. Aktivieren Sie Use Purolator prices without GST/HST/PST/QST, wenn Tax status auf Taxable steht, damit die Steuer nicht doppelt berechnet wird.

CAD → (store currency) rate: Purolator-Preise sind in CAD. Wenn die Währung Ihres Shops nicht CAD ist, geben Sie an, wie viele Einheiten Ihrer Währung einem CAD entsprechen, zum Beispiel 0.68. Ohne diesen Wert werden keine Live-Tarife verwendet. Wenn die Währung Ihres Shops CAD ist, lassen Sie das Feld leer.

Default product weight (kg): wird für jedes Produkt ohne Gewicht verwendet. Standard: 0.5. Gewichte werden aus der Shop-Einheit umgerechnet und als Gesamtgewicht in ganzen Pfund an Purolator gesendet, aufgerundet.

Feste Preise (werden ohne API-Zugangsdaten und als Ausweichpreis verwendet, wenn die API keinen Tarif liefert)

Country prices: ein Preis je Land und Warenkorbgewicht in der Shop-Währung. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Wählen Sie * Default (all other countries) für eine Zeile, die alle Länder ohne eigene Zeile abdeckt. Jede Zeile hat einen Base-Preis und Größenspalten: XS bis 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg und XL über 5 kg. Ein leerer oder Nullpreis in einer Größe verwendet Base. Ein Base von 0 oder ein leeres Base bedeutet kostenlosen Versand für Gewichte ohne eigenen Größenpreis. Zeilen ohne Preis und ungültige Ländercodes werden beim Speichern entfernt. Je Land bleibt nur eine Zeile erhalten.

Fallback price: der Preis für ein Land ohne Zeile in Country prices und ohne *-Zeile. Leer lassen, um die Versandart für solche Länder auszublenden.

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 die gesamte Sendung berechnet.

Bedingungen

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

Max cart weight (kg): blendet die Versandart aus, wenn der Warenkorb mehr wiegt. Standard: 30. 0 bedeutet keine Grenze.

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

Excluded shipping classes: blendet die Versandart aus, wenn der Warenkorb ein Produkt aus einer dieser WooCommerce-Versandklassen enthält.

Free shipping from: die Zwischensumme des Warenkorbs, ab der der Versand kostenlos ist. Das gilt nur, wenn die Versandart einen Preis hat: ein Länderpreis oder der Ausweichpreis (dann wird keine Anfrage an Purolator gesendet) oder ein Live-Tarif. Leer lassen, um nie kostenlosen Versand anzubieten.

Das Warenkorbgewicht für diese Bedingungen zählt Produkte ohne Gewicht als 0. Preise und Gewichte akzeptieren Komma oder Punkt als Dezimaltrennzeichen.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Purolator für die unten genannten Länder an, auch wenn die Versandart keiner Versandzone hinzugefügt ist.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die Sie versenden. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: schreibt die Tarifberechnungen in WooCommerce > Status > Logs (Quelle „vfd-purolator“). API-Fehler werden immer protokolliert, auch wenn das Debug-Protokoll ausgeschaltet ist. API-Schlüssel, das Abrechnungskonto und die Postleitzahlen der Kunden werden nicht protokolliert. Schalten Sie das Protokoll nach Abschluss wieder aus.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins seine Einstellungen, Zonen-Versandarten und zwischengespeicherten Tarife. Das Deaktivieren des Plugins löscht nie etwas.

So funktioniert es auf der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Lieferland, Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Dann sucht es einen Preis: den Live-Tarif von Purolator, danach die Länder-Tabelle, danach den Ausweichpreis. Gibt es keinen Preis, wird die Versandart ausgeblendet. Gilt kostenloser Versand, sieht der Kunde die Versandart kostenlos.

Mit API-Zugangsdaten sendet das Plugin an Purolator eine Quick-Estimate-Anfrage: Ihr Abrechnungskonto, die Versand-Postleitzahl, Ort, Provinz oder Bundesstaat des Kunden, Land und Postleitzahl sowie das Gesamtgewicht des Warenkorbs in ganzen Pfund. Für Kanada ist eine gültige Postleitzahl nötig, für die USA ein gültiger ZIP-Code; andere Länder werden mit der eingegebenen Postleitzahl gesendet. Abmessungen (Volumengewicht) werden nicht übermittelt. Purolator liefert die Preise aller Services; das Plugin nimmt Ihren gewählten Service oder den günstigsten, entfernt kanadische Verkaufssteuern, falls eingestellt, und rechnet den Preis aus CAD um. Der Service wird mit der Bestellung als Purolator service gespeichert und ist auf dem Bestellbildschirm im Admin-Bereich sichtbar.

Jede Antwort wird 1 Stunde lang zwischengespeichert. Eine fehlgeschlagene Anfrage wird 10 Minuten lang zwischengespeichert, damit ein Purolator-Ausfall nicht jede Aktualisierung der Kasse verlangsamt. Das API-Timeout beträgt 10 Sekunden.

Wenn Purolator keinen Tarif liefert (API nicht erreichbar, falsche Zugangsdaten oder Postleitzahl, Service nicht verfügbar, kein CAD-Kurs), sieht der Kunde keine Fehlermeldung. Der feste Preis wird verwendet, oder die Versandart wird ausgeblendet, wenn kein fester Preis vorhanden ist. Der Grund wird im Protokoll festgehalten.

Die Versandart funktioniert auf 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 Purolator-Sendungen, druckt keine Etiketten, bucht keine Abholungen, bearbeitet keine Rücksendungen und verfolgt keine Pakete. Es verwendet nicht den Full Estimate (Abmessungen, mehrere Teile, Optionen wie Unterschrift oder Gefahrgut), zeigt keine Lieferdaten, stellt nicht mehrere Services als eigene Tarife dar und ruft keine Wechselkurse automatisch ab.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock steht oben unter WooCommerce > Settings > Shipping > VibeFox Purolator. 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 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 den Domain-Platz nicht frei. Geben Sie ihn in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Purolator Kunden auf der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es 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, für Updates und Support ist aber eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Purolator erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Versandart der Zone des Kundenlandes hinzugefügt ist (oder Ignore shipping zones aktiv und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Wenn Purolator keinen Tarif liefert, wird die Versandart nur mit einem Länderpreis, einer *-Zeile oder einem Fallback price angezeigt.

Live-Tarife erscheinen nicht: Öffnen Sie WooCommerce > Status > Logs, Quelle „vfd-purolator“. API-Fehler stehen dort immer. Aktivieren Sie Debug log für Details. Mit API-Schlüsseln muss die Adresse eine gültige Postleitzahl (Kanada) oder einen gültigen ZIP-Code (USA) haben.

HTTP 401 im Protokoll: API-Schlüssel oder Passwort passen nicht zur gewählten Umgebung. Entwicklungsschlüssel funktionieren nur mit eingeschalteter Development environment, Produktionsschlüssel nur mit ausgeschalteter.

Der Tarif weicht von der Purolator-Website ab: Die Quick Estimate nutzt die Tarife Ihres Abrechnungskontos und das auf ganze Pfund aufgerundete Gesamtgewicht, ohne Volumengewicht. Bei kanadischen Adressen enthält der Gesamtpreis Verkaufssteuern; verwenden Sie Canadian sales taxes, wenn WooCommerce Steuern auf den Versand aufschlägt. Preise werden mit Ihrem CAD → (store currency) rate umgerechnet.

Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Das löscht die zwischengespeicherten Purolator-Tarife.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel etwa schon auf einer anderen Domain benutzt, 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 Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonen-Versandarten und zwischengespeicherte Tarife werden nur entfernt, wenn Remove data on uninstall aktiviert war. Sonst bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen.

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