出入库数据回传接口

## 物流信息对接

## 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/v1/wms/order/offline/uploadCode</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-销售出库，131149 - 收货入库， 196731 - 退货出库， 131140 - 退货入库， 196723 - 调拨出库， 131138 - 调拨入库</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>createTime</td>
<td>否</td>
<td>String</td>
<td>订单创建时间，同一订单上传多次时以第一次为准，不填默认为服务器当前时间，格式为yyyy-MM-ddTHH:mm:ss:Z</td>
</tr>

<tr>
<td>completedTime</td>
<td>否</td>
<td>String</td>
<td>订单完成时间，同一订单上传多次时以最后一次为准，不填默认为数据处理结束时间，格式为yyyy-MM-ddTHH:mm:ss:Z</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/shiwang/v1/wms/order/offline/uploadCode
{
  "products": [
    {
      "productNo": "test1020",
      "codes": [
        {
          "code": "114901000006",
          "scanTime": "",
          "scanUser": ""
        }
      ]
    }
  ],
  "completedTime": "",
  "createTime": "",
  "receiptNo": "",
  "receiptType": "196720",
  "receiverNo": "10021",
  "receiverType": "16",
  "senderNo": "CK001",
  "senderType": "14"
}
</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>