VibeFox 99Minutos 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.
99minutos-API-Schlüssel (nur für die Abdeckungsprüfung): Sie erhalten ihn von Ihrem Ansprechpartner bei 99minutos oder im 99minutos-Entwicklerportal (developers.99minutos.com). Sandbox- und Live-Schlüssel sind verschieden. Wenn Sie nur die Preismatrix nutzen, benötigen Sie keinen API-Schlüssel.
VibeFox-Lizenzschlüssel: Er 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. Alternativ können Sie den Ordner vfd_99minutos per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen unter WooCommerce > Settings > Shipping > VibeFox 99Minutos 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üllen Sie die Price matrix aus (mindestens eine Zeile, zum Beispiel „* Default“) und optional den API-Schlüssel und den Modus der Abdeckungsprüfung (siehe Abschnitt „Konfiguration“).
6. Fügen Sie VibeFox 99Minutos unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone hinzu, die Mexiko, Kolumbien, Chile oder Peru abdeckt.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox 99Minutos. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:
Method title (zone): der Name, den Kunden in dieser Zone sehen. Lassen Sie das Feld leer, um den globalen Method title zu verwenden.
Beim Speichern der Einstellungen warnt die Seite, wenn die Preismatrix leer ist oder ein Modus der Abdeckungsprüfung ohne API-Schlüssel gewählt wurde.
Allgemein
Enable/Disable: aktiviert 99Minutos gleichzeitig in allen Versandzonen. Die Methode muss außerdem einer Versandzone hinzugefügt werden, die Mexiko, Kolumbien, Chile oder Peru abdeckt. Standard: an.
Method title: der Name der Versandmethode, den Kunden an der Kasse sehen. Eine Zone kann ihn überschreiben. Standard: 99Minutos.
Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht.
99minutos-API (Abdeckungsprüfung) (optional)
Die API wird nur verwendet, um zu prüfen, ob 99minutos an die Postleitzahl des Kunden liefert. Der Preis stammt immer aus der Matrix.
Coverage check: ob und wie die Postleitzahl geprüft wird.
Bei aktiver Abdeckungsprüfung erscheint die Methode erst, nachdem der Kunde eine Postleitzahl eingegeben hat. Ergebnisse werden zwischengespeichert: abgedeckt 6 Stunden, nicht abgedeckt 30 Minuten, API-Fehler 5 Minuten. Nur die Postleitzahl wird an 99minutos gesendet.
API key: Ihr 99minutos-API-Schlüssel, der als Bearer-Token an den Abdeckungs-Endpunkt von 99minutos gesendet wird. Er ist erforderlich, wenn die Abdeckungsprüfung aktiv ist. Das Feld ist maskiert.
Environment: Sandbox (test) (Standard) oder Production. Sandbox und Live verwenden unterschiedliche API-Schlüssel. Wählen Sie die Umgebung, die zu Ihrem Schlüssel passt.
Tarife
Preise gelten in der Währung Ihres Shops und werden wie eingegeben verwendet, ohne Umrechnung.
Price matrix: eine Tabelle mit Zielländern und Preisen. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um sie zu entfernen. Jede Zeile hat ein Country, einen Base price und Preise für die Größen XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg). Ein leerer oder mit 0 angegebener Größenpreis fällt auf den Base price zurück. Die Zeile * Default gilt für Länder ohne eigene Zeile. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert; negative Preise werden als 0 gespeichert. Solange die Matrix keine einzige Zeile hat, wird die Methode an der Kasse nicht angezeigt.
Calculation: Per order — size by the total cart weight (Standard) berechnet einen Preis für die Paketgröße des gesamten Warenkorbs. Per item — each unit priced by its own weight bepreist jede Einheit nach der Größe ihres eigenen Gewichts und addiert die Preise.
Free shipping: aktiviert kostenlosen Versand ab einer Warenkorb-Zwischensumme.
Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer), ab der der Tarif 0 ist. Wird nur verwendet, wenn Free shipping aktiv ist.
Einschränkungen
Min weight (kg): blendet die Methode aus, wenn der Warenkorb leichter ist. 0 bedeutet keine Grenze. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet.
Max weight (kg): blendet die Methode aus, wenn der Warenkorb schwerer ist. Standard: 25. 0 bedeutet keine Grenze.
Minimum subtotal: zeigt die Methode nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer) mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.
Excluded shipping classes: blendet die Methode aus, wenn ein Artikel im Warenkorb eine dieser WooCommerce-Versandklassen hat.
Restrict countries: bietet die Methode nur für die unten genannten Länder an. Das ist ein zusätzlicher Filter über den Versandzonen: Die Methode muss trotzdem einer Zone hinzugefügt werden. Nützlich, wenn eine Zone mehrere Länder abdeckt.
Countries: Auswahl der 99minutos-Länder (Mexiko, Kolumbien, Chile, Peru). Wird nur verwendet, wenn Restrict countries aktiv ist. Leer lassen, um alle 99minutos-Länder zu erlauben.
Erweitert
Debug log: protokolliert Tarifberechnungen unter WooCommerce > Status > Logs (Quelle „vfd-99minutos“). API-Fehler werden auch dann protokolliert, wenn diese Option aus ist. API-Schlüssel sowie Namen und Adressen der Kunden werden nie protokolliert.
Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins seine Einstellungen und den Abdeckungs-Cache. Deaktivieren löscht nichts. Versandmethoden in den Zonen und Bestellungen bleiben in jedem Fall erhalten.
So funktioniert es an der Kasse
Die Methode wird nur angeboten, wenn das Lieferland Mexiko, Kolumbien, Chile oder Peru ist (und in der Liste Countries steht, wenn Restrict countries aktiv ist). Sobald der Kunde eine Lieferadresse eingibt, prüft das Plugin die Gewichtsgrenzen des Warenkorbs, Minimum subtotal und Excluded shipping classes.
Ist ein Modus der Abdeckungsprüfung aktiv, fragt das Plugin danach bei der 99minutos-API an, ob die Postleitzahl abgedeckt ist. Das Zeitlimit für die Anfrage beträgt 10 Sekunden, und die Antwort wird zwischengespeichert, sodass dieselbe Postleitzahl keine neue Anfrage auslöst. API-Fehler werden dem Kunden nie angezeigt: Im Modus Strict wird die Methode ausgeblendet, im Modus Soft wird der Matrixpreis verwendet. Kostenloser Versand umgeht die Abdeckungsprüfung nicht.
Der Preis stammt aus der Matrixzeile für das Lieferland oder aus der Zeile * Default. Fehlen beide, wird die Methode ausgeblendet. Ist Free shipping aktiv und erreicht die Warenkorb-Zwischensumme Free shipping from, beträgt der Tarif 0.
Die Methode funktioniert in der klassischen Kasse sowie im Warenkorb- und im Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin ruft keine Live-Tarife bei 99minutos ab: Preise stammen immer aus Ihrer Matrix. Es erstellt keine Sendungen oder Bestellungen bei 99minutos, druckt keine Etiketten (guides), verfolgt keine Pakete, bietet keine Punto99-Abholstellen an und übernimmt keine Nachnahme. Erstellen Sie Sendungen wie gewohnt in Ihrem 99minutos-Konto.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock steht oben unter WooCommerce > Settings > Shipping > VibeFox 99Minutos. 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 funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird 99Minutos Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen die Methode 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 WooCommerce-Seiten. 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
99Minutos erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone der Kundenadresse hinzugefügt wurde. Das Lieferland muss Mexiko, Kolumbien, Chile oder Peru sein. Prüfen Sie, ob die Price matrix eine Zeile für dieses Land oder eine Zeile * Default hat, und kontrollieren Sie die Gewichtsgrenzen, Minimum subtotal, Excluded shipping classes und Restrict countries.
Die Methode erscheint erst, nachdem eine Postleitzahl eingegeben wurde: Das ist bei der Abdeckungsprüfung erwartungsgemäß. Im Modus Strict erscheint sie nur, wenn die API die Abdeckung bestätigt.
Die Methode ist im Modus Strict immer ausgeblendet: Aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs (Quelle „vfd-99minutos“). Ein HTTP-Fehler 401 oder 403 bedeutet, dass der API-Schlüssel abgelehnt wurde: Prüfen Sie den Schlüssel und ob Environment passt (Sandbox- und Live-Schlüssel unterscheiden sich). Verwenden Sie den Modus Soft, wenn Kunden trotz nicht erreichbarer API den Matrixpreis erhalten sollen.
Der Preis ist nicht wie erwartet: Prüfen Sie Calculation (pro Bestellung oder pro Artikel), die Produktgewichte und die Gewichtseinheit Ihres Shops. Ein leerer oder mit 0 angegebener Größenpreis fällt auf den Base price zurück.
Andere Länder: Entwickler können die Liste der unterstützten Länder mit dem Filter vfd_99m_supported_countries ändern.
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 den Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Wurde 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 letzten bekannten Status weiter.
Deinstallation
Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen und Abdeckungs-Cache werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Versandmethoden in den Zonen und bestehende Bestellungen bleiben erhalten.
99minutos ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit 99minutos verbunden und wird von 99minutos weder unterstützt noch empfohlen.