VibeFox Packeta 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), mit der Standardkasse des Standarddesigns.

PHP: 8.0 oder neuer.

Packeta-API-Schlüssel: Sie finden ihn im Kundenbereich von Packeta (client.packeta.com) unter Client support. Er besteht aus 16 Buchstaben und Ziffern. Das Widget benötigt ihn, um an der Kasse zu öffnen. Deshalb wird die Versandart Kunden erst angezeigt, nachdem der API-Schlüssel eingegeben wurde.

Länder: Tschechien, die Slowakei, Ungarn oder Rumänien müssen als aktivierte Länder Ihres Shops hinterlegt sein. Sie sind in den Standarddaten von OpenCart enthalten. Ungarn hat in OpenCart keine Regionen, daher bleibt das Regionsfeld der Adresse leer. Das spielt keine Rolle.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel gilt für eine Domain.

Installation

Der Download ist eine einzige ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 vfd_packeta-oc3-(version).ocmod.zip und das Paket für OpenCart 4 vfd_packeta.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_packeta-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 Packeta und klicken Sie auf Install (die grüne +-Schaltfläche).

3. Klicken Sie auf Edit (die Schaltfläche mit dem Stift), um die Einstellungsseite zu öffnen.

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

5. Geben Sie Ihren Packeta-API key und Ihre Preise ein: mindestens eine Zeile Country prices (zum Beispiel * Default) oder eine Fallback cost. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Die Seite zeigt an, ob Packeta den Schlüssel akzeptiert hat.

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_packeta.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 Packeta, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, den API-Schlüssel und die Preise wie in den Schritten 4 und 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Nach der Installation ist die Versandart ausgeschaltet, bis Sie Enable/Disable aktivieren und speichern. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die aufbewahrten Packeta-Einstellungen wieder verwendet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Shipping > VibeFox Packeta > Edit. Die Abschnitte stehen links. Eine Schaltfläche Save unten speichert die ganze Seite, ohne sie neu zu laden. Nur Administratoren mit der Berechtigung zum Ändern dieser Erweiterung können die Einstellungen speichern.

Die Versandart wird nur für die Länder des eigenen Abholstellennetzes von Packeta angeboten: CZ, SK, HU und RO. Über den Einstellungen zeigt die Seite das Ergebnis der API-Schlüsselprüfung sowie Warnungen zu Problemen: kein API-Schlüssel, kein Preis, ausgewählte Länder außerhalb des Packeta-Netzes oder eine Gewichtseinheit des Shops, die die Erweiterung nicht kennt. Die Warnungen werden nach jedem Speichern aktualisiert.

Alle Preise und Grenzwerte akzeptieren ein Komma oder einen Punkt als Dezimaltrennzeichen (4,99 oder 4.99). Ein ungültiger oder negativer Wert wird mit einer Meldung abgelehnt, der vorherige Wert dieses Feldes bleibt erhalten. Die übrigen Felder werden gespeichert.

Allgemein

Enable/Disable: schaltet Packeta an der Kasse ein oder aus. Standard: aus.

Name: der Name der Versandart, den der Kunde sieht. Standard: Packeta pickup point. Erforderlich, höchstens 64 Zeichen.

API key: Ihr Packeta-API-Schlüssel aus client.packeta.com > Client support. Sie können auch das 32-stellige API-Passwort einfügen: Gespeichert werden nur seine ersten 16 Zeichen, also der API-Schlüssel. Der API-Schlüssel ist öffentlich: Er wird an den Browser des Kunden gesendet, um das Widget zu öffnen. Beim Speichern eines neuen Schlüssels wird er mit dem Carrier-Feed von Packeta geprüft, und die Seite zeigt Packeta API key verified oder dass Packeta ihn abgelehnt hat. Kann die Prüfung nicht ausgeführt werden, wird der Schlüssel gespeichert und beim nächsten Speichern erneut geprüft.

Widget language: die Sprache des Widgets für Abholstellen. Store / visitor language (Standard) folgt der Sprache der Seite. Sie können sie auch auf Tschechisch, Slowakisch, Ungarisch, Rumänisch, Englisch, Deutsch, Polnisch oder Ukrainisch festlegen.

Pickup point types: welche Packeta-Stellen das Widget anbietet.

Tax status: die OpenCart-Steuerklasse, die auf den Versandpreis angewendet wird, oder None (no tax on shipping) (Standard).

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

Preise

Packeta bietet keine öffentliche Tarif-API. Die Preise stammen aus dieser Tabelle und werden in der Standardwährung Ihres Shops ohne Steuern eingegeben. Kunden, die in einer anderen Währung zahlen, sehen den umgerechneten Preis.

