百事-离线物流对接
离线物流-上传数码
离线生产-上传数码
查询外箱码是否参与过活动
更新数码的商品信息
上海中商网络股份有限公司版权所有
-
+
首页
离线生产-上传数码
# 离线生产-上传数码 ## 支持场景 > ## API描述 > ## 环境信息 测试环境:`https://cmp-open-api-uat.ksf.cn` 生产环境:`https://cmp-open-api.ksf.cn` ## 请求流程 > 参阅 [API开放平台接入指南](https://developers.yesno.com.cn/doc/56/) 测试环境密钥: accessKey: e4a63e3fb71c4235af2afd2b3b6a25f8 secretKey:um7ed3izq6bdpbjk8pdgaq81vf4uwc6p secretKeySign: 57d2af7f29cbf42d6710823e57db6d35 ## 接口信息 |请求方法|`POST`| |-|-| |请求路径|`/ps/v2/pms/upload-code`| ## 公共参数 **通用请求头** >请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/) ## 传入参数 |参数|是否必填|类型|说明| |-|-|-|-| |order|必填|Object|生产订单| |├─ orderNo|必填|String|生产单号,不填自动生成单号并创建新订单,填入的订单号不存在时创建新订单,填入的订单号存在时取已有订单| |├─ productNo|传入的单号存在时非必填,否则必填|String|产品编号,同一订单上传多次时只取第一次| |├─ planQuantity|非必填|Integer|计划数量,同一订单上传多次时只取第一次| |├─ batchNo|传入的单号存在时非必填,否则必填|String|生产批次,同一订单上传多次时只取第一次| |├─ productionDate|传入的单号存在时非必填,否则必填|String|生产日期,格式yyyy-MM-dd,同一订单上传多次时只取第一次| |├─ expirationDate|传入的单号存在时非必填,否则必填|String|保质日期,格式yyyy-MM-dd,同一订单上传多次时只取第一次| |├─ remark|非必填|String|计划备注,同一订单上传多次时只取第一次| |├─ warehouse|开启生产及入库时必填,否则非必填|Object|存储仓库,同一订单上传多次时只取第一次| |├─ ├─ orgNo|必填|String|组织编号| |├─ ├─ orgType|必填|Long|[组织类型](https://developers.yesno.com.cn/doc/66/)| |├─ e1-e10|非必填|String|e1-e10扩展字段,同一订单上传多次时只取第一次| |task|必填|Object|生产任务单| |├─ organization|必填|Object|生产单位| |├─ ├─ orgNo|必填|String|组织编号| |├─ ├─ orgType|必填|Long|[组织类型](https://developers.yesno.com.cn/doc/66/)| |├─ scheduleQuantity|非必填|Integer|排产数量,同一任务单上传多次时只取第一次| |├─ planStartDate|非必填|String|计划开始日期,格式yyyy-MM-dd,同一任务单上传多次时只取第一次,不填默认等于计划开始日期| |├─ planEndDate|非必填|String|计划结束日期,格式yyyy-MM-dd,同一任务单上传多次时只取第一次,不填默认为服务器当前日期| |├─ remark|非必填|String|计划备注,同一任务单上传多次时只取第一次| |├─ f1-f10|非必填|String|f1-f10扩展字段,同一任务单上传多次时只取第一次| |team|非必填|String|班组| |teamNo|非必填|String|班组编号| |codeData|非必填|MultipartFile|扫码明细,UTF-8编码无BOM头TXT文件| txt文件内容 ``` 盖外码,箱外码,虚拟托码,是否尾包,扫描时间1,箱内码 盖外码,箱外码,虚拟托码,是否尾包,扫描时间2,箱内码 ...... ``` ## 百事企业说明 由于是原有接口基础上修改,所以接口的参数格式需与之前保持一致,百事企业没有盖外码和箱内码,这个两个码可以不传,但格式需要保持一致,即盖外码之后和箱内码之前的逗号需要保留 不传盖外码和箱内码时文件内容示例如下: ``` ,箱外码,虚拟托码,是否尾包,扫描时间1, ,箱外码,虚拟托码,是否尾包,扫描时间2, ...... ``` 不传箱内码时文件内容示例如下: ``` 盖外码,箱外码,虚拟托码,是否尾包,扫描时间1, 盖外码,箱外码,虚拟托码,是否尾包,扫描时间2, ...... ``` 不传盖外码时文件内容示例如下: ``` ,箱外码,虚拟托码,是否尾包,扫描时间1,箱内码 ,箱外码,虚拟托码,是否尾包,扫描时间2,箱内码 ...... ``` 数码处理说明: 如果没传盖外码,程序会根据箱外码查找出盖外码填充,如果传了盖外码则不执行这个逻辑 箱内码只是为了保持接口格式一致,传与不传不影响接口逻辑 数码激活说明: 数码激活方式配置为生产激活时,数码会在上传48小时之后开始激活 数码激活方式配置为其他的激活方式时,逻辑根据之前保持一致 测试数据说明: 生产单位编号(task.organization.orgNo):WL41 存储仓库编号(order.warehouse.orgNo):36 ## 传出参数 | 参数名称 | 参数类型 | 参数说明 | | --- | --- | --- | | code | Integer | 状态:200-成功,其他状态见[溯源应用平台错误代码](https://developers.yesno.com.cn/doc/44/ "溯源应用平台错误代码") | | message | String | 信息 | | timestamp | Long | 时间戳 | | traceId | String | 追踪ID | | data | Object | 返回信息 | ## 请求示例 form-data ``` order.orderNo:20241029006 order.productNo:sc121424 order.planQuantity:1 order.batchNo:20241029 order.productionDate:2024-10-29 order.expirationDate:2024-10-31 order.warehouse.orgNo:aaa order.warehouse.orgType:12 order.remark:xxx order.e1:xxx task.organization.orgNo:cx004 task.organization.orgType:13 task.scheduleQuantity:1 task.planStartDate:2024-10-10 task.planEndDate:2024-10-10 task.remark:xxx task.f1:xxx team:班组A teamNo:teamA codeData:TXT文件 ``` ## 出参示例 json ``` { "code": 200, "message": "success", "timestamp": 1679023142523, "traceId": "7074a316-3f60-462d-9e24-46f9780898b6", "data": null } ```
luozhoukai
2026年6月5日 10:54
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期