【顺丰快递管家】通用接口文档


预创建同城订单

<p>&lt;br/&gt;</p> <p>&gt; 预创建同城订单</p> <p>请求接口:/public/pub/tcOrder/preCreateOrder</p> <p>请求方法:POST</p> <p>请求类型:JSON</p> <p>请求参数:</p> <table> <thead> <tr> <th style="text-align: left;">参数名称</th> <th style="text-align: left;">参数类型</th> <th style="text-align: left;">是否必填</th> <th style="text-align: left;">默认值</th> <th style="text-align: left;">描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">settlementType</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">是</td> <td style="text-align: left;">结算方式,1同城月结 3大网月结 4余额支付</td> </tr> <tr> <td style="text-align: left;">cityName</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">发单城市</td> </tr> <tr> <td style="text-align: left;">customerCode</td> <td style="text-align: left;">String</td> <td style="text-align: left;">否</td> <td style="text-align: left;">&quot;&quot;</td> <td style="text-align: left;">大网月结卡号</td> </tr> <tr> <td style="text-align: left;">senderName</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">发件人姓名</td> </tr> <tr> <td style="text-align: left;">senderPhone</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">发件人电话</td> </tr> <tr> <td style="text-align: left;">senderAddress</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">发件人地址</td> </tr> <tr> <td style="text-align: left;">receiverName</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">收件人姓名</td> </tr> <tr> <td style="text-align: left;">receiverPhone</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">收件人电话</td> </tr> <tr> <td style="text-align: left;">receiverAddress</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">收件人地址</td> </tr> <tr> <td style="text-align: left;">productType</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">是</td> <td style="text-align: left;">物品类型,枚举值见下面定义</td> </tr> <tr> <td style="text-align: left;">weightGram</td> <td style="text-align: left;">String</td> <td style="text-align: left;">否</td> <td style="text-align: left;">0</td> <td style="text-align: left;">物品重量,单位:千克</td> </tr> <tr> <td style="text-align: left;">isInsured</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是否保价,0:非保价;1:保价</td> </tr> <tr> <td style="text-align: left;">declaredValue</td> <td style="text-align: left;">String</td> <td style="text-align: left;">否</td> <td style="text-align: left;">0</td> <td style="text-align: left;">保价金额,单位:元</td> </tr> <tr> <td style="text-align: left;">totalPrice</td> <td style="text-align: left;">String</td> <td style="text-align: left;">是</td> <td style="text-align: left;">商品总金额,单位:元</td> </tr> <tr> <td style="text-align: left;">isAppoint</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是否预约,0:非预约单;1:预约单</td> </tr> <tr> <td style="text-align: left;">appointType</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">否</td> <td style="text-align: left;">0</td> <td style="text-align: left;">预约单类型,预约单的时候传入,1:预约单送达单;2:预约单上门单</td> </tr> <tr> <td style="text-align: left;">expectPickupTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">否</td> <td style="text-align: left;">&quot;&quot;</td> <td style="text-align: left;">用户期望上门时间,appoint_type=2时需必传,格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">isPersonDirect</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">否</td> <td style="text-align: left;">0</td> <td style="text-align: left;">是否是专人直送订单,0:否;1:是</td> </tr> </tbody> </table> <p>请求示例:</p> <pre><code class="language-json">{ &amp;quot;settlementType&amp;quot;: 1, &amp;quot;cityName&amp;quot;: &amp;quot;北京市&amp;quot;, &amp;quot;customerCode&amp;quot;: &amp;quot;9999999999&amp;quot;, &amp;quot;senderName&amp;quot;: &amp;quot;张三&amp;quot;, &amp;quot;senderPhone&amp;quot;: &amp;quot;13800138000&amp;quot;, &amp;quot;senderAddress&amp;quot;: &amp;quot;北京市顺义区南法信顺捷大厦&amp;quot;, &amp;quot;receiverName&amp;quot;: &amp;quot;李四&amp;quot;, &amp;quot;receiverPhone&amp;quot;: &amp;quot;13900139000&amp;quot;, &amp;quot;receiverAddress&amp;quot;: &amp;quot;北京市顺义区南法信地铁站&amp;quot;, &amp;quot;productType&amp;quot;: 1, &amp;quot;weightGram&amp;quot;: &amp;quot;20&amp;quot;, &amp;quot;isInsured&amp;quot;: 1, &amp;quot;declaredValue&amp;quot;: &amp;quot;500&amp;quot;, &amp;quot;totalPrice&amp;quot;: &amp;quot;500&amp;quot;, &amp;quot;isAppoint&amp;quot;: 1, &amp;quot;appointType&amp;quot;: 2, &amp;quot;expectPickupTime&amp;quot;: &amp;quot;2023-01-25 14:00:00&amp;quot;, &amp;quot;isPersonDirect&amp;quot;: 0 }</code></pre> <p>响应参数:</p> <table> <thead> <tr> <th style="text-align: left;">参数名称</th> <th style="text-align: left;">参数类型</th> <th style="text-align: left;">描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">deliveryDistanceMeter</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">配送距离,单位:千米</td> </tr> <tr> <td style="text-align: left;">expectTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">预计送达(上门)时间,格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">feeDetail</td> <td style="text-align: left;">Object</td> <td style="text-align: left;">费用明细</td> </tr> <tr> <td style="text-align: left;">- basicFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">起步价,单位:元</td> </tr> <tr> <td style="text-align: left;">- cancelExcessFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">拒收扣费,单位:元</td> </tr> <tr> <td style="text-align: left;">- extraFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">附加费,单位:元</td> </tr> <tr> <td style="text-align: left;">- gratuityFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">小费,单位:元</td> </tr> <tr> <td style="text-align: left;">- overDistanceFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">超距离费用,单位:元</td> </tr> <tr> <td style="text-align: left;">- overWeightFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">超重量费用,单位:元</td> </tr> <tr> <td style="text-align: left;">- overflowFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">爆单费,单位:元</td> </tr> <tr> <td style="text-align: left;">- shopPayPrice</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">配送费总额,单位:元</td> </tr> <tr> <td style="text-align: left;">- specialTimeFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">特殊时段费,单位:元</td> </tr> <tr> <td style="text-align: left;">- vasFee</td> <td style="text-align: left;">BigDecimal</td> <td style="text-align: left;">增值服务费,单位:元</td> </tr> <tr> <td style="text-align: left;">promiseDeliveryTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">预计配送时间,单位:分钟</td> </tr> <tr> <td style="text-align: left;">pushTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">推单时间,格式:yyyy-MM-dd HH:mm:ss</td> </tr> </tbody> </table> <p>响应示例:</p> <pre><code class="language-json">// 响应成功示例 { &amp;quot;result&amp;quot;: { &amp;quot;deliveryDistanceMeter&amp;quot;: 1.312, &amp;quot;expectTime&amp;quot;: &amp;quot;2024-01-22 20:10:59&amp;quot;, &amp;quot;feeDetail&amp;quot;: { &amp;quot;basicFee&amp;quot;: 0.01, &amp;quot;cancelExcessFee&amp;quot;: 0, &amp;quot;extraFee&amp;quot;: 0, &amp;quot;gratuityFee&amp;quot;: 0, &amp;quot;overDistanceFee&amp;quot;: 0, &amp;quot;overWeightFee&amp;quot;: 0.15, &amp;quot;overflowFee&amp;quot;: 0, &amp;quot;shopPayPrice&amp;quot;: 3.16, &amp;quot;specialTimeFee&amp;quot;: 0, &amp;quot;vasFee&amp;quot;: 3 }, &amp;quot;promiseDeliveryTime&amp;quot;: &amp;quot;49&amp;quot;, &amp;quot;pushTime&amp;quot;: &amp;quot;2024-01-22 18:52:03&amp;quot; }, &amp;quot;succ&amp;quot;: &amp;quot;ok&amp;quot;, &amp;quot;msg&amp;quot;: null }</code></pre> <p>物品类型代码:</p> <table> <thead> <tr> <th>枚举值</th> <th>物品类型</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>快餐</td> </tr> <tr> <td>2</td> <td>药品</td> </tr> <tr> <td>3</td> <td>百货</td> </tr> <tr> <td>4</td> <td>脏衣服收</td> </tr> <tr> <td>5</td> <td>干净衣服派</td> </tr> <tr> <td>6</td> <td>生鲜</td> </tr> <tr> <td>8</td> <td>高端饮品</td> </tr> <tr> <td>10</td> <td>快递</td> </tr> <tr> <td>12</td> <td>文件</td> </tr> <tr> <td>13</td> <td>蛋糕</td> </tr> <tr> <td>14</td> <td>鲜花</td> </tr> <tr> <td>15</td> <td>数码</td> </tr> <tr> <td>16</td> <td>服装</td> </tr> <tr> <td>17</td> <td>汽配</td> </tr> <tr> <td>18</td> <td>珠宝</td> </tr> <tr> <td>20</td> <td>披萨</td> </tr> <tr> <td>21</td> <td>中餐</td> </tr> <tr> <td>22</td> <td>水产</td> </tr> <tr> <td>32</td> <td>中端饮品</td> </tr> <tr> <td>33</td> <td>便利店</td> </tr> <tr> <td>34</td> <td>面包糕点</td> </tr> <tr> <td>35</td> <td>火锅</td> </tr> <tr> <td>36</td> <td>证照</td> </tr> <tr> <td>41</td> <td>外部落地配</td> </tr> <tr> <td>44</td> <td>年夜饭</td> </tr> <tr> <td>48</td> <td>成人用品</td> </tr> <tr> <td>55</td> <td>宠物用品</td> </tr> <tr> <td>56</td> <td>母婴用品</td> </tr> <tr> <td>57</td> <td>美妆用品</td> </tr> <tr> <td>58</td> <td>家居建材</td> </tr> <tr> <td>59</td> <td>眼镜行</td> </tr> <tr> <td>60</td> <td>图文广告</td> </tr> </tbody> </table>

页面列表

ITEM_HTML