Calculation type: Per order (Standard) berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl der Produkte, die versendet werden müssen.

Country prices: ein Preis je Zielland und Paketgewicht. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf die Schaltfläche ×, um sie zu entfernen. Jede Zeile hat einen Price und Gewichtsspalten: XS bis 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg und XL über 5 kg. Eine Gewichtsspalte mit dem Wert 0 verwendet die Spalte Price. Die Zeile * Default gilt für Länder ohne eigene Zeile. Eine neue Zeile startet als * Default mit allen Preisen auf 0, was kostenlosem Versand entspricht. Wählen Sie das Land und geben Sie die Preise vor dem Speichern ein, oder entfernen Sie die Zeile. Ist dasselbe Land (oder * Default) in zwei Zeilen enthalten, wird beim Speichern nur die erste behalten. Ist ein Wert in der Tabelle keine Zahl von 0 oder mehr, wird die Tabelle nicht gespeichert und die Seite listet die fehlerhaften Werte auf.

Fallback cost: wird verwendet, wenn die Ländertabelle für das Ziel weder eine eigene Zeile noch eine Zeile * Default hat. Lassen Sie das Feld leer, um die Versandart dort nicht anzubieten.

Free shipping from: die Zwischensumme des Warenkorbs (nach dem Gutschein, ohne Steuern), ab der die Packeta-Lieferung kostenlos ist. Sie wird vor der Preistabelle geprüft: Ab diesem Betrag ist die Lieferung in jedem Packeta-Land kostenlos, in dem die Versandart angeboten wird, auch in einem Land ohne Länderzeile oder Ausweichgebühr. Lassen Sie das Feld leer, um nie kostenlosen Versand anzubieten.

Verfügbarkeit

Minimum weight (kg): blendet die Versandart aus, wenn der Warenkorb weniger wiegt. Produktgewichte werden aus ihren OpenCart-Gewichtsklassen umgerechnet. Leer oder 0 bedeutet keine Grenze.

Maximum weight (kg): blendet die Versandart aus, wenn der Warenkorb mehr wiegt. Standard: 15. Packeta-Abholstellen und Z-BOXen nehmen in der Regel Pakete bis 15 kg an; prüfen Sie Ihren Vertrag mit Packeta. Leer oder 0 bedeutet keine Grenze. Ein Mindestgewicht über dem Höchstgewicht wird beim Speichern abgelehnt, und beide vorherigen Werte bleiben erhalten.

Minimum cart subtotal: bietet die Versandart nur an, wenn die Zwischensumme des Warenkorbs (nach dem Gutschein, ohne Steuern) diesen Betrag erreicht.

Geo zone: bietet Packeta nur für Adressen in dieser Geozone an. All zones (Standard) bedeutet keine Begrenzung. Sie wird nicht geprüft, wenn Ignore shipping zones aktiviert ist. Geozonen verwalten Sie unter System > Localisation > Geo Zones.

Ignore shipping zones: Wenn aktiviert, wird die Geozone nicht geprüft, und die Versandart wird für die unten ausgewählten Länder angeboten. Wenn deaktiviert (Standard), wird sie nur in der oben gewählten Geozone angeboten.

Countries (ignore zones mode): die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Packeta-Länder zu verwenden. Länder außerhalb des Packeta-Abholstellennetzes werden übersprungen. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: schreibt Tarifberechnungen und Abholstellenauswahl in storage/logs/vfd_pckt_debug.log.php. Die Datei ist aus dem Web nicht lesbar. Persönliche Kundendaten und der API-Schlüssel werden nicht protokolliert. Fehler und fehlgeschlagene API-Schlüsselprüfungen werden immer protokolliert. Schalten Sie das Protokoll aus, wenn Sie fertig sind. Erreicht die Datei 5 MB, wird sie nach vfd_pckt_debug.old.log.php verschoben und ein neues Protokoll begonnen.

Log (last lines): 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: Wenn aktiviert, löscht die Deinstallation der Erweiterung die Einstellungen und das Protokoll. Wenn deaktiviert (Standard), bleiben die Einstellungen für eine Neuinstallation erhalten. Die in Bestellungen gespeicherte Abholstelle bleibt immer erhalten.

Import / Export

Export: klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern, einschließlich des API-Schlüssels, der öffentlich ist.

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.

So funktioniert es an der Kasse

