FAQ Kategorie: Administration

Tracking – Beispiele

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

Rückgabewerte

Die SOAP Schnittstelle liefert Ihnen verschiedene Rückgabewerte.

response

0 = nicht erfolgreich
1 = erfolgreich

Bei responseCode 0 wird der Rückgabewert wie folgt aufgebaut.

Ziffer 1
1 – important
2 – missing parameter
3 – invalid parameter
4 – notice

Ziffer 2-6
Parameter Code (siehe Mögliche Rückgabewerte)

Die Ziffern 2-6 des Rückgabewertes kodieren jeweils einen Key, welcher ein bestimmtes Datenfeld (z.B. Bestellmenge) oder einen Sachverhalt (Bestellung) beschreibt.

Beschreibt der Key ein Datenfeld, wird zusätzlich entschieden, ob es sich beim Fehlen dieses Wertes um ein Abbruchkriterium handelt (required), der Wert bestimmte vordefinierte Werte annimmt (values) oder bei einem fehlenden/fehlerhaften Wert ein Default-Wert gesetzt wird (default).

 

Mögliche Rückgabewerte

Message codeKeywordValuesRequiredDefault
00000Payment method failed!
20001aspect_ratiolandscape format | panel format1
20002availability_type1 | 201
20003customer_copy5 | 10 | 150
20004customer_item_id0
20006item_id1
...
30002customer_number1
30003data_source_host0
30006data_source_port0
30007data_transmissionftp | download |
e-mail | upload		1download
30008delivery_typedelivery |
self collection		0
30010order_name0
30011order_quantity1
30013payment_method0
30015shipping_type0
30016partial_quantity1
30017OrderCommitSucessful0
30018OrderCommitFailed0
30019email1
30020password1
40005address_id1
40014address_data_search0
40015address_ambiguous0
40016address_new_successful0
40017address_new_failed0
40018party_group_code_failed0
40019address_id_search0

Tracking

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.

Was kann ich tun bei einer Fehlermeldung?

Error on request interface: Could not connect to host

Die Variable „stream_context“ muss nur im Sample- bzw. Dev-System gesetzt werden, in der Liveumgebung muss diese entfallen.
In der Variablen „local_cert“ wird das verwendete Zertifikat für das Sample-, Dev- oder Produktivsystem angegeben.

Error on request interface: Not Extended

Der Pfad zu dem angegebenen Zertifikat ist nicht richtig.

Zertifikate (SOAP)

Für die Nutzung der SOAP Schnittstelle erhalten Sie drei eigenständige Zertifikate zur Kommunikation.
Diese Zertifikate werden sowohl für die Kommunikation mit dem Produktkatalog als auch zur Auftragsanlage verwendet.

sample_cert
Zertifikat zum Zugang der Testumgebung:
client certificate (zum Download klicken)

Die Zertifikate für Ihr indivituelles Test- (dev_cert) und Produktiv-System(prod_cert) erhalten Sie nach Vertragsunterzeichnung von uns per Mail zugesendet.

dev_cert
soap service = http://interface.unitedprint.com.onts.print24test.de/
Es ist ein Testserver mit demselben Katalog wie Ihr Produktivsystem. Sie können Aufträge ohne Konsequenzen testen.

Hinweis
Dieses Testsystem wird jede Nacht durch Ihre Online Produktkonfigurationen überschrieben.
Achtung
Verwechseln Sie Ihr dev_cert nicht mit öffentliche sample_cert unserer Beispielseite

prod_cert
soap service = interface.unitedprint.com
Bestellungen auf diesem System, werden im Unitedprint Produktivsystem als Auftrag erfasst inkl. der dazugehörigen Buchung.

Sollte es zu einer versehentlichen Bestellung kommen, informieren sie umgehend den print24 Support, um den Auftrag kostenfrei zu stornieren.

Hinweis
Nutzen Sie unseren Service von Montag-Freitag von 8-18 Uhr.
ServiceCall 0351/79550650
Senden Sie uns auch jederzeit Ihre Fragen oder Wünsche per E-Mail an support@print24.de.

Aufbau der SOAP-Verbindung (SOAP Service)

Das SOAP Array ist wie nachfolgend beschrieben aufgebaut.

$options = array(
’soap_version‘ => SOAP_1_1,’exceptions‘ => true,
‚trace‘ => 1,
‚cache_wsdl‘ => WSDL_CACHE_NONE,
‚local_cert‘ => ‚C:/xampp/htdocs/js/Certs/sample.cert‘,
‚charset‘ => ‚utf8′,
’stream_context‘ => stream_context_create([’ssl‘ => [‚verify_peer‘ => false, ‚verify_peer_name‘ => false, ‚allow_self_signed‘ => true]])
);

Hinweis
Die Variable „stream_context“ muss nur im Sample- bzw. Dev-System gesetzt werden. In der Liveumgebung muss diese entfallen.

In der Variablen „local_cert“ wird das verwendete Zertifikat für das Sample-, Dev- oder Produktiv-System angegeben.

In der Variable $soap_service wird der Webdienst angegeben.

Sample und Dev
http://interface.unitedprint.com.onts.print24test.de/wsdl2.1

Produktiv
http://interface.unitedprint.com/wsdl2.1

Anmeldeinformationen der SOAP-Verbindung (SOAP Client)

Bei allen Beispielskripten müssen die Inhalte der Pflichtfelder für password, customerNumber und portalName mit den Ihnen von UP zugesandten Werten ersetzt werden.

$args -> accountInformation -> password = ‚pwd‘;
$args -> accountInformation -> customerNumber = 123456789;
$args -> accountInformation -> portalName = ‚portal‘;
$args -> accountInformation -> languageCode = ‚de‘;
$args -> accountInformation -> countryCode = ‚DE‘;