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

ShipStation-Konto: verbinden Sie Ihre Versanddienstleister in ShipStation (Settings > Shipping > Carriers) und kopieren Sie dann API Key und API Secret von ShipStation > Settings > Account > API Settings. Der API-Zugang hängt von Ihrem ShipStation-Tarif ab. Ist die Seite nicht verfügbar, enthält Ihr Tarif keinen API-Zugang. Das Plugin nutzt die ShipStation API V1 (API Key und API Secret). ShipStation-API-V2-Konten mit einem einzigen API-Schlüssel werden nicht unterstützt. Ohne Schlüssel werden nur die Ersatzpreise verwendet.

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox ShipStation 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 API Key und API Secret ein, geben Sie die Postleitzahl des Versandorts ein und speichern Sie. Die Seite listet nun die Carrier-Codes Ihres Kontos auf. Tragen Sie den oder die gewünschten unter Carrier codes ein und speichern Sie erneut.

6. Wenn die Währung Ihres Shops nicht die Währung Ihres ShipStation-Kontos ist, stellen Sie Exchange rate ein.

7. Optional können Sie die Ersatzpreise eintragen.

8. Fügen Sie VibeFox ShipStation 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 ShipStation. 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 Kunden für diese Zone sehen. Leer lassen, um den globalen Name zu verwenden.

Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten ShipStation-Tarife gelöscht und API Key und API Secret geprüft. Die Seite zeigt dann die mit Ihrem Konto verbundenen Versanddienstleister mit ihren Codes, zum Beispiel "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)". Warnungen über den Einstellungen zeigen, wann Live-Tarife nicht funktionieren können: keine Schlüssel, kein Carrier-Code, keine Postleitzahl des Versandorts, kein Wechselkurs, eine fehlgeschlagene Verbindungsprüfung oder Carrier-Codes, die nicht mit Ihrem Konto verbunden sind.

Allgemein

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

Name: der Name der Versandmethode an der Kasse. Eine Zone kann ihn mit ihrem eigenen Title überschreiben. Standard: ShipStation Shipping.

ShipStation-Konto

API Key: der API Key von ShipStation > Settings > Account > API Settings.

API Secret: das API Secret von derselben Seite.

Carrier codes: ein oder mehrere ShipStation-Carrier-Codes, durch Kommas getrennt, zum Beispiel stamps_com, ups_walleted. Es werden bis zu 5 Codes verwendet, mit einer API-Anfrage pro Versanddienstleister. Angezeigt wird der günstigste Tarif dieser Dienstleister. Die Codes stammen aus der Liste, die nach dem Speichern erscheint.

Allowed services: optional, durch Kommas getrennte ShipStation-Service-Codes, zum Beispiel usps_priority_mail, ups_ground. Leer lassen, um den günstigsten Service der oben genannten Dienstleister anzuzeigen.

Package code: "package" (der Standard) berechnet Ihre eigene Box und lässt Umschläge und Flat-Rate-Boxen des Dienstleisters aus. Leer lassen, um jeden Pakettyp zu berechnen, den der Dienstleister anbietet.

Versandort

Ship-from postal code: für Live-Tarife erforderlich. ShipStation berechnet Tarife nur anhand der Postleitzahl, und sie muss im Land Ihres ShipStation-Kontos liegen. Leer lassen, um die Shop-Postleitzahl aus WooCommerce > Settings > General zu verwenden.

Tarife

Parcels: legt fest, wie der Warenkorb an ShipStation gesendet wird.

ShipStation account currency: die Währung, in der ShipStation die Tarife zurückgibt: USD, CAD, GBP, AUD, NZD oder EUR. Standard: USD (US-Konten).

Exchange rate: der Preis von 1 Einheit der Kontowährung in Ihrer Shopwährung, zum Beispiel 0.92. Nur nötig, wenn sich die Shopwährung von der Kontowährung unterscheidet. Ohne ihn werden keine Live-Tarife verwendet, und es gelten die Ersatzpreise. Wechselkurse werden nicht automatisch aktualisiert.

Tax status: Taxable lässt WooCommerce nach Ihren Steuerregeln Steuern auf den Versand aufschlagen, None tut dies nicht. ShipStation-Tarife enthalten keine Verkaufssteuer (Sales Tax).

Ersatzpreise (werden verwendet, wenn kein Live-Tarif vorliegt: keine API-Schlüssel, ShipStation nicht erreichbar oder kein Versanddienstleister liefert einen Tarif für die Adresse; Preise in Ihrer Shopwährung; Tabelle und Other countries leer lassen, um die Methode in diesem Fall auszublenden)

Prices by country: eine Tabelle mit einem Grundpreis pro Land und Größenspalten nach Paketgewicht: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg und XL >5 kg. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Eine leere Größe verwendet den Grundpreis. Ein Grundpreis von 0 bedeutet kostenlosen Versand. Die Zeile * Default (all other countries) gilt für Länder ohne eigene Zeile.

Other countries: der Preis, wenn die Tabelle für das Land keinen Preis enthält. Leer lassen, um die Methode in diesem Fall auszublenden.

Bedingungen

Free shipping from: die Warenkorb-Zwischensumme, ab der der Versand kostenlos ist. Dann wird keine Anfrage an ShipStation gesendet. Leer lassen, um dies zu deaktivieren.

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

Minimum weight: das minimale Warenkorbgewicht, in der Gewichtseinheit Ihres Shops, damit diese Methode angezeigt wird. 0 bedeutet keine Grenze.

