VibeFox GIG Logistics 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.

API-Zugangsdaten von GIG Logistics (nur für Live-Preise): Live-Preise nutzen die Drittanbieter-API von GIG Logistics. GIG Logistics stellt Geschäftskunden einen API-Benutzernamen (meist eine E-Mail-Adresse) und ein Passwort aus. Fordern Sie diese auf der Entwicklerseite von GIG Logistics (giglogistics.com/developer) an. Testzugangsdaten funktionieren nur mit der Test-API. Wenn Sie nur die Preistabelle und die Ersatzkosten verwenden, benötigen Sie keine API-Zugangsdaten.

Nigeria in Ihrem Shop: Live-Preise werden nur für Lieferadressen in Nigeria abgefragt. Daher muss das Land Nigeria unter International > Locations > Countries vorhanden und aktiv sein.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt 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 GIG Logistics später in der Modulliste und klicken Sie dort auf Configure.

3. Fügen 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. Füllen Sie die Preistabelle und/oder die Ersatzkosten aus. Für Live-Preise geben Sie außerdem den API-Benutzernamen und das Passwort, die Telefonnummer, die Stadt und den Bundesstaat der Abholung sowie den Umrechnungskurs ein, falls Ihre Standardwährung nicht NGN ist (siehe Konfiguration). Klicken Sie auf Save.

5. Wenn das Feld Nigerian states die Schaltfläche Add Nigerian states anzeigt, klicken Sie darauf (siehe Konfiguration).

Bei der Installation legt das Modul den Versanddienstleister GIG Logistics mit dem Lieferzeittext Courier delivery an. Der Versanddienstleister wird mit der Zone Nigeria (in einem Standardshop: Afrika) und mit allen Kundengruppen verknüpft. Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis stammt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox GIG Logistics > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern löscht außerdem die zwischengespeicherten Preise von GIG Logistics, API-Token und Koordinaten der Adressen.

Oberhalb der Abschnitte zeigt die Seite Warnungen an, wenn Live-Preise nicht verwendet werden können: Nur einer der Werte API-Benutzername und Passwort ist eingetragen, Sender phone oder Abholstadt und Bundesstaat fehlen, oder Ihre Standardwährung ist nicht NGN und kein Currency conversion rate ist festgelegt. Die Seite warnt außerdem, wenn der Versanddienstleister GIG Logistics nicht gefunden wurde, sowie wenn die Gewichtseinheit Ihres Shops (International > Localization > Local units) nicht bekannt ist; in diesem Fall werden Produktgewichte als kg gelesen. Beim Speichern werden ein ungültiger Zahlenwert (ein negativer Betrag, ein Currency conversion rate von 0, ein Breitengrad außerhalb von -90 bis 90, ein Längengrad außerhalb von -180 bis 180), ein Min weight (kg) über dem Max weight (kg), ein leerer oder ungültiger Method title oder eine unbekannte Steuerregel gemeldet, und nichts wird gespeichert.

General

Die Einstellungen auf dieser Seite gelten für alle Zonen des Versanddienstleisters.

Enable/Disable: 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: GIG Logistics. Pflichtfeld.

Tax: die Steuerregel des Versanddienstleisters oder No tax. Eine Steuerregel fügt Ihre Versandsteuer auf die Kosten hinzu. Wählen Sie No tax, wenn der GIG-Preis bereits alles enthält, was Sie berechnen möchten.

GIG Logistics API (live prices) (optional)

Mit API-Zugangsdaten wird der Preis für jede nigerianische Adresse bei GIG Logistics abgefragt. Ohne Zugangsdaten oder wenn die API keinen Preis liefert, werden die Preistabelle und die Ersatzkosten verwendet.

API username: Ihr API-Benutzername der Drittanbieter-API von GIG Logistics, meist Ihre E-Mail-Adresse.

API password: Ihr Passwort für die Drittanbieter-API von GIG Logistics. Es wird nur zur Anmeldung an der API verwendet und niemals protokolliert. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie das Passwort ändern möchten. Um das Passwort zu entfernen, leeren Sie API username und speichern Sie.

Test mode: nutzt die Test-API (dev) von GIG Logistics. Testzugangsdaten funktionieren nur mit der Test-API. Für echte Preise deaktivieren Sie diese Option. Standard: aus.

Currency conversion rate: GIG Logistics liefert Preise in NGN. Wenn die Standardwährung Ihres Shops nicht NGN ist, geben Sie an, wie viel ein NGN in Ihrer Standardwährung wert ist (1 NGN = ? Ihrer Währung, zum Beispiel 0.0006). Der Kurs muss größer als 0 sein. Ohne ihn werden Live-Preise von GIG nicht verwendet. Wenn Ihre Standardwährung NGN ist, zeigt das Feld dies an und es wird nicht benötigt. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Pickup (sender) address

Wo GIG Logistics die Pakete in Nigeria abholt. Befindet sich Ihr Shop in Nigeria, verwenden leere Felder für Straße, Stadt und Bundesstaat die Shopadresse aus Shop Parameters > Contact > Stores.

Sender name: der Absendername, der an GIG Logistics übermittelt wird. Ist das Feld leer, wird der Shopname verwendet.

Sender phone: Ihre Telefonnummer, zum Beispiel 08030000000. GIG Logistics verlangt sie für Live-Preise.

Street address: die Straßenadresse der Abholung.

City / area: die Stadt oder der Stadtteil der Abholung, zum Beispiel Victoria Island. Für Live-Preise erforderlich.

State: der nigerianische Bundesstaat der Abholadresse, auswählbar aus den 37 Bundesstaaten. Die Standardoption Shop state (Shop parameters > Contact > Stores) verwendet den Bundesstaat der Shopadresse. Für Live-Preise erforderlich.

Pickup latitude: optionaler Kartenbreitengrad des Abholpunkts, zum Beispiel 6.4281. GIG Logistics berechnet Preise nach Entfernung. Ist das Feld leer, werden die Koordinaten anhand der Adresse ermittelt.

Pickup longitude: optionaler Kartenlängengrad des Abholpunkts, zum Beispiel 3.4219.

Address lookup: ermittelt Kartenkoordinaten von Adressen mit OpenStreetMap (Nominatim). GIG Logistics berechnet den Preis anhand der Koordinaten von Abholung und Lieferung. Straße, Stadt und Bundesstaat des Kunden werden an nominatim.openstreetmap.org gesendet, und die Ergebnisse werden 30 Tage zwischengespeichert. Ohne diese Funktion wird nur der Adresstext übermittelt, und GIG Logistics liefert möglicherweise keinen Preis. Standard: ein.

Nigerian states: der Bundesstaat der Lieferadresse wird an GIG Logistics und an die Adresssuche übermittelt. PrestaShop enthält standardmäßig keine nigerianischen Bundesstaaten; ohne sie werden nur Straße und Stadt verwendet. Die Schaltfläche Add Nigerian states fügt die 37 Bundesstaaten hinzu (Codes LA, FC usw.), aktiviert Contains states für Nigeria und ergänzt das Bundesstaat-Feld im Adressformular für Nigeria. Bereits vorhandene Bundesstaaten (nach Code oder Name) werden nicht doppelt angelegt. Sind alle Voraussetzungen erfüllt, zeigt das Feld an, wie viele Bundesstaaten für nigerianische Adressen vorhanden sind. Bis Sie auf die Schaltfläche klicken, wird nichts verändert.

Price table and fallback

Wird für andere Länder verwendet, wenn Live-Preise nicht konfiguriert sind oder wenn GIG Logistics keinen Preis liefert. Die Preise gelten in der Standardwährung Ihres Shops ohne Steuern.

Country prices: eine Tabelle mit einem Grundpreis je Land. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Papierkorbsymbol, um sie zu entfernen. Wählen Sie * Any other country für alle Länder ohne eigene Zeile. Die Spalten XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg) sind optionale Preise für Gewichtsstufen: Ein Stufenpreis über 0 ersetzt den Grundpreis für Warenkörbe in dieser Stufe. Ein Preis von 0 bedeutet kostenlosen Versand. Leere Preisfelder werden als 0 gespeichert, daher tragen Sie bei jeder hinzugefügten Zeile den Grundpreis ein. Erscheint ein Land zweimal, bleibt die spätere Zeile erhalten. Korrigierte Werte werden nach dem Speichern in einer Warnung aufgelistet. Länder ohne Zeile (wenn keine *-Zeile vorhanden ist) erhalten keinen Tabellenpreis.

Fallback cost: wird verwendet, wenn weder GIG Logistics noch die Tabelle einen Preis liefern. Ist das Feld leer, wird der Versanddienstleister in diesem Fall ausgeblendet.

Table / fallback price is: Per order berechnet den Preis einmal. Per item (multiplied by the number of items) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Live-Preise von GIG gelten immer für die gesamte Bestellung.

Conditions

Free shipping from: der Warenkorb-Zwischensumme (Produkte, die einen Versand benötigen, nach Rabatten, ohne Steuern), ab der der Versand kostenlos ist. Ist das Feld leer, ist der Versand nie kostenlos.

Minimum subtotal: der Versanddienstleister wird nur angezeigt, wenn die Warenkorb-Zwischensumme diesen Betrag erreicht. Ist das Feld leer, wird er immer angezeigt.

Min weight (kg): das minimale Warenkorbgewicht in kg. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet. 0 bedeutet keine Grenze.

Max weight (kg): das maximale Warenkorbgewicht in kg. Standard: 30. 0 bedeutet keine Grenze.

Availability without shipping zones

Ignore shipping zones: bietet den Versanddienstleister für die unten aufgeführten Länder an, auch wenn seine Zonen sie nicht enthalten. Beim Einschalten wird der Versanddienstleister mit allen aktiven Zonen verknüpft, und später angelegte Zonen werden ebenfalls verknüpft. Beim Ausschalten erhält der Versanddienstleister seine früheren Zonen zurück.

Countries: die Zielländer für diesen Modus. Ist das Feld leer, gelten alle Länder, in die Sie liefern. Wird nur zusammen mit Ignore shipping zones verwendet.

Advanced

Debug log: schreibt die Preisberechnungen in logs/vfd_gigl_debug.log.php im Modulordner. Die Datei lässt sich nicht über den Webbrowser öffnen. API-Fehler werden immer protokolliert, auch wenn das Log ausgeschaltet ist. Passwörter, Token und Kundenadressen werden nicht geschrieben.

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

Remove data on uninstall: Ist die Option aktiv, löscht die Deinstallation des Moduls die Moduleinstellungen, den Versanddienstleister, die Caches und die Logs. Ist sie aus, bleibt alles für eine erneute Installation erhalten. Bestellungen bleiben immer erhalten.

So funktioniert das Modul an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Preis von GIG Logistics. Nur Produkte, die einen Versand benötigen, zählen: Virtuelle Produkte haben kein Gewicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft zuerst die Bedingungen: das Lieferland (mit Ignore shipping zones), das Warenkorbgewicht und die Mindest-Zwischensumme. Erreicht die Zwischensumme Free shipping from, beträgt der Preis 0 und es wird keine Anfrage an GIG Logistics gesendet.

Danach wird der Preis aus der ersten Quelle genommen, die einen Preis liefert. Zuerst der Live-Preis von GIG Logistics, sofern API-Zugangsdaten eingetragen sind, die Adresse in Nigeria liegt, die Adresse eine Stadt oder einen Bundesstaat hat, Telefonnummer, Stadt und Bundesstaat der Abholung gesetzt sind und bei Shops, deren Standardwährung nicht NGN ist, ein Umrechnungskurs festgelegt ist. Das Modul meldet sich bei der API von GIG Logistics an und sendet die Abhol- und Lieferadressen und -koordinaten sowie die Warenkorbartikel mit Namen, Mengen, Gewichten und Werten. Produkte ohne Gewicht werden als 1 kg gesendet. Der Preis wird für die Zustellung per Fahrrad abgefragt. Zweitens die Tabelle Country prices. Drittens die Fallback cost. Liefert keine davon einen Preis, wird der Versanddienstleister für diesen Warenkorb ausgeblendet. Der Preis wird in Ihrer Standardwährung berechnet und danach in der Warenkorbwährung des Kunden angezeigt.

Jede Antwort von GIG wird 1 Stunde zwischengespeichert, sodass derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage oder eine fehlgeschlagene Anmeldung wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf GIG Logistics warten muss. Das Anmeldetoken bleibt 30 Minuten gültig und wird automatisch erneuert, wenn GIG es ablehnt. Das Timeout der API beträgt 10 Sekunden, das der Adresssuche 5 Sekunden.

Gibt GIG Logistics einen Fehler oder einen Preis von null zurück, sieht der Kunde keine Fehlermeldung. Es wird der Tabellen- oder Ersatzpreis verwendet, und der Fehler wird im Debug-Log protokolliert.

Bearbeiten Sie den Versanddienstleister unter Shipping > Carriers, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul folgt der neuen Version automatisch.

