Receive device exceptions — Route fault, inventory, or ink alerts to operations staff for handling.
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.
Printer status callback: configure the corresponding callback URL per the reseller's application scenario below. When a printer's status is updated, the open platform will push the task information to that address in real time for 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
| Item | Value |
|---|---|
| Sample interface URL | http://XXXX.com/api/callback (configure the corresponding address per application scenario) |
Application Scenario 1 — Reseller integration & development: the service provider pushes real-time printer-status messages to this interface, and the reseller must handle the different message types. The full address is custom-defined by the customer.
Application Scenario 2 — Reseller does not integrate/develop: view the latest printer tasks and status on the service provider's system platform by configuring the callback URL provided by the service provider: https://tprint.colorpark.cn/api/OpenCallBack/printerCallBack
Application Scenario 3 — Value is empty: no callback is pushed and no platform device data is updated.
Callback Result
| Parameter | Data Type | Sample Value | Description |
|---|---|---|---|
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 |
status |
string | 1 |
Printer status, pushed in sync with the print-task callback. 0: offline; 1: idle; 2: printing; 3: fault; 4: maintenance |
msg |
string | Idle |
Printer status description |
fault_status |
string | 1 |
Fault status: 1 feed failure; 2 output failure; 3 homing failure; 4 printer reset failure; 5 system error; 6 print error; 7 descent failure; 8 unknown error |
fault_status_msg |
string | Feed failure |
Fault description |
stock_status |
string | 1 |
Inventory status: 1 sufficient; 2 insufficient |
stock_status_msg |
string | Insufficient inventory |
Inventory description |
ink_status |
string | 1 |
Ink-level status: 1 sufficient; 2 insufficient |
ink_status_msg |
string | Sufficient ink |
Ink-level description |
error_status |
string | 1 |
Error status: 1 network error; 2 print error; 3 system error; 4 unknown error |
error_status_msg |
string | Network error |
Error-status description |
other_status |
string | -1 |
Other status: 1 machine cleaning in progress; 2 machine cleaning completed; 3 machine cleaning canceled |
other_status_msg |
string | Machine cleaning in progress |
Other-status description |
phone |
string | 19900990000 |
Device-maintenance mobile number |
notice_time |
string | 2022-07-19 17:08:30 |
Notification time |
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