Wenn OpenCart die Versandarten anzeigt, fragt die Erweiterung nach dem Packeta-Preis. Ist eine Geo zone festgelegt (und Ignore shipping zones ist deaktiviert) und liegt die Adresse außerhalb, wird Packeta nicht angeboten. Nur Produkte mit Requires Shipping auf Yes zählen: Andere Produkte erhöhen das Gewicht nicht und sind nicht in der Zwischensumme enthalten. Die Erweiterung prüft die Bedingungen: Lieferland im Packeta-Netz, API-Schlüssel, die Länderliste im Modus Zonen ignorieren, Warenkorbgewicht und Mindestsumme des Warenkorbs. Die Zwischensumme ist der Preis der versandpflichtigen Produkte nach Gutscheinrabatt und ohne Steuern. Geschenkgutscheine, Bonuspunkte und Guthaben im Shop werden nicht berücksichtigt. Gilt kostenloser Versand, beträgt der Preis 0. Andernfalls stammt der Preis aus der Ländertabelle, danach aus der Ausweichgebühr. Gibt es keinen Preis, wird die Versandart ausgeblendet. Der Preis wird dem Kunden in seiner Währung mit der Steuer der gewählten Tax status angezeigt.

Unter der Packeta-Option im Schritt Versandart befindet sich die Schaltfläche Choose pickup point. Sie öffnet im Browser des Kunden das offizielle Packeta-Widget mit dem Zielland, dem Warenkorbgewicht, den gewählten Stellenarten und der Widget-Sprache. Nachdem der Kunde eine Stelle gewählt hat, werden Name und Adresse unter der Versandart angezeigt, und die Schaltfläche wechselt zu Change pickup point. Die Stelle wird für die Kassensitzung gespeichert und bleibt beim Neuladen der Seite erhalten. Eine für ein anderes Land gewählte Stelle wird nicht verwendet, wenn die Lieferadresse in ein anderes Land geändert wird.

Ihr Server fragt während des Bestellvorgangs nichts bei Packeta ab. Das Widget-Skript wird nur auf der Kassenseite von widget.packeta.com geladen. Wird es blockiert (durch einen Werbe- oder Datenschutzblocker, eine Content Security Policy oder einen Ausfall bei Packeta), sieht der Kunde die Meldung „The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.“

Packeta-Preise werden nicht live abgefragt, sondern stammen aus Ihrer Tabelle. Die Erweiterung erstellt keine Packeta-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Sie bietet auch keine Hauslieferung und keine Abholstellen von Partnerdiensten standardmäßig an. Geben Sie die Abholstellen-ID aus der Bestellung auf die übliche Weise an Packeta weiter, zum Beispiel per Import in client.packeta.com. Die Schaltfläche für die Abholstelle funktioniert mit der Standardkasse von OpenCart im Standarddesign.

In OpenCart 4 klickt der Kunde im Block der Versandart auf der Kassenseite auf Choose und wählt im Fenster Shipping method options Packeta aus. Die Schaltfläche Choose pickup point und die gewählte Stelle erscheinen in diesem Fenster unter der Packeta-Option, und das Packeta-Widget öffnet sich darüber. Die Preise sind dieselben wie in OpenCart 3.

Abholstellen

Die Abholstelle ist erforderlich. Klickt der Kunde im Schritt Versandart auf Continue, ohne eine Stelle zu wählen, wird der Schritt nicht abgeschlossen, und der Kunde sieht die Meldung „Please choose a Packeta pickup point.“ Liegt die gewählte Stelle in einem anderen Land als der Lieferadresse, sieht der Kunde „The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.“ Die Erweiterung prüft die Stellen-ID nicht bei Packeta; sie prüft nur, dass eine Stelle gewählt wurde und dass ihr Land passt.

Die Abholstelle wird der Bestellung beim Anlegen zugeordnet:

Versandart der Bestellung: Name und Adresse der Stelle werden dem Namen der Versandart hinzugefügt, zum Beispiel Packeta pickup point: <point> (bis zu 128 Zeichen). Der Kunde sieht sie im Bestellverlauf und in der Bestell-E-Mail, und sie wird auf der Rechnung ausgedruckt. Die Bestellbestätigungsseite von OpenCart zeigt die Versandart nicht an.

Bestellseite im Admin: öffnen Sie die Bestellung unter Sales > Orders. Ein Feld Packeta pickup point zeigt Name und Adresse, die Pickup point ID und das Land. Hat eine Packeta-Bestellung keine Stelle, steht dort: „No pickup point was selected for this order.“

