超8-SaaS-API开放平台

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

离线物流-上传数码

# 离线物流-上传数码

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

## API描述
>

## 请求流程
> 参阅 [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|非必填|订单编号，不填自动生成单号并创建新订单，填入的单号不存在时创建新订单，填入的单号存在时取已有订单|
|receiptType|传入的单号存在时非必填，否则必填|单据类型，见[溯源应用平台物流订单类型](https://developers.yesno.com.cn/doc/46/ "溯源应用平台物流订单类型")，同一订单上传多次时只取第一次，与第一次不一致则报错|
|senderNo|传入的单号存在时非必填，否则必填|发货方编号，同一订单上传多次时只取第一次，与第一次不一致则报错|
|senderType|传入的单号存在时非必填，否则必填|发货方类型，见[组织类型](https://developers.yesno.com.cn/doc/66/)，同一订单上传多次时只取第一次，与第一次不一致则报错|
|receiverNo|传入的单号存在时非必填，否则必填|收货方编号，同一订单上传多次时只取第一次，与第一次不一致则报错|
|receiverType|传入的单号存在时非必填，否则必填|收货方类型，见[组织类型](https://developers.yesno.com.cn/doc/66/)，同一订单上传多次时只取第一次，与第一次不一致则报错|
|f1-f10|非必填|订单扩展字段，同一订单多次上传有值时将更新，保存后可在物流管理列表和物流统计报表查看|
|createTime|非必填|订单创建时间，同一订单上传多次时以第一次为准，不填默认为服务器当前时间，格式为yyyy-MM-ddTHH:mm:ss:Z|
|completedTime|非必填|订单完成时间，同一订单上传多次时以最后一次为准，不填默认为数据处理结束时间，格式为yyyy-MM-ddTHH:mm:ss:Z|
|products|必填|商品列表|
|├─ productNo|必填|商品编号|
|├─ f11-f20|非必填|订单商品扩展字段，同一订单多次上传有值时将更新，保存后可在物流单商品列表和物流统计报表查看|
|├─ planQuantity|非必填|计划数量，订单下同一商品上传多次时取最后一次|
|├─ codes|非必填|数码列表|
|├─ ├─ code|必填|数码(每次最高1 万个，超过分多次上传，走追加模式)|
|├─ ├─ scanMode|必填|扫码类型:1 - 逐一扫码模式 2 - 整扫模式（非常用，了解清楚再使用）|
|├─ ├─ 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://open-test.yesno.com.cn/trace/app/v1/open/wms/order/offline/upload-code

POST BODY:
{
    "receiptType": "196720",
    "receiverNo": "ksdjxs001",
    "products": [{
        "codes": [{
            "code": "C86202361526",
            "scanTime": "2025-05-12T06:50:15.541Z",
            "scanMode": 1
        }],
        "productNo": "PRLSPNSP3-S25MB-E"
    }],
    "senderNo": "CAN2102",
    "receiverType": 16,
    "receiptNo": "CK2025121193",
    "senderType": 14
}
```
## 出参示例
```
{
  "code":"200",
  "message":"success",
  "traceId":"0b5e0e4a387a401c81da8e949754c085.170.17654247936792513",
  "data":{
    "taskId":"1998962584393699328",
    "receiptId":"1998962585094148096",
    "receiptNo":"CK2025121193"
  }
}
```

上一篇

下一篇