VibeFox Shippo for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Shippo-Konto: Erstellen Sie ein Shippo-Konto, verbinden oder aktivieren Sie die Versanddienstleister (USPS, UPS, FedEx, DHL und andere) und kopieren Sie das API-Token unter Shippo > Settings > Advanced > API. Shippo berechnet Gebühren für gekaufte Etiketten, nicht für Tarifanfragen. Neue Shippo-Konten müssen unter Umständen von Shippo verifiziert werden, bevor Live-Tarife zurückgegeben werden. Ohne Token werden nur die Ersatzpreise verwendet.

Produkte: Produkte sollten ein Gewicht und Abmessungen haben. Produkte ohne Abmessungen verwenden die Standardkartongröße.

VibeFox-Lizenzschlüssel: erhältlich 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. Alternativ können Sie den Ordner vfd_shippo per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Shippo, 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 Ihr Shippo-API-Token ein und füllen Sie die Adresse unter Ship from aus. Die Postleitzahl ist erforderlich.

6. Wählen Sie die Shippo rate currency (USD, wenn Sie aus den USA versenden) und geben Sie, falls Ihr Shop eine andere Währung verwendet, den Wechselkurs ein.

7. Optional können Sie Ersatzpreise in der Tabelle nach Land und Gewicht eintragen.

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

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Shippo. 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 den globalen Name zu verwenden.

Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Shippo-Tarife gelöscht. Warnungen oberhalb der Einstellungen zeigen Ihnen, wenn die Versandart nie angezeigt werden kann oder Live-Tarife nicht verwendet werden können: kein API-Token, keine Postleitzahl oder kein Land des Versandorts oder ein fehlender Wechselkurs. Ein Hinweis erinnert Sie, wenn ein Test-Token gesetzt ist.

Allgemein

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

Name: der Name der Versandart, der an der Kasse angezeigt wird. Eine Zone kann ihn mit einem eigenen Title überschreiben. Standard: Shippo Shipping.

Shippo-Konto

API token: Ihr Shippo-API-Token. Verwenden Sie das Live-Token (shippo_live_...) für echte Tarife im Live-Shop oder ein Test-Token (shippo_test_...) für Shippo-Testtarife.

Allowed carriers / services: optional, durch Kommas getrennt. Geben Sie einen Versanddienstleister so ein, wie Shippo ihn benennt (USPS, UPS, FedEx, DHL Express), oder ein Shippo-Servicestufen-Token (usps_priority, ups_ground). Angezeigt wird der günstigste erlaubte Tarif. Leer lassen, um den günstigsten Tarif eines beliebigen Versanddienstleisters anzuzeigen.

Ship from (die Adresse, von der Ihre Pakete versendet werden; leere Felder werden aus der Shopadresse unter WooCommerce > Settings > General übernommen, wenn sie im selben Land liegt)

Sender name / company: der Absendername. Er wird auch zum Unterzeichnen der Zollerklärung verwendet.

Street address: die Straße des Absenders.

City: die Stadt des Absenders.

State / province: der zweistellige Bundesstaatscode, zum Beispiel CA oder NY. Einige Versanddienstleister benötigen ihn.

Postal / ZIP code: für Live-Tarife erforderlich.

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

Tarife

Parcels: wie der Warenkorb an Shippo gesendet wird.

Default box size: Länge x Breite x Höhe in der Abmessungseinheit Ihres Shops, zum Beispiel 30 x 20 x 10. Shippo benötigt die Kartongröße. Sie wird verwendet, wenn ein Produkt im Warenkorb keine Abmessungen hat. Leer lassen, um 30 x 20 x 10 cm zu verwenden.

Shippo rate currency: die Währung, in der Shippo Ihre Versanddienstleister notiert; sie entspricht der Währung des Versandlandes: USD (USA), CAD (Kanada), GBP (Vereinigtes Königreich), EUR (Eurozone) oder AUD (Australien). Standard: USD. Tarife, die Shippo in der Shopwährung zurückgibt, werden immer unverändert verwendet.

Exchange rate: der Preis von 1 Einheit der Shippo rate currency in Ihrer Shopwährung, zum Beispiel 0.92. Nicht nötig, wenn beide gleich sind. Ohne ihn werden Tarife in der anderen Währung nicht verwendet und die Ersatzpreise gelten. Das Plugin rechnet Währungen nicht automatisch um.

Tax status: Taxable lässt WooCommerce nach Ihren Steuerregeln Steuern auf den Versand aufschlagen, None nicht. Shippo-Tarife enthalten keine Umsatzsteuer.

Ersatzpreise (werden verwendet, wenn kein Live-Tarif verfügbar ist: kein API-Token, Shippo nicht erreichbar, Token abgelehnt oder keine Versandtarife für die Adresse; Preise in Ihrer Shopwährung; beide Felder leer lassen, um die Versandart in diesem Fall auszublenden)

Country prices: eine Preistabelle nach Land und Warenkorbgewicht. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Die Spalten sind Price sowie die Gewichtsstufen XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg). Eine leere oder 0-Stufe verwendet die Spalte Price. Die Zeile * Default gilt für Länder ohne eigene Zeile. Eine neue Zeile beginnt als * Default. Eine Zeile, die mit allen leeren Zellen gespeichert wird, berechnet 0. Löschen Sie daher Zeilen, die Sie nicht ausfüllen.

Other countries: der Preis für Länder, die nicht in der Tabelle oben stehen (wenn keine Zeile * Default vorhanden ist). Leer lassen, um die Versandart für diese auszublenden.

Bedingungen

