FAQ

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.

Dies hängt maßgeblich von ihrem verwendeten technologischen Umfeld ab und wie sie die Schnittstelle in ihre Abläufe integrieren möchten.

In der Regel sollte die Integration aber innerhalb weniger Tage abgeschlossen sein.

Beispiele für die USS Connect Web Service Description Language (WSDL) finden Sie unter folgendem Link: http://upi.unitedprint.com

Verwenden Sie zur Anmeldung die Zugangsdaten Ihres UP Kundenkontos

• print24: E-Mail und Passwort
• SOAP API: Kundennummer und Passwort (+Zertifikat)
• REST API: E-Mail und Passwort

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.

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.

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

Zum aktuellen Zeitpunkt kann für USS Connect noch kein Plug-in für Drittanbieter-eCommerce- bzw. Onlineshop-Systeme wie Magento, PrestaShop, SAP usw. bereitgestellt werden.

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

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‘;