VibeFox Cargoson for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

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 ab dem Tarif Advanced). Den API-Schlüssel stellt Ihr Cargoson-Konto bereit; 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 verwenden, 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 im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls aus.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure oder suchen Sie VibeFox Cargoson später in der Modulliste und klicken Sie auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Wählen Sie, 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). Klicken Sie auf Save.

Bei der Installation legt das Modul den Versanddienstleister Cargoson mit dem Lieferzeittext Delivery by the cheapest Cargoson carrier an. Der Versanddienstleister wird allen Zonen und allen Kundengruppen zugewiesen. Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Cargoson > Configure. Sie gelten für alle Zonen des Versanddienstleisters. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Nach dem Speichern sehen Sie Settings saved. Cached Cargoson prices were cleared. Dezimalzahlen können mit Punkt oder Komma eingegeben werden. Es wird nichts gespeichert, und die Seite zeigt einen Fehler, wenn ein Zahlenfeld Text oder eine negative Zahl enthält, Currency conversion rate 0 ist, Minimum weight größer als Maximum weight ist, Method title länger als 64 Zeichen ist, Price currency kein dreistelliger Währungscode ist oder eine Zeile der Preistabelle einen ungültigen Ländercode oder Preis hat. Wenn das Modul die Gewichtseinheit des Shops nicht kennt, weist nach dem Speichern eine Warnung darauf hin, dass Produktgewichte als Kilogramm angenommen werden; legen Sie die Einheit unter International > Localization (Local units) fest.

General

Enable Cargoson: schaltet den Versanddienstleister ein oder aus. Es ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Method title: der Name des Versanddienstleisters, der im Warenkorb und an der Kasse angezeigt wird. Standard: Cargoson. Pflichtfeld. Dies ist auch der Name des Versanddienstleisters unter Shipping > Carriers.

Shipping cost: wie der Preis berechnet wird.

Der Grund für einen fehlenden Live-Preis wird im Modulprotokoll festgehalten. Er wird dem 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 gesendet und nie Kunden angezeigt oder im Protokoll gespeichert. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten.

Remove the saved API key: erscheint, wenn ein Schlüssel gespeichert ist. Aktivieren Sie die Option und speichern Sie, um den Schlüssel zu löschen.

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

Package type code: der Cargoson-Pakettyp, der mit der Preisabfrage 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 nötig, wenn die Preiswährung von der Standardwährung Ihres Shops abweicht: 1 Einheit der Cargoson-Währung = X Einheiten Ihrer Standardwährung. Lassen Sie das Feld leer, um solche Preise abzulehnen, damit ein Kunde nie in der falschen Währung zahlt.

Versand ab (Abholadresse) (für Live-Preise verwendet)

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

Collection postcode: die Postleitzahl, von der aus Sie versenden. Cargoson verlangt sie. Ist sie leer und das Abholland das Land Ihres Shops, wird die Postleitzahl des Shops aus Shop Parameters > Contact > Stores verwendet.

Das Abholdatum, das an Cargoson gesendet wird, ist heute in der Zeitzone des Shops oder bei Wochenenden der folgende Montag.

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

Price per country and size: eine Tabelle mit einer Spalte Country (2-stelliger Code), einer Spalte Price und Preisen nach Warenkorbgewicht in der Standardwährung Ihres Shops, ohne Steuern: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg, XL über 5 kg. Ist der Preis einer Größe leer oder 0, wird die Spalte Price verwendet; ein leerer Price bedeutet, dass für diese Größe kein Festpreis gilt. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Papierkorb-Symbol, um sie zu entfernen. Verwenden Sie * als Ländercode für alle Länder ohne eigene Zeile. Länder ohne Zeile (wenn keine *-Zeile vorhanden ist) erhalten keinen Festpreis, daher wird der Versanddienstleister für sie ausgeblendet. Preise müssen Zahlen von 0 oder mehr sein. Eine leere Zeile wird ignoriert.

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.

Bedingungen

Minimum weight: blendet den Versanddienstleister unterhalb dieses Warenkorbgewichts aus, in kg. 0 bedeutet keine Begrenzung.

Maximum weight: blendet den Versanddienstleister oberhalb dieses Warenkorbgewichts aus, in kg. Standard: 25. 0 bedeutet keine Begrenzung.

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

Free shipping: schaltet kostenlose Lieferung ein, wenn der unten angegebene Bestellbetrag erreicht ist.

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: die Steuerregel des Versanddienstleisters oder No tax. Die Versandpreise in Cargoson sind in der Regel netto (ohne MwSt.). Wählen Sie No tax, wenn Ihre Preise die Steuer bereits enthalten.

Verfügbarkeit ohne Versandzonen

Normalerweise wird der Versanddienstleister in den Zonen angeboten, die ihm unter Shipping > Carriers zugewiesen sind.

Ignore shipping zones: bietet Cargoson für die unten angegebenen Länder an, unabhängig davon, welche Zonen dem Versanddienstleister zugewiesen sind. Wenn Sie die Option einschalten und speichern, wird der Versanddienstleister allen Zonen zugewiesen; später angelegte Zonen werden ebenfalls zugewiesen. Wenn Sie sie ausschalten und speichern, erhält der Versanddienstleister seine vorherigen Zonen zurück.

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

