发送打印任务

最后更新:2026-09-30 14:58:38

第三方平台通过接口向指定设备发送单个打印任务,开放平台自动派发至该设备终端软件执行。支持离线任务发送,终端上线后自动接收并执行。全自助设备调用时需携带货道信息,设备自动完成指定货道商品打印。

注:当使用的全自助设备,将调用此接口,参数带有货道信息,设备将自动完成指定货道商品的打印操作,桌面收单软件新增:打印模式,墨水模式(需升级收单软件为最新版本V3.5.1)。

接口信息

项目 值
接口地址 https://www.colorpark.cn/api/Printer/mulPrint
请求方式 POST

请求参数

参数名 参数值(示例) 数据类型 必填项 参数说明
printer_id 500001 string 是 打印机分配的唯一 ID 号,每一台打印都会分配一个不同的编号
once 8305 string 是 加密生成签名时使用的随机数值
time 1646790335 string 是 加密生成签名时使用的时间戳
sign 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c string 是 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名章节
order_id 164679033555822 string 是 第三方平台的订单编号,由第三方平台生成,最大接受 32 位字符
name 手机壳 string 是 第三方平台的商品名称,由第三方平台生成,最大接受 32 位字符
file https://img.colorpark.cn/api/render/36531651306594235.png string 是 详细说明查看下方【参数说明】
file_bgc https://img.colorpark.cn/back/6167751754907026663.png string 可选 打印进度条显示的背景特效图,网址最大接受 255 位字符,支持 jpg、png,推荐使用 jpg、png,仅支持部分机型,可与技术人员确认
width 185 string 是 打印的图片宽度,单位为 mm
height 140 string 是 打印的图片高度,单位为 mm
left 0 string 是 打印起点的左边距,单位为 mm
top 0 string 是 打印起点的上边距,单位为 mm
channel_type 1 string 可选 货道放置的币种,如果两个货道都放同一种币,这里为 1,如果两个货道放两种不同的币,这里为 2
channel 1 string 可选 纪念币的货道,如果是 1 货道这里传 1,如果是 2 货道这里为 2,如果两个货道放同一种币,可以保持一直为 1
ink_mode 0 int 可选 查看下方【墨水模式-明细】ink_mode 注解
ink_item [{"code":"W","layer":1},{"code":"CMYK","layer":1}] string 可选 详细查看下方【墨水项目-明细】ink_item 注解
is_format_conversion 0 string 可选 默认 0 原文件打印,1 原文件转换为图片格式后再打印
callback http://www.abc.com/api/callback string 可选 第三方系统用于接收打印通知的回调地址,如开始打印通知、完成打印通知、取消打印通知、打印故障通知

请求参数(多任务合并打印,限机型)

注:需要不同商品订单同时打印,则需要用以下参数,第一次调用需联系官方添加设备治具。可以通过调用接口【查询指定治具的商品】获取商品标识【unique】。

参数名 参数值(示例) 数据类型 必填项 参数说明
printer_id 500001 string 是 打印机分配的唯一 ID 号,每一台打印都会分配一个不同的编号
once 8305 string 是 加密生成签名时使用的随机数值
time 1646790335 string 是 加密生成签名时使用的时间戳
sign 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c string 是 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名章节
order_id 164679033555822 string 是 第三方平台的订单编号,由第三方平台生成,最大接受 32 位字符
name 手机壳 string 是 第三方平台的商品名称,由第三方平台生成,最大接受 32 位字符
file https://img.colorpark.cn/api/render/36531651306594235.png string 是 详细说明查看下方【参数说明】
file_bgc https://img.colorpark.cn/back/6167751754907026663.png string 可选 打印进度条显示的背景特效图,网址最大接受 255 位字符,支持 jpg、png,推荐使用 jpg、png,仅支持部分机型,可与技术人员确认
is_merge 1 string 是 是否是合并订单,0:不是 1:是合并打印订单
unique RefrigeratorMagnet string 是 商品唯一标识
quantity 1 string 是 当前订单商品打印数量
ink_mode 0 int 可选 查看下方【墨水模式-明细】ink_mode 注解
ink_item [{"code":"W","layer":1},{"code":"CMYK","layer":1}] string 可选 详细查看下方【墨水项目-明细】ink_item 注解
callback http://www.abc.com/api/callback string 可选 第三方系统用于接收打印通知的回调地址,如开始打印通知、完成打印通知、取消打印通知、打印故障通知

