狮王对接
对接信息
物流信息对接
上海中商网络股份有限公司版权所有
-
+
首页
物流信息对接
## 生产订单接口 ## 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>/customer/shiwang/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>receiptNo</td> <td>否</td> <td>String</td> <td>订单编号, 不传则自动生成</td> </tr> <tr> <td>receiptType</td> <td>是</td> <td>List<T></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<T></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<T></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对象说明** <table> <thead> <tr> <th>参数名称</th> <th>参数类型</th> <th>参数说明</th> </tr> </thead> </table> ## 请求示例 <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}/customer/yiersan/v1/wms/pms/syncorder { "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": 400, "message": "原始生产单号不能为空", "data": null, "timestamp": 1781427049875, "traceId": "eda83164-55c8-441c-8d42-80c5fae5aec9", "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": [ { "productNo": "test001", "code": 200, "message": "修改单据成功" }, { "productNo": "test003", "code": 26010015, "message": "商品编号在系统中不存在" } ], "timestamp": 1781427096559, "traceId": "b1fdd2d5-ebdc-4488-a92d-30b952eb850d", "exception": null, "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": [ { "productNo": "test001", "code": 200, "message": "修改单据成功" }, { "productNo": "test002", "code": 200, "message": "修改单据成功" } ], "timestamp": 1781427128623, "traceId": "1591fddb-8e20-45d0-8d3d-a317d6b0c591", "exception": null, "meta": null, "ext": null } </code></pre></div> ## 常见错误 **错误码说明** <table> <thead> <tr> <th>错误码</th> <th>错误描述</th> <th>场景</th> </tr> </thead> <tbody> <tr> <td>400</td> <td>参数不正确</td> <td>参数校验不过</td> </tr> <tr> <td>。。。</td> <td>。。。</td> <td>。。。</td> </tr> </tbody> </table>
xiaosheng
2026年10月20日 22:02
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期