Free shipping from: die Warenkorb-Zwischensumme, ab der der Versand kostenlos ist. Dann wird keine Anfrage an Shippo gestellt. Leer lassen, um es auszuschalten.

Minimum subtotal: die Versandart nur anzeigen, wenn die Warenkorb-Zwischensumme mindestens diesem Betrag entspricht. Leer lassen, um sie immer anzuzeigen.

Minimum weight (kg): das minimale Warenkorbgewicht, um diese Versandart anzuzeigen. 0 bedeutet keine Begrenzung.

Maximum weight (kg): die Versandart wird oberhalb dieses Warenkorbgewichts ausgeblendet. Standard: 30. 0 bedeutet keine Begrenzung.

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

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Versandart für die unten genannten Länder an, unabhängig davon, ob sie einer Zone zugewiesen ist.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die der Shop versendet. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist. Eine einer Versandzone zugewiesene Versandart funktioniert immer für die Länder ihrer Zone.

Erweitert

Debug log: protokolliert Shippo-Anfragen unter WooCommerce > Status > Logs, Quelle vfd-shippo. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Das API-Token und Kundenadressen werden nie protokolliert.

Remove data on uninstall: ist die Option aktiviert, entfernt das Löschen des Plugins dessen Einstellungen und seine Versandart-Zuordnungen in Zonen. 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: Warenkorbgewicht, Mindestzwischensumme und deaktivierte Versandklassen. Gilt kostenloser Versand, wird die Versandart mit einem Preis von 0 angezeigt und es wird keine Anfrage an Shippo gesendet.

Danach sendet das Plugin an Shippo die Versandadresse, die Adresse des Kunden und das Paket. In Ländern, in denen WooCommerce eine Postleitzahl verlangt, wartet die Anfrage, bis der Kunde sie eingegeben hat. Bei internationalen Sendungen wird eine Zollerklärung mit Artikelnamen, Mengen, Gewichten und Werten hinzugefügt. Shippo liefert die Tarife Ihrer Versanddienstleister zurück, und das Plugin zeigt den günstigsten erlaubten Tarif in Ihrer Shopwährung unter dem Namen der Versandart an.

Im Modus pro Bestellung werden die Artikel in einen Karton gestapelt: die längste und mittlere Seite der größten Artikel sowie die kleinsten Seiten aller Einheiten zusammengezählt. Hat ein Produkt keine Abmessungen, wird für das gesamte Paket die Standardkartongröße verwendet. Im Modus pro Artikel wird jedes Produkt als eigenes Paket tarifiert und der Tarif mit seiner Menge multipliziert.

Jede Antwort wird 1 Stunde lang pro Adresse und Paket zwischengespeichert. Wenn Shippo ohne brauchbaren Tarif antwortet, wird die Adresse 10 Minuten lang gemerkt. Nach einer Zeitüberschreitung, einem abgelehnten Token, einem Serverfehler oder einem Ratenlimit pausiert das Plugin Anfragen für 5 Minuten und verwendet die Ersatzpreise. Das Zeitlimit für Anfragen beträgt 10 Sekunden.

Gibt es keinen Live-Tarif, stammt der Preis aus der Ersatztabelle, danach aus Other countries. Trifft keines davon zu, wird die Versandart ausgeblendet. Der Kunde sieht nie einen Fehler.

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

Das Plugin berechnet nur Tarife. Es kauft keine Etiketten, verfolgt keine Pakete, prüft keine Adressen und bietet keine Abhol- oder Abgabestellen, Versicherung, Unterschriftsoptionen oder Retourenetiketten an. Angezeigt wird nur der günstigste erlaubte Tarif, nicht eine Liste aller Services. Es gibt keine Kartonoptimierung über das oben beschriebene Stapeln hinaus und keinen Tarifaufschlag und keine Bearbeitungsgebühr.

Bestellungen

Die Versandzeile der Bestellung speichert den gewählten Carrier / service und bei einem Paket pro Bestellung die Estimated delivery days. Sie sehen diese auf der Bestellseite im Admin-Bereich und können das passende Etikett in Shippo kaufen.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Shippo. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, etwa das Datum, bis zu dem die Lizenz aktiv ist, sowie 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 deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Shippo Kunden an 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 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 im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Shippo erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Versandart der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum subtotal und Disabled shipping classes. Ohne Live-Tarif prüfen Sie, ob das Land, * Default oder Other countries einen Preis hat.

Live-Tarife erscheinen nicht: aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-shippo. Häufige Ursachen: kein API-Token oder keine Postleitzahl des Versandorts, eine Shopwährung, die sich von der Shippo rate currency unterscheidet, ohne Wechselkurs, die Postleitzahl des Kunden noch nicht eingegeben, kein Versanddienstleister Ihres Shippo-Kontos bedient die Adresse oder das Shippo-Konto ist noch nicht verifiziert.

Test-Tarife im Live-Shop: ein Test-Token (shippo_test_...) liefert Shippo-Testtarife. Verwenden Sie das Live-Token (shippo_live_...).

Kostenloser Versand für unerwartete Länder: prüfen Sie die Preistabelle auf eine leere Zeile, besonders eine leere Zeile * Default. Eine Zeile mit allen leeren Zellen berechnet 0.

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

Für Entwickler: die Filter vfd_shpo_shipment_request, vfd_shpo_customs_declaration, vfd_shpo_selected_rate und vfd_shpo_api_url ändern den Anfragekörper, die Zollerklärung, den gewählten Tarif und die API-URL.

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 sowie die zwischengespeicherten Tarife werden immer entfernt. Einstellungen und Zonen-Versandarten werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandzeilen.

Shippo ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Shippo verbunden noch von Shippo unterstützt.