Receive task & dispensing results — Process finish, pause, failure, and dispensing statuses per the V2 definition.
What do you need to prepare before starting?
First confirm the self-service client version, product and channel configuration, inventory, and callback URL. The channel parameter is only used for self-service devices that support channels.
The V2 callback uses status values different from the legacy callback — they must not be mixed. V2 requires the corresponding client version; confirm with technical staff first.
Next: Receive device exceptions →
Task callback: the third-party platform must configure a callback URL on the open platform. Thereafter, when a print task's status is updated, the open platform will push the task information to that address in real time, enabling the third party to perform follow-up processing..
Note: You must upgrade or install the latest version of the cloud-printing client to use this feature (confirm the client version with the official technical team).
Callback URL
| Type | Address URL | Source |
|---|---|---|
| Interface URL | http://XXXX.com/api/callback |
Custom-defined by the third party |
Callback Result
| Parameter | Data Type | Sample Value | Description |
|---|---|---|---|
type |
string | printing |
Callback event type: printing — printing in progress; finish — finished; cancel — canceled; pause — printing paused; failure — print failure; shipped — dispensing completed |
taskid |
string | 20000196 |
Unique ID assigned to the print task |
printer_id |
string | 500001 |
Printer ID assigned for the print job |
once |
string | 8305 |
Random value sent with each request |
time |
string | 1646790335 |
Timestamp sent with each request |
sign |
string | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c |
Signature |
order_id |
string | 8003A |
Order number in the partner's system. If two orders are merged for printing, the two order numbers are separated by a comma, e.g. 1569885222,1785336685 |
status |
string | 1 |
Print task status: 1 printing in progress; 2 print finished; 3 print canceled; 4 printing paused; 5 print failure; 6 dispensing completed |
receive_status |
string | 1 |
Client image-receiving status: 0 pending; 1 received successfully; 2 receive failed |
msg |
string | Print finished |
Displays different information based on task status: printing in progress, print finished, print canceled, printing paused, print failure, dispensing completed |
If a problem that cannot be resolved occurs during device commissioning, contact the cloud-printing responsible person for troubleshooting. Contact details: Phone: 137-5177-4454 (WeChat same number) Email: info@ColorPark.cn