In OpenCart 4 führt die Schaltfläche Continue des Fensters Shipping method options ohne gültige Stelle nicht weiter, mit denselben Meldungen. OpenCart 4 führt für den Checkout eine einzige Bestellung und aktualisiert sie jedes Mal, wenn der Kunde erneut bestätigt; die Abholstelle der Bestellung wird dabei mit aktualisiert. Das Feld Packeta pickup point der Bestellseite im Admin wird oberhalb des Abschnitts History angezeigt.

Die Stelle wird in der eigenen Tabelle der Erweiterung vfd_pckt_point gespeichert (Kassensitzung, Bestellung, Stellen-ID, Name und Adresse, Land).

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Packeta ist der erste Block unter Extensions > Extensions > Shipping > VibeFox Packeta > 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 maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-shipping-packeta und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Administratoren mit der Berechtigung Modify für diese Erweiterung ändern. Die Texte des Blocks folgen der Sprache des Administrators (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. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Packeta Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Administrator, der im Admin im selben Browser angemeldet ist, sieht die Methode im Shop weiterhin, markiert als (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin nicht, daher wird die Methode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint eine Erinnerung im Dashboard des Admins. Schließen Sie sie mit ×, um sie 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 Admins 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. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Packeta erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der API key eingegeben ist und das Lieferland CZ, SK, HU oder RO ist. Prüfen Sie, ob ein Preis für das Land festgelegt ist (Länderzeile, Zeile * Default oder Fallback cost), die Gewichts- und Summengrenzen sowie Geo zone (oder Ignore shipping zones und dessen Länder). Prüfen Sie, dass bei den Produkten Requires Shipping auf Yes steht. Die Einstellungsseite listet Konfigurationsprobleme oben auf. Aktivieren Sie Debug log, um den Grund unter Log (last lines) zu sehen.

Packeta hat den API-Schlüssel abgelehnt: Kopieren Sie den API-Schlüssel erneut von client.packeta.com > Client support und speichern Sie. Bis dahin kann das Widget an der Kasse nicht geöffnet werden.

Das Widget öffnet sich nicht: Das Packeta-Skript wird durch einen Werbe- oder Datenschutzblocker, eine Content Security Policy oder einen Ausfall bei Packeta blockiert. Erlauben Sie widget.packeta.com in Ihrer Content Security Policy.

Der Versand ist irrtümlich kostenlos: Prüfen Sie unter Country prices Zeilen mit einem Price von 0, besonders eine mit Add country hinzugefügte und nicht ausgefüllte Zeile * Default, und prüfen Sie Free shipping from.

Gewichtsgrenzen oder Gewichtsspalten wirken falsch: Warnt die Seite vor der Gewichtseinheit des Shops, verwenden Sie Gewichtsklassen mit der Einheit kg, g, lb oder oz und stellen Sie die Standard-Gewichtsklasse unter System > Settings, Reiter Local, ein. Andere Einheiten werden als Kilogramm gelesen.

Die Seite zeigt „Warning: You do not have permission to modify VibeFox Packeta!“: Ihre Administrator-Benutzergruppe darf die Einstellungen nur ansehen. Geben Sie der Gruppe die Änderungsberechtigung für extension/shipping/vfd_packeta (OpenCart 3) oder extension/vfd_packeta/shipping/vfd_packeta (OpenCart 4) unter System > Users > User Groups.

Für Entwickler: Andere Erweiterungen können Länder hinzufügen, Optionen wie Carrier-IDs an das Widget übergeben, die URL des Widget-Skripts oder dessen Sprache mit den OpenCart-Ereignissen vfd_packeta/countries, vfd_packeta/widget_options, vfd_packeta/widget_url und vfd_packeta/widget_language ändern (Auslöser mit dem Präfix catalog/, zum Beispiel catalog/vfd_packeta/widget_options).

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox Packeta auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt Enable/Disable, Sort order, Tax status und Geo zone immer zurück. Die gespeicherte Prüfung des API-Schlüssels wird immer entfernt, und die Schaltfläche für die Abholstelle sowie das Bestellfeld werden nicht mehr angezeigt. Ist Remove data on uninstall aktiviert, werden die Einstellungen, das Protokoll und die Abholstellen von Kassenvorgängen gelöscht, die nie zu Bestellungen wurden. Ist es deaktiviert, bleiben die übrigen Einstellungen erhalten und werden bei einer erneuten Installation wieder verwendet. Bestehende Bestellungen behalten immer die gespeicherte Abholstelle und die Stelle in ihrer Versandart.

In OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Packeta auf Uninstall (die orangefarbene −-Schaltfläche) und anschließend auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Packeta ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung steht in keiner Verbindung zu Packeta und wird nicht von Packeta unterstützt.