FAQ

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)

Archiv

 

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.

Kategorie: Administration
Schlagwort: Zertifikat

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.

Kategorie: Administration
Schlagwort: Schnittstelle

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

Kategorie: Administration
Schlagwort: WSDL

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
Kategorie: Administration
Schlagwort: Login

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.

Kategorie: Administration
Schlagwort: Fehlermeldung

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

Kategorie: Administration
Schlagwort: 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.

Kategorie: Administration
Schlagwort: Tracking

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
Kategorie: Administration
Schlagwort: Fehlermeldung

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.

Kategorie: Administration
Schlagwort: Plug-in

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

Kategorie: Administration
Schlagwort: Soap Service

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

Kategorie: Administration
Schlagwort: Soap Client

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.

Kategorie: Allgemein

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.

Kategorie: Allgemein

Mit dem USS Connect-Dienst „Catalogue“ haben Sie die Möglichkeit, in Echtzeit verfügbare Produkte, Produktoptionen und Preise abzufragen und diese Informationen in Ihrem Frontend zu verwenden.

Kategorie: Allgemein

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.

Kategorie: Auftrag

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

Kategorie: Auftrag
Schlagwort: Übertragung

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.

Kategorie: Auftrag

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

Kategorie: Auftrag

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

Kategorie: Auftrag

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“.

Kategorie: Auftrag
Schlagwort: Freiform

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

Kategorie: Auftrag
Schlagwort: Downlaod

Bei der Auftragsanlage (Create order) kann es erfahrungsgemäß zu Antwortzeiten > 300 Sekunden kommen.

Stellen Sie deshalb Ihren Timeout für die Response auf 360 Sekunden

Kategorie: Auftrag

Produkt (12)

Wenn ein aktuell gespeichertes Produkt nicht angezeigt wird, obwohl Sie eine Artikel ID bekommen haben, gab es einen Fehler bei der Speicherung.

Mögliche Ursache: Eine oder mehrere Optionen/Produktparameter wurden nicht korrekt übergeben.

Kategorie: Produkt
Schlagwort: Artikel

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.

Kategorie: Produkt
Tags: Artikel, Produkte

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.

Kategorie: Produkt
Schlagwort: Produktkatalog

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.

Kategorie: Produkt
Schlagwort: Produkte

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.

Kategorie: Produkt
Schlagwort: Produkte

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
Kategorie: Produkt

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

Kategorie: Produkt
Tags: Auftrag, Code

Hier werden die gespeicherten Produkte des Katalogs zusammen mit deren Gruppenzuordnung aufgelistet.

Beispiel
http://interface.unitedprint.com/ws2/catalogueList.php

Kategorie: Produkt
Schlagwort: Produkte

Ü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();
}

Kategorie: Produkt
Schlagwort: Löschen

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

Kategorie: Produkt

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.

Beispiel-Code

Kategorie: Produkt

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.

Kategorie: Produkt
Schlagwort: Artikel

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

Kategorie: Zahlung

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.

Kategorie: Zahlung
Tags: Rechnung, Zahlart

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.

Kategorie: Zahlung
Tags: SEPA, Zahlart