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

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 der Vertragsunterzeichnung aus. Sie benötigen den Embarcador-API-Token, die CNPJ (oder CPF) des im Vertrag eingetragenen Absenders, das Girokonto (conta corrente) und, falls vorhanden, die Vertragsnummer. Wenn Sie nur feste Preise verwenden, benötigen Sie keinen Jadlog-Vertrag.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt 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. Sie können den Ordner vfd_jadlog auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Jadlog, oder klicken Sie auf der Plugins-Seite 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 den API-Token ein, geben Sie CNPJ, Girokonto, Vertragsnummer und CEP des Versandursprungs ein, wählen Sie den Jadlog-Service und geben Sie, falls Ihre Shop-Währung nicht BRL ist, den BRL-Wechselkurs ein. Fügen Sie bei Bedarf feste Preise oder Ausweichkosten hinzu (siehe Konfiguration).

6. Fügen Sie VibeFox Jadlog unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone für Brasilien hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie Länder aus. Um zusätzlich Jadlog-Pickup-Punkte anzubieten, fügen Sie die Methode der Zone ein zweites Mal hinzu und wählen Sie Pickup (40) als Service.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Jadlog. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster zwei Felder:

Title (zone): der Name, den Kunden für diese Zone sehen. Leer lassen, um den globalen Method title zu verwenden.

Jadlog service (zone): der Service dieser Zonenmethode. Same as the global setting verwendet den Service von der Hauptseite der Einstellungen. Fügen Sie die Methode zweimal hinzu, um zum Beispiel Heimlieferung (.Package) und Jadlog-Pickup-Punkte in derselben Zone anzubieten.

Ist der Zonentitel leer und der Service Pickup, wird dem globalen Titel das Wort „Pickup“ hinzugefügt, damit die beiden Methoden unterschiedliche Namen haben.

Oben auf der Einstellungsseite zeigt das Plugin Warnungen bei unvollständiger Einrichtung: kein API-Token, keine CNPJ oder kein Girokonto, kein Versandursprungs-CEP oder kein BRL-Wechselkurs für einen Shop, der nicht in BRL verkauft. Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Jadlog-Preise und Listen der Pickup-Punkte gelöscht.

Allgemein

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: Jadlog. Eine Zone kann ihn überschreiben.

Jadlog-Live-Preise

Live-Preise werden nur für Adressen in Brasilien mit vollständiger 8-stelliger CEP abgefragt.

API token: der Embarcador-Token von Jadlog. Sie können ihn mit oder ohne das Wort „Bearer“ einfügen. Leer lassen, um nur feste Preise zu verwenden.

CNPJ: die CNPJ (14 Stellen) oder CPF (11 Stellen) des im Jadlog-Vertrag eingetragenen Absenders. Punkte, Schrägstriche und Bindestriche sind erlaubt. Das Plugin warnt Sie, wenn die Anzahl der Stellen nicht stimmt.

Current account (conta corrente): Ihre Girokontonummer bei Jadlog. Ohne sie und die CNPJ kann Jadlog keine Preise berechnen, und es werden nur feste Preise verwendet.

Contract number: Ihre Vertragsnummer bei Jadlog, falls Ihnen Ihre Franchise eine vergeben hat.

Origin CEP: die Postleitzahl, von der aus die Pakete versendet werden, 8 Stellen. Sie wird im Format 00000-000 gespeichert. Leer lassen, um die Shop-Postleitzahl aus WooCommerce > Settings > General zu verwenden, sofern die Shop-Adresse in Brasilien liegt.

Jadlog service: der Service (modalidade) Ihres Vertrags: .Package (3, Standard), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12), Emergencial (14) oder Pickup (40). Pickup bietet die Jadlog-Pickup-Punkte in der Nähe des Kunden an. Eine Zonenmethode kann einen anderen Service verwenden.

Insurance type: Normal (N) (Standard) oder Own insurance policy (A — apólice), wie in Ihrem Jadlog-Vertrag vereinbart.

Volumetric weight: Jadlog berechnet das größere von tatsächlichem und volumetrischem Gewicht.

