VibeFox Cargoson for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Cargoson-Konto (nur für Live-Preise): Live-Preise nutzen die Frachtpreis-API von Cargoson. Frachtpreisabfragen erfordern ein Cargoson-Abonnement mit API-Zugang (zum Zeitpunkt der Erstellung Plan Advanced oder höher). Der API-Schlüssel wird in Ihrem Cargoson-Konto ausgestellt; wenn Ihr Tarif keine API-Einstellungen anzeigt, wenden Sie sich an den Cargoson-Support. Die Preise stammen von den Spediteuren und Preislisten, die mit diesem Konto verbunden sind. Wenn Sie nur Festpreise nutzen, benötigen Sie kein Cargoson-Konto.

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 aus und klicken Sie auf Install Now. Alternativ können Sie den Ordner vfd_cargoson per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Cargoson, oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Wählen Sie aus, wie die Versandkosten berechnet werden, und füllen Sie die passenden Abschnitte aus: die Festpreise und bei Live-Preisen den API-Schlüssel und die Abholpostleitzahl (siehe Konfiguration).

6. Fügen Sie VibeFox Cargoson 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 Cargoson. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name, der Kunden für diese Zone angezeigt wird. Lassen Sie das Feld leer, um den globalen Method title zu verwenden.

Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Cargoson-Preise gelöscht. Dezimalzahlen können mit Punkt oder Komma eingegeben werden.

General

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

Method title: der Name der Versandmethode, der im Warenkorb und an der Kasse angezeigt wird. Standard: Cargoson. Eine Zone kann ihn überschreiben.

Shipping cost: so wird der Preis berechnet.

Der Grund für einen fehlenden Live-Preis wird in das WooCommerce-Protokoll geschrieben. Er wird Kunden nie angezeigt.

Cargoson API (nur für Live-Preise erforderlich)

API key: der API-Schlüssel aus Ihrem Cargoson-Konto. Er wird nur an cargoson.com gesendet und nie Kunden angezeigt oder im Protokoll gespeichert.

Carrier: welche Preise verwendet werden. Der Kunde sieht einen einzigen Tarif.

Package type code: der Cargoson-Pakettyp, der mit der Preisanfrage gesendet wird. Standard: CLL. Die Beispiele der Cargoson-API verwenden EUR (EUR-Palette) und FIN (FIN-Palette). Für Pakete verwenden Sie den Paketcode Ihres Cargoson-Kontos. Die Bestellung wird als ein Paket mit dem Gesamtgewicht des Warenkorbs gesendet.

Price currency: die Währung der Preise in Ihrem Cargoson-Konto als dreistelliger Code. Standard: EUR. Die API gibt Beträge ohne Währungscode zurück.

Currency conversion rate: nur erforderlich, wenn die Preiswährung von der Währung Ihres Shops abweicht: 1 Einheit der Cargoson-Währung = X Einheiten Ihrer Shopwährung. Lassen Sie das Feld leer, um solche Preise abzulehnen, damit ein Kunde nie in der falschen Währung zahlt.

Ship from (collection address) (für Live-Preise verwendet)

Collection country: das Land, aus dem Sie versenden. Standardmäßig das Land Ihres Shops.

Collection postcode: die Postleitzahl, von der Sie versenden. Cargoson verlangt sie. Ist sie leer und ist das Abholland das Land Ihres Shops, wird die Shop-Postleitzahl aus WooCommerce > Settings > General verwendet.

Das Abholdatum, das an Cargoson gesendet wird, ist heute oder am nächsten Montag, wenn heute ein Wochenende ist.

Fixed prices (verwendet, wenn Shipping cost auf Fixed prices steht, und als Ausweichlösung für Live-Preise)

Price per country and size: eine Tabelle mit Ländern, einer Spalte Price und Preisen nach Warenkorbgewicht in Ihrer Shopwährung: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg, XL über 5 kg. Ein leerer oder mit 0 angegebener Größenpreis verwendet die Spalte Price; eine leere Spalte Price bedeutet, dass für diese Größe kein Festpreis gilt. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine Zeile zu entfernen. Die Zeile * Default gilt für alle Länder ohne eigene Zeile. Länder ohne Zeile (wenn keine *-Zeile vorhanden ist) erhalten keinen Festpreis, daher wird die Methode für sie ausgeblendet.

Fixed price applies: Per order berechnet den Preis einmal. Per item (price × quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Live-Preise von Cargoson gelten immer je Sendung.

Conditions

Minimum weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze.

Maximum weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. Standard: 25. 0 bedeutet keine Grenze.

Minimum order amount: zeigt die Methode nur an, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um die Methode immer anzuzeigen.

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

Free shipping: schaltet kostenlose Lieferung ein, wenn der unten angegebene Bestellwert erreicht wird.

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern), ab der die Lieferung kostenlos ist. Wird nur verwendet, wenn Free shipping eingeschaltet ist.

