VibeFox Packeta for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

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 eingetragen wurde.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine 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. Sie können auch den Ordner vfd_packeta per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Packeta, 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. Geben Sie Ihren Packeta-API key und Ihre Preise ein: mindestens eine Zeile unter Country prices (zum Beispiel * Default) oder einen Fallback cost. Speichern Sie. Die Seite zeigt an, ob Packeta den Schlüssel akzeptiert hat.

6. Fügen Sie VibeFox Packeta Ihren Versandzonen für Tschechien, die Slowakei, Ungarn oder Rumänien unter WooCommerce > Settings > Shipping > Shipping zones hinzu, oder aktivieren Sie Ignore shipping zones.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Packeta. Sie gelten für alle Versandzonen. Wenn Sie die Versandart einer Zone hinzufügen, enthält das Zonenfenster nur ein Feld:

Title (zone): der Name, den Kunden in dieser Zone sehen. Leer lassen, um den globalen Name zu verwenden.

Die Versandart wird nur für die Länder des eigenen Abholstellennetzes von Packeta angeboten: CZ, SK, HU und RO. Oberhalb der Einstellungen zeigt die Seite das Ergebnis der API-Schlüssel-Prüfung und Warnungen zu Problemen, etwa fehlender API-Schlüssel, fehlender Preis oder ausgewählte Länder außerhalb des Packeta-Netzes.

Alle Preise und Grenzwerte akzeptieren ein Komma oder einen Punkt als Dezimaltrennzeichen (4,99 oder 4.99). Eine ungültige Zahl wird mit einer Meldung abgelehnt, und der bisherige Wert bleibt erhalten.

Allgemein

Enable/Disable: schaltet die Versandart in allen Zonen gleichzeitig ein oder aus.

Name: der Name der Versandart, den der Kunde sieht. Eine Zone kann ihn mit einem eigenen Title überschreiben. Standard: Packeta pickup point.

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 gegen den 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 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: Taxable rechnet die WooCommerce-Steuer auf die Versandkosten auf, None nicht.

Preise

Packeta bietet keine öffentliche Tarif-API. Die Preise stammen aus dieser Tabelle und werden in der Shopwährung eingetragen.

Calculation type: Per order berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl der versandfähigen 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 mit dem Wert 0 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 kostenlosen Versand bedeutet. Wählen Sie das Land und tragen Sie die Preise ein, bevor Sie speichern, oder entfernen Sie die Zeile. Steht dasselbe Land in zwei Zeilen, bleibt beim Speichern nur die erste erhalten.

Fallback cost: wird verwendet, wenn die Länder-Tabelle für das Ziel keine Zeile und keine Zeile * Default hat. Leer lassen, um die Versandart dort nicht anzubieten.

Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer), ab der die Packeta-Lieferung kostenlos ist. Sie gilt nur dort, wo ein Preis festgelegt ist: eine Länderzeile, die Zeile * Default oder der Ersatzpreis. Leer lassen, um nie kostenlosen Versand anzubieten.

Verfügbarkeit

Minimum weight (kg): blendet die Versandart 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 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.

Minimum cart subtotal: bietet die Versandart nur an, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer) diesen Betrag erreicht.

Excluded shipping classes: blendet die Versandart aus, wenn der Warenkorb ein Produkt aus einer dieser WooCommerce-Versandklassen enthält.

Ignore shipping zones: Ist die Option aktiv, wird die Versandart für die unten gewählten Länder angeboten, auch wenn sie der passenden Versandzone nicht hinzugefügt wurde. Ist sie aus, wird sie nur in den Zonen angeboten, denen sie hinzugefügt wurde.

Countries (ignore zones mode): die Zielländer für diesen Modus. Leer lassen, 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 aktiv ist.

Erweitert

Debug log: schreibt Tarifberechnungen und Auswahlen von Abholstellen unter WooCommerce > Status > Logs (Quelle „vfd-packeta“). Es werden keine personenbezogenen Daten der Kunden und kein API-Schlüssel protokolliert. Fehlgeschlagene API-Schlüssel-Prüfungen werden immer protokolliert. Schalten Sie das Protokoll nach Abschluss der Arbeiten wieder aus.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins die Einstellungen und die Zonen-Instanzen dieser Versandart. Das Deaktivieren des Plugins löscht nie etwas. Die in Bestellungen gespeicherte Abholstelle bleibt immer erhalten.

So funktioniert es an der Kasse

