InPost integration (Paczkomaty)

Die InPost-Integration deckt die Sendungsverfolgung ab. Sie hinterlegen das ShipX API-Token, tragen die Sendungsnummer in der Bestellung ein, und die Bestellseite zeigt den Live-Status sowie den Ereignisverlauf aus InPost. Die Etikettenerstellung ist geplant, aber heute nicht Teil des Plugins, hier wird also keine Sendung in ShipX angelegt.

Modul aktivieren

Gehen Sie zu Polski > Module und aktivieren Sie Fulfillment. Das Modul ist standardmäßig ausgeschaltet, und solange es aus ist, werden die Tracking-Felder, die Tracking-Spalte und die kundenseitigen Tracking-Blöcke gar nicht erst registriert.

ShipX-Zugangsdaten

Die InPost-Zugangsdaten liegen in der Option polski_pro_shipping:

Schlüssel	Beschreibung
`inpost_enabled`	Muss wahr sein, sonst wird die Live-Abfrage übersprungen
`inpost_api_token`	Autorisierungstoken aus dem InPost Manager Panel (manager.paczkomaty.pl)
`inpost_organization_id`	Wird gespeichert, aber von der Tracking-Abfrage nicht verwendet
`inpost_environment`	Wird gespeichert, aber nicht verwendet. Abfragen gehen immer an den Produktiv-Host von ShipX

Für diese Felder gibt es bisher keine gerenderte Einstellungsseite. Speichern Sie sie über die REST-Route der PRO-Einstellungen:

PUT /wp-json/polski-pro/v1/settings
Content-Type: application/json
X-WP-Nonce: {wp_rest Nonce}

{
  "shipping": {
    "inpost_enabled": true,
    "inpost_api_token": "eyJhbGciOi..."
  }
}

Die Route erfordert die Berechtigung manage_woocommerce. Der gespeicherte Payload ersetzt die gesamte Option polski_pro_shipping, senden Sie daher die Schlüssel Ihrer anderen Versanddienstleister in derselben Anfrage mit, falls diese bereits konfiguriert sind.

Auch WP-CLI funktioniert:

wp option patch update polski_pro_shipping inpost_api_token "eyJhbGciOi..."
wp option patch update polski_pro_shipping inpost_enabled 1

Das Token wird bei jeder ShipX-Anfrage im Header Authorization: Bearer {token} übergeben. Lesezugriff auf das Tracking genügt, Berechtigungen zum Erstellen von Sendungen sind nicht nötig.

Sendungsnummer in der Bestellung

Auf der Bestellbearbeitungsseite bietet der Block Sendungsverfolgung unterhalb der Lieferadresse drei Felder:

Feld	Beschreibung
Träger	InPost, DPD, DHL, Poczta Polska oder Sonstige
Tracking-Nummer	Von Hand eingetragen, zum Beispiel `6230000123456789`
Tracking-URL	Leer lassen, dann wird sie aus Träger und Nummer gebildet

Für InPost lautet der erzeugte Link:

https://inpost.pl/sledzenie-przesylek?number={tracking_number}

Die Felder werden mit der Bestellung gespeichert. Nichts füllt sie automatisch aus, die Nummer stammt von dort, wo Sie die Sendung angelegt haben (InPost Manager, Kurier-App, Lieferschein).

Live-Tracking aktualisieren

Sobald eine Tracking-Nummer oder eine Tracking-URL gespeichert ist, erscheint im selben Block über der Live-Vorschau die Schaltfläche Live-Tracking aktualisieren. Sie löscht die zwischengespeicherte Antwort und lädt die Bestellseite neu, wodurch eine frische Anfrage ausgelöst wird:

GET https://api-shipx-pl.easypack24.net/v1/tracking/{tracking_number}

Die Antwort wird 10 Minuten lang in einem WordPress-Transient zwischengespeichert, sodass wiederholte Aufrufe der Bestellung die API nicht erneut belasten. Die Vorschau zeigt den Trägerstatus, den Namen des Trägers, die Tracking-Nummer, einen Link Sendung verfolgen und bis zu acht der jüngsten Sendungsereignisse mit Datum und Ort.

