订单发货并上传
<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>
<ul>
<li>订单在oms发货成功，才会调用上传线上平台；若上传线上平台失败，oms发货是成功的，需要手工在OMS再次上传</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>单据编码</td>
</tr>
<tr>
<td style="text-align: left;">action</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>操作类型 tradeshipandupload</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></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;">批号</td>
<td>批次存货必传</td>
</tr>
</tbody>
</table>
<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;">Modify</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List<Map></td>
<td>修改订单的内容 不需要修改则不传</td>
</tr>
</tbody>
</table>
<p><strong> Modify </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;">id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>订单id</td>
</tr>
<tr>
<td style="text-align: left;">cExpressCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>快递单号</td>
</tr>
<tr>
<td style="text-align: left;">cExpressCorp</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>物流网点(快递公司编码)</td>
</tr>
<tr>
<td style="text-align: left;">iweight</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Bigdacimal</td>
<td>整单重量</td>
</tr>
<tr>
<td style="text-align: left;">dShipTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">datetimestring</td>
<td>发货时间 yyyy-MM-dd HH:mm:ss格式字符串</td>
</tr>
</tbody>
</table>
<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;">expresslists</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List<Map></td>
<td>实际发货的快递明细,传入数据会覆盖原快递明细 不需要修改则不传</td>
</tr>
</tbody>
</table>
<p><strong> expresslists </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;">cexpresscode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>快递单号</td>
</tr>
<tr>
<td style="text-align: left;">iweight</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Bigdacimal</td>
<td>包裹重量，可不传</td>
</tr>
<tr>
<td style="text-align: left;">cweighter</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>称重人，可不传</td>
</tr>
<tr>
<td style="text-align: left;">dweighttime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">date</td>
<td>称重时间，可不传</td>
</tr>
<tr>
<td style="text-align: left;">tid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>交易编号</td>
</tr>
<tr>
<td style="text-align: left;">dshiptime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">date</td>
<td>发货时间</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;">whcode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>实发仓库，只做显示用，编码名称均可</td>
</tr>
<tr>
<td style="text-align: left;">deliverstatus</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>物流状态，只做显示用</td>
</tr>
<tr>
<td style="text-align: left;">define1-10</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>
{
"ids": "1228320612454656",
"action": "tradeshipandupload",
"partParam": {
"1228320612454656": "2019-06-28 11:04:22"
},
"path": "0",
"billnum": "ec_tradeorder",
"externalData": "{\"shipdetails\":[{\"parentid\":\"1228320612454656\",\"bodyid\":\"0\",\"iWarehouseId\":\"622402136887552\",\"itemid\":\"6932\",\"product\":\"62240213683824\",\"skuCode\":\"0000003140\",\"warehouseCode\":\"YY005\",\"cshipcode\":\"FH10272019020100000005\",\"iquantity\":\"1\",\"sBatchNo\":\"\"}],\"expresslists\":[{\"cexpresscode\":\"0\",\"iweight\":\"1\",\"parentid\":\"1228320612454656\",\"cweighter\":\"2\",\"dweighttime\":\"2011-01-01 00:00:00\",\"tid\":\"11111111\",\"cshipcode\":\"FH10272019020100000005\",\"ismain\":\"1\",\"whcode\":\"001\"}],\"Modify\":[{\"id\":\"1228320612454656\",\"cExpressCode\":\"777777\",\"iweight\":\"7.99\",\"dShipTime\":\"2019-01-01 12:12:12\"}]}"
}
</code></pre>
<p><strong>返回示例</strong>
<strong>备注 失败的订单会从data返回</strong></p>
<pre><code>{
"code": 200,
"message": "[{"exceptionMsg":"没有需要操作的单据","code":"1","isShowMsg":true,"failCount":"1","successCount":"0","isExcuteAction":true,"actionName":"订单发货"},{"code":"2","isShowMsg":true,"failCount":"1","successCount":"0","isExcuteAction":false,"actionName":"订单发货上传"}]"
}
}</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>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>