Gibt der Kunde eine Lieferadresse ein, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft die Bedingungen: Lieferland im Packeta-Netz, API-Schlüssel, Warenkorbgewicht, Mindest-Zwischensumme des Warenkorbs und ausgeschlossene Versandklassen. Der Preis stammt aus der Länder-Tabelle, danach aus dem Ersatzpreis. Gibt es keinen Preis, wird die Versandart ausgeblendet. Gilt kostenloser Versand, sieht der Kunde die Versandart ohne Kosten.

Wählt der Kunde die Packeta-Versandart aus, 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 deren Name und Adresse unter der Versandart angezeigt, und die Schaltfläche wechselt zu Change pickup point. Die Auswahl wird in der Kundensitzung gespeichert, wenn die Kasse neu geladen wird oder die Seite neu lädt.

Ihr Server fragt bei der Kasse nichts bei Packeta 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.“

Die Versandart funktioniert in der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist mit der High-Performance-Bestellspeicherung (HPOS) von WooCommerce kompatibel.

Packeta-Preise werden nicht live abgefragt; sie stammen aus Ihrer Tabelle. Das Plugin erstellt keine Packeta-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Es bietet auch keine Lieferung nach Hause und keine Abholstellen von Partner-Versanddienstleistern im Standardumfang. Übergeben Sie die Abholstellen-ID aus der Bestellung wie gewohnt an Packeta, zum Beispiel per Import in client.packeta.com.

Abholstellen

Die Abholstelle ist Pflicht. Gibt der Kunde die Bestellung ohne Auswahl ab, stoppt die Kasse mit „Please choose a Packeta pickup point.“. Liegt die gewählte Abholstelle in einem anderen Land als die Lieferadresse, stoppt die Kasse mit „The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.“. Beide Prüfungen laufen serverseitig, sowohl in der klassischen als auch in der Block-Kasse. Das Plugin prüft die Abholstellen-ID nicht bei Packeta; es prüft nur, dass eine Abholstelle gewählt wurde und ihr Land passt.

Die Abholstelle wird mit der Bestellung gespeichert, sobald diese angelegt wird:

Bestellbildschirm im Admin-Bereich: Packeta pickup point mit Name, Adresse, Pickup point ID und Land unter der Lieferadresse. Hat eine Packeta-Bestellung keine Abholstelle, zeigt der Bildschirm „No pickup point was selected for this order.“ an.

Dankeseite und Bestellansicht: Packeta pickup point: mit Name und Adresse.

Bestell-E-Mails: Name und Adresse der Abholstelle in HTML- und Text-E-Mails. Admin-E-Mails enthalten zusätzlich die Pickup point ID.

In der Datenbank wird die Abholstelle in den Bestell-Metadaten _vfd_pckt_point_id, _vfd_pckt_point_name (Name und Adresse) und _vfd_pckt_point_country gespeichert.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Packeta. 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 für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren 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. Angemeldete Shop-Manager sehen die Versandart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Auf der Seite Plugins und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist aber eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Packeta erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der API key eingetragen ist und das Zielland 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 Zwischensummengrenzen, Excluded shipping classes sowie ob die Versandart der passenden Zone hinzugefügt wurde (oder Ignore shipping zones aktiv ist). Die Einstellungsseite listet Konfigurationsprobleme oben auf. Aktivieren Sie Debug log, um den Grund unter WooCommerce > Status > Logs 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 kann das Widget an der Kasse nicht geöffnet werden.

Das Widget öffnet sich nicht: Das Packeta-Skript ist 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 Filter vfd_pckt_widget_url ändern.

Versand ist irrtümlich kostenlos: Prüfen Sie unter Country prices Zeilen mit einem Price von 0, besonders eine Zeile * Default, die mit + Add country hinzugefügt und nicht ausgefüllt wurde.

Andere Länder oder Versanddienstleister: Im Standardumfang funktioniert die Versandart für CZ, SK, HU und RO. Entwickler können Länder mit dem Filter vfd_pckt_countries ergänzen und Carrier-IDs mit dem Filter vfd_pckt_widget_options an das Widget übergeben.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel etwa bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz 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 zuletzt 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, zusammen mit der gespeicherten API-Schlüssel-Prüfung. Einstellungen und Zonen-Versandarten werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen und die gespeicherte Abholstelle.

Packeta ist eine Marke des jeweiligen Inhabers. Dieses Plugin ist nicht mit Packeta verbunden und wird nicht von Packeta unterstützt.