Es gibt keine geplante Statusabfrage und keine automatische Änderung des Bestellstatus. Live-Daten werden geholt, wenn eine Bestellseite mit abgelaufenem Cache gerendert wird oder wenn Sie die Schaltfläche betätigen.

Wo das Tracking erscheint

Bestellliste - eine Spalte “Verfolgung” mit Träger, Nummer, Live-Status und Track-Link
Bestellbearbeitung - die Felder sowie die oben beschriebene Live-Vorschau
Mein Konto > Bestellungen - eine Zeilenaktion “Sendung verfolgen” und ein Abschnitt “Sendungsverfolgung” in den Bestelldetails
Kunden-E-Mails - derselbe Tracking-Block nach der Bestelltabelle, nur in Kunden-E-Mails, nicht in den Admin-Kopien

Fulfillment-Status

Das Modul registriert drei WooCommerce-Bestellstatus direkt nach “In Bearbeitung”: packed, shipped und delivered. In der Bestellliste stehen sie als Massenaktionen zur Verfügung:

Massenaktion	Ergebnis
Status in “Verpackt” ändern	Bestellung als verpackt markiert, E-Mail “Ihre Bestellung wurde verpackt”
Status in “Versendet” ändern	Bestellung als versendet markiert, E-Mail “Ihre Bestellung wurde versendet”
Status in “Geliefert” ändern	Bestellung als geliefert markiert, E-Mail “Ihre Bestellung wurde geliefert”

Jede E-Mail wiederholt Träger, Tracking-Nummer und Tracking-Link, sofern diese gefüllt sind. Diese Status setzen Sie selbst, sie werden nicht vom InPost-Status gesteuert.

Noch nicht verfügbar

Die Etikettenerstellung ist geplant, aber nicht ausgeliefert. Das Plugin enthält keinen Code, der eine Sendung in ShipX anlegt, deshalb gibt es keine Schaltfläche zum Generieren, Herunterladen oder Drucken von Etiketten, keine Massenaktion für Etiketten, keinen ZIP-Download und keine Einstellung für die Paketgröße. Auch die Paczkomat-Karte an der Kasse und eine eigene InPost-Versandmethode sind nicht umgesetzt, und es existieren keine Filter oder Aktionen polski_pro/inpost/*. Wenn Sie heute eine Paczkomat-Auswahl benötigen, nutzen Sie ein separates Plugin oder ein eigenes Kassenfeld.

Fehlerbehebung

Der Block Sendungsverfolgung erscheint nicht Das Modul Fulfillment ist deaktiviert, oder für die Bestellung ist weder eine Tracking-Nummer noch eine Tracking-URL gespeichert. Live-Vorschau und Aktualisierungsschaltfläche erscheinen erst, wenn eines von beidem vorhanden ist.

Nummer und Link werden angezeigt, aber kein Live-Status inpost_enabled ist falsch oder inpost_api_token ist leer, deshalb gilt der Anbieter als nicht verfügbar und die Abfrage wird übersprungen. Für andere Träger als InPost, DPD, DHL und Poczta Polska wird nur der Link gebildet, es findet gar keine Live-Abfrage statt.

“Live-Tracking aktualisieren” ändert nichts Das Token ist abgelaufen oder ungültig, und die fehlgeschlagene Antwort lässt den Status leer. Prüfen Sie es außerhalb von WordPress: curl -H "Authorization: Bearer {token}" https://api-shipx-pl.easypack24.net/v1/tracking/{number}. Prüfen Sie außerdem, ob die Nummer selbst eine ShipX-Sendungsnummer ist.

Nächste Schritte

Probleme melden: GitHub Issues
ShipX-API-Dokumentation: https://docs.inpost24.com/

Diese Seite dient ausschließlich zu Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.