VibeFox Correos CityPaq 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.

Correos-API-Zugangsdaten (nur für die Live-Automatenliste): Die Correos-CityPaq-Liste liest die aktiven Automaten über die „terminals“-API von Correos. Öffnen Sie im Correos-Entwicklerportal die „terminals“-API und klicken Sie für Ihre Anwendung auf Request access. Correos genehmigt Anfragen von Geschäftskunden und sendet eine Client-ID und ein Client-Secret. Diese werden außerdem unter My applications im Portal angezeigt. Wenn Kunden den Automaten selbst eingeben oder aus Ihrer eigenen Liste wählen, benötigen Sie keine API-Zugangsdaten.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel gilt 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_correos_citypaq per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Correos CityPaq, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzbereich oben auf der Seite ein und klicken Sie auf Activate.

5. Füllen Sie die Preistabelle aus und wählen Sie, wie der Kunde den Automaten auswählt (siehe Konfiguration).

6. Fügen Sie VibeFox Correos CityPaq in WooCommerce > Settings > Shipping > Shipping zones Ihrer Versandzone für Spanien hinzu oder aktivieren Sie Ignore shipping zones.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Correos CityPaq. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name dieser Option an der Kasse für diese Zone. Leer lassen, um den globalen Name zu verwenden.

Warnungen über den Einstellungen zeigen an, wenn die Preistabelle keine brauchbare Zeile hat, wenn die gewählte Automatenauswahl nicht funktionieren kann (keine Automaten in Ihrer Liste, keine API-Zugangsdaten) und welcher letzte Correos-API-Fehler aufgetreten ist. Preise und Beträge akzeptieren ein Dezimalkomma oder einen Dezimalpunkt.

Allgemein

CityPaq-Automaten gibt es nur in Spanien, daher wird die Methode für andere Länder nie angeboten.

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

Name: der Name der Versandart, den der Kunde an der Kasse sieht. Standard: Correos CityPaq.

Tax status: Taxable fügt die WooCommerce-Steuer zu den Preisen aus der Tabelle hinzu, None nicht.

Preise (der Abschnittstitel zeigt Ihre Shopwährung)

Price table: eine Zeile für Spain (ES) und/oder eine Standardzeile *. Jede Zeile hat einen Grundpreis Price und optionale Preise für die Paketgrößen XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg). Ein Größenpreis von 0 oder leer verwendet den Grundpreis. Klicken Sie auf + Add row, um eine Zeile hinzuzufügen, und auf das Kreuz, um sie zu entfernen. Geben Sie Ihre Correos-Vertragspreise in der Shopwährung ein. Ohne passende Zeile wird die Methode ausgeblendet. Ungültige Preise und doppelte Zeilen werden beim Speichern gemeldet.

Calculation type: wie die Paketgröße ermittelt wird.

Per order (size by the total cart weight): ein Preis für den gesamten Warenkorb, gewählt nach dem Gesamtgewicht. Das ist die Standardeinstellung.

Per item (size by each item weight, multiplied by quantity): jedes Produkt erhält den Preis seiner eigenen Größe, multipliziert mit seiner Menge, und die Preise werden addiert.

Produktgewichte werden aus Ihrer Gewichtseinheit im Shop (kg, g, lbs oder oz) in kg umgerechnet.

Bedingungen

Min weight (kg): blendet die Methode aus, wenn der Warenkorb leichter ist. 0 bedeutet keine Grenze.

Max weight (kg): blendet die Methode aus, wenn der Warenkorb schwerer ist. Standard: 30, da CityPaq Pakete bis 30 kg annimmt. 0 bedeutet keine Grenze.

Minimum order amount: zeigt die Methode nur, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Excluded shipping classes: blendet die Methode aus, wenn der Warenkorb ein Produkt einer dieser WooCommerce-Versandklassen enthält, zum Beispiel sperrige Artikel, die nicht in einen Automaten passen. Das Plugin prüft keine Paketmaße.

Kostenloser Versand

Free shipping: aktiviert die kostenlose CityPaq-Lieferung ab dem unten angegebenen Betrag.

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern), ab der diese Methode 0 kostet. Wird nur verwendet, wenn Free shipping aktiviert ist.