BRL exchange rate: Jadlog kotiert in brasilianischen Real. Wenn Ihre Shop-Währung BRL ist, wird dieses Feld nicht benötigt. Andernfalls geben Sie ein, wie viel 1 BRL in Ihrer Shop-Währung wert ist, zum Beispiel 0.16. Der Jadlog-Preis wird mit diesem Kurs multipliziert, und der an Jadlog übermittelte deklarierte Bestellwert wird zurück in BRL umgerechnet. Ohne den Kurs werden keine Live-Preise verwendet, und es gelten nur feste Preise. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Delivery time: zeigt die von Jadlog gelieferte Lieferzeit neben dem Titel der Methode an, zum Beispiel „Jadlog (3 Werktage)“. Standardmäßig eingeschaltet. Die Lieferzeit wird immer in der Bestellung gespeichert.

Jadlog-Pickup-Punkte (für den Service Pickup (40) verwendet; benötigt den API-Token)

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 Ihrer Shop-Währung. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Die Größenspalte wird nach dem 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. Ein Preis von 0 bedeutet kostenlosen Versand für dieses Land. Verwenden Sie * Default als Land für alle übrigen Länder. Zeilen ohne Preis werden beim Speichern entfernt.

Fallback cost: wird verwendet, wenn weder Jadlog noch die Tabelle einen Preis liefern. Leer lassen, um die Methode in diesem Fall auszublenden.

Fixed price applies: Per order berechnet den Preis einmal. Per item (price × quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Das gilt nur für feste Preise und die Ausweichkosten. Jadlog-Preise decken bereits den gesamten Warenkorb ab.

Bedingungen

Minimum weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. 0 bedeutet keine Begrenzung.

Maximum weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Standard: 150. 0 bedeutet keine Begrenzung.

Minimum order amount: zeigt die Methode nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, vor Steuern) diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

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

Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, vor Steuern), ab der die Lieferung kostenlos ist. Leer lassen für keinen kostenlosen Versand.

Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht. Jadlog-Preise sind endgültige Preise des Versanddienstleisters. Wählen Sie None, wenn WooCommerce darauf keine Steuer aufschlagen soll.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Jadlog für die unten genannten Länder an, auch wenn die Methode keiner Versandzone hinzugefügt wurde. In diesem Modus wird der globale Jadlog service verwendet.

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

Erweitert

Debug log: protokolliert jede Anfrage und Antwort von Jadlog unter WooCommerce > Status > Logs, Quelle vfd-jadlog. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet 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.

Remove data on uninstall: wenn eingeschaltet, entfernt das Löschen des Plugins alle Jadlog-Einstellungen und Zonenmethoden. Das Deaktivieren des Plugins löscht nie Einstellungen. Zwischengespeicherte Preise werden immer entfernt.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Preis. Das Plugin prüft zuerst die Bedingungen: Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Erreicht die Warenkorb-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 das Plugin an Jadlog die CEP von Versandursprung und Ziel, das Gewicht, Ihre CNPJ, Ihr Girokonto, den Vertrag, den Service, die Versicherungsart und den deklarierten Bestellwert und zeigt den zurückgegebenen Preis in Ihrer Shop-Währung an. Warenkörbe ohne Gewicht werden mit 0,1 kg berechnet. Gibt es keinen Live-Preis (kein Token, Adresse außerhalb Brasiliens, unvollständige CEP, kein BRL-Wechselkurs, Jadlog-Fehler), verwendet das Plugin die Tabelle Price per country und danach die Fallback cost. Liefert keine davon einen Preis, wird die Methode für diesen Warenkorb ausgeblendet.

Jeder Preis wird 1 Stunde zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 10 Minuten zwischengespeichert. Antwortet Jadlog nicht, meldet einen Serverfehler oder lehnt den 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.

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

Das Plugin berechnet nur Preise und listet Pickup-Punkte auf. Es erstellt keine Jadlog-Sendungen, druckt keine Etiketten, beantragt keine Abholungen, storniert keine Sendungen und verfolgt keine Pakete. Es zeigt keine Karte der Pickup-Punkte und fragt bei Jadlog keine internationalen Angebote ab. Verwenden Sie für andere Länder feste Preise.

Pickup-Punkte