Erweitert

Debug log: protokolliert jede Tarifberechnung in logs/vfd_cgs_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. API-Fehler und abgelehnte Preise werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Der API-Schlüssel und die Postleitzahl des Kunden werden nie protokolliert.

Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Remove data on uninstall: ist die Option eingeschaltet, löscht die Deinstallation des Moduls die Cargoson-Einstellungen, den Versanddienstleister, zwischengespeicherte Preise, Angebote zu Bestellungen und Protokolle. Ist sie ausgeschaltet, bleibt alles für eine erneute Installation erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Cargoson-Preis. Nur physische Produkte zählen: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht im Bestellbetrag enthalten. Produktgewichte werden von der Gewichtseinheit Ihres Shops in Kilogramm umgerechnet. Das Modul prüft zuerst die Bedingungen: Lieferland, Warenkorbgewicht und Mindestbestellwert. Gilt kostenloser Versand, beträgt der Preis 0 und es wird keine Anfrage an Cargoson gesendet.

Im Festpreismodus wird der Preis aus der Tabelle übernommen. Im Live-Modus sendet das Modul 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). Ein Live-Preis wird nur abgefragt, wenn die Lieferadresse eine Postleitzahl hat. Cargoson gibt die Preise Ihrer Spediteure zurück; das Modul wählt den günstigsten (des ausgewählten Spediteurs, falls gesetzt) und rechnet ihn bei Bedarf in Ihre Standardwährung um. Der Preis wird in Ihrer Standardwährung berechnet und dann in der Warenkorbwährung des Kunden angezeigt.

Jede Antwort wird 1 Stunde lang zwischengespeichert, sodass 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 zurück, keinen Preis für die Strecke oder einen Preis in einer anderen Währung ohne Umrechnungskurs, sieht der Kunde keine Fehlermeldung. Der Versanddienstleister wird ausgeblendet oder im Ausweichmodus wird der Festpreis verwendet.

Wenn Sie den Versanddienstleister unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul übernimmt die neue Version automatisch.

Das Modul 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 übermittelt. Es wird nur der einzelne günstigste Preis angezeigt, keine Liste von Spediteuren.

Bestellungen

Die Bestellseite einer Cargoson-Bestellung zeigt einen Block Cargoson shipping mit dem Tarif, der an der Kasse berechnet wurde:

Carrier, Service und Cargoson service ID: der angebotene Cargoson-Spediteur und Service, angezeigt, wenn ein Live-Preis verwendet wurde.

Price source: Cargoson live price, Fixed price oder Free shipping threshold.

Calculated price (excl. tax): der Preis in der Standardwährung Ihres Shops.

Das Angebot wird beim Abschluss der Bestellung gespeichert und ändert sich später nicht. Buchen Sie die Sendung in Cargoson oder über dessen eigene Integrationen.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Cargoson ist der erste Block unter Modules > Module Manager > VibeFox Cargoson > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-shipping-cargoson und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung zum Konfigurieren des Moduls können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back-Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einem Multistore-Setup. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird der Cargoson-Versanddienstleister Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Die Storefront von PrestaShop weiß nicht, dass Sie im Back-Office angemeldet sind, daher wird der Versanddienstleister auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber an der Kasse nicht testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird während Ihrer Arbeit im Back-Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Cargoson erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable Cargoson eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Ländes des Kunden und die Kundengruppe abdeckt (oder ob Ignore shipping zones eingeschaltet und das Land unter Countries eingetragen ist). Prüfen Sie die Gewichtsgrenzen und Minimum order amount. Prüfen Sie im Festpreismodus, ob das Land oder * einen Preis für die Warenkorbgröße hat. Produkte können auch auf der Produktseite auf bestimmte Versanddienstleister beschränkt sein.

Live-Preise erscheinen nicht: Sehen Sie im Feld Log auf der Modulseite nach. API-Fehler werden immer protokolliert; schalten Sie Debug log ein, um jede Berechnung zu sehen. Typische Ursachen: noch keine Lieferpostleitzahl eingegeben, keine Abholpostleitzahl, 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.

Steuer wird beim Versand doppelt berechnet: Ihre Cargoson-Preise enthalten bereits die MwSt. Stellen Sie Tax auf No tax.

Tarife wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save. Dadurch werden die zwischengespeicherten Cargoson-Preise gelöscht.

Die Seite meldet, dass der Cargoson-Versanddienstleister nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn neu anzulegen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Cargoson und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Die zwischengespeicherten Preise werden immer entfernt. Ist Remove data on uninstall eingeschaltet, wird der Versanddienstleister gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, die Angebote zu Bestellungen und das Protokoll werden entfernt. Ist die Option ausgeschaltet, wird der Versanddienstleister nur deaktiviert, die Einstellungen und die Angebote zu aufgegebenen Bestellungen bleiben erhalten, und nur die Angebote zu Warenkörben ohne Bestellung werden entfernt. Wenn Sie das Modul erneut installieren, erhält der gespeicherte Versanddienstleister seinen früheren Status zurück; Reset schaltet also keinen Versanddienstleister ein, den Sie deaktiviert hatten.

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