大平台——App客户端接口

App接口


跑腿提交订单4.5(新接口名字)

<p><strong>简要描述:</strong> </p> <ul> <li>跑腿提交订单 &quot;1001&quot;, &quot;超出配送范围&quot; &quot;1002&quot;, &quot;配送费由?元变成了?元&quot; &quot;1004&quot;, &quot;选择时间已失效,请重新选择&quot; &quot;1005&quot;, &quot;发货/购买地址不在配送范围内&quot; &quot;1012&quot;, &quot;跑腿业务已暂停营业目前已经停止接单&quot;</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>取送件 { &amp;quot;param&amp;quot;: { &amp;quot;timeStamp&amp;quot;: &amp;quot;1506415038551&amp;quot;, &amp;quot;uuid&amp;quot;: &amp;quot;dd0bf721-da04-4761-b247-3d6ecd9d9127&amp;quot;, &amp;quot;authKey&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;secretKey&amp;quot;: &amp;quot;48EAF3777B978B3542EC09FA3AB4DC38&amp;quot;, &amp;quot;dtype&amp;quot;: 4, &amp;quot;userKey&amp;quot;: &amp;quot;631AB130821C5F9CE0538C06030A5B73&amp;quot;, &amp;quot;custId&amp;quot;:&amp;quot;EFAD2C1757EA418BABA8D58D49B9DDFB&amp;quot;, &amp;quot;sendAddressId&amp;quot;:&amp;quot;7CE47429B27944638D148B28E8033824&amp;quot;, &amp;quot;revAddressId&amp;quot;:&amp;quot;45E740DF8B8C4B029862C4AD69C8F708&amp;quot;, &amp;quot;pickUpTime&amp;quot;:&amp;quot;2018-03-28 14:10:00&amp;quot;, &amp;quot;isFastest&amp;quot;:1, &amp;quot;totalAmount&amp;quot;:&amp;quot;3&amp;quot;, &amp;quot;freight&amp;quot;:&amp;quot;3&amp;quot;, &amp;quot;goodsName&amp;quot;:&amp;quot;小商品&amp;quot;, &amp;quot;goodsValue&amp;quot;: &amp;quot;100-300元&amp;quot;, &amp;quot;goodsWeight&amp;quot;: &amp;quot;4&amp;quot;, &amp;quot;type&amp;quot;:1 }, &amp;quot;modular&amp;quot;: &amp;quot;order&amp;quot;, &amp;quot;requestname&amp;quot;: &amp;quot;newRunOrder&amp;quot;, &amp;quot;version&amp;quot;: &amp;quot;1.0&amp;quot; } 代购 { &amp;quot;param&amp;quot;: { &amp;quot;timeStamp&amp;quot;: &amp;quot;1506415038551&amp;quot;, &amp;quot;uuid&amp;quot;: &amp;quot;dd0bf721-da04-4761-b247-3d6ecd9d9127&amp;quot;, &amp;quot;authKey&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;secretKey&amp;quot;: &amp;quot;48EAF3777B978B3542EC09FA3AB4DC38&amp;quot;, &amp;quot;dtype&amp;quot;: 4, &amp;quot;userKey&amp;quot;: &amp;quot;631AB130821C5F9CE0538C06030A5B73&amp;quot;, &amp;quot;custId&amp;quot;:&amp;quot;EFAD2C1757EA418BABA8D58D49B9DDFB&amp;quot;, &amp;quot;sendAddressId&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;revAddressId&amp;quot;:&amp;quot;45E740DF8B8C4B029862C4AD69C8F708&amp;quot;, &amp;quot;pickUpTime&amp;quot;:&amp;quot;2018-03-28 14:10:00&amp;quot;, &amp;quot;isFastest&amp;quot;:1, &amp;quot;totalAmount&amp;quot;:&amp;quot;4&amp;quot;, &amp;quot;freight&amp;quot;:&amp;quot;4&amp;quot;, &amp;quot;goodsName&amp;quot;:&amp;quot;小商品&amp;quot;, &amp;quot;type&amp;quot;:2, &amp;quot;longitude&amp;quot;:&amp;quot;103.263581&amp;quot;, &amp;quot;latitude&amp;quot;:&amp;quot;25.561378&amp;quot;, &amp;quot;sendLbsName&amp;quot;:&amp;quot;购买地址LBS名称&amp;quot;, &amp;quot;sendAddress&amp;quot;:&amp;quot;购买地址&amp;quot;, &amp;quot;estimatePrice&amp;quot;:&amp;quot;30&amp;quot;, &amp;quot;selectedCouponId&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;couponAmount&amp;quot;:&amp;quot;&amp;quot; }, &amp;quot;modular&amp;quot;: &amp;quot;order&amp;quot;, &amp;quot;requestname&amp;quot;: &amp;quot;newRunOrder&amp;quot;, &amp;quot;version&amp;quot;: &amp;quot;1.0&amp;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成功/其它返回错误信息(&quot;0002&quot;, &quot;该发货地址已被删除&quot;;&quot;0002&quot;, &quot;请填写发货信息&quot;;&quot;0002&quot;, &quot;该收货地址已被删除&quot;;&quot;0002&quot;, &quot;请填写收货信息&quot;;&quot;0002&quot;, &quot;请选择取货时间&quot;;&quot;0002&quot;, &quot;超出可配送时间范围&quot;)</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>{ &amp;quot;result&amp;quot;: { &amp;quot;orderCode&amp;quot;: &amp;quot;218082214032525&amp;quot;, &amp;quot;orderId&amp;quot;: &amp;quot;E19BEB63FB654570B3F9B366FF78B1D3&amp;quot; }, &amp;quot;resultcode&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;resultdesc&amp;quot;: &amp;quot;success&amp;quot; } 配送费变更提示 { &amp;quot;changedfreight&amp;quot;: &amp;quot;3.00&amp;quot;, &amp;quot;resultcode&amp;quot;: &amp;quot;1002&amp;quot;, &amp;quot;resultdesc&amp;quot;: &amp;quot;配送费由2.00元变成了3.00元&amp;quot; }</code></pre> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML