VibeFox Jadlog for OpenCart — Hilfe
Anforderungen
OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).
PHP: 8.0 oder neuer.
Jadlog-Vertrag (für Live-Preise und Pickup-Punkte): Live-Preise und die Liste der Pickup-Punkte stammen aus der Jadlog-Embarcador-API. Ihre Jadlog-Franchise stellt den Zugang nach Vertragsunterzeichnung aus. Sie benötigen das Embarcador-API-Token, die CNPJ (oder CPF) des im Vertrag eingetragenen Absenders, das Kontokorrent (conta corrente) und, falls vorhanden, die Vertragsnummer. Wenn Sie nur feste Preise nutzen, brauchen Sie keinen Jadlog-Vertrag.
VibeFox-Lizenzschlüssel: gekauft auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.
Installation
Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket vfd_jadlog-oc3-(version).ocmod.zip und das OpenCart-4-Paket vfd_jadlog.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.
OpenCart 3
1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_jadlog-oc3-(version).ocmod.zip. Die Erweiterung fügt keine OCMOD-Modifikationen hinzu, daher müssen Sie Extensions > Modifications nicht aktualisieren. Statt des Installers können Sie den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.
2. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox Jadlog und klicken Sie auf Install (die grüne +-Schaltfläche).
3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzblock oben auf der Seite Edit ein und klicken Sie auf Activate (siehe Lizenzschlüssel).
5. Fügen Sie das API-Token ein, geben Sie CNPJ, Kontokorrent, Vertragsnummer und Ursprungs-CEP ein, wählen Sie den Jadlog-Dienst und geben Sie, falls Ihre Standardwährung nicht BRL ist, den BRL-Umrechnungskurs ein. Fügen Sie bei Bedarf feste Preise oder einen Ersatzpreis hinzu (siehe Konfiguration).
6. Aktivieren Sie Enable Jadlog home delivery, Enable Jadlog Pickup oder beide und klicken Sie auf Save.
OpenCart 4
1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_jadlog.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.
2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).
3. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox Jadlog, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).
4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 4 bis 6 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.
Nach der Installation sind beide Optionen aus, bis Sie sie einschalten und speichern. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die gespeicherten Jadlog-Einstellungen wieder verwendet.
Konfiguration
Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Shipping > VibeFox Jadlog > Edit. Sie gelten für beide Jadlog-Optionen. Die Abschnitte sind links aufgelistet. Eine Schaltfläche Save speichert die gesamte Seite ohne Neuladen. Jedes Speichern löscht außerdem die zwischengespeicherten Jadlog-Preise und Pickup-Punktlisten. Nur Admin-Benutzer mit der Berechtigung zum Ändern dieser Erweiterung können die Einstellungen speichern.
Oben auf der Seite zeigt die Erweiterung Warnungen für eine unvollständige Einrichtung: kein API-Token (nur feste Preise werden verwendet, und Pickup-Punkte können nicht aufgelistet werden), kein API-Token und keine festen Preise (die Methode wird nie angezeigt), keine CNPJ oder kein Kontokorrent, keine Ursprungs-CEP, kein BRL-Umrechnungskurs für einen Shop, der nicht in BRL verkauft, und keine Gewichtsklasse „kg“ oder Längenklasse „cm“ im Shop (dann werden Gewichte und Maße anhand des Einheitennamens ihrer Klasse umgerechnet; prüfen Sie System > Localisation > Weight Classes und Length Classes).
Beim Speichern führt ein ungültiger Titel einer der beiden Optionen (leer, länger als 64 Zeichen oder mit < > ; = # { }), eine Sort order, die keine ganze Zahl ist, oder eine Steuerklasse bzw. Geozone, die nicht existiert, zu einem Fehler, und das Speichern wird abgebrochen. Andere falsche Werte werden mit einem Hinweis über den Einstellungen gespeichert: Eine ungültige Zahl oder eine Zahl unter 0 wird nicht gespeichert, ein Mindestgewicht über dem Höchstgewicht behält beide gespeicherten Gewichte, ein BRL-Umrechnungskurs, der keine positive Zahl ist, wird gelöscht, eine CEP ohne 8 Ziffern oder eine CNPJ ohne 14 Ziffern (oder 11 bei einer CPF) wird wie eingegeben mit einer Warnung gespeichert, und in der Preistabelle wird eine Zeile mit unbekanntem Land entfernt und ein ungültiger Preis leer gelassen.
Allgemein
Jadlog bietet zwei Lieferoptionen: Jadlog home delivery (dieser Abschnitt) und Jadlog Pickup (eigener Abschnitt). Die Einstellungen auf dieser Seite gelten für beide.
Enable Jadlog home delivery: bietet die Lieferung von Jadlog an die Adresse des Kunden mit dem unten gewählten Dienst an. Standard: off.
Method title: der Name der Option Heimzustellung, der dem Kunden an der Kasse angezeigt wird. Standard: Jadlog. Pflichtfeld, bis zu 64 Zeichen.
Sort order: die Position von Jadlog unter den Versandarten an der Kasse. Eine ganze Zahl.
Tax class: die Steuerklasse der Versandkosten oder No tax (Standard). Jadlog-Preise sind endgültige Frachtpreise. Wählen Sie No tax, wenn OpenCart keine Steuer darauf aufschlagen soll. Dies gilt für beide Optionen.
Jadlog-Live-Preise
Live-Preise werden nur für Adressen in Brasilien mit vollständiger 8-stelliger CEP angefragt.
API token: das Embarcador-Token von Jadlog. Sie können es mit oder ohne das Wort „Bearer“ einfügen. Lassen Sie es leer, um nur feste Preise zu verwenden. Nach dem Speichern bleibt das Feld leer und zeigt Saved - leave empty to keep it. Geben Sie einen neuen Wert nur ein, um ihn zu ändern. Ist kein Token gespeichert, zeigt die Seite No token saved.
Remove the saved API token: Haken setzen und auf Save klicken, um das gespeicherte Token zu löschen.
CNPJ: die CNPJ (14 Ziffern) oder CPF (11 Ziffern) des im Jadlog-Vertrag eingetragenen Absenders, zum Beispiel 00.000.000/0000-00.
Current account (conta corrente): Ihre Kontokorrentnummer bei Jadlog. Ohne sie und ohne CNPJ kann Jadlog keinen Preis angeben, und es werden nur feste Preise verwendet.
Contract number: Ihre Vertragsnummer bei Jadlog, falls Ihre Franchise Ihnen eine gegeben hat.
Origin CEP: die Postleitzahl, von der die Pakete versendet werden, 8 Ziffern (00000-000). Für Live-Preise erforderlich: OpenCart hat keine Shop-Postleitzahl, daher werden ohne dieses Feld nur feste Preise verwendet.
Jadlog service: der Dienst (modalidade) Ihres Vertrags für die Heimzustellung: .Package (3, Standard), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12) oder Emergencial (14). Jadlog Pickup (40) ist die zweite Option.
Insurance type: Normal (N) (Standard) oder Own insurance policy (A - apolice), wie in Ihrem Jadlog-Vertrag vereinbart.
Volumetric weight: Jadlog berechnet das größere von realem und volumetrischem Gewicht.
BRL exchange rate: Jadlog kalkuliert in brasilianischen Real. Ist die Standardwährung Ihres Shops BRL, wird dieses Feld nicht benötigt. Andernfalls geben Sie ein, wie viel 1 BRL in Ihrer Standardwährung ist, zum Beispiel 0.16. Der Jadlog-Preis wird mit diesem Kurs multipliziert, und der an Jadlog gesendete deklarierte Bestellwert wird zurück in BRL umgerechnet. Ohne den Kurs werden keine Live-Preise verwendet, und es gelten nur feste Preise.
Delivery time: zeigt die von Jadlog an der Kasse gelieferte Lieferzeit neben dem Titel der Heimzustellung (zum Beispiel „Jadlog (3 business days)“) und neben jedem Pickup-Punkt. Standardmäßig eingeschaltet. Die Lieferzeit wird immer mit der Bestellung gespeichert.
Jadlog Pickup
Eine zweite Lieferoption mit dem Jadlog-Dienst Pickup (40). Sie benötigt das API-Token. Ohne Punkte ist die Option ausgeblendet.
Enable Jadlog Pickup: bietet die Lieferung an einen Jadlog-Pickup-Punkt an, der an der Kasse gewählt wird. Standard: off.
Jadlog Pickup title: der Name dieser Option an der Kasse. Standard: Jadlog Pickup. Pflichtfeld, bis zu 64 Zeichen.
Points to show: wie viele Pickup-Punkte angeboten werden, von 1 bis 10. Standard: 5.
Feste Preise (werden verwendet, wenn kein API-Token vorhanden ist, für Länder, die Jadlog nicht bedient, und immer dann, wenn Jadlog keinen Preis liefert)
Price per country: eine Tabelle mit den Spalten Country, Price, XS, S, M, L und XL in der Standardwährung Ihres Shops. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf die ×-Schaltfläche, um eine zu entfernen. Die Größenspalte wird nach Warenkorbgewicht gewählt: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg, XL über 5 kg. Price wird verwendet, wenn die Größenspalte leer ist. Der Preis 0 bedeutet kostenlosen Versand für dieses Land. Verwenden Sie * Default (other countries) für alle übrigen Länder.
Fallback cost: wird verwendet, wenn weder Jadlog noch die Tabelle einen Preis liefern. Lassen Sie das Feld leer, um die Methode in diesem Fall auszublenden.
Fixed price applies: Per order (Standard) berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Dies gilt nur für feste Preise und den Ersatzpreis. Jadlog-Preise decken bereits den gesamten Warenkorb ab.
Bedingungen
Minimum weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze (Standard).
Maximum weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. Standard: 150. 0 bedeutet keine Grenze.
Minimum order amount: zeigt die Methode nur, wenn die Zwischensumme der versandpflichtigen Produkte (nach dem Gutschein, vor Steuer) diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.
Free shipping from: die Zwischensumme (nach dem Gutschein, vor Steuer), ab der die Lieferung kostenlos ist. Leer lassen für keinen kostenlosen Versand.
Verfügbarkeit
Geo zone: Jadlog nur für Adressen in dieser Geozone anbieten. All zones (Standard) bedeutet keine Begrenzung. Die Geozone wird nicht geprüft, wenn Ignore shipping zones aktiviert ist. Geozonen werden unter System > Localisation > Geo Zones verwaltet.
Ignore shipping zones: ist die Option aktiv, wird die Geo zone nicht geprüft und Jadlog wird für die unten genannten Länder angeboten. Ist sie aus (Standard), gilt nur die Geo zone.
Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zuzulassen. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiv ist.
Erweitert
Debug log: protokolliert jede Anfrage und Antwort von Jadlog in storage/logs/vfd_jdlg_debug.log.php (bei OpenCart 4 system/storage/logs/vfd_jdlg_debug.log.php). Die Datei kann nicht aus dem Web gelesen werden. API-Fehler und Jadlog-Pickup-Bestellungen ohne Punkt werden immer protokolliert, auch wenn diese Option aus ist. Token, CNPJ und Konto werden nie protokolliert, und die CEP des Kunden wird gekürzt. Schalten Sie das Protokoll aus, wenn Sie fertig sind.
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 aktiv, löscht die Deinstallation der Erweiterung alle Jadlog-Einstellungen, das Protokoll und die Punktauswahl von Kassenvorgängen, die nie zu Bestellungen wurden. Ist sie aus (Standard), bleiben die Einstellungen für eine erneute Installation erhalten. Zwischengespeicherte Preise werden immer entfernt. Die Jadlog-Daten von Bestellungen werden nie gelöscht.
Import / Export
Export: klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern. Das API-Token wird nicht exportiert.
Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen, zum Beispiel in einem anderen Shop. Die Werte werden wie bei einem normalen Speichern geprüft. Das gespeicherte API-Token bleibt erhalten.
Ablauf an der Kasse
Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem Preis jeder Jadlog-Option: Heimzustellung und Jadlog Pickup erscheinen als zwei Auswahlmöglichkeiten unter einer Jadlog-Methode. Ist Ignore shipping zones aktiv, wird Jadlog nur angeboten, wenn das Land erlaubt ist (die Geozone wird nicht geprüft). Andernfalls wird Jadlog nicht angeboten, wenn eine Geo zone gesetzt ist und die Adresse außerhalb liegt. Nur Produkte mit Requires Shipping auf Yes zählen: andere Produkte erhöhen das Gewicht nicht und sind nicht im Bestellwert enthalten. Der Bestellwert ist der Preis der versandpflichtigen Produkte nach Abzug des Gutscheins und vor Steuer. Die Erweiterung prüft das Warenkorbgewicht und den Mindestbestellwert. Erreicht die Zwischensumme Free shipping from, ist die Lieferung kostenlos und es wird keine Preisanfrage an Jadlog gesendet.
Für eine Lieferadresse in Brasilien mit vollständiger 8-stelliger CEP sendet die Erweiterung an Jadlog die Ursprungs- und Ziel-CEP, das Gewicht, Ihre CNPJ, das Kontokorrent, den Vertrag, den Dienst, die Versicherungsart und den deklarierten Bestellwert. Produktgewichte werden von ihrer OpenCart-Gewichtsklasse in kg und Maße von ihrer Längenklasse in cm umgerechnet. Warenkörbe ohne Gewicht werden mit 0.1 kg angefragt. Der zurückgegebene Preis wird in Ihre Standardwährung umgerechnet, auf deren Dezimalstellen gerundet und in der Währung des Kunden mit der Steuer der gewählten Tax class angezeigt. Gibt es keinen Live-Preis (kein Token, eine Adresse außerhalb Brasiliens, eine unvollständige CEP, kein BRL-Kurs, ein Jadlog-Fehler), verwendet die Erweiterung die Tabelle Price per country und danach den Fallback cost. Liefert keiner von beiden einen Preis, wird die Option für diesen Warenkorb ausgeblendet.
Jeder Preis wird 1 Stunde zwischengespeichert, sodass derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 10 Minuten zwischengespeichert. Antwortet Jadlog nicht, meldet einen Serverfehler oder lehnt das Token ab, wird die API 10 Minuten lang nicht erneut aufgerufen. Das API-Zeitlimit beträgt 10 Sekunden. Der Kunde sieht nie einen API-Fehler. Der Grund wird im Protokoll festgehalten.
Bei OpenCart 4 klickt der Kunde im Block der Versandart auf der Kassenseite auf Choose und wählt im Fenster Shipping method options eine Jadlog-Option aus. Die Preise sind dieselben wie bei OpenCart 3.
Die Erweiterung berechnet nur Preise und listet nur Pickup-Punkte auf. Sie erstellt keine Jadlog-Sendungen, druckt keine Etiketten, beantragt keine Abholungen, storniert keine Sendungen und verfolgt keine Pakete. Sie zeigt keine Karte der Pickup-Punkte und fragt keine internationalen Angebote bei Jadlog an. Verwenden Sie für andere Länder feste Preise.
Pickup-Punkte
Die Option Jadlog Pickup wird nur für Adressen in Brasilien angeboten, und nur wenn Enable Jadlog Pickup aktiv und das API-Token gespeichert ist. Hat der Kunde eine vollständige 8-stellige CEP eingegeben, fragt die Erweiterung bei Jadlog die nächstgelegenen aktiven Pickup-Punkte an und listet bis zu Points to show Punkte unter der Option auf, jeweils mit ihrem Preis, zum Beispiel „Name des Punkts — Preis (3 business days) — Adresse“. Ist die Liste noch nicht zwischengespeichert, wird sie im Hintergrund geladen, sobald der Kunde Jadlog Pickup auswählt, sodass der Schritt Versandart nicht auf Jadlog wartet.
Der Preis zu jedem Punkt wird bei Jadlog angefragt. Gibt Jadlog für einen Punkt keinen Preis, wird der feste Preis verwendet, und ein Punkt ohne jeden Preis wird weggelassen. Punktlisten werden 12 Stunden zwischengespeichert. Der Optionspreis ist der Preis des gewählten Punkts. Bevor ein Punkt gewählt ist, ist es der Preis des nächsten Punkts mit einem Preis. Nachdem der Kunde einen Punkt gewählt hat, wird der Preis neben Jadlog Pickup aktualisiert.
Ein Punkt ist erforderlich. Klickt der Kunde im Schritt Versandart ohne Punkt auf Continue, sieht er Please select a Jadlog Pickup point. Die Erweiterung prüft auf dem Server, ob der Punkt in der Jadlog-Liste für die CEP der Lieferung steht. Wenn nicht, sieht der Kunde The selected Jadlog Pickup point is not in the Jadlog list for this CEP. Please choose the point again. Ist die CEP unvollständig, gibt es keine Punkte in der Nähe oder ist Jadlog nicht verfügbar, wird unter der Option eine Meldung angezeigt.
Ohne API-Token, wenn Jadlog nicht verfügbar ist oder wenn es keine aktiven Punkte in der Nähe gibt, wird die Option Jadlog Pickup ausgeblendet. Eine Bestellung ohne Punkt könnte nicht versendet werden.
Bei OpenCart 4 erscheint die Liste der Pickup-Punkte im Fenster Shipping method options, unter der Option Jadlog Pickup. Sie wird im Hintergrund geladen, zuerst aus dem Cache und dann mit den Preisen der übrigen Punkte von Jadlog. Nachdem der Kunde einen Punkt gewählt hat, wird der Preis neben Jadlog Pickup im Fenster aktualisiert. Die Schaltfläche Continue des Fensters geht nicht ohne einen gültigen Punkt weiter, mit denselben Meldungen.
Bestellungen
Wird eine Bestellung mit einer Jadlog-Option aufgegeben, speichert die Erweiterung den Jadlog-Dienst und, wenn Jadlog ihn zurückgegeben hat, die Lieferzeit in Werktagen. Bei einer Jadlog-Pickup-Bestellung speichert sie außerdem Name, Adresse und ID des Pickup-Punkts. Bei OpenCart 4 behält der Shop für den Checkout eine einzige Bestellung und aktualisiert sie jedes Mal, wenn der Kunde erneut bestätigt; die Jadlog-Daten der Bestellung werden dabei mit aktualisiert. Wechselt der Kunde diese Bestellung zu einer anderen Versandart, werden ihre Jadlog-Daten entfernt.
Der Punkt wird nach dem Optionstitel der Versandart der Bestellung hinzugefügt, zum Beispiel Jadlog Pickup:, gefolgt von Name und Adresse des Punkts. Dieser Text erscheint auf den Bestellseiten im Admin und im Kundenkonto, in den Bestell-E-Mails und auf der Rechnung.
Die Bestellseite im Admin (Sales > Orders) zeigt ein Feld Jadlog mit Jadlog service, Delivery time und, für Jadlog Pickup, Pickup point, Pickup point address und Pickup point ID. Bei OpenCart 4 wird das Feld oberhalb von History angezeigt.
Buchen Sie die Sendung selbst im Jadlog-System. Die Bestellung zeigt den Dienst und die Pickup-Punkt-ID, die Sie dafür benötigen.
Lizenzschlüssel
Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Jadlog ist der erste Block auf Extensions > Extensions > Shipping > VibeFox Jadlog > Edit, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-shipping-jadlog und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung zum Ändern dieser Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).
Wird der Schlüssel nicht akzeptiert, zeigt 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 die Erweiterung mit dem zuletzt bekannten Status weiter.
Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. 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 werden die Jadlog-Versandoptionen Kunden an der Kasse nicht angezeigt, und es wird kein Preis berechnet. Ein Admin-Benutzer, der im Admin im selben Browser angemeldet ist, sieht sie weiterhin im Shop, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher sind die Jadlog-Optionen ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Admin-Dashboard. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen.
Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Admin-Dashboard oder die Seite Edit öffnen: 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. Beim Deinstallieren der Erweiterung werden immer der Lizenzschlüssel und der Lizenzstatus entfernt.
Fehlerbehebung
Jadlog erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist und Enable Jadlog home delivery (oder Enable Jadlog Pickup) eingeschaltet ist. Prüfen Sie Geo zone oder schalten Sie Ignore shipping zones ein und prüfen Sie Countries. Prüfen Sie die Warnungen oben auf der Erweiterungsseite, die Gewichtsgrenzen, Minimum order amount und ob die Produkte Requires Shipping auf Yes haben. Hat der Kunde noch keine vollständige 8-stellige CEP eingegeben, können nur feste Preise verwendet werden. Fügen Sie daher eine Zeile Price per country oder einen Fallback cost hinzu.
Nur feste Preise werden angezeigt: aktivieren Sie Debug log, laden Sie die Kasse neu und sehen Sie sich das Feld Log auf der Erweiterungsseite an. Es zeigt den Grund: keine CNPJ oder kein Kontokorrent, keine Ursprungs-CEP, eine unvollständige Ziel-CEP, kein BRL-Umrechnungskurs oder die Jadlog-Fehlermeldung.
HTTP 401 oder 403 im Protokoll: Jadlog hat das API-Token abgelehnt. Prüfen Sie es mit Ihrer Jadlog-Franchise. Nach diesem Fehler ist die API 10 Minuten pausiert. Beim Speichern der Einstellungen wird die Pause aufgehoben, sodass Sie sofort erneut versuchen können.
Pickup-Punkte erscheinen nicht: die Option Jadlog Pickup benötigt Enable Jadlog Pickup, das API-Token und eine vollständige 8-stellige CEP in Brasilien. Hat Jadlog keine aktiven Punkte in der Nähe der CEP, wird die Option ausgeblendet. Prüfen Sie das Protokoll auf den Grund.
Preise werden in Real statt in meiner Währung angezeigt: geben Sie den BRL exchange rate ein (wie viel 1 BRL in der Standardwährung Ihres Shops ist).
Preise wirken zu niedrig oder zu hoch: tragen Sie Produktgewichte und -maße ein. Warenkörbe ohne Gewicht werden mit 0.1 kg angefragt, und das volumetrische Gewicht benötigt Maße.
Steuer wird auf Jadlog-Preise aufgeschlagen: setzen Sie Tax class auf No tax.
Preise wirken nach einer Änderung veraltet: klicken Sie auf der Erweiterungsseite auf Save. Dadurch werden die zwischengespeicherten Jadlog-Preise und Pickup-Punktlisten gelöscht.
Die Seite zeigt „Warning: You do not have permission to modify VibeFox Jadlog!“: Ihre Admin-Benutzergruppe darf die Einstellungen eventuell nur ansehen. Erteilen Sie der Gruppe die Berechtigung zum Ändern für extension/shipping/vfd_jadlog (OpenCart 3) bzw. extension/vfd_jadlog/shipping/vfd_jadlog (OpenCart 4) unter System > Users > User Groups.
Deinstallation
Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox Jadlog auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt immer den Status der Erweiterung, Sort order, Tax class und Geo zone zurück. Die zwischengespeicherten Preise und Pickup-Punktlisten werden immer entfernt. Ist Remove data on uninstall aktiv, werden außerdem die Jadlog-Einstellungen und das Protokoll gelöscht. Ist es aus, bleiben die übrigen Einstellungen erhalten und werden bei einer erneuten Installation wieder verwendet. Dienst, Lieferzeit und Pickup-Punkt von Jadlog, die mit Bestellungen gespeichert wurden, bleiben immer erhalten, und bestehende Bestellungen behalten ihre Versandart und Kosten.
Um bei OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Jadlog auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.
Jadlog ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Jadlog verbunden und wird von Jadlog nicht unterstützt.