出入库数据回传接口

## 物流信息对接

## API描述
>API描述：对接物流信息

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

## 请求信息

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

<table>
<thead>
<tr>
<th>请求协议</th>
<th>HTTPS</th>
</tr>
</thead>
<tbody><tr>
<td>请求方法</td>
<td>POST</td>
</tr>
<tr>
<td>接口路径</td>
<td>/hivezs/guanfang/touyun/v1/wms/upload</td>
</tr>
</tbody></table>

## 请求参数
**路径参数:**
>无

**Headers:**
>请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "通用请求头")

**Body:**
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必填</th>
<th>参数类型</th>
<th>参数说明</th>
</tr>
</thead>
<tbody>

<tr>
<td>serialNo</td>
<td>是</td>
<td>String</td>
<td>流水号（唯一）</td>
</tr>

<tr>
<td>receiptNo</td>
<td>否</td>
<td>String</td>
<td>订单编号, 不传则自动生成</td>
</tr>

<tr>
<td>receiptType</td>
<td>是</td>
<td>String</td>
<td>单据类型，196720-销售出库，131140 - 退货入库</td>
</tr>

<tr>
<td>senderNo</td>
<td>是</td>
<td>String</td>
<td>发货方编号，同一订单上传多次时只取第一次，与第一次不一致则报错</td>
</tr>

<tr>
<td>senderType</td>
<td>是</td>
<td>String</td>
<td>发货方类型，见组织类型，同一订单上传多次时只取第一次，与第一次不一致则报错</td>
</tr>

<tr>
<td>receiverNo</td>
<td>是</td>
<td>String</td>
<td>收货方编号，同一订单上传多次时只取第一次，与第一次不一致则报错</td>
</tr>

<tr>
<td>receiverType</td>
<td>是</td>
<td>String</td>
<td>收货方类型，见组织类型，同一订单上传多次时只取第一次，与第一次不一致则报错</td>
</tr>

<tr>
<td>products</td>
<td>是</td>
<td>List&ltT&gt</td>
<td>商品列表(每次最高1 万个数码，超过分多次上传，走追加模式)</td>
</tr>

<tr>
<td>-productNo</td>
<td>是</td>
<td>String</td>
<td>商品编号</td>
</tr>

<tr>
<td>-codes</td>
<td>是</td>
<td>List&ltT&gt</td>
<td>数码列表</td>
</tr>
 
 <tr>
<td>--code</td>
<td>是</td>
<td>String</td>
<td>数码(不支持带链接的数码)</td>
</tr>

<tr>
<td>--scanTime</td>
<td>否</td>
<td>String</td>
<td>扫码时间，格式为yyyy-MM-ddTHH:mm:ss:Z</td>
</tr>

<tr>
<td>--scanUser</td>
<td>否</td>
<td>String</td>
<td>扫码人</td>
</tr>

</tbody></table>

## 返回数据

<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数类型</th>
<th>参数说明</th>
</tr>
</thead>
<tbody><tr>
<td>code</td>
<td>String</td>
<td>状态：成功=200，非200见message</td>
</tr>
<tr>
<td>message</td>
<td>String</td>
<td>信息</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>时间戳</td>
</tr>
<tr>
<td>traceId</td>
<td>String</td>
<td>追踪Id</td>
</tr>
<tr>
<td>data</td>
<td>Object</td>
<td>返回数据</td>
</tr>
</tbody></table>

**data对象说明**

## 请求示例

<div class="code-toolbar"><pre class="line-numbers language-json" data-prismjs-copy="复制" data-prismjs-copy-error="按Ctrl+C复制" data-prismjs-copy-success="代码已复制！" tabindex="0"><code class="language-json">POST {host}/hivezs/guanfang/touyun/v1/wms/upload
{
  "serialNo": "SN202610271436000456",
  "receiptNo": "SO-20261027-00087",
  "receiptType": "196720",
  "senderNo": "F01",
  "senderType": "11",
  "receiverNo": "WMS-SH-01",
  "receiverType": "12",
  "products": [
    {
      "productNo": "P-SUP8-APPLE-001",
      "codes": [
        {
          "code": "SN0000000000001",
          "scanTime": "2026-10-27T14:28:05Z",
          "scanUser": "zhangsan"
        },
        {
          "code": "SN0000000000002",
          "scanTime": "2026-10-27T14:28:41Z",
          "scanUser": "zhangsan"
        },
        {
          "code": "SN0000000000003",
          "scanTime": "2026-10-27T14:29:58Z",
          "scanUser": "lisi"
        }
      ]
    }
  ]
}

</code>
</pre>
</div>

## 出参示例-参数不正确
<div class="code-toolbar"><pre class="line-numbers language-json" data-prismjs-copy="复制" data-prismjs-copy-error="按Ctrl+C复制" data-prismjs-copy-success="代码已复制！" tabindex="0"><code class="language-json">{
    "code": 23560021,
    "message": "发货方不正确",
    "data": null,
    "timestamp": 1792549759690,
    "traceId": "87cd3c1a-34f0-4602-82ce-e465e977eb29",
    "exception": "发货方不正确",
    "meta": null,
    "ext": null
} </code></pre></div>

## 出参示例-成功
<div class="code-toolbar"><pre class="line-numbers language-json" data-prismjs-copy="复制" data-prismjs-copy-error="按Ctrl+C复制" data-prismjs-copy-success="代码已复制！" tabindex="0"><code class="language-json">{
  "code": 200,
  "message": "success",
  "data": null,
  "timestamp": 1792504583663,
  "traceId": "",
  "exception": null,
  "meta": null,
  "ext": null
} </code></pre></div>

## 常见错误

**错误码说明**

<tbody>

<tr>
<td>23560021</td>
<td>参数不正确</td>
<td>参数校验不过</td>
</tr>

</tbody>
</table>