预创建同城订单
<p><br/></p>
<p>> 预创建同城订单</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;">""</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;">""</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">{
&quot;settlementType&quot;: 1,
&quot;cityName&quot;: &quot;北京市&quot;,
&quot;customerCode&quot;: &quot;9999999999&quot;,
&quot;senderName&quot;: &quot;张三&quot;,
&quot;senderPhone&quot;: &quot;13800138000&quot;,
&quot;senderAddress&quot;: &quot;北京市顺义区南法信顺捷大厦&quot;,
&quot;receiverName&quot;: &quot;李四&quot;,
&quot;receiverPhone&quot;: &quot;13900139000&quot;,
&quot;receiverAddress&quot;: &quot;北京市顺义区南法信地铁站&quot;,
&quot;productType&quot;: 1,
&quot;weightGram&quot;: &quot;20&quot;,
&quot;isInsured&quot;: 1,
&quot;declaredValue&quot;: &quot;500&quot;,
&quot;totalPrice&quot;: &quot;500&quot;,
&quot;isAppoint&quot;: 1,
&quot;appointType&quot;: 2,
&quot;expectPickupTime&quot;: &quot;2023-01-25 14:00:00&quot;,
&quot;isPersonDirect&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">// 响应成功示例
{
&quot;result&quot;: {
&quot;deliveryDistanceMeter&quot;: 1.312,
&quot;expectTime&quot;: &quot;2024-01-22 20:10:59&quot;,
&quot;feeDetail&quot;: {
&quot;basicFee&quot;: 0.01,
&quot;cancelExcessFee&quot;: 0,
&quot;extraFee&quot;: 0,
&quot;gratuityFee&quot;: 0,
&quot;overDistanceFee&quot;: 0,
&quot;overWeightFee&quot;: 0.15,
&quot;overflowFee&quot;: 0,
&quot;shopPayPrice&quot;: 3.16,
&quot;specialTimeFee&quot;: 0,
&quot;vasFee&quot;: 3
},
&quot;promiseDeliveryTime&quot;: &quot;49&quot;,
&quot;pushTime&quot;: &quot;2024-01-22 18:52:03&quot;
},
&quot;succ&quot;: &quot;ok&quot;,
&quot;msg&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>