DE
EUR
Zurück

VibeFox EasyPost 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.

EasyPost-Konto (nur für Live-Tarife): Legen Sie ein Konto auf der EasyPost-Website an, verbinden Sie Ihre Versanddienstleister-Konten (USPS, UPS, FedEx und weitere) im EasyPost-Dashboard und kopieren Sie den API-Schlüssel aus EasyPost Dashboard > Account Settings > API Keys. EasyPost berechnet Gebühren für gekaufte Etiketten, nicht für Tarifanfragen. Wenn Sie nur Ersatzpreise nutzen, benötigen Sie kein EasyPost-Konto.

Produkte: Produkte benötigen ein Gewicht und besser auch Abmessungen.

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox EasyPost, 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. Fügen Sie Ihren EasyPost-API-Schlüssel ein und füllen Sie die Adresse unter Ship from aus. Die Postleitzahl ist für Live-Tarife erforderlich.

6. Wenn die Währung Ihres Shops nicht USD ist, geben Sie den USD exchange rate ein. Optional können Sie Ersatzpreise eingeben (siehe Konfiguration).

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

Konfiguration

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

Title (zone): der Name der Versandart, den Kunden für diese Zone sehen. Leer lassen, um den globalen Name zu verwenden.

Oben auf der Seite zeigt das Plugin Warnungen an, wenn Live-Tarife nicht genutzt werden können: kein API-Schlüssel, keine Versand-Postleitzahl oder kein Versandland, oder eine Shopwährung außer USD ohne Wechselkurs. Ein Hinweis erscheint außerdem, wenn ein Test-API-Schlüssel gesetzt ist. Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten EasyPost-Tarife gelöscht.

General

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

Name: der Name der Versandart, der im Warenkorb und an der Kasse angezeigt wird. Eine Zone kann ihn mit eigenem Title überschreiben. Standard: EasyPost Shipping.

EasyPost-Konto

API key: Ihr EasyPost-API-Schlüssel aus EasyPost Dashboard > Account Settings > API Keys. Ein Produktionsschlüssel (beginnt mit EZAK) liefert echte Tarife. Ein Testschlüssel (beginnt mit EZTK) liefert EasyPost-Testtarife; verwenden Sie ihn nur zum Testen.

Allowed carriers / services: optional, durch Kommas getrennt. Geben Sie einen Dienstleister (USPS) oder einen Dienstleister und einen Service (USPS:Priority, UPS:Ground) so ein, wie EasyPost sie benennt. Angezeigt wird der günstigste erlaubte Tarif. Leer lassen, um den günstigsten Tarif jedes Dienstleisters anzuzeigen.

Versandursprung

Die Adresse, von der Ihre Pakete versendet werden. Wenn das Country Ihr Shopland ist, werden leere Felder aus der Shopadresse unter WooCommerce > Settings > General übernommen (und der Absendername aus dem Seitentitel).

Sender name / company: der Name des Absenders oder das Unternehmen.

Street address: die Straße der Versandadresse.

City: die Stadt der Versandadresse.

State: das zweistellige Bundesstaatskürzel, zum Beispiel CA oder NY.

ZIP code: die Postleitzahl der Versandadresse. Für Live-Tarife erforderlich.

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

Tarife

Parcels: wie der Warenkorb an EasyPost gesendet wird.

One parcel per order (the cart is packed into one box): Alle Einheiten werden in einen Karton gepackt und einmal bewertet. Das ist der Standard.
One parcel per item (every unit ships in its own box): Jedes Produkt wird als eigenes Paket bewertet, und der Tarif wird für jede Einheit berechnet. Auch Ersatzpreise werden pro Einheit berechnet.

Gewichte werden von der Gewichtseinheit Ihres Shops in Unzen umgerechnet (mindestens 1 oz), Abmessungen in Zoll. Hat ein Produkt keine Abmessungen, wird das Paket nur nach Gewicht bewertet.

USD exchange rate: EasyPost-Tarife sind in USD. Geben Sie den Preis von 1 USD in der Währung Ihres Shops ein, zum Beispiel 0.92. Ohne diesen Wert werden keine Live-Tarife verwendet, nur Ersatzpreise. Nicht nötig, wenn die Shopwährung USD ist. USD- und CAD-Shops lassen EasyPost in ihrer eigenen Währung angeben. Sowohl der Punkt als auch das Komma werden als Dezimaltrennzeichen akzeptiert.

Tax status: Taxable lässt WooCommerce gemäß Ihren Steuerregeln Steuern auf den Versand erheben, None nicht. EasyPost-Tarife enthalten keine Umsatzsteuer. Standard: Taxable.

Ersatzpreise

Werden verwendet, wenn kein Live-Tarif vorliegt: kein API-Schlüssel, EasyPost ist nicht erreichbar, der Schlüssel wird abgelehnt oder kein Dienstleister hat einen Tarif für die Adresse. Die Preise gelten in der Währung Ihres Shops. Lassen Sie beide Felder leer, um die Methode in diesem Fall auszublenden.

Country prices: eine Zeile pro Land: zweistelliger Ländercode, ein Doppelpunkt und der Preis, zum Beispiel US:9.99. Zeilen in einem anderen Format werden ignoriert und beim Speichern in einer Fehlermeldung aufgelistet.

Other countries: der Preis für Länder, die nicht in der obigen Liste stehen. Leer lassen, um die Methode für diese Länder auszublenden.

