跑腿提交订单4.5(新接口名字)
<p><strong>简要描述:</strong> </p>
<ul>
<li>跑腿提交订单
"1001", "超出配送范围"
"1002", "配送费由?元变成了?元"
"1004", "选择时间已失效,请重新选择"
"1005", "发货/购买地址不在配送范围内"
"1012", "跑腿业务已暂停营业目前已经停止接单"</li>
</ul>
<p><strong>作者:</strong> </p>
<ul>
<li>黄丹明</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;">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>
<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;">goodsId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>物品id 4.5</td>
</tr>
<tr>
<td style="text-align: left;">specialAttach</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>特殊物品费(为0不传) 4.5</td>
</tr>
<tr>
<td style="text-align: left;">goodsPic</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>代购图片 4.5</td>
</tr>
<tr>
<td style="text-align: left;">goodsSpec</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>代购物品描述 4.5</td>
</tr>
<tr>
<td style="text-align: left;">weightAttach</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>取送件重量附加费(为0不传) 4.5</td>
</tr>
<tr>
<td style="text-align: left;">goodsValue</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>取送件价值 4.5</td>
</tr>
<tr>
<td style="text-align: left;">goodsWeight</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>取送件重量(单位:公斤) 4.5</td>
</tr>
<tr>
<td style="text-align: left;">specialTimeFreight</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>特殊时段费(为0不传) 4.5</td>
</tr>
<tr>
<td style="text-align: left;">rewardAmount</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>小费(为0不传) 4.5</td>
</tr>
<tr>
<td style="text-align: left;">isUseBalance</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>是否使用余额抵扣 (1是)</td>
</tr>
<tr>
<td style="text-align: left;">balanceDeduction</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>余额抵扣金额</td>
</tr>
<tr>
<td style="text-align: left;">nearbyBuy</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>是否是就近购买:1是</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code>取送件
{
&quot;param&quot;: {
&quot;timeStamp&quot;: &quot;1506415038551&quot;,
&quot;uuid&quot;: &quot;dd0bf721-da04-4761-b247-3d6ecd9d9127&quot;,
&quot;authKey&quot;: &quot;0&quot;,
&quot;secretKey&quot;: &quot;48EAF3777B978B3542EC09FA3AB4DC38&quot;,
&quot;dtype&quot;: 4,
&quot;userKey&quot;: &quot;631AB130821C5F9CE0538C06030A5B73&quot;,
&quot;custId&quot;:&quot;EFAD2C1757EA418BABA8D58D49B9DDFB&quot;,
&quot;sendAddressId&quot;:&quot;7CE47429B27944638D148B28E8033824&quot;,
&quot;revAddressId&quot;:&quot;45E740DF8B8C4B029862C4AD69C8F708&quot;,
&quot;pickUpTime&quot;:&quot;2018-03-28 14:10:00&quot;,
&quot;isFastest&quot;:1,
&quot;totalAmount&quot;:&quot;3&quot;,
&quot;freight&quot;:&quot;3&quot;,
&quot;goodsName&quot;:&quot;小商品&quot;,
&quot;goodsValue&quot;: &quot;100-300元&quot;,
&quot;goodsWeight&quot;: &quot;4&quot;,
&quot;type&quot;:1
},
&quot;modular&quot;: &quot;order&quot;,
&quot;requestname&quot;: &quot;newRunOrder&quot;,
&quot;version&quot;: &quot;1.0&quot;
}
代购
{
&quot;param&quot;: {
&quot;timeStamp&quot;: &quot;1506415038551&quot;,
&quot;uuid&quot;: &quot;dd0bf721-da04-4761-b247-3d6ecd9d9127&quot;,
&quot;authKey&quot;: &quot;0&quot;,
&quot;secretKey&quot;: &quot;48EAF3777B978B3542EC09FA3AB4DC38&quot;,
&quot;dtype&quot;: 4,
&quot;userKey&quot;: &quot;631AB130821C5F9CE0538C06030A5B73&quot;,
&quot;custId&quot;:&quot;EFAD2C1757EA418BABA8D58D49B9DDFB&quot;,
&quot;sendAddressId&quot;:&quot;&quot;,
&quot;revAddressId&quot;:&quot;45E740DF8B8C4B029862C4AD69C8F708&quot;,
&quot;pickUpTime&quot;:&quot;2018-03-28 14:10:00&quot;,
&quot;isFastest&quot;:1,
&quot;totalAmount&quot;:&quot;4&quot;,
&quot;freight&quot;:&quot;4&quot;,
&quot;goodsName&quot;:&quot;小商品&quot;,
&quot;type&quot;:2,
&quot;longitude&quot;:&quot;103.263581&quot;,
&quot;latitude&quot;:&quot;25.561378&quot;,
&quot;sendLbsName&quot;:&quot;购买地址LBS名称&quot;,
&quot;sendAddress&quot;:&quot;购买地址&quot;,
&quot;estimatePrice&quot;:&quot;30&quot;,
&quot;selectedCouponId&quot;:&quot;&quot;,
&quot;couponAmount&quot;:&quot;&quot;
},
&quot;modular&quot;: &quot;order&quot;,
&quot;requestname&quot;: &quot;newRunOrder&quot;,
&quot;version&quot;: &quot;1.0&quot;
}</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>{
&quot;result&quot;: {
&quot;orderCode&quot;: &quot;218082214032525&quot;,
&quot;orderId&quot;: &quot;E19BEB63FB654570B3F9B366FF78B1D3&quot;
},
&quot;resultcode&quot;: &quot;0&quot;,
&quot;resultdesc&quot;: &quot;success&quot;
}
配送费变更提示
{
&quot;changedfreight&quot;: &quot;3.00&quot;,
&quot;resultcode&quot;: &quot;1002&quot;,
&quot;resultdesc&quot;: &quot;配送费由2.00元变成了3.00元&quot;
}</code></pre>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>