VibeFox FedEx for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

FedEx-Konto und API-Schlüssel (nur für Live-Tarife): Erstellen Sie im FedEx Developer Portal (developer.fedex.com) ein Projekt mit der Rate API, verknüpfen Sie Ihr FedEx-Versandkonto und kopieren Sie den API Key und den Secret Key. Außerdem benötigen Sie Ihre 9-stellige FedEx-Kontonummer. Testschlüssel funktionieren nur bei aktivierter Sandbox, Produktionsschlüssel nur bei deaktivierter. Das Plugin verwendet die FedEx REST API mit OAuth 2.0; es benötigt weder eine Meter Number noch ein Passwort für Webservices. Wenn Sie nur Festpreise verwenden, brauchen Sie keine FedEx-Schlüssel.

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox FedEx, 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. Geben Sie den API Key, den Secret Key, die 9-stellige FedEx-Kontonummer und die Adresse Ship from ein (PLZ und bei den USA und Kanada den 2-stelligen Bundesstaat). Deaktivieren Sie Sandbox, wenn Sie Produktionsschlüssel verwenden.

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

7. Optional können Sie Festpreise als Ausweichlösung eingeben.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox FedEx. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name dieser Option an der Kasse. Lassen Sie das Feld leer, um den globalen Name zu verwenden.

Oben auf der Seite zeigt das Plugin Warnungen an: Nur einige der drei API-Zugangsdaten sind ausgefüllt, es fehlen API-Schlüssel oder Festpreise (dann wird die Methode nie angezeigt), es fehlt die PLZ des Versandorts, für die USA oder Kanada fehlt der Bundesstaat des Versandorts, oder die Shop-Währung weicht von der Währung des FedEx-Kontos ab, ohne dass ein Wechselkurs hinterlegt ist. Bei jedem Speichern der Einstellungen werden das zwischengespeicherte FedEx-Token und die Tarife gelöscht. Zahlenfelder akzeptieren einen Dezimalpunkt oder ein Komma. Eine ungültige Zahl wird nicht gespeichert und gemeldet.

General

Enable/Disable: schaltet den FedEx-Versand in allen Zonen gleichzeitig ein oder aus. Standard: ein.

Name: der Name der Versandmethode, den der Kunde an der Kasse sieht. Standard: FedEx.

Tax status: Taxable lässt WooCommerce Steuern auf die Versandkosten aufschlagen, daher wird der FedEx-Betrag ohne Steuern verwendet. None übernimmt den FedEx-Nettobetrag unverändert. Standard: Taxable.

FedEx-API (Live-Tarife)

Ohne Schlüssel werden die Festpreise verwendet. Der Abschnitt enthält den Link Clear cached FedEx token and rates.

Sandbox: verwendet die FedEx-Sandbox mit Testschlüsseln. Deaktivieren Sie die Option für echte Tarife mit Produktionsschlüsseln. Standard: ein.

API Key: der API Key (client_id) Ihres Projekts im FedEx Developer Portal.

Secret Key: der Secret Key (client_secret) desselben Projekts.

FedEx account number: das 9-stellige FedEx-Versandkonto, das mit dem Projekt verknüpft ist.

Rates: Account rates (your negotiated FedEx prices) (Standard) oder List rates (FedEx published prices).

Residential delivery: Kundenadressen werden als Privatadressen kalkuliert (FedEx Home Delivery, Zuschlag für Privatzustellung). Deaktivieren Sie die Option, wenn Sie überwiegend an Unternehmen liefern. Standard: ein.

Box size: optionale Paketmaße in der Maßeinheit Ihres Shops, zum Beispiel 30x20x15. FedEx wendet dann das Dimensionsgewicht an. Lassen Sie das Feld leer, um nur nach Gewicht zu kalkulieren.

FedEx account currency: die Währung Ihres FedEx-Kontos, zum Beispiel USD für US-Konten oder CAD für Kanada. Standard: USD. FedEx wird immer auch um eine Kalkulation in der Shop-Währung gebeten.

Exchange rate: nur nötig, wenn FedEx Tarife ausschließlich in der Kontowährung zurückgibt und Ihre Shop-Währung abweicht: der Preis von 1 Einheit der Kontowährung in Ihrer Shop-Währung, zum Beispiel 0.92. Ohne diesen Wert werden solche Tarife nicht verwendet.

Versand ab

Die Adresse, an der FedEx die Pakete abholt oder an der Sie diese abgeben. Sie wird für Live-Tarife verwendet.

Country: das Land, aus dem Sie versenden. Standard: United States.

State / province code: der 2-stellige Code, für die USA und Kanada erforderlich, zum Beispiel TN, CA oder ON.

City: die Stadt des Versandorts.

ZIP / postal code: die Postleitzahl des Versandorts. FedEx benötigt sie für die Kalkulation der Tarife.

Festpreise

Sie werden verwendet, wenn keine API-Schlüssel eingegeben sind, und als Ausweichlösung, wenn FedEx keinen Tarif zurückgibt (API nicht erreichbar, falsche Schlüssel, kein Service). Lassen Sie beide Felder leer, um die Methode in diesem Fall auszublenden.

Country prices: der Preis in Ihrer Shop-Währung je Zielland, eine Zeile pro Land im Format CC=PREIS, zum Beispiel US=12.99 oder CA=19,99. Verwenden Sie * für jedes andere Land, zum Beispiel *=29.99. Zeilen in einem anderen Format werden beim Speichern ignoriert und gemeldet.

Fallback cost: ein fester Preis, wenn kein Länderpreis passt. Lassen Sie das Feld leer, um die Methode auszublenden.

