Poczta Polska Integration (eNadawca)

Das Modul Poczta Polska verbindet WooCommerce-Bestellungen mit der Sendungsverfolgung von Poczta Polska. Sie tragen die Sendungsnummer in der Bestellung ein, und das Plugin erzeugt daraus den emonitoring-Link und holt den aktuellen Status des Versanddienstleisters in die Bestellansicht, auf die Bestellseite des Kunden und in die Versand-E-Mails.

Konfiguration

Die Zugangsdaten für Poczta Polska werden in der Option polski_pro_shipping gespeichert und über den PRO-REST-Endpunkt polski-pro/v1/settings geschrieben. Eine eigene Versandseite im WP-Admin ist geplant, aber noch nicht ausgeliefert, daher werden die Werte heute über diesen Endpunkt oder direkt in der Option gesetzt.

Schlüssel	Beschreibung
`poczta_enabled`	Aktiviert den Anbieter Poczta Polska
`poczta_login`	Login für das eNadawca-System
`poczta_password`	Passwort für das eNadawca-System

Die Zugangsdaten erhalten Sie durch Registrierung im eNadawca-System unter poczta-polska.pl.

Die Option nimmt zusätzlich poczta_environment, poczta_default_service und poczta_cod_bank_account entgegen. In dieser Version liest sie nichts aus, sie sind für den nicht veröffentlichten Etiketten-Code reserviert, um den es weiter unten im Abschnitt Etiketten und Paketautomaten geht.

Der Anbieter gilt erst dann als verfügbar, wenn poczta_enabled aktiv ist und Login und Passwort ausgefüllt sind. Die emonitoring-Abfrage selbst ist eine öffentliche Anfrage, das Plugin führt sie jedoch erst aus, wenn die Zugangsdaten hinterlegt sind.

Sendungsnummer eintragen

Öffnen Sie eine Bestellung unter WooCommerce > Orders
Suchen Sie unterhalb der Lieferadresse den Bereich Shipment Tracking
Wählen Sie bei Carrier den Eintrag Poczta Polska
Tragen Sie die Sendungsnummer in Tracking number ein
Lassen Sie Tracking URL leer, damit der Link erzeugt wird, oder tragen Sie einen eigenen Link ein, um ihn zu überschreiben
Aktualisieren Sie die Bestellung

Der erzeugte Link hat dieses Format:

https://emonitoring.poczta-polska.pl/?numer={number}

Live-Tracking

Sobald die Bestellung einen Versanddienstleister und eine Nummer hat, zeigt der Bereich Shipment Tracking eine Live preview mit dem Status des Dienstleisters und der Sendungshistorie aus dem emonitoring-Dienst. Die Antwort wird 10 Minuten zwischengespeichert, damit wiederholtes Öffnen der Bestellung nicht bei jedem Aufruf eine Abfrage an Poczta Polska auslöst.

Refresh live tracking leert diesen Zwischenspeicher für die Bestellung und lädt die Ansicht mit einer frischen Abfrage neu. Nutzen Sie die Schaltfläche, wenn sich das Paket gerade bewegt hat und der Bereich noch das vorherige Ereignis zeigt.

Wo die Sendungsverfolgung erscheint

Ort	Was angezeigt wird
Bestellliste	Eine Spalte Tracking mit Dienstleister und Nummer
Bestellansicht	Der Bereich Shipment Tracking mit Live-Status, Historie und Aktualisieren-Schaltfläche
Mein Konto > Bestellungen	Die Aktion Track shipment in der Bestellzeile
Bestelldetails und Kunden-E-Mails	Ein Tracking-Kasten mit Status, Dienstleister, Nummer und der Schaltfläche Track shipment

Das Fulfillment-Modul ergänzt die Bestellliste außerdem um die Massenaktionen Packed, Shipped und Delivered, über die der Status einer Poczta-Polska-Sendung gesteuert wird.

Etiketten und Paketautomaten

Die Etikettenerstellung und die Suche nach Paketautomaten sind programmiert, aber nicht angebunden. PocztaPolskaProvider::generateLabel() und die Suche nach Abholpunkten liegen im Code, doch nichts im WP-Admin oder an der Kasse ruft sie auf. Es gibt daher keine Schaltfläche zum Erstellen von Etiketten, keine Massenaktion und keinen Etikettendownload, und die Sendungsnummer entsteht in eNadawca (oder einem anderen Werkzeug von Poczta Polska) und wird von Hand in die Bestellung eingetragen.

Technische Voraussetzungen

Das Live-Tracking nutzt gewöhnliche HTTPS-Anfragen, für den heutigen Funktionsumfang des Moduls ist also keine zusätzliche PHP-Erweiterung nötig. Die PHP-Erweiterung SOAP (ext-soap) würde erst der Etiketten-Code benötigen, den nichts aufruft. Prüfen Sie, ob sie aktiv ist:

phpinfo(); // Suchen Sie nach dem Abschnitt "soap"

Die meisten PHP-Hosting-Anbieter haben SOAP standardmäßig aktiviert.