News
20.01.2024 | Extension API-Function getCustomCatalogue
The function getCustomCatalogue has been extended. Now it is possible to get multiple Prices (up to 10) in one Request.
Therefore you have to take multiple quantities in the parameter quantity.
Example:
quantity=1_quantity|50_quantity|100_quantity
The prices are return in the respone in productList – selectGroupList – optionList in array optionTranslations.
The value of the field optionName is the requested quantity. (In the example 1_quantity or 50_quantity or 100_quantity)
Order (8)
If an order cannot be transferred correctly, please check whether the parameter validate = 0 was set correctly?
With $ args -> validate = 1 the order is not transferred to the UP system and no order number is returned.
In this case, set the parameter as follows. $ args -> validate = 0
The product PDF is usually downloaded via an FTP server.
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’;
The access data for the FTP server (user, password, port) and the name of the PDF that is to be transferred to UP are specified here. The value “download” must appear in the field “dataTransmission”.
Alternatively, the PDF download can also be carried out via the URL of a web server. To do this, access to the PDF must be possible.
The variables “dataSourceUser” , “dataSourcePassword” and “dataSourcePort” must not be empty.
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’;
You have various options for placing test orders.
Sample
Test page = http://interface.unitedprint.com/ws2/catalogue.php
Test server with an example catalog.
You can test orders without restriction.
Test
soap service = http://interface.unitedprint.com.onts.print24test.de/
Test server with the same catalog as your production system.
You can test orders without restriction.
Produktiv
soap service = http://interface.unitedprint.com
Live serves, orders are recorded in the UP productive system as an order – including the corresponding booking.
Note
For test orders that should not be produced, please contact the support.
The order can be canceled there.
Use our service from Monday to Friday from 8 a.m. to 6 p.m.
ServiceCall 0351/79550650
Send us your questions or requests via e-mail at any time support@print24.de.
Special formats can also be defined when ordering. To do this, select the desired article in the next larger format and transfer the special format values via the following additional parameters in createOrder().
Example
For a flyer with a format of 150 x 150 mm, the next larger format with 183 x 273 mm should be selected.
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‘;
Special colors can also be selected when configuring the item. This requires extensions in the createOrder() code.
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’;
Example
# HKS color key
# $args->orderPositions[0]->orderInformation->specialColorValues->value = ’92’;
Example
# Pantone color key
# $args->orderPositions[0]->orderInformation->specialColorValues->value = ‘295’;
Possible color values for HKS or 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’ ];
Freeforms can also be defined when ordering. To do this, select the desired article in the neccessary format and transfer the special format values via the following additional parameters in createOrder().
Example
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‘;
Note
For Freeform, create a vector path in your printing data, showing the cutting line. Give this path a spot colour, name the special colour “cutting line”, and set it to “Overprint”.
unitedprint waits 28 days for the receipt of your data.
As usual, you will be reminded of pending data uploads.
Note
You can collect data from unitedprint. When ordering, simply tell us the link (FTP / AWS) to your data.
Experience has shown that response when creating an order can occur times of > 300 seconds.
Set your response timeout to 360 seconds