News
20.01.2024 | Erweiterung API-Funktion getCustomCatalogue
Die Funktion getCustomCatalogue wurde erweitert. Es ist jetzt möglich Preise für mehrere Mengen (bis zu 10) in einer Anfrage abzurufen.
Dazu werden im Parameter quantity mehrere Mengen angegeben.
Beispiel:
quantity=1_quantity|50_quantity|100_quantity
Die Preise werden im XML productList – selectGroupList – optionList im Array optionTranslations zurückgegeben.
Dabei entspricht der Wert im Feld optionName der angefragten Menge. (Im Beispiel 1_quantity oder 50_quantity oder 100_quantity)
Administration (11)
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.
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
| Message code | Keyword | Values | Required | Default |
|---|---|---|---|---|
| 00000 | Payment method failed! | |||
| 20001 | aspect_ratio | landscape format | panel format | 1 | |
| 20002 | availability_type | 1 | 2 | 0 | 1 |
| 20003 | customer_copy | 5 | 10 | 15 | 0 | |
| 20004 | customer_item_id | 0 | ||
| 20006 | item_id | 1 | ||
| ... | ||||
| 30002 | customer_number | 1 | ||
| 30003 | data_source_host | 0 | ||
| 30006 | data_source_port | 0 | ||
| 30007 | data_transmission | ftp | download | e-mail | upload | 1 | download |
| 30008 | delivery_type | delivery | self collection | 0 | |
| 30010 | order_name | 0 | ||
| 30011 | order_quantity | 1 | ||
| 30013 | payment_method | 0 | ||
| 30015 | shipping_type | 0 | ||
| 30016 | partial_quantity | 1 | ||
| 30017 | OrderCommitSucessful | 0 | ||
| 30018 | OrderCommitFailed | 0 | ||
| 30019 | 1 | |||
| 30020 | password | 1 | ||
| 40005 | address_id | 1 | ||
| 40014 | address_data_search | 0 | ||
| 40015 | address_ambiguous | 0 | ||
| 40016 | address_new_successful | 0 | ||
| 40017 | address_new_failed | 0 | ||
| 40018 | party_group_code_failed | 0 | ||
| 40019 | address_id_search | 0 |
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‘;
Allgemein (3)
Voraussetzung für die Nutzung der Schnittstelle ist ein UP Kundenkonto.
Verfügen Sie noch nicht über ein gültiges Kundenkonto, registrieren Sie sich bitte bei einem der von UP angebotenen Portale in Ihrem Land.
Um die nötigen Vertragsunterlagen zu erhalten, senden Sie bitte eine E-Mail an info@unitedprintshopervices.com.
Nach Eingang und Prüfung der vollständigen Unterlagen durch uns, erhalten Sie die notwendigen Zugriffszertifikate innerhalb weniger Tage.
USS Connect ist die SOAP-Schnittstelle von Unitedprint (UP) zur Steuerung von API-Aufrufen (Application Programming Interface).
Von der Preisabfrage, über eine komfortable Produktauswahl und Bestellung bis hin zur Verfolgung des Produktionsfortschritts, kann der gesamte Bestellvorgang über direkte Serviceaufrufe realisiert werden.
Das Interface arbeitet nach dem SOAP-Standard und ist so konzipiert, dass es direkt in ein Warenwirtsschaftssystem bzw. einen Workflow integriert werden kann.
Derzeit stehen diese 4 Module zur Verfügung:
- Verwalten eines persönlichen Produktkataloges
- Preisabfrage und Bestellung
- Verwalten von Kundenprofilen und Adressdaten
- Konfigurieren von Kommunikationskanälen für die Bestellverfolgung (Tracking)
Ihr Kundenkonto muss durch UP für den Schnittstellenbetrieb freigeschaltet werden.
Für den Zugriff auf die Schnittstelle ist außerdem ein SSL-Zertifikat erforderlich.
Auftrag (8)
unitedprint wartet 28 Tage auf den Eingang Ihrer Daten.
Sie werden wie üblich an ausstehende Daten-Uploads erinnert.
Hinweis
Für Sie besteht die Möglichkeit der Datenabholung durch unitedprint.
Teilen Sie uns bei Ihrer Bestellung einfach den Link (FTP/AWS) zu Ihren Daten mit.
Kann ein Auftrag nicht korrekt übertragen werden, prüfen Sie bitte, ob der Parameter validate = 0 korrekt gesetzt wurde?
Mit $args -> validate = 1 wird der Auftrag nicht an UP-System übertragen und keine Auftragsnummer zurückgegeben.
In diesem Fall setzen Sie den Paramter wie folgt. $args -> validate = 0
Sie haben verschiedene Möglichkeiten Testbestellungen auszulösen.
Sample
Testseite = http://interface.unitedprint.com/ws2/catalogue.php
Testserver mit einem Beispiel Katalog.
Sie können Aufträge uneingeschränkt testen.
Test
soap service = http://interface.unitedprint.com.onts.print24test.de/
Testserver mit dem selben Katalog wie Ihr Produktiv-System.
Sie können Aufträge uneingeschränkt testen.
Produktiv
soap service = http://interface.unitedprint.com
Liveserver, Bestellungen werden im UP Produktiv-System als Auftrag erfasst – einschließlich der dazugehörigen Buchung.
Hinweis
Für Testbestellungen, welche nicht produziert werden sollen, wenden Sie sich bitte an den Support.
Dort kann die Stornierung des Aufrags erfolgen.
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.
Bei der Bestellung können auch Sonderformate definiert werden. Dazu wählen Sie den gewünschten Artikel im nächstgrößeren Format und übergeben die Sonderformat-Werte über folgende zusätzliche Parameter im createOrder().
Beispiel
Für einen Flyer im Format 150 x 150 mm ist das nächst größere Format mit 183 x 273 mm auszuwählen.
class specialFormatType {
public $width; // int
public $height; // int
public $formatType; // string
}
class orderDataType {
public $customerProductId; // string
public $orderQuantity; // int
public $aspectRatio; // string
public $shippingType; // string
public $orderName; // string
public $customerCopy; // int
public $customerComment; // string
public $specialFormatValues;
}
$args->orderPositions[0]->orderInformation->specialFormatValues = new specialFormatType();
$args->orderPositions[0]->orderInformation->specialFormatValues->width = 150;
$args->orderPositions[0]->orderInformation->specialFormatValues->height = 150;
$args->orderPositions[0]->orderInformation->specialFormatValues->formatType = ‚special format‚;
Bei der Artikelkonfiguration können auch Sonderfarben ausgewählt werden. Dazu sind Erweiterungen im Code von createOrder() notwendig.
class pairOfValueType {
public $name;
public $value;
}
class orderDataType {
public $customerProductId; // string
public $orderQuantity; // int
public $aspectRatio; // string
public $shippingType; // string
public $orderName; // string
public $customerCopy; // int
public $customerComment; // string
public $specialColorValues;
}
$args->orderPositions[0]->orderInformation->specialColorValues = new pairOfValueType();
$args->orderPositions[0]->orderInformation->specialColorValues->name = ‚farben‘;
Beispiel
# HKS Farbschlüssel
# $args->orderPositions[0]->orderInformation->specialColorValues->value = ’92‘;

