广东一二三批发有限公司
对接信息
生产订单对接
商品对接
上海中商网络股份有限公司版权所有
-
+
首页
生产订单对接
## 生产订单接口 ## 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/yiersan/v1/wms/pms/syncorder</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>originalOrderNo</td> <td>是</td> <td>String</td> <td>原始生产单号</td> </tr> <tr> <td>productList</td> <td>是</td> <td>List<T></td> <td>商品信息</td> </tr> <tr> <td>-productNo</td> <td>是</td> <td>String</td> <td>商品编号</td> </tr> <tr> <td>-planQuantity</td> <td>是</td> <td>Integer</td> <td>计划数量</td> </tr> <tr> <td>batchNo</td> <td>是</td> <td>String</td> <td>批次</td> </tr> <tr> <td>productionDate</td> <td>是</td> <td>String</td> <td>生产日期(格式yyyy-MM-dd)</td> </tr> <tr> <td>expirationDate</td> <td>否</td> <td>String</td> <td>保质日期(格式yyyy-MM-dd),如果未传则按照商品的保质期计算(建议传)</td> </tr> <tr> <td>burGentFlag</td> <td>否</td> <td>String</td> <td>是否加急(0:否,1:是)</td> </tr> <tr> <td>remark</td> <td>否</td> <td>String</td> <td>备注</td> </tr> <tr> <td>factoryNo</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> <tbody> <tr> <td>productNo</td> <td>String</td> <td>产品编码</td> </tr> <tr> <td>code</td> <td>String</td> <td>状态:成功=200,非200见message</td> </tr> <tr> <td>message</td> <td>String</td> <td>信息</td> </tr> </tbody></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 { "originalOrderNo": "temp260614", "productList": [ { "productNo": "test001", "planQuantity": "50" }, { "productNo": "test002", "planQuantity": "60" } ], "batchNo": "1234", "productionDate": "2026-06-24", "expirationDate": "2028-06-24", "burGentFlag": "0", "remark": "", "factoryNo": "123gc" } </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年6月15日 13:41
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期