大平台——App客户端接口

App接口


跑腿提交订单(写)4.0

<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>黄丹明(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成功/其它返回错误信息(&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>{ "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>

页面列表

ITEM_HTML