Das Modul berechnet nur Preise. Es erstellt keine Sendungen, Versandbelege oder Etiketten von GIG Logistics, bucht keine Abholungen, verfolgt keine Pakete und lässt Kunden kein Servicecenter wählen. Bestellungen werden wie gewohnt über Ihr GIG-Logistics-Konto versendet. Live-Preise werden nur für nigerianische Adressen abgefragt. Für andere Länder verwenden Sie die Preistabelle.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox GIG Logistics ist der erste Block unter Modules > Module Manager > VibeFox GIG Logistics > 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 zum erneuten Prüfen des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-shipping-gig-logistics und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul 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. Klicken Sie nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, 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 in 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 einen aktiven Schlüssel wird der Versanddienstleister GIG Logistics Kunden an der Kasse nicht angezeigt und es wird kein Preis berechnet. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Versanddienstleister auch Ihnen ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Ein Hinweis erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen jedoch 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 Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren oder Zurücksetzen des Moduls werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

GIG Logistics erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv und Enable/Disable eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Landes und die Kundengruppe des Kunden abdeckt, oder schalten Sie Ignore shipping zones ein und prüfen Sie Countries. Prüfen Sie die Gewichtsgrenzen und die Minimum subtotal. Prüfen Sie, ob die Tabelle (das Land oder *) oder die Fallback cost einen Preis für das Land ergibt. Produkte können auch auf der Produktseite auf bestimmte Versanddienstleister beschränkt werden.

Der Preis stammt aus der Tabelle, nicht von GIG Logistics: Live-Preise benötigen API-Benutzername und Passwort, die Sender phone, Stadt und Bundesstaat der Abholung, eine nigerianische Lieferadresse mit Stadt oder Bundesstaat und bei Shops, deren Standardwährung nicht NGN ist, den Currency conversion rate. Beachten Sie die Warnungen oben auf der Seite Configure. Schalten Sie das Debug log ein, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Modulseite nach dem Grund. Eine fehlgeschlagene Anfrage wird nach 10 Minuten wiederholt.

Login failed im Log: GIG Logistics hat den API-Benutzernamen oder das Passwort abgelehnt. Prüfen Sie beides und prüfen Sie Test mode: Testzugangsdaten funktionieren nur mit der Test-API. Speichern Sie die Einstellungen, um sofort einen neuen Versuch zu starten.

GIG Logistics liefert keinen Preis: GIG berechnet Preise nach Entfernung. Lassen Sie Address lookup eingeschaltet oder geben Sie Pickup latitude und Pickup longitude ein. Klicken Sie auf Add Nigerian states, damit auch der Bundesstaat der Lieferung übermittelt wird. Bestätigen Sie die Preise mit Ihrem GIG-Logistics-Konto, bevor Sie live gehen.

Die Warnung zu Stadt und Bundesstaat der Abholung bleibt bestehen: Wählen Sie einen Bundesstaat unter State und füllen Sie City / area aus. Die Shopadresse wird nur verwendet, wenn das Shopland Nigeria ist, und der Bundesstaat des Shops ist erst bekannt, nachdem die nigerianischen Bundesstaaten hinzugefügt und unter Shop Parameters > Contact > Stores ausgewählt wurden.

Steuer wird auf den GIG-Preis aufgeschlagen: Stellen Sie Tax auf No tax, wenn der GIG-Preis bereits alles enthält, was Sie berechnen möchten.

Preise wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save. Dadurch werden die zwischengespeicherten Preise, Token und Koordinaten gelöscht.

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

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox GIG Logistics und wählen Sie Uninstall. Lizenzschlüssel und Lizenzstatus werden immer entfernt. Die zwischengespeicherten Preise, Token und Adresskoordinaten werden immer entfernt. Ist Remove data on uninstall eingeschaltet, wird der Versanddienstleister gelöscht (Bestellungen behalten ihren Verlauf) und die Einstellungen sowie das Log werden entfernt. Ist die Option aus, wird der Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Wird das Modul erneut installiert, erhält der gespeicherte Versanddienstleister seinen früheren Status zurück. Die mit Add Nigerian states hinzugefügten nigerianischen Bundesstaaten bleiben in beiden Fällen in Ihrem Shop erhalten.

GIG Logistics ist eine Marke ihres jeweiligen Inhabers. Dieses Modul steht in keiner Verbindung zu GIG Logistics und wird von GIG Logistics nicht unterstützt.