VibeFox 99Minutos 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.

API-Schlüssel von 99minutos (nur für die Abdeckungsprüfung): erhalten Sie von Ihrem Ansprechpartner bei 99minutos oder im Entwicklerportal von 99minutos (developers.99minutos.com). Sandbox- und Produktivschlüssel sind verschieden. Wenn Sie nur die Preismatrix verwenden, brauchen Sie keinen API-Schlüssel.

Länder: 99minutos liefert nach Mexiko, Kolumbien, Chile und Peru. Die Länder, in die Sie versenden, müssen unter System > Localisation > Countries aktiviert sein.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer 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_99minutos-oc3-(version).ocmod.zip und das OpenCart-4-Paket vfd_99minutos.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_99minutos-oc3-(version).ocmod.zip. Die Erweiterung fügt keine OCMOD-Modifikationen hinzu, Sie müssen Extensions > Modifications also nicht aktualisieren. Statt des Installers können Sie auch 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 99Minutos 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. Fügen 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ü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 Konfiguration). Aktivieren Sie Enable 99Minutos und klicken Sie auf Save.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_99minutos.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 99Minutos, 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 ein wie in den Schritten 4 und 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Nach der Installation ist die Versandart deaktiviert, bis Sie Enable 99Minutos einschalten und speichern. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die gespeicherten Einstellungen von 99minutos wieder verwendet.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Shipping > VibeFox 99Minutos > Edit. Die Abschnitte sind links aufgelistet. Eine einzige Schaltfläche Save speichert die gesamte Seite ohne Neuladen. Jedes Speichern löscht außerdem die zwischengespeicherten Ergebnisse der Abdeckungsprüfung. Ist ein Wert falsch, wird nichts gespeichert, und die Seite zeigt den Grund an, zum Beispiel Enter a method title (1 to 64 characters)., eine Meldung, dass ein Feld eine Zahl von 0 oder mehr sein muss, oder dass Min weight (kg) nicht größer als Max weight (kg) sein darf. Nach dem Speichern zeigen Warnungen über den Einstellungen, wann die Versandart mit der aktuellen Konfiguration nicht funktionieren kann: Die Preismatrix ist leer, ein Modus der Abdeckungsprüfung ist ohne API-Schlüssel gewählt, die Matrix enthält Zeilen für Länder, die 99minutos nicht bedient, oder der Shop hat keine Gewichtsklasse „kg“ und seine Gewichtseinheit ist der Erweiterung nicht bekannt (Gewichte werden dann als Kilogramm gelesen). Nur Administratoren mit der Berechtigung zum Ändern dieser Erweiterung können die Einstellungen speichern.

Allgemein

Die Einstellungen gelten für alle Geozonen. 99Minutos wird nur für Mexiko, Kolumbien, Chile und Peru als Zielländer angeboten.

Enable 99Minutos: zeigt 99Minutos an der Kasse an oder blendet es aus. Standard: aus.

Method title: der Name der Versandart, den der Kunde im Warenkorb und an der Kasse sieht. Standard: 99Minutos. Pflichtfeld, bis zu 64 Zeichen.

Tax class: die Steuerklasse der Versandkosten oder No tax (Standard). Mit einer Steuerklasse fügt OpenCart dem Preis aus der Matrix die Steuer hinzu.

Sort order: die Position von 99Minutos unter den Versandarten an der Kasse. Eine ganze Zahl.