Fixed price is: Per order berechnet den Preis einmal. Per item (price x number of items) multipliziert ihn mit der Anzahl der Artikel. Dies gilt nur für Festpreise. FedEx-Live-Tarife werden immer für das Gesamtgewicht des Warenkorbs kalkuliert.

Bedingungen

Free shipping from: die Warenkorb-Zwischensumme, ab der diese Methode kostenlos ist. Lassen Sie das Feld leer, wenn es nie einen kostenlosen Versand geben soll.

Minimum subtotal: zeigt die Methode nur an, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Min weight (kg): das Mindestgewicht des Warenkorbs, damit die Methode erscheint. 0 bedeutet keine Grenze.

Max weight (kg): das maximale Gewicht des Warenkorbs. Wird es überschritten, ist die Methode ausgeblendet. 0 bedeutet keine Grenze.

Default product weight (kg): das Gewicht für Produkte ohne Gewichtsangabe, für die FedEx-Tarife und für die oben genannten Gewichtsgrenzen. Standard: 0.5.

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

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Methode für die unten angegebenen Länder auch dann an, wenn sie keiner Versandzone hinzugefügt wurde. Eine Zonenmethode, die in ihrer Zone deaktiviert ist, bleibt deaktiviert.

Countries: die Zielländer für diesen Modus. Leer lassen für alle Versandländer des Shops. Wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: protokolliert API-Anfragen und die Tarifberechnung unter WooCommerce > Status > Logs, Quelle vfd-fedex. API-Fehler werden immer protokolliert. Schlüssel, Token und Kundenadressen werden nie protokolliert.

Remove data on uninstall: ist die Option aktiv, werden beim Löschen des Plugins alle Plugin-Einstellungen und Zonenmethoden entfernt. Das Deaktivieren löscht nie Einstellungen.

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, die Mindestzwischensumme und die ausgeschlossenen Versandklassen. Gilt kostenloser Versand, sieht der Kunde die Methode als FedEx (Free), und es wird keine Anfrage an FedEx gesendet.

Andernfalls holt das Plugin ein OAuth-Token und sendet an die FedEx Rate API die Versandadresse, die Lieferadresse, das Warenkorbgewicht (in kg, bei Shops mit lb oder oz in lb), die Paketgröße, falls festgelegt, und Ihre Shop-Währung als bevorzugte Währung. In Ländern mit Postleitzahlen erfolgt die Anfrage erst, nachdem der Kunde eine eingegeben hat. Bei internationalen Sendungen wird der Zollwert des Warenkorbs übermittelt. Bundesstaatencodes werden nur für die USA und Kanada gesendet.

FedEx liefert die verfügbaren Services zurück. Für jeden Service übernimmt das Plugin den von Ihnen gewählten Konto- oder Listentarif, bevorzugt einen Tarif in Ihrer Shop-Währung, rechnet einen Tarif in der Kontowährung mit Ihrem Wechselkurs um und verwirft Tarife, die es nicht umrechnen kann. Der günstigste Service wird unter Ihrem Methodennamen angezeigt, und sein Name wird mit der Versandposition der Bestellung gespeichert.

Das Token wird pro Umgebung und Schlüssel zwischengespeichert und automatisch neu angefordert, wenn FedEx es ablehnt. Berechnungen werden 1 Stunde zwischengespeichert. Eine fehlgeschlagene Tarifanfrage wird 10 Minuten lang gemerkt, eine fehlgeschlagene Token-Anfrage 5 Minuten lang, damit ein Ausfall nicht jede Aktualisierung der Kasse verlangsamt. Das Timeout der API beträgt 15 Sekunden. Antwortet FedEx nicht, sieht der Kunde keine Fehlermeldung: Es wird der Festpreis verwendet, oder die Methode wird ausgeblendet.

Die Methode funktioniert an der klassischen Kasse und am Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin berechnet nur Tarife. Es erstellt keine FedEx-Sendungen, druckt keine Etiketten, bucht keine Abholungen, verfolgt keine Pakete und lässt Kunden keinen FedEx-Standort wählen. Es zeigt eine Option (den günstigsten Service) statt mehrerer an, und es gibt keine Verpackungsoptimierung: Der Warenkorb wird als ein Paket kalkuliert.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox FedEx. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, 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 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 aktiven Schlüssel wird FedEx Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager 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 Seite Plugins und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

FedEx 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 Warnungen oben auf der Einstellungsseite, die Gewichtsgrenzen, Minimum subtotal und Excluded shipping classes. Ohne Live-Tarif benötigt die Methode einen Länderpreis, eine *-Zeile oder eine Fallback cost.

Live-Tarife erscheinen nicht: Aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-fedex. Dort werden falsche Schlüssel, die falsche Umgebung (Testschlüssel bei deaktivierter Sandbox oder Produktionsschlüssel bei aktivierter) und FedEx-Fehlercodes protokolliert.

Mein Shop verwendet nicht USD: FedEx wird um den Tarif in der Shop-Währung gebeten. Gibt Ihr Konto nur seine eigene Währung zurück, legen Sie FedEx account currency und Exchange rate fest. Ohne Wechselkurs werden solche Tarife ignoriert und der Festpreis wird verwendet, sodass ein USD-Betrag nie als Euro angezeigt wird.

Multipliziert „per item“ den FedEx-Tarif? Nein. Per item gilt nur für Festpreise.

Tarife wirken nach einer Änderung veraltet: Nach einer Änderung der Schlüssel wird der Cache automatisch geleert. Sie können auch auf Clear cached FedEx token and rates klicken.

Nur bestimmte Services sollen angeboten werden: Entwickler können Services mit dem Filter vfd_fdx_allowed_services einschränken.

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. 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 Einstellungen und löscht nur die zwischengespeicherten Token und Tarife. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins, die zwischengespeicherten Token und Tarife sowie alte Protokolldateien werden immer entfernt. 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.

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