Bedingungen

Free shipping from: die Warenkorb-Zwischensumme, ab der der Versand kostenlos ist. In diesem Fall wird keine Anfrage an EasyPost gestellt. Leer lassen, um dies zu deaktivieren.

Minimum subtotal: Die Methode wird nur angezeigt, wenn die Warenkorb-Zwischensumme mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Minimum weight: blendet die Methode aus, wenn der Warenkorb weniger wiegt, in der Gewichtseinheit Ihres Shops. 0 bedeutet keine Grenze.

Maximum weight: blendet die Methode aus, wenn der Warenkorb mehr wiegt, in der Gewichtseinheit Ihres Shops. 0 bedeutet keine Grenze.

Disabled 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 genannten Länder an, unabhängig davon, ob sie einer Zone hinzugefügt ist.

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

Erweitert

Debug log: schreibt EasyPost-Anfragen in WooCommerce > Status > Logs, Quelle vfd-easypost. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Der API-Schlüssel und Kundenadressen werden nie protokolliert.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins seine Einstellungen und Zonen-Methoden. Das Deaktivieren des Plugins 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 die Bedingungen: Lieferland, Warenkorbgewicht, Mindestzwischensumme und deaktivierte Versandklassen. Gilt kostenloser Versand, wird die Methode mit dem Preis null angezeigt und keine Anfrage an EasyPost gesendet.

Andernfalls sendet das Plugin an EasyPost die Versandadresse, die Lieferadresse und das Paket und erhält die Tarife aller Ihrer Versanddienstleister-Konten. Es wählt den günstigsten erlaubten Tarif, rechnet ihn in die Währung Ihres Shops um und zeigt ihn unter Ihrem Methodennamen an. Für Länder, die eine Postleitzahl benötigen, wird die Anfrage erst gestellt, nachdem der Kunde eine eingegeben hat.

Jede Antwort wird für dieselbe Adresse und dasselbe Paket 1 Stunde lang zwischengespeichert. Eine Adresse ohne verwertbare Tarife wird 10 Minuten lang gemerkt. Nach einem Timeout, einem abgelehnten Schlüssel, einer Ratenbegrenzung oder einem EasyPost-Serverfehler werden 5 Minuten lang keine Anfragen gestellt. Das API-Timeout beträgt 10 Sekunden. In all diesen Fällen sieht der Kunde keine Fehlermeldung: Es wird der Ersatzpreis verwendet, oder die Methode wird ausgeblendet, wenn es keinen Ersatzpreis gibt.

Der gewählte Dienstleister und Service sowie im Ein-Paket-Modus die voraussichtlichen Liefertage werden in der Versandzeile der Bestellung gespeichert. Sie sehen sie auf der Bestellseite im Admin-Bereich.

Die Methode funktioniert in der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist mit dem WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin berechnet nur Tarife. Es kauft keine Etiketten, verfolgt keine Pakete, prüft keine Adressen, bietet keine Abhol- oder Abgabestellen und fügt keine Versicherungs- oder Unterschriftsoptionen hinzu. Es zeigt eine Option (den günstigsten erlaubten Tarif), nicht eine Liste von Services. Es gibt keine Kartonoptimierung über das Stapeln der Artikel in ein Paket hinaus und keinen Tarifaufschlag oder keine Bearbeitungsgebühr.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox EasyPost. 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 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 EasyPost den Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, gekennzeichnet 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 eine Erinnerung. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

EasyPost 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 eingeschaltet ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum subtotal und Disabled shipping classes. Ohne Live-Tarif benötigt die Methode einen Ersatzpreis für das Land oder für Other countries.

Live-Tarife erscheinen nicht: Lesen Sie die Warnungen oben auf der Einstellungsseite, schalten Sie dann Debug log ein, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-easypost. Häufige Ursachen: kein API-Schlüssel oder keine Versand-Postleitzahl, ein Shop außerhalb von USD ohne USD exchange rate, der Kunde hat noch keine Postleitzahl eingegeben, kein Dienstleister Ihres EasyPost-Kontos bedient die Adresse oder die Filter unter Allowed carriers / services schließen alle Tarife aus.

Die Tarife wirken wie Testpreise: Ein Testschlüssel (EZTK...) ist gesetzt. Verwenden Sie im Live-Shop einen Produktionsschlüssel (EZAK...).

Tarife wurden für einige Minuten gestoppt: Nach einem Timeout, einem abgelehnten Schlüssel oder einem EasyPost-Serverfehler pausiert das Plugin Anfragen 5 Minuten lang und verwendet Ersatzpreise. Prüfen Sie den API-Schlüssel und das Protokoll.

Ist die Steuer enthalten? EasyPost-Tarife enthalten keine Umsatzsteuer. Mit Tax status Taxable fügt WooCommerce entsprechend Ihren Steuereinstellungen Steuern auf den Versand hinzu.

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

Entwickler-Hooks: Die Filter vfd_ep_shipment_request (Anfragedaten), vfd_ep_selected_rate (gewählter Tarif), vfd_ep_api_url (API-Basis-URL) und woocommerce_shipping_vfd_easypost_is_available passen das Plugin an.

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. Wurde 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 Tarife. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins, die zwischengespeicherten Tarife und alte Logdateien werden immer entfernt. Einstellungen und Zonen-Methoden werden nur entfernt, wenn Remove data on uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandzeilen.

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