API von 99minutos (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.

Mit einer Abdeckungsprüfung erscheint die Versandart erst, nachdem der Kunde eine Postleitzahl eingegeben hat. Ergebnisse werden zwischengespeichert: abgedeckt für 6 Stunden, nicht abgedeckt für 30 Minuten, API-Fehler für 5 Minuten, aber nie länger als die Lebensdauer des OpenCart-Caches (standardmäßig 1 Stunde). An 99minutos wird nur die Postleitzahl gesendet, in Großbuchstaben und nur mit Buchstaben und Ziffern.

API key: Ihr API-Schlüssel von 99minutos, der als Bearer-Token an den Abdeckungs-Endpunkt von 99minutos gesendet wird. Erforderlich, wenn die Abdeckungsprüfung aktiv ist. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Der Schlüssel wird so gespeichert, wie Sie ihn eingeben; nur Leerzeichen am Anfang und Ende werden entfernt.

Remove the saved API key: wird nur angezeigt, wenn ein Schlüssel gespeichert ist. Aktivieren Sie es und klicken Sie auf Save, um den Schlüssel zu löschen.

Environment: Sandbox (test) (Standard) oder Production. Sandbox und Produktion verwenden verschiedene API-Schlüssel. Wählen Sie die Umgebung, die zu Ihrem Schlüssel passt.

Tarife

Preise gelten in der Standardwährung Ihres Shops, ohne Steuern, und werden so verwendet, wie Sie sie eingeben. Der Endpreis wird in der Währung des Kunden angezeigt.

Price matrix: eine Tabelle mit Zielländern und Preisen. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf die Schaltfläche × , um sie zu entfernen. Jede Zeile hat ein Country (* Default, Mexiko, Kolumbien, Chile oder Peru), 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 0-Größenpreis verwendet den Base price. Die Zeile * Default gilt für Länder ohne eigene Zeile. Hat ein Land mehrere Zeilen, wird die erste verwendet. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert; leere, ungültige oder negative Preise werden als 0 gespeichert. Solange die Matrix keine Zeile hat, wird die Versandart 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 den kostenlosen Versand ab einem Bestellwert.

Free shipping from: die Zwischensumme der Produkte, die versandt werden müssen (nach dem Gutschein, vor Steuern), ab der der Preis 0 ist. Wird nur verwendet, wenn Free shipping aktiv ist.

Einschränkungen

Min weight (kg): blendet die Versandart aus, wenn der Warenkorb leichter ist. 0 bedeutet keine Begrenzung (Standard). Der Wert darf nicht größer sein als Max weight (kg). Produktgewichte werden aus ihrer Gewichtsklasse umgerechnet.

Max weight (kg): blendet die Versandart aus, wenn der Warenkorb schwerer ist. Standard: 25. 0 bedeutet keine Begrenzung; ein leeres Feld bedeutet 25 kg.

Minimum subtotal: zeigt die Versandart nur an, wenn die Zwischensumme der Produkte, die versandt werden müssen (nach dem Gutschein, vor Steuern), mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um die Versandart immer anzuzeigen.

Geo zone: bietet 99Minutos nur für Adressen in dieser Geozone an. All zones (Standard) bedeutet keine Einschränkung. Geozonen werden unter System > Localisation > Geo Zones verwaltet.

Restrict countries: bietet die Versandart nur für die unten genannten Länder an. Dies ist ein zusätzlicher Filter zur Geo zone.

Countries: eine Auswahl der Länder von 99minutos (Mexiko, Kolumbien, Chile, Peru). Wird nur verwendet, wenn Restrict countries aktiv ist. Lassen Sie das Feld leer, um alle Länder von 99minutos zuzulassen.

Erweitert

Debug log: schreibt Tarifberechnungen in storage/logs/vfd_99m_debug.log.php. Die Datei ist aus dem Web nicht lesbar. API-Fehler werden auch protokolliert, wenn dies ausgeschaltet ist. API-Schlüssel sowie Namen und Adressen der Kunden werden nie protokolliert. Schalten Sie das Protokoll nach Abschluss wieder aus. Erreicht die Datei 5 MB, wird sie nach vfd_99m_debug.old.log.php verschoben und ein neues Protokoll begonnen.

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

Remove data on uninstall: ist die Option aktiv, werden bei der Deinstallation der Erweiterung die Einstellungen von 99minutos, der Abdeckungs-Cache und das Protokoll gelöscht. Ist sie aus (Standard), bleiben sie für eine erneute Installation erhalten. Bestellungen bleiben in jedem Fall erhalten.

Import / Export

Export: klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern. Der API-Schlüssel 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. Der gespeicherte API-Schlüssel bleibt erhalten.

Ablauf an der Kasse

Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem Preis für 99Minutos. Ist eine Geo zone gesetzt und liegt die Adresse außerhalb, wird 99Minutos nicht angeboten. Nur Produkte mit Requires Shipping auf Yes zählen: Andere Produkte fügen kein Gewicht hinzu und sind nicht im Bestellwert enthalten. Die Versandart wird nur angeboten, wenn das Lieferland Mexiko, Kolumbien, Chile oder Peru ist (und in der Liste Countries steht, wenn Restrict countries aktiv ist). Dann prüft die Erweiterung die Gewichtsgrenzen und den Minimum subtotal. Der Bestellwert ist der Preis der Produkte, die versandt werden müssen, nach dem Gutscheinrabatt und vor Steuern. Geschenkgutscheine, Bonuspunkte und Store Credit werden nicht berücksichtigt.

Ist eine Abdeckungsprüfung aktiv, fragt die Erweiterung die API von 99minutos, ob die Postleitzahl abgedeckt ist. Das Zeitlimit der 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 Versandart ausgeblendet, im Modus Soft wird der Matrixpreis verwendet. Kostenloser Versand umgeht die Abdeckungsprüfung nicht.

Der Preis stammt aus der Matrixzeile des Lieferlandes oder aus der Zeile * Default. Fehlen beide, wird die Versandart ausgeblendet. Ist Free shipping aktiv und erreicht der Bestellwert Free shipping from, beträgt der Tarif 0. Der Preis wird in der Standardwährung Ihres Shops berechnet, auf deren Dezimalstellen gerundet und dem Kunden in seiner Währung mit der Steuer der gewählten Tax class angezeigt.

Die Erweiterung ruft keine Live-Tarife bei 99minutos ab: Preise stammen immer aus Ihrer Matrix. Sie erstellt keine Sendungen oder Bestellungen bei 99minutos, druckt keine Versandetiketten (Guides), verfolgt keine Pakete, bietet keine Punto99-Abholstellen an und unterstützt keine Nachnahme. Sie fügt Bestellungen nichts hinzu: Die Bestellung zeigt den Namen der Versandart und die Versandkosten wie bei jeder anderen OpenCart-Versandart. Erstellen Sie Sendungen wie gewohnt in Ihrem 99minutos-Konto.

Auf OpenCart 4 klicken Sie an der Kasse im Block der Versandart auf Choose und wählen 99Minutos im Fenster Shipping method options. Die Versandart funktioniert genauso wie unter OpenCart 3.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox 99Minutos ist der erste Block auf der Seite Extensions > Extensions > Shipping > VibeFox 99Minutos > Edit, über den Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel verdeckt, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-shipping-99minutos und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wenn der Schlüssel nicht akzeptiert wird, 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. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain. Ihre Lizenzen und Domains verwalten Sie in Ihrem vibefox.net-Konto.

Ohne aktiven Schlüssel wird die Versandart 99Minutos Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Admin-Benutzer, der im Administrationsbereich im selben Browser angemeldet ist, sieht die Versandart im Shop weiterhin, markiert als (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Versandart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Administrationsbereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen.

Wenn eine Lizenz abläuft, arbeitet die Erweiterung weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard des Administrationsbereichs oder die Seite Edit öffnen: 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 der Erweiterung werden immer der Lizenzschlüssel und der Lizenzstatus entfernt.

Fehlerbehebung

99Minutos erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist und Enable 99Minutos eingeschaltet ist. Das Lieferland muss Mexiko, Kolumbien, Chile oder Peru sein und unter System > Localisation > Countries aktiviert sein. Prüfen Sie Geo zone und Restrict countries. Prüfen Sie, ob die Price matrix eine Zeile für dieses Land oder eine Zeile * Default hat, und kontrollieren Sie die Gewichtsgrenzen und den Minimum subtotal. Prüfen Sie, ob die Produkte Requires Shipping auf Yes haben. Warnungen, die nach Save angezeigt werden, weisen auf Einstellungen hin, die die Versandart ausblenden.

Die Versandart erscheint erst, nachdem eine Postleitzahl eingegeben wurde: das ist bei einer Abdeckungsprüfung zu erwarten. Im Modus Strict erscheint sie nur, wenn die API die Abdeckung bestätigt.

Die Versandart ist im Modus Strict immer ausgeblendet: schalten Sie Debug log ein, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Erweiterungsseite nach. Ein HTTP-Fehler 401 oder 403 bedeutet, dass der API-Schlüssel abgelehnt wurde: Prüfen Sie den Schlüssel und ob Environment dazu passt (Sandbox- und Produktionsschlüssel unterscheiden sich). Verwenden Sie den Modus Soft, wenn Kunden auch bei nicht erreichbarer API den Matrixpreis erhalten sollen.

Der Preis ist nicht wie erwartet: prüfen Sie Calculation (pro Bestellung oder pro Artikel) sowie die Produktgewichte und Gewichtsklassen. Ein leerer oder 0-Größenpreis verwendet den Base price. Mit einer Tax class wird Steuer auf den Matrixpreis aufgeschlagen.

Abdeckungsergebnisse wirken nach einer Änderung veraltet: klicken Sie auf der Erweiterungsseite auf Save. Dadurch werden die zwischengespeicherten Abdeckungsergebnisse gelöscht.

Die Seite meldet „Warning: You do not have permission to modify VibeFox 99Minutos!“: Ihre Administrator-Benutzergruppe darf die Einstellungen möglicherweise nur ansehen. Geben Sie der Gruppe die Berechtigung zum Ändern für extension/shipping/vfd_99minutos (OpenCart 3) oder extension/vfd_99minutos/shipping/vfd_99minutos (OpenCart 4) unter System > Users > User Groups.

Für Entwickler: die Adresse der API von 99minutos kann über die Einstellung vfd_99m_api_url ersetzt werden (für Tests); sie hat kein Feld auf der Einstellungsseite.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox 99Minutos auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt immer Enable 99Minutos, Sort order, Tax class und Geo zone zurück. Die zwischengespeicherten Abdeckungsergebnisse werden immer entfernt. Ist Remove data on uninstall aktiv, werden außerdem die Einstellungen von 99minutos und das Debug-Protokoll gelöscht. Ist die Option aus, bleiben die übrigen Einstellungen erhalten und werden bei einer erneuten Installation wieder verwendet. Bestehende Bestellungen behalten ihre Versandart und Kosten.

Auf OpenCart 4 entfernen Sie die Dateien der Erweiterung ebenfalls, indem Sie nach der Deinstallation zu Extensions > Installer gehen, neben VibeFox 99Minutos in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) klicken und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

99minutos ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit 99minutos verbunden und wird von 99minutos nicht unterstützt.