VibeFox Packeta 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.
Packeta-API-Schlüssel: Sie finden ihn im Packeta-Kundenbereich (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 der Versanddienstleister Kunden erst angezeigt, nachdem der API-Schlüssel eingegeben wurde.
Länder: Tschechien, die Slowakei, Ungarn oder Rumänien müssen aktive Länder Ihres Shops sein, in einer Zone, mit der der Versanddienstleister verknüpft ist.
VibeFox-Lizenzschlüssel: Er 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 Packeta in der Modulliste und klicken Sie dort auf Configure.
3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Konfigurationsseite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).
4. Geben Sie Ihren Packeta-API key und Ihre Preise ein: mindestens eine Zeile unter Country prices (zum Beispiel * Default) oder einen Fallback cost. Klicken Sie auf Save. Die Seite zeigt an, ob Packeta den Schlüssel akzeptiert hat.
Bei der Installation erstellt das Modul den Versanddienstleister Packeta pickup point mit dem Lieferzeittext Packeta pickup point or Z-BOX. Er ist mit den Zonen Tschechien, Slowakei, Ungarn und Rumänien sowie mit allen Kundengruppen verknüpft. Zonen, Kundengruppen, Lieferzeit und Logo können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer vom Modul.
Konfiguration
Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Packeta > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die gesamte Seite speichert.
Der Versanddienstleister 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üssel-Prüfung sowie Warnungen zu Problemen an: kein API-Schlüssel, kein Preis, gewählte Länder außerhalb des Packeta-Netzes, ein fehlender Versanddienstleister oder eine Gewichtseinheit des Shops, die das Modul nicht kennt.
Alle Preise und Grenzwerte akzeptieren ein Komma oder einen Punkt als Dezimaltrennzeichen (4,99 oder 4.99). Eine ungültige oder negative Zahl wird mit einer Meldung abgelehnt, und der bisherige Wert bleibt erhalten.
Allgemein
Enable/Disable: schaltet Packeta an der Kasse ein oder aus.
Name: der Name des Versanddienstleisters, den der Kunde sieht. Er ist auch der Name des Versanddienstleisters unter Shipping > Carriers. Standard: Packeta pickup point. Pflichtfeld, 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 die 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. Wenn Sie einen neuen Schlüssel speichern, wird er gegen den Versanddienstleister-Feed von Packeta geprüft. Die Seite zeigt dann Packeta API key verified oder dass Packeta den Schlüssel abgelehnt hat. Kann die Prüfung nicht durchgeführt werden, wird der Schlüssel gespeichert und beim nächsten Speichern erneut geprüft.
Widget language: die Sprache des Abholstellen-Widgets. 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-Abholstellen das Widget anbietet.
Tax status: die Steuerregeln, die auf den Versandpreis angewendet werden. None (no tax on shipping) oder Taxable mit einer Ihrer Steuerregelgruppen. Die Auswahl wird am Versanddienstleister gespeichert.
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 bezahlen, sehen den umgerechneten Preis.
Calculation type: Per order berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl der physischen Artikel im Warenkorb.
Country prices: ein Preis je Zielland und Paketgewicht. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine Zeile 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, die auf 0 bleibt, verwendet die Spalte Price. Die Zeile * Default gilt für Länder ohne eigene Zeile. Eine neue Zeile beginnt als * Default mit allen Preisen auf 0, was kostenlosem Versand entspricht. Wählen Sie das Land und geben Sie die Preise ein, bevor Sie speichern, oder entfernen Sie die Zeile. Steht dasselbe Land (oder * Default) in zwei Zeilen, bleibt beim Speichern nur die erste erhalten. Ist ein Wert in der Tabelle keine gültige Zahl, wird die Tabelle nicht gespeichert, und die Seite zeigt die fehlerhaften Werte an.
Fallback cost: wird verwendet, wenn die Länder-Tabelle für das Zielland keine Zeile und keine * Default-Zeile hat. Lassen Sie das Feld leer, um den Versanddienstleister dort nicht anzubieten.
Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuern), ab der die Lieferung mit Packeta kostenlos ist. Sie wird vor der Preistabelle geprüft: Ab diesem Betrag ist die Lieferung in jedem Packeta-Land kostenlos, in dem der Versanddienstleister angeboten wird, auch in einem Land ohne Länderzeile oder Ersatzpreis. Lassen Sie das Feld leer, um nie kostenlosen Versand anzubieten.
Verfügbarkeit
Minimum weight (kg): blendet den Versanddienstleister aus, wenn der Warenkorb weniger wiegt. Das Warenkorbgewicht wird aus der Gewichtseinheit Ihres Shops umgerechnet. Leer oder 0 bedeutet keine Grenze.
Maximum weight (kg): blendet den Versanddienstleister 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 Packeta-Vertrag. Leer oder 0 bedeutet keine Grenze. Ein Mindestgewicht, das größer als das Höchstgewicht ist, wird beim Speichern abgelehnt, und beide bisherigen Werte bleiben erhalten.
Minimum cart subtotal: bietet den Versanddienstleister nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuern) diesen Betrag erreicht.
Ignore shipping zones: Ist die Option aktiviert, wird der Versanddienstleister mit allen Zonen verknüpft und für die unten gewählten Länder angeboten. Später erstellte Zonen werden sofort verknüpft. Schalten Sie die Option aus, erhält der Versanddienstleister wieder die Zonen, die er zuvor hatte. Ist sie ausgeschaltet, wird er nur in den Zonen angeboten, die unter Shipping > Carriers für den Versanddienstleister festgelegt sind.
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. Halten Sie Strg gedrückt und klicken Sie, um mehrere auszuwählen. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.
Erweitert
Debug log: schreibt Preisberechnungen und die Wahl der Abholstellen in modules/vfd_packeta/logs/. Die Datei lässt sich nicht über das Web öffnen. Es werden keine personenbezogenen Daten von Kunden und kein API-Schlüssel protokolliert. Fehler und fehlgeschlagene API-Schlüssel-Prüfungen werden immer protokolliert. Schalten Sie das Protokoll aus, wenn Sie fertig sind.
Log (last lines): zeigt die neuesten Einträge des Debug-Protokolls an. Klicken Sie auf Clear log, um es zu leeren.
Remove data on uninstall: Ist die Option aktiviert, werden beim Deinstallieren des Moduls die Einstellungen und das Protokoll gelöscht. Die in Bestellungen gespeicherte Abholstelle bleibt immer erhalten.
So funktioniert es an der Kasse
Im Versandschritt fragt PrestaShop das Modul nach dem Packeta-Preis. Es zählen nur physische Produkte: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft die Bedingungen: Lieferland im Packeta-Netz, API-Schlüssel, die Länderliste im Modus „Ignore shipping zones“, Warenkorbgewicht und Mindest-Zwischensumme. Gilt kostenloser Versand, beträgt der Preis 0. Andernfalls stammt der Preis aus der Länder-Tabelle und danach aus dem Ersatzpreis. Gibt es keinen Preis, wird der Versanddienstleister ausgeblendet.
Wählt der Kunde den Packeta-Versanddienstleister, erscheint darunter die Schaltfläche Choose pickup point. Sie öffnet im Browser des Kunden das offizielle Packeta-Widget mit dem Zielland, dem Warenkorbgewicht, den gewählten Abholstellentypen und der Widget-Sprache. Nachdem der Kunde eine Abholstelle gewählt hat, werden ihr Name und ihre Adresse unter dem Versanddienstleister angezeigt, und die Schaltfläche wechselt zu Change pickup point. Die Abholstelle wird mit dem Warenkorb gespeichert und bleibt beim Neuladen der Seite erhalten. Eine für ein anderes Land gewählte Abholstelle wird verworfen, wenn sich die Lieferadresse ändert.
Ihr Server fragt bei Packeta an der Kasse nichts ab. Das Widget-Skript wird 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.“
Wenn Sie den Versanddienstleister unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul folgt der neuen Version automatisch.
Packeta-Preise werden nicht live abgefragt, sondern stammen aus Ihrer Tabelle. Das Modul erstellt keine Packeta-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Außerdem bietet es standardmäßig weder Heimlieferung noch Abholstellen anderer Partner-Versanddienstleister an. Übergeben Sie die Abholstellen-ID aus der Bestellung wie gewohnt an Packeta, zum Beispiel per Import im client.packeta.com.
Abholstellen
Die Abholstelle ist Pflicht. Klickt der Kunde im Versandschritt auf Continue, ohne eine Abholstelle zu wählen, wird der Schritt nicht abgeschlossen, und der Kunde sieht die Meldung „Please choose a Packeta pickup point.“ Liegt die gewählte Abholstelle in einem anderen Land als der Lieferadresse, sieht der Kunde die Meldung „The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.“ Das Modul prüft die Abholstellen-ID nicht bei Packeta. Es kontrolliert nur, ob eine Abholstelle gewählt wurde und ob ihr Land passt.
Die Abholstelle wird der Bestellung beim Anlegen zugeordnet:
Bestellseite im Back Office: ein Block Packeta pickup point mit Name, Adresse, Pickup point ID und Land. Hat eine Packeta-Bestellung keine Abholstelle, lautet der Hinweis im Block: „No pickup point was selected for this order.“
Bestellbestätigung und Bestelldetailseiten: Packeta pickup point: mit Name und Adresse.
Bestell-E-Mails: Name und Adresse der Abholstelle werden in der Bestellbestätigungs-E-Mail beim Versanddienstleister ergänzt. Die E-Mail über neue Bestellungen an den Händler enthält außerdem die Pickup point ID.
Die Abholstelle wird in der Modultabelle vfd_pckt_point gespeichert (Warenkorb, Bestellung, Abholstellen-ID, Name und Adresse, Land).
Lizenzschlüssel
Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Packeta ist der erste Block unter Modules > Module Manager > VibeFox Packeta > Configure, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, 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 zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-shipping-packeta 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 Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz 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 bei einer Multistore-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 einen aktiven Schlüssel wird der Packeta-Versanddienstleister Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind. Daher wird der Versanddienstleister auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber an der Kasse nicht testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen.
Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird während der Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal wöchentlich. Es ist kein Cron-Job nötig. Das Deinstallieren oder Zurücksetzen des Moduls 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, die API key eingegeben wurde und das Lieferland CZ, SK, HU oder RO ist. Prüfen Sie, ob für das Land ein Preis festgelegt ist (Länderzeile, Zeile * Default oder Fallback cost), die Gewichts- und Zwischensummen-Grenzen, und ob der Versanddienstleister die Zone des Landes des Kunden und die Kundengruppe unter Shipping > Carriers abdeckt (oder Ignore shipping zones eingeschaltet ist). Produkte können auf der Produktseite außerdem auf bestimmte Versanddienstleister beschränkt sein. Die Einstellungsseite listet Konfigurationsprobleme oben auf. Schalten Sie Debug log ein, um den Grund unter Log (last lines) zu sehen.
Packeta hat den API-Schlüssel abgelehnt: Kopieren Sie den API-Schlüssel erneut aus client.packeta.com > Client support und speichern Sie. Bis dahin lässt sich das Widget an der Kasse nicht öffnen.
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. Entwickler können die Skript-URL mit dem Hook actionVfdPcktWidgetUrl ändern.
Versand ist irrtümlich kostenlos: Prüfen Sie Country prices auf Zeilen mit einem Price von 0, besonders auf 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, stellen Sie unter International > Localization (Local units) kg, g, lb oder oz ein. Andere Einheiten werden als Kilogramm gelesen.
Andere Länder oder Versanddienstleister: Standardmäßig funktioniert der Versanddienstleister für CZ, SK, HU und RO. Entwickler können mit dem Hook actionVfdPcktCountries weitere Länder hinzufügen und mit dem Hook actionVfdPcktWidgetOptions Versanddienstleister-IDs an das Widget übergeben.
Die Seite meldet, dass der Packeta-Versanddienstleister fehlt: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn erneut anzulegen.
Deinstallation
Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Packeta und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Der Packeta-Versanddienstleister wird immer entfernt (Bestellungen behalten ihren Versanddienstleister), zusammen mit dem gespeicherten Ergebnis der API-Schlüssel-Prüfung. Ist Remove data on uninstall eingeschaltet, werden die Einstellungen, das Protokoll und die Abholstellen von Warenkörben gelöscht, die nie zu Bestellungen wurden. Ist die Option ausgeschaltet, bleiben die Einstellungen für eine erneute Installation erhalten; dabei wird der Versanddienstleister wieder angelegt. Bestehende Bestellungen behalten immer die gespeicherte Abholstelle.
Packeta ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit Packeta verbunden und wird von Packeta nicht unterstützt.