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)
Administration (2)
The standard UPI tracking function is a simple HTTP callback.
For defined events in the creation process, status changes with definable parameters are transmitted to a URL that they announced.
Below are two examples of a status change (to “Cancellation”) based on the order_number 999999
as well as the 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
This PHP call writes a “tracking.log” in the same directory with the parameters previously defined by you.
The status of an order is not queried via the interface. Instead, information is returned to the partner via the interface.
When the status in the UP system is changing, a script can be called up by the partner using a so-called “http callback”. This is possible for every relevant status change.
Possible status changes are
- Acknowledgement of order
- Data processing
- Pooling
- Processing
- Shipping deployment
- Shipping
- Cancellation
Different values can be transferred for each script.
Can be selected
- General information
- Order number
- Location information
- Status
- Delivery date
- Position number
- Item delivery information
- Delivery service (Carrier)
- Tracking number
- Subset
Return values / mapping delivery service (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
Return values / mapping status values
- order_stati_1000_4 Acknowledgement of order
- order_stati_1500_4 File check
- order_stati_1600_4 Customize release
- order_stati_1750_4 Data processing
- order_stati_2000_4 Pooling
- order_stati_3000_4 Pre-press stage
- order_stati_3400_4 Plotting
- order_stati_3600_4 Stamping
- order_stati_3700_4 Plating
- order_stati_4000_4 Printing
- order_stati_5000_4 Processing
- order_stati_5400_4 Shipping deployment
- order_stati_5800_4 Shipping stop
- order_stati_6000_4 Shipping
- order_stati_7000_4 Cancellation
UP must activate the authorization to transmit the tracking information explezit for you. For this it is necessary to give us a callback URL.
Tracking examples you can find here.