Auswahl des CityPaq-Automaten

Locker selection: wie der Kunde den Automaten vor der Bestellung auswählt. Standard: der Kunde gibt den Automaten ein.

Customer chooses from the Correos CityPaq list (Correos API, credentials below): der Kunde sieht die aktiven CityPaq-Automaten der Postleitzahl der Lieferadresse und kann nach einer anderen fünfstelligen Postleitzahl suchen. Hat eine Postleitzahl keinen Automaten, werden zuerst die Automaten desselben Gebiets, dann derselben Provinz angezeigt, mit den nächstgelegenen Postleitzahlen zuerst. Jeder Automat zeigt Name, Adresse, Postleitzahl, Ort und Öffnungszeiten. Wenn die Liste nicht geladen werden kann oder nichts findet, gibt der Kunde den Automaten manuell ein.

Customer enters the locker (code or address from the Correos finder): ein Pflichtfeld für den Automatencode (zum Beispiel S0000213D) oder die Adresse, mit einem Link zum offiziellen CityPaq-Finder von Correos.

Customer chooses from my list of lockers (below): eine Pflicht-Auswahlliste mit den Automaten aus My lockers. Automaten in der Nähe der Postleitzahl des Kunden stehen zuerst.

Do not ask for a locker: keine Automatenabfrage an der Kasse.

Wenn Sie die Correos-Liste ohne API-Zugangsdaten oder Ihre eigene Liste wählen, während My lockers leer ist, wird der Kunde gebeten, den Automaten manuell einzugeben.

My lockers: wird verwendet, wenn Locker selection auf Ihre Liste gesetzt ist. Ein Automat pro Zeile: CODE | Name | Address | Postal code | City. Code und Name sind Pflichtangaben. Ungültige und doppelte Zeilen werden beim Speichern gemeldet.

Correos-CityPaq-Liste (API) (nur bei Verwendung der Correos-CityPaq-Liste)

Der Abschnitt enthält einen Link zur „terminals“-API-Seite im Correos-Entwicklerportal. Gelesen wird nur die Automatenliste. Preise kommen immer aus der Preistabelle.

API client ID: die client_id Ihrer Anwendung im Correos-Entwicklerportal.

API client secret: das client_secret Ihrer Anwendung im Correos-Entwicklerportal.

Wenn Sie die Zugangsdaten oder die Automatenauswahl ändern, werden die zwischengespeicherten Automatenlisten gelöscht.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet CityPaq für jede spanische Adresse an, auch wenn keine Versandzone diese Methode enthält. Aus (empfohlen) bedeutet, dass sie dort angeboten wird, wo Sie sie einer Versandzone hinzugefügt haben.

Erweitert

Debug log: schreibt Debug-Zeilen nach WooCommerce > Status > Logs, Quelle vfd-correos-citypaq. Correos-API-Fehler werden immer protokolliert, auch wenn dies aus ist. Zugangsdaten und personenbezogene Daten werden nie protokolliert.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins seine Einstellungen und Zonenmethoden. Das Deaktivieren des Plugins löscht nie etwas. In Bestellungen gespeicherte Automaten bleiben erhalten.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse in Spanien eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft das Warenkorbgewicht, den Mindestbestellwert und die ausgeschlossenen Versandklassen, ermittelt die Preiszeile für Spanien (oder die *-Zeile) und die Paketgröße und zeigt den Preis an. Gilt der kostenlose Versand, beträgt der Preis 0.

Wenn der Kunde CityPaq auswählt, erscheint das Automatenfeld unter der Methode. Die Bestellung kann ohne gültigen Automaten nicht abgeschlossen werden. Das wird auch serverseitig geprüft, ebenso bei Bestellungen über den Warenkorb- und Kassen-Block. Bei der Correos-Liste wird ein Automatencode nur akzeptiert, wenn Correos ihn diesem Kunden angeboten hat, und Name und Adresse werden von Correos übernommen. Die Anzahl der Postleitzahlsuchen pro Kundensitzung ist begrenzt. Ist das Limit erreicht, gibt der Kunde den Automaten manuell ein.