Tax status: Taxable fügt die Versandsteuer gemäß Ihren WooCommerce-Steuereinstellungen hinzu, None nicht. Die Spediteurpreise in Cargoson sind in der Regel netto (ohne MwSt.). Wählen Sie None, wenn Ihre Preise bereits Steuern enthalten.

Availability without shipping zones

Ignore shipping zones: bietet Cargoson für die unten angegebenen Länder an, auch wenn es keiner Versandzone hinzugefügt wurde.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder zu verwenden, in die Sie liefern. Dieses Feld wird nur verwendet, wenn Ignore shipping zones eingeschaltet ist.

Advanced

Debug log: protokolliert jede Tarifberechnung unter WooCommerce > Status > Logs, Quelle vfd_cargoson. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Der API-Schlüssel und die Postleitzahl des Kunden werden nie protokolliert.

Remove data on uninstall: wenn eingeschaltet, werden beim Löschen des Plugins alle Cargoson-Einstellungen, Zonenmethoden und zwischengespeicherten Preise entfernt. Das Deaktivieren des Plugins löscht nie etwas.

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, Mindestbestellwert und ausgeschlossene Versandklassen. Gilt kostenloser Versand, erhält der Kunde einen kostenlosen Tarif und es geht keine Anfrage an Cargoson.

Im Festpreismodus wird der Preis aus der Tabelle übernommen. Im Live-Modus sendet das Plugin an Cargoson das Abholdatum, das Abholland und die Abholpostleitzahl, das Lieferland und die Lieferpostleitzahl sowie ein Paket mit dem Pakettypcode und dem Gesamtgewicht des Warenkorbs (mindestens 0,1 kg). Produktgewichte werden von Ihrer Shopeinheit in Kilogramm umgerechnet. Ein Live-Preis wird erst angefragt, nachdem der Kunde eine Postleitzahl eingegeben hat. Cargoson liefert die Preise Ihrer Spediteure; das Plugin wählt den günstigsten aus (oder den des gewählten Spediteurs, falls eingestellt) und rechnet ihn bei Bedarf in Ihre Shopwährung um.

Jede Antwort wird 1 Stunde lang zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 10 Minuten lang zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf Cargoson warten muss. Das API-Timeout beträgt 10 Sekunden. Gibt Cargoson einen Fehler, keinen Preis für die Strecke oder einen Preis in einer anderen Währung ohne Umrechnungskurs zurück, sieht der Kunde keine Fehlermeldung. Die Methode wird ausgeblendet oder im Ausweichmodus wird der Festpreis verwendet.

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

Das Plugin berechnet nur Tarife. Es erstellt keine Sendungen oder Buchungen in Cargoson, druckt keine Etiketten und verfolgt keine Pakete, und Kunden können keine Paketstation und keinen Abholpunkt wählen. Der Warenkorb wird als ein Paket mit dem Gesamtgewicht angeboten; Paketmaße werden nicht gesendet. Es wird nur der eine günstigste Preis angezeigt, keine Liste von Spediteuren.

Bestellungen

Wird ein Live-Preis verwendet, speichert die Versandposition der Bestellung den angebotenen Carrier, Service und die Cargoson service ID. Sie werden auf der Bestellbearbeitungsseite angezeigt, damit Sie wissen, was Sie in Cargoson buchen müssen. Buchen Sie die Sendung in Cargoson oder über dessen eigene Integrationen.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Cargoson. 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 Cargoson Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Cargoson 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 order amount und Excluded shipping classes. Prüfen Sie im Festpreismodus, ob das Land oder * Default einen Preis für die Warenkorbgröße hat.

Live-Preise erscheinen nicht: Öffnen Sie WooCommerce > Status > Logs, Quelle vfd_cargoson. API-Fehler werden immer protokolliert; schalten Sie Debug log ein, um jede Berechnung zu sehen. Typische Ursachen: noch keine Liefer-Postleitzahl eingegeben, keine Abhol-Postleitzahl, der API-Schlüssel wurde abgelehnt (falscher oder abgelaufener Schlüssel oder kein API-Zugang in Ihrem Cargoson-Tarif), kein Spediteur für die Strecke oder das Gewicht oder ein Preis in einer anderen Währung. Mit Cargoson live prices, fixed prices if the API fails erhalten Kunden weiterhin den Festpreis, während Sie das Problem beheben.

Cargoson lehnt den Pakettyp ab: Verwenden Sie den Paketcode, den Ihr Cargoson-Konto unter Package type code nutzt. Der Grund erscheint im Protokoll.

Preis in einer anderen Währung wird abgelehnt: Stellen Sie Price currency auf die Währung Ihrer Cargoson-Preise ein und geben Sie den Currency conversion rate ein.

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

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel beispielsweise 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 werden immer entfernt. Einstellungen, Zonenmethoden und zwischengespeicherte Preise werden nur entfernt, wenn Remove data on uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen.

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