VibeFox 99Minutos for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

99minutos-API-Schlüssel (nur für die Abdeckungsprüfung): Sie erhalten ihn von Ihrem Account Manager bei 99minutos oder im Developer-Portal von 99minutos (developers.99minutos.com). Sandbox- und Live-Schlüssel sind verschieden. Wenn Sie nur die Preismatrix nutzen, benötigen 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 International > Locations aktiv sein.

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

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls aus.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox 99Minutos in der Modulliste und klicken Sie auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Configure-Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. 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). Klicken Sie auf Save.

Bei der Installation legt das Modul den Transporteur 99Minutos mit dem Liefertext Courier delivery an. Der Transporteur wird allen Zonen und allen Kundengruppen zugewiesen. Zonen, Kundengruppen, Lieferzeit, Logo und Größenlimits können Sie unter Shipping > Carriers ändern. Die Zonen für Mexiko, Kolumbien, Chile und Peru müssen für den Transporteur aktiviert bleiben. Setzen Sie dort keine Preise: Der Preis kommt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox 99Minutos > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern löscht außerdem die zwischengespeicherten Abdeckungsergebnisse. Nach dem Speichern warnt die Seite, wenn die Preismatrix leer ist, wenn sie Zeilen für Länder enthält, die 99minutos nicht beliefert, wenn ein Modus der Abdeckungsprüfung ohne API-Schlüssel gewählt ist oder wenn die Gewichtseinheit des Shops dem Modul unbekannt ist (Gewichte werden dann als Kilogramm behandelt). Es wird nichts gespeichert, und ein Fehler wird angezeigt, wenn Method title länger als 64 Zeichen ist, wenn ein Gewichts- oder Betragsfeld keine Zahl von 0 oder mehr ist oder wenn Min weight (kg) größer als Max weight (kg) ist. Wenn die Seite The 99Minutos carrier was not found — reset the module to create it again. anzeigt, lesen Sie den Abschnitt Fehlerbehebung.

Allgemein

Enable 99Minutos: schaltet den Transporteur ein oder aus. Das ist derselbe Schalter wie der Status des Transporteurs unter Shipping > Carriers.

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

Tax: die Steuerregel des Transporteurs oder No tax. Mit einer Steuerregel addiert PrestaShop die Steuer auf den Versandpreis aus der Matrix.

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 kommt immer aus der Matrix.

Coverage check: ob und wie die Postleitzahl geprüft wird.

Bei aktiver Abdeckungsprüfung erscheint der Transporteur 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. An 99minutos wird nur die Postleitzahl gesendet, in Großbuchstaben und nur mit Buchstaben und Ziffern.

API key: Ihr 99minutos-API-Schlüssel, der als Bearer-Token an den Abdeckungs-Endpoint 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 die Option und klicken Sie auf Save, um den Schlüssel zu löschen.

Environment: Sandbox (test) (Standard) oder Production. Sandbox und Produktion verwenden unterschiedliche API-Schlüssel. Wählen Sie daher 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 eingegeben wurden. Der Endpreis wird in der Warenkorbwä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 das Papierkorb-Symbol, um eine zu entfernen. Jede Zeile enthält ein Country (* Default, Mexiko, Kolumbien, Chile oder Peru), einen Base price sowie 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 Größenpreis oder ein Preis von 0 greift auf den Base price zurück. 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 der Transporteur 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 Steuern), ab der der Preis 0 ist. Wird nur verwendet, wenn Free shipping aktiv ist.

Einschränkungen

Min weight (kg): blendet den Transporteur aus, wenn der Warenkorb leichter ist. 0 bedeutet keine Grenze. Der Wert darf nicht größer sein als Max weight (kg). Produktgewichte werden von der Gewichtseinheit Ihres Shops umgerechnet.

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

Minimum subtotal: zeigt den Transporteur nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuern) mindestens diesen Betrag erreicht. Leer lassen, um ihn immer anzuzeigen.

Restrict countries: bietet den Transporteur nur für die unten genannten Länder an. Das ist ein zusätzlicher Filter zu den Transporteur-Zonen. Nützlich, wenn eine Zone mehrere Länder umfasst.

Countries: eine Auswahl der Länder von 99minutos (Mexiko, Kolumbien, Chile, Peru). Halten Sie Strg (Cmd) gedrückt, um mehrere auszuwählen. Wird nur verwendet, wenn Restrict countries aktiv ist. Leer lassen, um alle Länder von 99minutos zuzulassen.

Erweitert

Debug log: schreibt Tarifberechnungen in logs/vfd_99m_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. API-Fehler werden auch protokolliert, wenn diese Option aus ist. API-Schlüssel sowie Namen und Adressen der Kunden werden nie protokolliert. Schalten Sie das Log aus, wenn Sie fertig sind.

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

