VibeFox Mercado Envios for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Mercado-Pago-Konto (nur für Live-Tarife): Live-Tarife stammen vom Mercado-Envios-Rechner Ihres Mercado-Pago-Kontos in Argentinien, Brasilien oder Mexiko. Mercado Envios muss für das Konto aktiviert sein. Pakete werden ab der Versandadresse berechnet, die in diesem Konto hinterlegt ist. Sie benötigen das Access Token für die Produktionsumgebung (es beginnt mit APP_USR-): Öffnen Sie im Mercado-Pago-Entwicklerbereich Ihre Anwendung und deren Zugangsdaten für die Produktion. Es gibt keine Anmeldeschaltfläche: Sie fügen das Token in die Einstellungen ein. Wenn Sie nur Preise je Land verwenden, benötigen Sie kein Mercado-Pago-Konto.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können auch den Ordner vfd_mercado_envios per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Mercado Envios oder klicken Sie auf der Seite Plugins 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ür Live-Tarife fügen Sie das Access Token ein, wählen das Land von Mercado Envios und, falls die Shopwährung nicht ARS, BRL oder MXN ist, den Wechselkurs. Optional füllen Sie Country prices und Fallback cost aus (sie werden ohne Live-Tarife verwendet).

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

Title (zone): der Name dieser Option an der Kasse. Lassen Sie das Feld leer, um den allgemeinen Name zu verwenden.

Warnungen oben auf der Seite zeigen Konfigurationsprobleme an: fehlender Wechselkurs, kein Access Token und kein Preis sowie der letzte API-Fehler von Mercado Envios mit Datum. Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Tarife gelöscht.

Allgemein

Enable/Disable: schaltet den Versand über Mercado Envios in allen Zonen gleichzeitig ein oder aus.

Name: der Name der Versandart, den Kunden an der Kasse sehen. Standard: Mercado Envios.

Tax status: Mercado Envios liefert Endpreise. None zeigt sie wie angeboten an, Taxable fügt die Versandsteuer aus WooCommerce hinzu.

Mercado Envios API (Live-Tarife) (ohne Token werden nur die unten genannten Preise verwendet)

Access token: Ihr Access Token für die Produktionsumgebung von Mercado Pago (APP_USR-...). Es wird nur an Mercado Pago gesendet und nie protokolliert.

Mercado Envios country: das Land Ihres Mercado-Pago-Kontos: Argentina (ARS) (Standard), Brazil (BRL) oder Mexico (MXN). Live-Tarife werden nur für Ziele in diesem Land angefragt und in dessen Währung angegeben.

Exchange rate: nur nötig, wenn sich die Shopwährung von der Währung von Mercado Envios unterscheidet: der Preis von 1 ARS, BRL oder MXN in Ihrer Shopwährung, zum Beispiel 0.001. Ohne ihn werden keine Live-Tarife verwendet. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Preise ohne Live-Tarife

Diese Preise werden verwendet, wenn kein Access Token vorhanden ist, für Ziele außerhalb des Landes von Mercado Envios und wenn die API keinen Tarif liefert.

Country prices: Preise in Ihrer Shopwährung. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Wählen Sie * All other countries für alle Länder ohne eigene Zeile. Price ist der Preis für das Land. Die Spalten XS (bis 1 kg), S (1-2 kg), M (2-3 kg), L (3-5 kg) und XL (über 5 kg) ersetzen ihn für das jeweilige Warenkorbgewicht. Eine leere Spalte oder eine mit 0 verwendet Price. Werte, die keine Zahlen sind, werden nach dem Speichern gemeldet und gelöscht. Zeilen ohne Preis werden beim Speichern entfernt.

Fallback cost: wird verwendet, wenn weder die API noch Country prices einen Preis liefern. Lassen Sie das Feld leer, um die Methode in diesem Fall auszublenden.

Calculation type: Per order berechnet den Preis einmal. Per item (each item priced by its own weight x quantity) sucht für das Gewicht jedes Artikels in Country prices (oder im Fallback cost) nach dem Preis und multipliziert ihn mit der Menge. Live-Tarife von Mercado Envios gelten immer für das gesamte Paket.

Verfügbarkeit

Min weight (kg): das minimale Warenkorbgewicht, damit diese Methode erscheint. 0 bedeutet kein Limit.

Max weight (kg): blendet die Methode aus, wenn der Warenkorb schwerer ist. Standard: 25. 0 bedeutet kein Limit.

Minimum subtotal: zeigt die Methode nur, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Excluded shipping classes: blendet die Methode aus, wenn ein Artikel im Warenkorb einer dieser WooCommerce-Versandklassen angehört.

Ignore shipping zones: bietet die Methode für die unten genannten Länder an, auch ohne Zuordnung zu einer Versandzone.

Countries: die Zielländer für diesen Modus. Leer lassen für alle Länder. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Kostenloser Versand

Free shipping from: die Warenkorb-Zwischensumme, ab der diese Methode kostenlos ist. In diesem Fall wird keine Anfrage an Mercado Envios gestellt. Leer lassen, um die Option zu deaktivieren.

Erweitert

