ORLEN Paczka API
Globe Pickup Points lässt sich mit ORLEN Paczka verbinden, einem polnischen Paketdienst, der an eigene Abholpunkte und Paketautomaten liefert. Mit dieser Integration können Sie:
- Bestellungen direkt aus Shopify an ORLEN Paczka exportieren
- Versandlabels direkt in Shopify drucken
- An Abholpunkte und Paketautomaten von ORLEN Paczka in Polen liefern
- Pakete auf der Sendungsverfolgungsseite von ORLEN Paczka verfolgen
ORLEN-Paczka-API-Integration aktivieren
Abschnitt betitelt „ORLEN-Paczka-API-Integration aktivieren“Sie benötigen ein Konto bei ORLEN Paczka mit unterschriebenem Vertrag: Von einem PREPAID-Konto lassen sich keine Pakete versenden.
- Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und navigieren Sie zu Versandetiketten. Klicken Sie auf Spediteurintegration hinzufügen und wählen Sie ORLEN Paczka.
- Geben Sie Ihre Partner ID und Ihren Partner Key ein. ORLEN Paczka sendet beides per E-Mail, sobald Ihr Vertrag aktiviert ist. Falls Sie sie nicht haben, fragen Sie Ihren Ansprechpartner bei ORLEN Paczka. Der Partner Key ist identisch mit Ihrem WebTrucker-Passwort. Wenn Sie das Passwort in WebTrucker ändern, ändern Sie es also auch in Globe.
- Wählen Sie die Umgebung: Produktion für echte Pakete oder Entwicklung für die Test-API von ORLEN Paczka.
- Füllen Sie die Absenderdaten aus: Firmenname des Absenders, Straße des Absenders, Hausnummer des Absenders, Stadt des Absenders, PLZ des Absenders, Telefon des Absenders und E-Mail des Absenders. Die Absenderadresse wird auf jedes Label gedruckt.
- PLZ des Absenders ist eine fünfstellige polnische Postleitzahl (
NN-NNN, der Bindestrich ist optional). - Telefon des Absenders ist eine polnische Nummer mit 9 Ziffern, mit oder ohne
+48. - Wohnungsnummer des Absenders ist optional. Sie wird nach der Hausnummer gedruckt (
12/4) und fasst bis zu 10 Zeichen. - Längere Werte werden gekürzt: der Firmenname auf 70 Zeichen, Straße und Ort auf 30 und die Hausnummer auf 10.
- PLZ des Absenders ist eine fünfstellige polnische Postleitzahl (
- Konfigurieren Sie nach Bedarf die Fulfillment- und Tagging-Optionen:
- Bestellungen automatisch erfüllen: Nie, Ja, senden Sie eine E-Mail mit der Sendungsverfolgungsnummer oder Ja, senden Sie keine E-Mail. Wenn die Option aktiv ist, wird nach dem Export das Fulfillment mit der Paketnummer als Sendungsverfolgungsnummer, ORLEN Paczka als Spediteur und einem Link zur Sendungsverfolgungsseite angelegt.
- Bestellungen automatisch mit Sendungsverfolgungsnummer markieren fügt die Paketnummer als Tag zur Bestellung hinzu.
- Benutzerdefiniertes Tag nach dem Export und Benutzerdefiniertes Tag nach dem Drucken fügen nach jedem erfolgreichen Export bzw. Druck Ihr eigenes Tag hinzu.
- Ordnen Sie unter Versandmethoden Ihre Abholpunkt-Versandmethoden den Paketgrößen von ORLEN Paczka zu. Sie können die Größe für jede Bestellung beim Erstellen des Labels ändern.
Bestellungen exportieren und Labels drucken
Abschnitt betitelt „Bestellungen exportieren und Labels drucken“Sie können Bestellungen direkt aus Shopify an ORLEN Paczka exportieren und Versandlabels drucken, einzeln oder im Stapel. Zum Label-Workflow selbst siehe Versandlabels erstellen.
Der Export einer Bestellung erstellt ein Paket bei ORLEN Paczka. Die Paketnummer dient als Sendungsverfolgungsnummer. Die Sendungsverfolgung läuft über https://www.orlenpaczka.pl/sledz-paczke/?numer=<parcel number>. Die Shopify-Bestellnummer wird auf jedes Label gedruckt.
Labels werden bei jedem Druck im gewählten Format von ORLEN Paczka heruntergeladen, sodass Sie ein Label später erneut drucken können.
Die Integration überträgt keine Zustellstatus zurück an Shopify.
Paketgrößen
Abschnitt betitelt „Paketgrößen“Wählen Sie beim Zuordnen einer Versandmethode oder beim Erstellen eines Labels die Paketgröße, die zum Paket passt:
| Größe | Bezeichnung in Globe |
|---|---|
| S | S (8 x 38 x 60 cm) |
| M | M (19 x 38 x 60 cm) |
| L | L (41 x 38 x 60 cm) |
Jede Größe nimmt Pakete bis 20 kg an. Globe prüft das Sendungsgewicht und exportiert keine Bestellung über 20 kg.
Nur Abholpunkte und Paketautomaten
Abschnitt betitelt „Nur Abholpunkte und Paketautomaten“ORLEN Paczka liefert nur an eigene Abholpunkte und Paketautomaten. Eine Zustellung an die Adresse gibt es nicht. Jede Bestellung braucht einen Abholpunkt von ORLEN Paczka, den der Kunde im Checkout wählt. Wie Sie die Punkte anbieten, lesen Sie unter Abholpunkt-Spediteure hinzufügen.
Globe übermittelt den Punkt mit seiner numerischen Punkt-ID von ORLEN Paczka im universellen Codeformat XX-<point ID>-00-00. ORLEN Paczka ordnet diesen Code dem Punkt auch dann zu, wenn sich der vollständige Code des Punkts (zum Beispiel WS-116263-C3-01) geändert hat.
Eine Bestellung ohne Punkt von ORLEN Paczka, auch eine mit einem Punkt aus dem Netz eines anderen Spediteurs, wird nicht exportiert.
Nachnahme (COD)
Abschnitt betitelt „Nachnahme (COD)“ORLEN Paczka unterstützt keine Nachnahme. ORLEN Paczka hat die Nachnahme am 2. Januar 2025 abgeschaltet, und Globe übermittelt nie einen Nachnahmebetrag. Das Label-Panel markiert eine Bestellung mit Nachnahmebetrag unter Vor dem Export prüfen, und der Export lehnt sie ab, weil das Paket sonst ausgehändigt würde, ohne dass das Geld eingezogen wird. Setzen Sie den Nachnahmebetrag im Label-Panel auf 0 oder versenden Sie die Bestellung mit einem anderen Spediteur.
Eine Versicherung gibt es ebenfalls nicht: ORLEN Paczka hat sie am 4. Dezember 2024 abgeschaltet, und Globe übermittelt weder eine Versicherung noch einen Paketwert.
Labeldruck
Abschnitt betitelt „Labeldruck“Labels von ORLEN Paczka können in den folgenden Formaten gedruckt werden:
| Format | Positionen pro Bogen |
|---|---|
| 10x14 cm | 1 |
| 10x10 cm | 1 |
10x14 cm ist der Standard. Das Format passt auf A6-Bögen und auf Thermolabels mit 100x150 mm. Ein A4-Format gibt es nicht. Den Standard können Sie unter Standard-Druckoption in den Einstellungen des Spediteurkontos ändern.
Labels für mehrere Bestellungen werden in einem PDF zusammengefasst. Ein Paket, das sich nicht drucken lässt, zum Beispiel weil es storniert wurde, wird ausgelassen, und die übrigen Labels werden trotzdem gedruckt.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“| Problem | Lösung |
|---|---|
ORLEN Paczka Partner ID and Partner Key are not set | Tragen Sie beides in den Einstellungen des Spediteurkontos ein. |
ORLEN Paczka sender address is incomplete | Die Meldung nennt die fehlenden oder ungültigen Werte. Keine Bestellung des Stapels wird exportiert, bis Sie sie in den Einstellungen des Spediteurkontos korrigiert haben. PLZ des Absenders braucht fünf Ziffern und Telefon des Absenders eine polnische Nummer mit 9 Ziffern. |
Order … has no ORLEN Paczka pickup point | Die Bestellung hat keinen Abholpunkt, oder ihr Punkt gehört zum Netz eines anderen Spediteurs. Prüfen Sie den Abholpunkt der Bestellung (siehe wo er gespeichert ist), bitten Sie den Kunden um einen Punkt von ORLEN Paczka oder wählen Sie selbst einen, und exportieren Sie dann erneut. |
ORLEN Paczka has no cash on delivery | Setzen Sie den Nachnahmebetrag im Label-Panel auf 0 oder verwenden Sie einen anderen Spediteur. Siehe Nachnahme (COD). |
ORLEN Paczka takes parcels up to 20 kg in every size | Ist das Gewicht falsch, korrigieren Sie das Sendungsgewicht (kg) im Label-Panel. Andernfalls versenden Sie die Bestellung mit einem anderen Spediteur. |
ORLEN Paczka needs the recipient's Polish phone number (9 digits) | ORLEN Paczka sendet die Abholbenachrichtigung an eine polnische Telefonnummer. Ergänzen Sie die polnische Nummer des Kunden (9 Ziffern, mit oder ohne +48) in der Lieferadresse der Bestellung und exportieren Sie erneut. |
this account has no signed agreement (PREPAID) | Von einem Konto bei ORLEN Paczka ohne unterschriebenen Vertrag lassen sich keine Pakete versenden. Wenden Sie sich an Ihren Ansprechpartner bei ORLEN Paczka. Globe versucht, das Paket zu stornieren, das ORLEN Paczka für die Bestellung erstellt hat. |
… the parcel may already exist | ORLEN Paczka hat das Paket nicht bestätigt, zum Beispiel nach einer Zeitüberschreitung oder einem Verbindungsabbruch, kann es aber erstellt haben. Globe versucht es nicht von selbst erneut. Prüfen Sie Ihr Konto bei ORLEN Paczka, bevor Sie die Bestellung erneut exportieren. |
ORLEN Paczka created parcel … but Globe could not save it | Das Paket existiert bei ORLEN Paczka, Globe kann sein Label aber nicht drucken, und die Bestellung wurde weder erfüllt noch getaggt. Exportieren Sie die Bestellung nicht erneut, sonst erstellt ORLEN Paczka ein zweites Paket. Rufen Sie das Label bei ORLEN Paczka ab oder lassen Sie das Paket zuerst von ORLEN Paczka stornieren. |
ORLEN Paczka: mit einem anderen Grund | ORLEN Paczka hat das Paket abgelehnt, und der Text nach dem Doppelpunkt ist der Grund. Beheben Sie die Ursache und exportieren Sie die Bestellung erneut. |
| Labels werden nicht gedruckt | ORLEN Paczka hat kein Label geliefert, zum Beispiel wegen eines Problems mit den Zugangsdaten oder eines vorübergehenden Fehlers auf seiner Seite. Prüfen Sie Partner ID und Partner Key oder drucken Sie später erneut. |
| Im PDF fehlt ein Label | Das Paket wurde storniert, ORLEN Paczka findet es nicht, oder es gehört zu einem anderen Konto bei ORLEN Paczka. Globe lässt es aus und druckt die übrigen Labels. |