Eine Methode mit dem Service Pickup (40) wird nur für Adressen in Brasilien angeboten. Hat der Kunde eine vollständige 8-stellige CEP eingegeben, fragt das Plugin bei Jadlog die nächstgelegenen aktiven Pickup-Punkte ab und bietet bis zu Points to show Punkte an. Jeder Punkt ist eine eigene Versandoption mit eigenem Preis, zum Beispiel „Jadlog Pickup: Name des Punkts — Adresse“. Der Kunde wählt einen Punkt, indem er die Versandoption auswählt, sowohl an der klassischen Kasse als auch in den Warenkorb- und Kassenblöcken.

Der Preis zu jedem Punkt wird bei Jadlog angefragt. Gibt Jadlog für einen Punkt keinen Preis an, wird der feste Preis verwendet; ein Punkt ganz ohne Preis wird ausgelassen. Listen der Pickup-Punkte werden 12 Stunden zwischengespeichert.

Ohne API-Token, ohne 8-stellige CEP, wenn Jadlog nicht erreichbar ist oder wenn es in der Nähe keine aktiven Punkte gibt, wird die Pickup-Methode ausgeblendet. Eine Bestellung ohne Punkt könnte nicht versandt werden.

Bestellungen

Die Versandposition der Bestellung enthält den Jadlog-Service und, sofern Jadlog sie zurückgegeben hat, die Lieferzeit in Werktagen. Bei einer Pickup-Bestellung enthält der Name der Versandposition den Namen und die Adresse des Punkts, und die Bestellung speichert außerdem Name, Adresse und ID des Pickup-Punkts. Sie sehen diese unter der Versandposition im Bestellbildschirm des Admin-Bereichs. Der Kunde sieht den gewählten Punkt auf der Bestätigungsseite („Danke“) und in den Bestell-E-Mails.

Die Sendung buchen Sie selbst im Jadlog-System. Die Bestellung zeigt den Service und die Pickup-Punkt-ID, die Sie dafür benötigen.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Jadlog. 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 gilt 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 Jadlog Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Jadlog 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 wurde (oder Ignore shipping zones eingeschaltet ist und das Land erlaubt ist). Prüfen Sie die Warnungen oben auf der Einstellungsseite, die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Hat der Kunde noch keine vollständige 8-stellige CEP eingegeben, sind nur feste Preise möglich. Fügen Sie dann eine Zeile unter Price per country oder eine Fallback cost hinzu.

Nur feste Preise werden angezeigt: Schalten Sie das Debug log ein, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-jadlog. Dort steht der Grund: keine CNPJ oder kein Girokonto, kein Versandursprungs-CEP, unvollständige Ziel-CEP, kein BRL-Wechselkurs oder die Jadlog-Fehlermeldung.

HTTP 401 oder 403 im Protokoll: Jadlog hat den API-Token abgelehnt. Prüfen Sie ihn bei Ihrer Jadlog-Franchise. Nach diesem Fehler wird die API 10 Minuten pausiert. Das Speichern der Einstellungen hebt die Pause auf, sodass Sie sofort erneut versuchen können.

Pickup-Punkte erscheinen nicht: Die Pickup-Methode benötigt den API-Token und eine vollständige 8-stellige CEP in Brasilien. Hat Jadlog keine aktiven Punkte nahe der CEP, wird die Methode ausgeblendet. Den Grund finden Sie im Protokoll.

Preise werden in Reais statt in meiner Währung angezeigt: Geben Sie den BRL exchange rate ein (wie viel 1 BRL in Ihrer Shop-Währung wert ist).

Preise wirken zu niedrig oder zu hoch: Tragen Sie Produktgewichte und -abmessungen ein. Warenkörbe ohne Gewicht werden mit 0,1 kg berechnet, und das volumetrische Gewicht benötigt Abmessungen.

Preise wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Jadlog-Preise und Listen der Pickup-Punkte gelöscht.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel 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 Einstellungen und Zonenmethoden. Nur zwischengespeicherte Preise und Listen der Pickup-Punkte werden gelöscht. Um das Plugin zu entfernen, deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die zwischengespeicherten Preise werden immer entfernt. Einstellungen und Zonenmethoden 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 mit dem Jadlog-Service und dem Pickup-Punkt.

Jadlog ist eine Marke des jeweiligen Inhabers. Dieses Plugin steht in keiner Verbindung zu Jadlog und wird von Jadlog nicht unterstützt oder empfohlen.