Debug log: protokolliert API-Anfragen und die Tarifberechnung unter WooCommerce > Status > Logs (Quelle vfd-mercado-envios). Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Das Access Token und Kundenadressen werden nie protokolliert.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins alle Plugin-Einstellungen und die Methoden in den Zonen. Das Deaktivieren des Plugins löscht nie Einstellungen.

So funktioniert es an der Kasse

Sobald der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Warenkorbgewicht, Mindestzwischensumme und ausgeschlossene Versandklassen. Gilt der kostenlose Versand, kostet die Methode 0, und es geht keine Anfrage an Mercado Envios.

Bei einem Ziel im Land von Mercado Envios mit gültiger Postleitzahl beschreibt das Plugin den Warenkorb als ein Paket: die größte Breite und Länge der Artikel, die Summe der Höhen aller Artikel und das Gesamtgewicht in Gramm. Jede Seite und das Gewicht werden auf die Mindestwerte von Mercado Envios für das Land angehoben, sodass auch Produkte ohne Maße oder Gewicht einen Tarif erhalten. Der Warenkorbwert wird als Artikelpreis in der Währung von Mercado Envios übermittelt. Die günstigste Option von Mercado Envios wird in Ihre Shopwährung umgerechnet und unter Ihrem Methodennamen angezeigt.

Jedes Angebot wird 1 Stunde zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Ein fehlgeschlagenes Angebot wird 5 Minuten lang nicht wiederholt. Wenn Mercado Pago nicht erreichbar ist oder das Token ablehnt, werden alle Live-Angebote für 5 Minuten pausiert, damit die Kasse bei jeder Aktualisierung nicht auf die API warten muss. Das API-Timeout beträgt 10 Sekunden.

Preise ohne Live-Tarife werden stattdessen verwendet, wenn kein Token vorhanden ist, das Ziel außerhalb des Landes von Mercado Envios liegt, die Postleitzahl fehlt oder ungültig ist, der Wechselkurs fehlt, das Paket schwerer ist als das Gewichtslimit von Mercado Envios für das Land (25 kg in Argentinien, 15 kg in Brasilien, 30 kg in Mexiko) oder Mercado Envios für die Adresse einen Fehler oder keine Option zurückgibt. Verwendet wird die Zeile des Landes (oder die Zeile *), sonst die Ersatzkosten. Gibt es keinen Preis, wird die Methode ausgeblendet. Kunden sehen nie einen API-Fehler.

Die Methode funktioniert an der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin berechnet nur Tarife. Es erstellt keine Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Erstellen Sie die Sendung in Ihrem Mercado-Libre- oder Mercado-Pago-Konto. Es zeigt einen Tarif je Methode, die günstigste Option von Mercado Envios, keine Auswahl aus allen Optionen, und hat keine Auswahl für Abholstellen (Agenturen).

Bestellungen

Wenn die Bestellung mit einem Live-Tarif aufgegeben wird, werden der Name des Dienstes und die voraussichtliche Lieferzeit in Tagen in der Versandposition der Bestellung als Mercado Envios service und Estimated delivery gespeichert. Bestehende Bestellungen behalten ihre Versandpositionen.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Mercado Envios. 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 auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Mercado Envios Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Seite Plugins und auf den WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Mercado Envios 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 aktiv ist und das Land erlaubt ist). Prüfen Sie die Warnungen oben auf der Einstellungsseite, die Gewichtslimits, Minimum subtotal und Excluded shipping classes. Die Methode benötigt einen Preis: ein funktionierendes Access Token für Adressen im Land von Mercado Envios oder Country prices bzw. Fallback cost.

Live-Tarife erscheinen nicht: aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-mercado-envios. Typische Gründe: kein Token, ein Ziel außerhalb des Landes von Mercado Envios, eine fehlende oder ungültige Postleitzahl, ein fehlender Exchange rate, ein Paket über dem Gewichtslimit oder keine Option von Mercado Envios für die Adresse.

HTTP 401 oder 403 in den Warnungen: das Access Token ist ungültig oder abgelaufen. Kopieren Sie das Access Token für die Produktionsumgebung erneut aus dem Mercado-Pago-Entwicklerbereich.

Mercado Envios hat in einer anderen Währung geantwortet: das Land des Kontos stimmt nicht mit Mercado Envios country überein. Wählen Sie das Land Ihres Mercado-Pago-Kontos.

In welcher Währung die Preise sind: Country prices und Fallback cost gelten in Ihrer Shopwährung. Live-Tarife kommen in der Währung Ihres Mercado-Pago-Kontos und werden mit dem Exchange rate umgerechnet, wenn der Shop eine andere Währung verwendet.

Tarife wirken nach einer Änderung veraltet: speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Tarife gelöscht.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Wenn der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet wird, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Wenn sich die Adresse der Website geändert hat, 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. Nur der Tarif-Cache wird geleert. Zum Entfernen deaktivieren und löschen Sie das Plugin auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins, die zwischengespeicherten Tarife und der letzte API-Fehler werden immer entfernt. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen.

Mercado Envios und Mercado Pago sind Marken ihrer jeweiligen Inhaber. Dieses Plugin ist nicht mit Mercado Envios oder Mercado Pago verbunden und wird von diesen nicht unterstützt.