查询实时库存

最后更新:2026-07-14 18:29:38

核对剩余商品在继续接单前确认设备库存。

开始前需要准备什么?

先确认自助客户端版本、商品与通道配置、库存和回调地址。通道参数只用于支持通道的自助设备。

V2 回调和旧回调的状态值不同,不能混用;V2 需要对应的客户端版本,先与技术人员确认。

接下来:接收任务与出货结果 →

当前接口为自助机专用版本

查询库存信息,第三方平台可通过调用接口,向开放平台查询所有货道库存数量,及时对库存状态作管理。

接口信息

接口地址 https://www.colorpark.cn/api/Printer/getChannelStocks
请求方式 POST

请求参数

| 参数名 | 参数值(示例)| 数据类型 | 必填项 | 参数说明 | | ---- | ---- | :----: | ---- | | printer_id | 500001 | string| 是 | 打印机分配的唯一ID号,每一台打印都会分配一个不同的编号 | | once | 8305 | string| 是 | 加密生成签名时使用的随机数值 | | time | 1646790335 | string| 是 | 加密生成签名时使用的时间戳 | | sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string| 是 | 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名 章节 | | channel | 1 | string| 否 | 1:一货道 2:二货道 3:三货道 4:四货道 字段不传查询全部货道数量 |

返回结果

| 参数名 | 参数名 | 数据类型 | 参数值(示例) |参数说明| | --- | --- | --- |----| | code | | string| 0 |返回结果状态码,成功时为0,失败时为1 | | msg | | string| 获取成功 | 返回结果描述,如:获取成功 | |data| | 数组对象 | [{"channel":1,"stock quantity:10},{"channel":2,"stock quantity:20}] |货道库存对象数组| | | channel | string| 1 | 货道序号 | | | stock_quantity | string| 20 | 库存数 |


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

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