Eine Correos-Liste wird 12 Stunden pro Postleitzahl zwischengespeichert. Eine fehlgeschlagene Anfrage wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf Correos warten muss. Das API-Timeout beträgt 12 Sekunden. Der Kunde sieht nie den technischen Fehler, nur eine kurze Meldung und das manuelle Feld.

Die Methode funktioniert in der klassischen Kasse und im Warenkorb- und Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin ruft keine Live-Tarife von Correos ab, zeigt keine Karte an, meldet keine Sendungen vorab an, druckt keine Etiketten, bestellt keine Abholungen und verfolgt keine Pakete. Legen Sie die Sendung in Ihrem Correos-Konto mit dem in der Bestellung gespeicherten Automaten an.

Abholstellen

Der gewählte Automat wird in der Bestellung gespeichert. Er wird in der Bestellverwaltung unter der Lieferadresse, auf der Bestellbestätigungsseite, unter My account > Orders und in allen Bestell-E-Mails (HTML und Nur-Text) als CityPaq locker angezeigt.

In der Bestellverwaltung können Sie den Automaten im Feld Change CityPaq locker ändern: Wählen Sie einen anderen Automaten aus Ihrer Liste oder geben Sie einen neuen Code oder eine neue Adresse ein. Bei der Correos-Liste wird ein eingegebener Automatencode bei Correos nachgeschlagen. Lassen Sie das Feld leer, um den aktuellen Automaten beizubehalten. Jede Änderung fügt eine Bestellnotiz hinzu.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Correos CityPaq. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich 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 gilt 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 Correos CityPaq Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Eine Erinnerung erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, doch für Updates und Support ist eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Correos CityPaq erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Adresse in Spanien liegt und die Methode der passenden Versandzone hinzugefügt ist (oder Ignore shipping zones aktiviert ist). Prüfen Sie, ob die Preistabelle eine Zeile für Spanien oder eine *-Zeile hat und ob der Warenkorb innerhalb der Gewichtsgrenzen, des Minimum order amount und der Excluded shipping classes liegt.

Kunden müssen den Automaten eingeben, obwohl die Correos-Liste gewählt ist: prüfen Sie, ob API client ID und API client secret ausgefüllt sind, und sehen Sie sich die Warnung über den Einstellungen an. Sie zeigt den letzten Correos-API-Fehler. HTTP 401/403 bedeutet, dass Correos die Zugangsdaten abgelehnt hat: Prüfen Sie diese und ob Ihre Anwendung Zugriff auf die „terminals“-API hat. Nach einem Fehler erfolgt der nächste Versuch nach 10 Minuten.

Keine Automaten für eine Postleitzahl: Correos hat für diese Postleitzahl, ihr Gebiet oder ihre Provinz keinen aktiven Automaten gefunden. Der Kunde kann nach einer anderen Postleitzahl suchen oder den im CityPaq-Finder von Correos gefundenen Automaten eingeben.

Die Auswahlliste „My lockers“ erscheint nicht: My lockers ist leer oder die Zeilen sind ungültig. Jede Zeile braucht mindestens CODE | Name.

Wo Kunden den Automatencode finden: im CityPaq-Finder von Correos, der unter dem Automatenfeld verlinkt ist.

Entwicklerhinweise: Der Automat wird in den Bestellmetadaten _vfd_cpq_locker (überall angezeigter Text) und _vfd_cpq_locker_id (Automatencode, wenn aus der Correos-Liste oder Ihrer Liste gewählt) gespeichert. Das Plugin verwendet die Produktions-„terminals“-API von Correos. Für diese API ist keine Sandbox dokumentiert.

Der Lizenzbereich zeigt einen Fehler: folgen Sie der Meldung im Bereich. Wenn der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet wird, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Wenn sich die Adresse der Website geändert hat, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Wenn der Lizenzserver nicht erreicht werden kann, 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, ebenso die zwischengespeicherten Correos-Automatenlisten und der letzte API-Fehler. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Automaten werden nie gelöscht, und bestehende Bestellungen behalten ihre Versandpositionen.

Correos und CityPaq sind Marken ihrer jeweiligen Inhaber. Dieses Plugin ist weder mit Correos verbunden noch wird es von Correos unterstützt.