OMS接口文档

OMS接口文档


订单发货(门店发货回传)

<p><strong>简要描述:</strong> </p> <ul> <li>订单发货(门店发货回传)</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://localhost:8080/api/billoperation/apiaction?token=12345678</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">billnum</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>单据编码 ec_tradeorder</td> </tr> <tr> <td style="text-align: left;">action</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>操作类型 writebackshipinfo</td> </tr> <tr> <td style="text-align: left;">ids</td> <td style="text-align: left;">是</td> <td style="text-align: left;">List</td> <td>需要发货的订单id</td> </tr> <tr> <td style="text-align: left;">partParam</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Map</td> <td>订单-时间戳关系映射</td> </tr> <tr> <td style="text-align: left;">path</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>调用标识。需传2</td> </tr> <tr> <td style="text-align: left;">externalData</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Map</td> <td>订单支持修改的部分内容</td> </tr> </tbody> </table> <p><strong>externalData 支持修改订单表头表体信息,必输</strong> <strong>externalData数据格式请查看订单修改api中关于externaldata的描述https://www.showdoc.cc/265424688438926?page_id=1513322086814400</strong> <strong>externalData中数量,价格,金额,费用字段必传,否则会导致异常,具体字段请参考请求示例</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">shipdetails</td> <td style="text-align: left;">否</td> <td style="text-align: left;">List<Map></td> <td>实际发货的发货明细,保存后将把原发货明细替换成此发货明细,不需要修改发货明细则不传</td> </tr> </tbody> </table> <p><strong> shipdetails </strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">parentid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Long</td> <td>订单id</td> </tr> <tr> <td style="text-align: left;">bodyid</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>表体行id,可不传,后台根据仓库+商品表体匹配</td> </tr> <tr> <td style="text-align: left;">iWarehouseId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>仓库id,可不传</td> </tr> <tr> <td style="text-align: left;">itemid</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>商品skuid,可不传</td> </tr> <tr> <td style="text-align: left;">product</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>商品id,可不传</td> </tr> <tr> <td style="text-align: left;">skuCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>【SKU编码】 与【itemid/product】 必选其一传递</td> </tr> <tr> <td style="text-align: left;">warehouseCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Map</td> <td>【仓库编码】 与【iWarehouseId】 必选其一传递</td> </tr> <tr> <td style="text-align: left;">cshipcode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>发货单号</td> </tr> <tr> <td style="text-align: left;">iquantity</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Bigdacimal</td> <td>数量</td> </tr> <tr> <td style="text-align: left;">sBatchNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>批号 批次存货必传</td> </tr> <tr> <td style="text-align: left;">dProduceDate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>批次存货对应生产日期 没有的话不传</td> </tr> <tr> <td style="text-align: left;">dInvalidDate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>批次存货对应失效日期 没有的话不传</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code> {"path":2,"action":"writebackshipinfo","ids":1797333168935168,"externalData":"{\"shipdetails\":[{\"parentid\":\"1797333168935168\",\"bodyid\":\"1797333168935169\",\"iWarehouseId\":\"1776004093726976\",\"itemid\":\"1225921131057408\",\"product\":\"1225921101598976\",\"cshipcode\":\"122520200623000000013617\",\"iquantity\":\"4\",\"sBatchNo\":\"aa2020062802\",\"dProduceDate\":\"2020-06-01\",\"dInvalidDate\":\"2020-12-31\"},{\"parentid\":\"1797333168935168\",\"bodyid\":\"1797333168935170\",\"iWarehouseId\":\"1776004093726976\",\"itemid\":\"1225927729664256\",\"product\":\"1225927727845632\",\"cshipcode\":\"122520200623000000013617\",\"iquantity\":\"9\",\"sBatchNo\":\"bb2020062801\",\"dInvalidDate\":\"2020-11-30\"},{\"parentid\":\"1797333168935168\",\"bodyid\":\"1797475753627907\",\"iWarehouseId\":\"1776004093726976\",\"itemid\":\"1226584541974792\",\"product\":\"1226584541974790\",\"cshipcode\":\"122520200623000000013617\",\"iquantity\":\"1\"}],\"Added\":[{\"productID\":1226584541974790,\"num\":\"1.00\",\"product_code\":\"005\",\"product_name\":\"服务费\",\"product_skucode\":\"005\",\"price\":0,\"citemID\":1226584541974792,\"total_fee\":0,\"cWhCode\":1776004093726976,\"saleserId\":1776147871846656}],\"Head\":[{\"fDiscountSum\":\"0.00\",\"iPostage\":\"0.00\",\"order_tax_fee\":0,\"total_fee\":\"888.00\",\"total_num\":\"14.00\",\"adjust_fee\":0,\"id\":1797333168935168,\"iweight\":0.08,\"cExpressCoID\":\"1225929776451840\",\"cExpressCode\":\"YT20200620001\"}],\"Modified\":[{\"value\":\"[{\\\"productID\\\":1225921101598976,\\\"product_skuname\\\":\\\"大米10KG\\\",\\\"num\\\":\\\"4.00\\\",\\\"product_code\\\":\\\"001\\\",\\\"product_name\\\":\\\"大米10KG\\\",\\\"product_skucode\\\":\\\"001\\\",\\\"price\\\":\\\"55.50\\\",\\\"citemID\\\":1225921131057408,\\\"total_fee\\\":\\\"222.00\\\",\\\"cWhCode\\\":1776004093726976,\\\"payment\\\":222,\\\"saleserId\\\":1776147871846656,\\\"id\\\":1797333168935169},{\\\"productID\\\":1225927727845632,\\\"product_skuname\\\":\\\"面包\\\",\\\"num\\\":\\\"9.00\\\",\\\"product_code\\\":\\\"003\\\",\\\"product_name\\\":\\\"面包\\\",\\\"product_skucode\\\":\\\"003\\\",\\\"price\\\":\\\"74.00\\\",\\\"citemID\\\":1225927729664256,\\\"total_fee\\\":\\\"666.00\\\",\\\"cWhCode\\\":1776004093726976,\\\"payment\\\":666,\\\"saleserId\\\":1776147871846656,\\\"id\\\":1797333168935170}]\"}]}","partParam":{"1797333168935168":"2020-06-28 11:11:57"},"billnum":"ec_tradeorder"} </code></pre> <p><strong>返回示例</strong> <strong><em>成功示例 </em></strong></p> <pre><code>{ "code": 200, "message": "sucess" }</code></pre> <p><strong><em>失败示例 </em></strong></p> <pre><code>{ "code": 200, "message": "failed" }</code></pre> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">String</td> <td>返回代码:成功200,失败其他</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">Map</td> <td>返回消息:成功sucess,否则记录的失败信息</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML