Bei der standardmäßigen UPI Tracking Funktion handelt es sich um einen einfachen HTTP callback.
Zu definierten Ereignissen im Erstellungsprozess werden Statusänderungen mit definierbaren Parametern an eine durch sie bekanntgegebene URL übermittelt.
Nachfolgend zwei Beispiele für eine Statusänderung (zu „Cancellation“) anhand der order_number 999999
sowie der customer_number 1234567.
HTTP JSON callback
https://your_url.de/?execute=join/unitedprint.job/state-set&order_number=9999999&item_group_name=flyer&customer_item_name=myfirst order&actual_state=order_stati_7000_4&shipment_number=1&customer_number=1234567
HTTP callback
https://your_url.de/tracking.php?order_number=999999&item_group_name=flyer&customer_item_name=myfirst order&actual_state=order_stati_7000_4&shipment_number=1&customer_number=1234567
Dieser PHP Aufruf schreibt ein „tracking.log“ in das gleiche Verzeichnis mit den zuvor durch Sie definierten Parametern.
Tracking.php
Der Status einer Bestellung wird nicht über die Schnittstelle abgefragt. Stattdessen werden über die Schnittstelle Informationen an den Partner zurückgegeben.
Bei Statusänderungen im UP-System kann ein Skript beim Partner über einen so genannten “http callback“ aufgerufen werden. Dies ist für jede relevante Statusänderung möglich.
Mögliche Statusänderungen sind
- Auftragseingang
- Datenbearbeitung
- Pooling
- Verarbeitung
- Versandbereitstellung
- Versand
- Stornierung
Für jedes Skript ist die Übertragung unterschiedlicher Werte möglich.
Ausgewählt werden können
- Allgemeine Informationen
- Auftragsnummer
- Positionsinformationen
- Status
- Lieferdatum
- Positionsnummer
- Lieferinformationen der Position
- Lieferdienst (Carrier)
- Trackingnummer
- Teilmenge
Rückgabewerte/Mapping Lieferdienst (Carrier Service) [carrier_service_id]
- 2 DPD (www.dpd.com)
- 26 DHL Express National (www.dhl.de)
- 27 DHL Express International
- 31 Schenker (www.schenker.com)
- 35 Schenker (www.schenker.com)
- 49 DPD (www.dpd.com)
- 50 DPD (www.dpd.com)
- 52 GEL (www.gel-express.de)
- 77 DHL Paket
- 76 DHL Economy Select
- 82 FedEx Regional Economy (www.fedex.com)
- 83 FedEx International Economy (www.fedex.com)
- 84 FedEx International Prio Express (www.fedex.com)
- 85 FedEx First
- 86 FedEx Priority
- 87 FedEx Priority Express
- 88 DPD Classic
Rückgabewerte/Mapping Statuswerte
- order_stati_1000_4 Auftragseingang
- order_stati_1500_4 Datenkontrolle
- order_stati_1600_4 Bearbeitungsfreigabe
- order_stati_1750_4 Datenbearbeitung
- order_stati_2000_4 Pooling
- order_stati_3000_4 Vorstufe
- order_stati_3400_4 Plotting
- order_stati_3600_4 Stamping
- order_stati_3700_4 Plating
- order_stati_4000_4 Druck
- order_stati_5000_4 Verarbeitung
- order_stati_5400_4 Versandbereitstellung
- order_stati_5800_4 Versandstopp
- order_stati_6000_4 Versand
- order_stati_7000_4 Stornierung
UP muss die Berechtigung zur Übermittlung der Trackinginformationen explezit für Sie freischalten.
Dazu ist es nötig, uns eine Callback URL mitzuteilen.
Tracking – Beispiele finden Sie hier.