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