Beispiel
# Pantone Farbschlüssel
# $args->orderPositions[0]->orderInformation->specialColorValues->value = ‚295‘;

Mögliche Farbwerte für HKS bzw. PANTONE
var a_sc_names_p = [ ‚137‘,’151′,’1505′,’1585′,’021′,’012′,’382′,’7488′,’032′,’186′,’375′,’376′,’320′,’292′,’293′,’280′,’286′,’288′,’294′,’295′,’Reflex Blue‘,’Gray Cool 3′,’430′,’Gray Cool 10′,’4625′ ];
var a_sc_names_h = [ ’03‘,’04‘,’05‘,’06‘,’07‘,’08‘,’13‘,’14‘,’15‘,’16‘,’17‘,’18‘,’83‘,’93‘,’92‘,’67‘,’66‘,’65‘,’55‘,’52‘,’47‘,’44‘,’43‘,’42‘,’41‘ ];
Bei der Bestellung können auch Freiformen definiert werden. Dazu wählen Sie den gewünschten Artikel im benötigten Format und übergeben die Sonderformat-Werte über folgende zusätzliche Parameter im createOrder().
Beispiel
class specialFormatType {
public $width; // int
public $height; // int
public $formatType; // string
}
class orderDataType {
public $customerProductId; // string
public $orderQuantity; // int
public $aspectRatio; // string
public $shippingType; // string
public $orderName; // string
public $customerCopy; // int
public $customerComment; // string
public $specialFormatValues;
}
$args->orderPositions[0]->orderInformation->specialFormatValues = new specialFormatType();
$args->orderPositions[0]->orderInformation->specialFormatValues->width = 150;
$args->orderPositions[0]->orderInformation->specialFormatValues->height = 150;
$args->orderPositions[0]->orderInformation->specialFormatValues->formatType = ’free_form‘;
Hinweis
Für eine Freiform legen Sie in Ihren Druckdaten bitte einen Vektorpfad an, der die Schnittlinie darstellt. Weisen Sie diesem Pfad eine Volltonfarbe zu, benennen Sie die Sonderfarbe mit „cutting line“ und stellen Sie diese auf „Überdrucken“.
Der Download des Produkt-PDFs findet normalerweise über einen FTP-Server statt.
PDF-Download FTP
$args -> orderPositions[0] -> dataSourceInformation -> dataSourceUser = ‚username‘;
$args -> orderPositions[0] -> dataSourceInformation -> dataSourcePassword = ‚passw0rd‘;
$args -> orderPositions[0] -> dataSourceInformation -> dataSourcePort = 21;
$args -> orderPositions[0] -> dataSourceInformation -> dataSourceHost = ‚ftp://testftp/filename.pdf‘;
$args -> orderPositions[0] -> dataSourceInformation -> dataTransmission = ‚download‘;
Hier werden die Zugangsdaten für den FTP-Server (User, Passwort, Port) und der Name des PDFs angegeben, welches zu UP übertragen werden soll. Im Feld „dataTransmission” muss der Wert “download” stehen.
Der PDF-Download kann alternativ auch über die URL eines Webservers durchgeführt werden. Dazu muss der Zugriff auf das PDF möglich sein.
Die Variablen „dataSourceUser“ , „dataSourcePassword“ und „dataSourcePort“ dürfen nicht leer sein.
PDF-Download URL
$args -> orderPositions[0] -> dataSourceInformation -> dataSourceUser = ‚xxx‘;
$args -> orderPositions[0] -> dataSourceInformation -> dataSourcePassword = ‚yyy‘;
$args -> orderPositions[0] -> dataSourceInformation -> dataSourcePort = 21;
$args -> orderPositions[0] -> dataSourceInformation -> dataSourceHost = ‚ftp://testftp/filename.pdf‘;
$args -> orderPositions[0] -> dataSourceInformation -> dataTransmission = ‚download‘;
Produkt (12)
Können Sie Ihre gespeicherten Produkte nicht mehr finden, kann es daran liegen, dass Sie mit dem DEV-Entwicklungsystem arbeiten.
Diese Testumgebung wird über Nacht immer mit dem Produktiv-System überschrieben.
Wenn Sie Testdaten oder Testbestellungen im Tetsystem anlegen, stehen diese nur am Tag der Anlage auf dem Testsystem zur Verfügung.
Im Produktkatalog werden alle für einen Kunden bestellbaren Produkte gepflegt.
Um ein Produkt bei UP bestellen zu können, muss dieses vorher über die Katalog-Schnittstelle angelegt werden.
Dazu werden alle Eigenschaften des Produkts festgelegt und unter einer Artikelnummer gespeichert.
Diese Artikelnummer kann später zur Auftragsanlage verwendet werden.
Bei der Produktanlage werden diese Produkteigenschaften angezeigt – hier dargestellt für das Beispielprodukt „Flyer“.
- Produkttyp
- Seitenanzahl
- Format
- Ausrichtung
- Papierstärke
- Papier
- Papiereigenschaft
- Druck
- Verarbeitung
- Veredelung
- Art der Veredelung
- Nutung
- Perforation
- Menge
- Lieferart
Wichtig
Die Auswahl der Eigenschaften muss von „oben“ nach „unten“ erfolgen, um so Kombinationen, welche nicht bestellt werden können, ausschließen zu können.
Die in der Hirarchie darüber liegenden Eigenschaften haben somit immer Einfluss darauf, welche Optionen in den Gruppen darunter ausgewählt werden können.
Zur Anlage eines Produkts rufen Sie das folgende Beispielskript auf.
http://interface.unitedprint.com/ws2/catalogue.php
Die einzelnen Produkteigenschaften werden angezeigt und können über Dropdownlisten gewählt werden.
Eine eindeutige Kombination aus allen zur Verfügung stehenden Optionen wird als „Produkt“ gespeichert.
Dieses „Produkt“ wird später bei der Auftragsanlage im Feld orderPositions[$pos] -> orderInformation -> customerProductId angesprochen.
Für die Auftragsanlage im Order Client sind folgende Pflichtfelder definiert.
- environment
- portalName
- countryCode
- languageCode
- partyGroupName
- accountInformation
- customerNumber
- password
- orderInformation
- customerProductId
- orderQuantity
- shippingType
- orderName
- dataSourceInformation
- dataSourceHost
- dataSourceUser
- dataSourcePassword
- dataSourcePort
- dataTransmission
- messageLevel
Bei der Auftragsanlage wird ein zuvor im Produktkatalog angelegtes Produkt zusammen mit den Auftragsdaten, Bestellmenge und Versandart an die Schnittstelle übergeben.
Bestellmenge und Versandart werden in den folgenden Feldern überschrieben:
$order->orderQuantity
$args->orderPositions[0]->orderInformation->orderQuantity
$args->orderPositions[0]->orderInformation->shippingType
Beispiel
http://interface.unitedprint.com/ws2/order.php
Im Beispiel kann der Parameter „validate“ gesetzt werden.
$args -> validate = ($_GET{‚validate‘} == ‚on‘ ? 1 : 0);
$erg = $client -> createOrder($args);
Über diesen Parameter lässt sich ein Auftrag überprüfen.
Bei „validate = 1“ wird kein Auftrag angelegt – es findet nur eine Überprüfung des Auftrags statt, ohne dass dieser bei UP gespeichert wird.
Bei erfolgreicher Prüfung werden das voraussichtliche Lieferdatum, Netto- und Bruttopreis sowie die Währung zurückgegeben.
Mit „validate = 0”
$args -> validate = 0
$erg = $client -> createOrder($args);
wird der Auftrag ins UP-System geschrieben und die Auftragsnummer zurückgegeben.
// begin processing
$args->accountInformation->password = ‚passwort‘;
$args->accountInformation->customerNumber = 1234567;
$args->accountInformation->portalName = ‚print24‘;
$args->accountInformation->languageCode = ‚de‘;
$args->accountInformation->countryCode = ‚DE‘;
Wenn Sie ein Produkt im Katalog ausgewählt haben, können Sie es speichern, um ein bestellbares Produkt zu erstellen. Verwenden Sie für Ihre Bestellung den Namen dieses neu erstellten Produkts.
Für jede Bestellanfrage ist ein Benutzerkonto erforderlich. Das Bestellskript erfordert einen Produktnamen, eine Menge und mindestens eine Lieferadresse. Die Menge und die Versandart können von Ihrem gespeicherten Produkt abweichen. Sie können jede im Katalog vorhandene Menge bestellen.
Das Bestell-Demo-Skript unterstützt nur eine Lieferadresse. Sie können mehrere Lieferadressen verwenden.
Verwenden Sie das Validierungskennzeichen, um Ihre Bestellung zu validieren. Sie können es auch für Preisanfragen verwenden.
Downlaod
order_demo.php
Über die Funktion getCustomProduct() kann die „internalId“ eines gespeicherten Artikels abgefragt werden. Mit der „internalId“ kann im Anschluss ein gespeicherter Artikel gelöscht werden.
Beispiel
$deletearticle = ‚articletodelete‘;
try {
$getItemArgs = new getCustomProductRequestType();
$getItemArgs->environment = $environment;
$getItemArgs->messageLevel = $messageLevel;
$selection = new catalogueSelectionType();
$getItemArgs->selection = $selection;
$getItemArgs->selection->itemIdentifier = $deletearticle;
$product = $client->getCustomProduct($getItemArgs);
$internalId = $product->product->internalId;
} catch(Exception $e) {
echo „Error on request getCustomProduct: “ . $e->getMessage();
}
try {
$changeArgs->writeMode = ‚deactivate‘;
$changeArgs->product = new selectedType();
$changeArgs->product->internalId = $internalId;
$erg = $client->setCustomProduct($changeArgs);
} catch(Exception $e) {
echo „Error on request setCustomerProduct: “ . $e->getMessage();
}
Dieses Beispielskript zeigt, wie Sie mit dem Katalog auf Ihre gespeicherten Produkte zugreifen können.
Damit ist es möglich, detaillierte Informationen für gespeicherte Produkte wie Preis- und Lieferinformationen zu erhalten.
Dieses Skript verwendet die Katalogfunktionen getCatalogueList und getCustomProduct.
Es ist eine schnellere Alternative zu getCustomCatalogue.
Download
catalogueList_demo.php
Sie können mit Ihren eigenen Kundendaten auf den UP Produktkatalog zugreifen.
Laden Sie dazu das nachstehende Beispielskript sowie ein Zertifikat herunter und starten Sie sofort Ihre Kataloganfragen, um Preis- und Lieferinformationen zu erhalten.
Das Skript demonstriert die Katalogfunktion „getCustomCatalogue“.
Das Beispiel-Zertifikat ermöglicht Ihnen dabei nur den Zugriff auf unsere Testumgebung.
Zur Anzeige bzw. Bearbeitung Ihrer gespeicherten Artikel nutzen Sie dieses Beispielskript.
http://interface.unitedprint.com/ws2/catalogueList.php
Dabei werden die von Ihnen gespeicherten Produkte des Katalogs mit der jeweiligen Gruppenzuordnung aufgelistet dargestellt und können weiter bearbeitet werden.
Zahlung (3)
Für die Bezahlung Ihrer automatisierten Aufträge stehen Ihnen die folgenden Zahlungsarten zur Verfügung.
- Vorkasse
- Rechnung*
- PayPal**
- SEPA-Lastschriftverfahren***
- Kreditkarte ****
Anwendung finden diese paymentMethods für den createOrderRequestType.
- Vorkasse = paymentInformation->paymentMethod = ‚ADP‘
- Rechnung = paymentInformation->paymentMethod = ‚INV‘
- PayPal = paymentInformation->paymentMethod = ‚PAY‘;
- SEPA = paymentInformation->paymentMethod = ‚SDB‘;
- Kreditkarte = paymentInformation->paymentMethod = ‚CRC‘;
* setzt ein Mandat für UP voraus
** setzt die Freischalung durch UP voraus
*** nur innerhalb Deutschlands
**** setzt die Freischalung durch UP voraus
Liefert die Funktion „createOrder“ den folgenden Response, wenden Sie sich bitte per E-Mail anf folgende Adresse. connect@unitedprintshopservices.com
important: Payment method failed! Value is: INV
Hinweis:
Ihr UP Kundenkonto ist für die Zahlart Rechnung (Invoice) gesperrt.
Die einfachste Form der Bezahlung an unitedprint ist das SEPA-Lastschriftverfahren.
Im bereits von uns vorbereiteten Formular müssen Sie nur Ihre Bankverbindung eintragen,
unterschreiben und das Original in zweifacher Ausführung per Post an folgende Adresse senden:
unitedprint.com Deutschland GmbH
Friedrich-List-Straße 3
01445 Radebeul
Deutschland
Nach einer Bearbeitungsfrist von 14 Tagen können Sie diese Zahlungsart dann für zukünftige Aufträge nutzen.
Melden Sie sich bitte mit Ihren Benutzerdaten an und Ihre Kundendaten werden für den Lastschriftausdruck komplett übernommen.
Hinweis
Diese Funktion steht ausschließlich Kunden innerhalb Deutschlands zur Verfügung.