百事-离线物流对接

上海中商网络股份有限公司版权所有

离线物流-上传数码

# 离线物流-上传数码

## 支持场景
>1. 相同的订单基本信息，分两批上传数码，数码追加在同一个订单
2.相同的订单基本信息，重复上传覆盖

## API描述
> 对接已自建环境域名为准：
测试： https://cmp-open-api-uat.ksf.cn
生产：

## 请求流程
> 参阅 [API开放平台接入指南](https://developers.yesno.com.cn/doc/56/)

## 请求信息
>域名：请参阅 [环境信息](https://developers.yesno.com.cn/doc/56/)

|请求方法|`POST`|
|-|-|
|请求路径|`/trace/app/v1/open/wms/order/offline/upload-code`|

## 公共参数
**通用请求头**
>请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/)

## 请求参数
|参数|是否必填|说明|
|-|-|-|
|receiptNo|非必填|订单编号，不传自动生成，长度最大50|
|receiptType|必填|单据类型，见[溯源应用平台物流订单类型](https://developers.yesno.com.cn/doc/46/ "溯源应用平台物流订单类型")|
|senderNo|必填|发货方编号|
|senderType|必填|发货方类型，见[组织类型](https://developers.yesno.com.cn/doc/66/)，同一订单上传多次时只取第一次。当是14（仓库）类型时，如果发货方不存在系统会依据senderName自动新增|
|senderName|非必填|发货方名称|
|receiverNo|必填|收货方编号|
|receiverType|必填|收货方类型，如果不是16或17时，自动移除receiverNo前缀0。当是14（仓库）类型时，如果收货方不存在系统会依据receiverName自动新增|
|receiverName|非必填|收货方名称|
|f1|必填|**SAP单号，只能传一个，会校验是否预先存在，不存在预警**|
|createTime|非必填|订单创建时间,不填默认当前时间，格式为yyyy-MM-ddTHH:mm:ss:Z|
|completedTime|非必填|订单完成时间，同一订单上传多次时以第一次为准，不填默认为数据处理结束时间，格式为yyyy-MM-ddTHH:mm:ss:Z|
|processType|非必填|处理类型1：覆盖 2：合并，默认覆盖。针对上传相同单据数据是合并还是覆盖|
|products|必填|商品列表|
|├─ productNo|必填|商品编号|
|├─ f11-f20|非必填|订单商品扩展字段，同一订单多次上传有值时将更新，保存后可在物流单商品列表和物流统计报表查看|
|├─ planQuantity|非必填|计划数量，订单下同一商品上传多次时取最后一次|
|├─ codes|非必填|数码列表|
|├─ ├─ code|必填|数码(每次最高1 万个，超过分多次上传，走合并模式)|
|├─ ├─ scanTime|必填|扫码时间，格式为yyyy-MM-ddTHH:mm:ss:Z|
|├─ ├─ scanUser|非必填|扫码人登入名，不填默认为当前登录用户|
|├─ ├─ f1-f20|非必填|扫码扩展字段|
## 响应参数
|参数|类型|说明|
|-|-|-|
|code|integer|错误码|
|message|string|错误信息|
|traceId|string|链路ID|
|data|object|返回数据|
|├─ taskId|long|离线物流任务ID|
|├─ receiptId|long|订单ID|
|├─ receiptNo|string|订单编号|
## 请求示例
```
https://cmp-open-api-uat.ksf.cn/trace/app/v1/open/wms/order/offline/upload-code

POST BODY:
{
	"receiptNo":"jkck20250304007-5",
	"receiptType":"196720",
	"senderNo":"CK041000",
    "senderName":"仓库0410ck",
	"senderType":14,
	"receiverNo":"ccnyijie2",
    "receiverName":"CCN测试终端2（一阶）",
	"receiverType":17,
	"processType":"1",
	"createTime":"2025-04-18T03:14:13Z"
	"completedTime":"2025-04-18T03:14:13Z"
    "f1":"2011111111",
	"products":[
		{
			"productNo":"851090203510125A",
			"planQuantity":"15",
			"codes":[
				{
					"code":"https://bw-uat.ksf.cn/?6166813560301803C0470",
					"scanTime":"2025-04-18T03:14:13Z"
				}
			]
		}
	]
}
```
## 出参示例
```
{
  "code":"200",
  "message":"success",
  "traceId":"0b5e0e4a387a401c81da8e949754c085.170.17654247936792513",
  "data":{
    "taskId":"1998962584393699328",
    "receiptId":"1998962585094148096",
    "receiptNo":"CK2025121193"
  }
}
```