Maximum weight: die Methode wird oberhalb dieses Warenkorbgewichts ausgeblendet, in der Gewichtseinheit Ihres Shops. 0 bedeutet keine Grenze.

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

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Methode für die unten angegebenen 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 der Shop liefert. Dieses Feld wird nur verwendet, wenn Ignore shipping zones eingeschaltet ist. Eine Methode, die einer Versandzone hinzugefügt wurde, gilt immer für die Länder dieser Zone.

Erweitert

Debug log: protokolliert ShipStation-Anfragen unter WooCommerce > Status > Logs, Quelle vfd-shipstation. API-Fehler werden immer protokolliert, auch wenn diese Option aus ist. API Key, API Secret und Kundenadressen werden nie protokolliert. Die Postleitzahl wird maskiert.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins seine Einstellungen und seine Methoden in den Versandzonen. Das Deaktivieren des Plugins löscht nie Einstellungen.

So funktioniert es an der Kasse

Gibt der Kunde eine Lieferadresse ein, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Warenkorbgewicht, Mindestzwischensumme und deaktivierte Versandklassen. Gilt kostenloser Versand, wird die Methode mit dem Preis 0 angezeigt und es wird keine Anfrage an ShipStation gesendet.

Anschließend sendet das Plugin an ShipStation die Postleitzahl des Versandorts, das Zielland, Bundesland, die Stadt und die Postleitzahl des Kunden, das Paketgewicht und die Boxgröße. Vor der Eingabe einer Postleitzahl durch den Kunden wird keine Anfrage gesendet. Länder ohne Postleitzahlen erhalten die Ersatzpreise. Gewichte und Abmessungen werden aus den Einheiten Ihres Shops umgerechnet. Artikel werden in einer Box gestapelt. Hat ein Produkt keine Abmessungen, wird das Paket nur nach Gewicht berechnet.

ShipStation wird einmal pro Carrier-Code angefragt. Das Plugin zeigt den günstigsten zulässigen Tarif, in Ihre Shopwährung umgerechnet, unter dem Namen der Methode an.

Jede Antwort wird 1 Stunde zwischengespeichert. Liefert ShipStation keinen brauchbaren Tarif, wird die Antwort 10 Minuten gemerkt. Lehnt ShipStation die Schlüssel ab oder ist es nicht erreichbar, werden Anfragen 5 Minuten pausiert. Nach einem Ratenlimit richtet sich die Pause nach der Reset-Zeit von ShipStation. Das Zeitlimit einer Anfrage beträgt 12 Sekunden. Das Deaktivieren des Plugins löscht die zwischengespeicherten Tarife.

Gibt es keinen Live-Tarif, stammt der Preis aus der Ersatztabelle und danach aus Other countries. Trifft keines davon zu, wird die Methode ausgeblendet. Der Kunde sieht nie ShipStation-Fehlermeldungen. Details gehen in das WooCommerce-Protokoll.

Die Methode funktioniert an der klassischen Kasse und in den Blöcken Warenkorb und Kasse. Sie ist mit der Bestellspeicherung für hohe Leistung von WooCommerce (HPOS) kompatibel.

Das Plugin berechnet nur Tarife. Es kauft keine Versandetiketten, erstellt keine ShipStation-Bestellungen oder Sendungen, verfolgt keine Pakete und übernimmt keine Retouren. Es gibt keine Abholstellen, keine Auswahl zwischen mehreren Services an der Kasse, keine Adressprüfung, keine Versicherung, keine Unterschriftsbestätigung, keine Verpackung in mehrere Pakete und keinen Aufschlag auf Tarife.

Bestellungen

Die Versandposition der Bestellung speichert den gewählten Service, zum Beispiel "USPS Ground Advantage - Package". Sie sehen ihn im Admin-Bestellbildschirm und können das passende Etikett in ShipStation erstellen.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock steht oben unter WooCommerce > Settings > Shipping > VibeFox ShipStation. 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 ShipStation Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es 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 Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

ShipStation erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Kundenlandes hinzugefügt ist (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 prüfen Sie, ob das Land, * Default oder Other countries einen Preis hat.

Die Kasse zeigt den Ersatzpreis statt des ShipStation-Tarifs: prüfen Sie die Warnungen oben auf der Einstellungsseite (Schlüssel, Carrier-Code, Postleitzahl des Versandorts, Wechselkurs). Aktivieren Sie Debug log und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-shipstation. Die Postleitzahl des Kunden ist erforderlich. Vor ihrer Eingabe wird keine Anfrage gesendet.

Welchen Carrier-Code eintragen: speichern Sie die Einstellungen mit Schlüssel und Secret. Die Seite listet die Carrier-Codes Ihres Kontos auf. Verwenden Sie einen oder mehrere davon.

Der Tarif weicht von ShipStation ab: das Paket wird aus den Produktgewichten und -abmessungen gebildet, die Artikel sind in einer Box gestapelt. Produkte ohne Abmessungen werden nur nach Gewicht berechnet. Tarife werden 1 Stunde zwischengespeichert. Speichern Sie die Einstellungen, um den Cache zu leeren.

Für Entwickler: die Filter vfd_shst_rate_request, vfd_shst_selected_rate und vfd_shst_api_url ändern die Tarifanfrage je Carrier, den gewählten Tarif und die API-Basis-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. 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 die Einstellungen und löscht nur die zwischengespeicherten Tarife. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins, die zwischengespeicherten Tarife und die gespeicherte Liste der Versanddienstleister 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.

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