Remove data on uninstall: ist die Option aktiv, löscht die Deinstallation des Moduls die Einstellungen, den Transporteur, den Abdeckungs-Cache und das Log. Ist sie aus, bleibt alles für eine Neuinstallation erhalten. Bestellungen bleiben in jedem Fall erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem 99Minutos-Preis ab. Nur physische Produkte zählen: Virtuelle Produkte haben kein Gewicht und sind nicht in der Warenkorb-Zwischensumme enthalten. Der Transporteur wird nur angeboten, wenn das Zielland Mexiko, Kolumbien, Chile oder Peru ist (und in der Liste Countries steht, wenn Restrict countries aktiv ist). Danach prüft das Modul die Gewichtsgrenzen und die Minimum subtotal.

Ist ein Modus der Abdeckungsprüfung aktiv, fragt das Modul die 99minutos-API, ob die Postleitzahl abgedeckt ist. Die Zeitgrenze 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 der Transporteur ausgeblendet, im Modus Soft wird der Matrixpreis verwendet. Kostenloser Versand umgeht die Abdeckungsprüfung nicht.

Der Preis wird aus der Matrixzeile des Ziellands oder aus der Zeile * Default entnommen. Gibt es keines von beiden, wird der Transporteur ausgeblendet. Ist Free shipping aktiv und erreicht die Warenkorb-Zwischensumme Free shipping from, beträgt der Preis 0. Der Preis wird in der Standardwährung Ihres Shops berechnet und dann in der Warenkorbwährung des Kunden angezeigt.

Wenn Sie den Transporteur unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Transporteurs. Das Modul folgt der neuen Version automatisch.

Das Modul ruft keine Live-Tarife bei 99minutos ab: Die Preise kommen immer aus Ihrer Matrix. Es erstellt keine Sendungen oder Bestellungen bei 99minutos, druckt keine Versandetiketten (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 Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox 99Minutos ist der erste Block auf Modules > Module Manager > VibeFox 99Minutos > Configure, ü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 maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv 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: presta-shipping-99minutos und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt 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 Adresse des Shops geändert hat oder nachdem Sie in Ihrem Konto einen Domainplatz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch in einer Multistore-Installation. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird der Transporteur 99Minutos Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Der Storefront von PrestaShop weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Transporteur auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Ein Hinweis erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: 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. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

99Minutos erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable 99Minutos eingeschaltet ist. Das Zielland muss Mexiko, Kolumbien, Chile oder Peru sein und unter International > Locations aktiv sein. Prüfen Sie unter Shipping > Carriers, ob der Transporteur die Zone des Landes des Kunden und dessen Kundengruppe abdeckt. Prüfen Sie, ob die Price matrix eine Zeile für dieses Land oder eine Zeile * Default hat, und kontrollieren Sie die Gewichtsgrenzen, die Minimum subtotal und Restrict countries. Auf der Produktseite können Produkte außerdem auf bestimmte Transporteure beschränkt sein.

Der Transporteur erscheint erst, nachdem eine Postleitzahl eingegeben wurde: Das ist bei einer Abdeckungsprüfung zu erwarten. Im Modus Strict erscheint er nur, wenn die API die Abdeckung bestätigt.

Der Transporteur ist im Modus Strict immer ausgeblendet: Aktivieren Sie das Debug log, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Modulseite 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 Live-Schlüssel sind verschieden). Verwenden Sie den Modus Soft, wenn Kunden auch bei nicht erreichbarer API den Matrixpreis sehen sollen.

Der Preis entspricht nicht den Erwartungen: Prüfen Sie Calculation (pro Bestellung oder pro Artikel), die Produktgewichte und die Gewichtseinheit Ihres Shops (International > Localization). Ein leerer Größenpreis oder ein Preis von 0 greift auf den Base price zurück. Mit einer Steuerregel unter Tax wird die Steuer auf den Matrixpreis aufgeschlagen.

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

Die Seite meldet, dass der Transporteur 99Minutos nicht gefunden wurde: Der Transporteur wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul im Modules > Module Manager zurück, damit er neu angelegt wird. Dasselbe gilt für die Meldung The settings were saved, but the carrier could not be updated. Reset the module to create it again.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox 99Minutos und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Der Abdeckungs-Cache wird ebenfalls immer gelöscht. Ist Remove data on uninstall aktiv, wird der Transporteur gelöscht (Bestellungen behalten ihren Verlauf), und Einstellungen sowie Log werden entfernt. Ist die Option aus, wird der Transporteur nur deaktiviert und alle Einstellungen bleiben erhalten. Wird das Modul erneut installiert, erhält der gespeicherte Transporteur wieder den Status, den er vor der Deinstallation hatte. Reset aktiviert daher keinen deaktivierten Transporteur.

99minutos ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit 99minutos verbunden noch von 99minutos empfohlen.