跑腿提交订单(写)4.0
<p><strong>简要描述:</strong> </p>
<ul>
<li>跑腿提交订单
"1001", "超出配送范围"
"1002", "配送费由?元变成了?元"
"1004", "选择时间已失效,请重新选择"
"1005", "发货/购买地址不在配送范围内"
"1012", "跑腿业务已暂停营业目前已经停止接单"</li>
</ul>
<p><strong>作者:</strong> </p>
<ul>
<li>黄丹明(1.5丁晓忠修改)</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/xtwl_write_interface/cmd</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;">custId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>客户id</td>
</tr>
<tr>
<td style="text-align: left;">sendAddressId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>取货地址id(4.0 不保存地址时不用传,以前是必传)</td>
</tr>
<tr>
<td style="text-align: left;">revAddressId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货地址id(4.0 不保存地址时不用传,以前是必传)</td>
</tr>
<tr>
<td style="text-align: left;">pickUpTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>取货时间</td>
</tr>
<tr>
<td style="text-align: left;">isFastest</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>是否立即送达:1是,0否</td>
</tr>
<tr>
<td style="text-align: left;">totalAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>订单总金额</td>
</tr>
<tr>
<td style="text-align: left;">freight</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>运费</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>买家备注</td>
</tr>
<tr>
<td style="text-align: left;">goodsName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>商品名称</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>跑腿订单类别:1取送件,2代购</td>
</tr>
<tr>
<td style="text-align: left;">estimatePrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>代购商品预估价</td>
</tr>
<tr>
<td style="text-align: left;">selectedCouponId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>优惠券领用id</td>
</tr>
<tr>
<td style="text-align: left;">couponAmount</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>优惠券金额</td>
</tr>
<tr>
<td style="text-align: left;">longitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>购买地址经度(代购必传)(4.0 sendAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">latitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>购买地址维度(代购必传)(4.0 sendAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">sendLbsName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>购买地址LBS名称(代购必传)(4.0 sendAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">sendAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>购买地址LBS地址(代购必传)(4.0 sendAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">sendCall</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>发件人性别:先生/女士(4.0 revAddressId不传时传,不传就不记录)</td>
</tr>
<tr>
<td style="text-align: left;">sendName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>发件人姓名(4.0 revAddressId不传时传,不传就不记录)</td>
</tr>
<tr>
<td style="text-align: left;">sendHouseNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>发件人门牌号(4.0 revAddressId不传时传,不传就不记录)</td>
</tr>
<tr>
<td style="text-align: left;">sendPhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>发件人电话(4.0 revAddressId不传时传,不传就不记录)</td>
</tr>
<tr>
<td style="text-align: left;">changedfreight</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>费送费变更时和错误信息一起返回</td>
</tr>
<tr>
<td style="text-align: left;">revLongitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货经度(4.0 revAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">revLatitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货维度(4.0 revAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">revCall</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货人性别:先生/女士(4.0 revAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">revName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货人姓名(4.0 revAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">revAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货人地址(4.0 revAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">revHouseNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货人门牌号(4.0 revAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">revPhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货人电话(4.0 revAddressId不传时必传)</td>
</tr>
<tr>
<td style="text-align: left;">lbsName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货人LBS地址名称(4.0 revAddressId不传时必传)</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code>取送件
{
"param": {
"timeStamp": "1506415038551",
"uuid": "dd0bf721-da04-4761-b247-3d6ecd9d9127",
"authKey": "0",
"secretKey": "48EAF3777B978B3542EC09FA3AB4DC38",
"dtype": 4,
"userKey": "631AB130821C5F9CE0538C06030A5B73",
"custId":"EFAD2C1757EA418BABA8D58D49B9DDFB",
"sendAddressId":"7CE47429B27944638D148B28E8033824",
"revAddressId":"45E740DF8B8C4B029862C4AD69C8F708",
"pickUpTime":"2018-03-28 14:10:00",
"isFastest":1,
"totalAmount":"3",
"freight":"3",
"goodsName":"小商品",
"type":1
},
"modular": "order",
"requestname": "newOrderByPt",
"version": "1.0"
}
代购
{
"param": {
"timeStamp": "1506415038551",
"uuid": "dd0bf721-da04-4761-b247-3d6ecd9d9127",
"authKey": "0",
"secretKey": "48EAF3777B978B3542EC09FA3AB4DC38",
"dtype": 4,
"userKey": "631AB130821C5F9CE0538C06030A5B73",
"custId":"EFAD2C1757EA418BABA8D58D49B9DDFB",
"sendAddressId":"",
"revAddressId":"45E740DF8B8C4B029862C4AD69C8F708",
"pickUpTime":"2018-03-28 14:10:00",
"isFastest":1,
"totalAmount":"4",
"freight":"4",
"goodsName":"小商品",
"type":2,
"longitude":"103.263581",
"latitude":"25.561378",
"sendLbsName":"购买地址LBS名称",
"sendAddress":"购买地址",
"estimatePrice":"30",
"selectedCouponId":"",
"couponAmount":""
},
"modular": "order",
"requestname": "newOrderByPt",
"version": "1.0"
}</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;">orderCode</td>
<td style="text-align: left;">string</td>
<td>订单编号</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">string</td>
<td>订单ID</td>
</tr>
<tr>
<td style="text-align: left;">resultcode/resultdesc</td>
<td style="text-align: left;">String</td>
<td>0成功/其它返回错误信息("0002", "该发货地址已被删除";"0002", "请填写发货信息";"0002", "该收货地址已被删除";"0002", "请填写收货信息";"0002", "请选择取货时间";"0002", "超出可配送时间范围")</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"result": {
"orderCode": "218082214032525",
"orderId": "E19BEB63FB654570B3F9B366FF78B1D3"
},
"resultcode": "0",
"resultdesc": "success"
}
配送费变更提示
{
"changedfreight": "3.00",
"resultcode": "1002",
"resultdesc": "配送费由2.00元变成了3.00元"
}</code></pre>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>