返回结果

字段 数据类型 参数值(示例) 参数说明
code string 0 返回结果状态码,成功时为 0,失败时为 1
msg string 提交成功 返回结果描述,如:提交成功
data.taskid string 20000196 打印任务的唯一编号
data.order_id string 164679033555822 第三方平台的订单编号,由第三方平台生成,最大接受 32 位字符
data.status string 0 打印任务状态,0:等待打印 1:正在打印 2:完成打印 3:取消打印 4:打印故障

callback 回调通知

请求方式:POST

请求参数:

参数 类型 示例 说明
type string printing printing:打印中,finish:打印完成,cancel:取消打印,pause:暂停打印,failure:打印失败,shipped:出货完成
taskid int 10041 任务 ID
printer_id int 1000926 设备编号
once int 0254 随机数
time int 1778048444 时间
sign string 06caec435ebbf494e8ed73fdc5daa0a8 签名
order_id string 1844398 订单 ID
status string 1 打印状态:1-打印中 2-打印完成 3-取消打印 4-暂停打印 5-打印失败 6-出货完成
msg string 打印中 提示

墨水项目-明细(限机型)

参数说明:code:对应墨水项目-标识,layer:打印层数

标识(ink_mode) 名称 参数(ink_item)
0 CMYK [{ "code": "W", "layer": 1 }]
1 W>CMYK [{ "code": "W", "layer": 1 },{ "code": "CMYK", "layer": 1 }]
2 专色 [{ "code": "P", "layer": 1 }]
3 白色 [{ "code": "W", "layer": 1 }]
4 CMYK>W [{ "code:": "CMYK", "layer": 1 },{ "code:": "W", "layer": 1 }]
13 浮雕 [{"code":"W","layer":8},{"code":"CMYK","layer":1}]
15 食品雕刻 [{"code":"CMYK","layer":1},{"code":"S", "layer":1}]

墨水项目-标识(限机型)

标识 名称 默认值 最小值 最大值
W 白色 1 1 8
CMYK 彩墨 1 1 1
V 光油 1 1 1
S 描边 0 1 1
P 专色 0 0 1

墨水项目-参数说明(浮雕与雕刻场景(限机型))

浮雕打印:
参数参考:
ink_mode=13,
ink_item=[{"code":"W","layer":8},{"code":"CMYK","layer":1}]
file=https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/tmp/2026/09/0c94cf9aa93dd5bf10acda49474c72cddf8452e1_3203.tif,
https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png

参数注释:
ink_item:13(参考墨水项目-明细)
ink_model:[{"code":"W","layer":8}((第一遍灰度图打印白墨8倍),{"code":"CMYK","layer":1}] (第二遍打印原图彩色1倍打印)
file:提供2张图(必须),第一张是灰度图,第二张是原图,用英文逗号分隔
-----------------------------------------------------------

浮雕打印(自动合成):
参数参考:
ink_mode=13,
ink_item=[{"code":"W","layer":8},{"code":"CMYK","layer":1}]
file=https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png

参数注释:
ink_item:13(参考墨水项目-明细);
ink_model:[{"code":"W","layer":8}(第一遍灰度图打印白墨8倍,灰度图由开放平台生成),{"code":"CMYK","layer":1}](第二遍打印原图彩色1倍打印);
file:提供1张图,需要转成浮雕的原图地址;
-----------------------------------------------------------

食品雕刻:
参数参考:
ink_item=15
ink_model=[{"code":"CMYK","layer":1},{"code":"S", "layer":1}]
file=https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png

参数注释:
ink_mode:15(参考墨水项目-明细)
ink_model:{"code":"CMYK","layer":1}(彩色打印,layer:默认值1){"code":"S", "layer":1}(layer:0-不描边 1-描边1个像素)
file:提供1张图,需要雕刻的原图地址;
-----------------------------------------------------------

其他打印:
ink_model,ink_item 传参参考【 墨水项目-明细】
file=需要打印的图片网址,图片由第三方平台生成,网址最大接受 255 位字符,支持 jpg、png、tif,推荐使用 jpg、png

若设备在调试过程中遇到不能解决问题,可以联系云打印负责人排除问题,找到解决的方法。联系方法如下: 电 话:137-5177-4454【微信同号】 邮 箱:info@ColorPark.cn

软硬件深度整合的UV云打印服务商 ® 瑞丰彩