创建同城订单
<p><br/></p>
<p>> 创建同城订单</p>
<p>请求接口：/public/pub/tcOrder/createOrder</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>默认值</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>结算方式，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>发单城市</td>
</tr>
<tr>
<td style="text-align: left;">orderSequence</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">否</td>
<td>""</td>
<td style="text-align: left;">取货号，示例：美团22号</td>
</tr>
<tr>
<td style="text-align: left;">customerCode</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">否</td>
<td>""</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>发件人姓名</td>
</tr>
<tr>
<td style="text-align: left;">senderPhone</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>发件人电话</td>
</tr>
<tr>
<td style="text-align: left;">senderProvince</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>发件人省</td>
</tr>
<tr>
<td style="text-align: left;">senderCity</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>发件人市</td>
</tr>
<tr>
<td style="text-align: left;">senderCounty</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>发件人区</td>
</tr>
<tr>
<td style="text-align: left;">senderAddress</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>发件人地址</td>
</tr>
<tr>
<td style="text-align: left;">receiverName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>收件人姓名</td>
</tr>
<tr>
<td style="text-align: left;">receiverPhone</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>收件人电话</td>
</tr>
<tr>
<td style="text-align: left;">receiverProvince</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>收件人省</td>
</tr>
<tr>
<td style="text-align: left;">receiverCity</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>收件人市</td>
</tr>
<tr>
<td style="text-align: left;">receiverCounty</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>收件人区</td>
</tr>
<tr>
<td style="text-align: left;">receiverAddress</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>收件人地址</td>
</tr>
<tr>
<td style="text-align: left;">userOrderId</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td>商家订单号</td>
</tr>
<tr>
<td style="text-align: left;">productType</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">是</td>
<td>物品类型，枚举值见下面定义</td>
</tr>
<tr>
<td style="text-align: left;">weightGram</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">否</td>
<td>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>是否保价，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>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>商品总金额，单位：元</td>
</tr>
<tr>
<td style="text-align: left;">isAppoint</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">是</td>
<td>是否预约，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>0</td>
<td style="text-align: left;">预约单类型，预约单的时候传入，1：预约单送达单；2：预约单上门单</td>
</tr>
<tr>
<td style="text-align: left;">isPersonDirect</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">否</td>
<td>0</td>
<td style="text-align: left;">是否是专人直送订单，0：否；1：是</td>
</tr>
<tr>
<td style="text-align: left;">expectTime</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">否</td>
<td>""</td>
<td style="text-align: left;">用户期望送达时间，若传入自此段且时间大于配送时效，则按照预约送达单处理，时间小于配送时效按照立即单处理；appoint_type=1时需必传，格式：yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">expectPickupTime</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">否</td>
<td>""</td>
<td style="text-align: left;">用户期望上门时间，appoint_type=2时需必传，格式：yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">否</td>
<td>""</td>
<td style="text-align: left;">订单备注</td>
</tr>
<tr>
<td style="text-align: left;">verifyCodeType</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">否</td>
<td>0</td>
<td style="text-align: left;">是否发送取件码或收件码，0不生成，1发送取件码，2发送收件码，3二者都发送</td>
</tr>
</tbody>
</table>
<p>请求示例：</p>
<pre><code class="language-json">{
&quot;settlementType&quot;: 1,
&quot;cityName&quot;: &quot;北京市&quot;,
&quot;orderSequence&quot;: &quot;ORDER-20240122-001&quot;,
&quot;customerCode&quot;: &quot;CUST001&quot;,
&quot;senderName&quot;: &quot;张三&quot;,
&quot;senderPhone&quot;: &quot;13900139000&quot;,
&quot;senderProvince&quot;: &quot;北京市&quot;,
&quot;senderCity&quot;: &quot;北京市&quot;,
&quot;senderCounty&quot;: &quot;顺义区&quot;,
&quot;senderAddress&quot;: &quot;北京市顺义区南法信顺捷大厦&quot;,
&quot;receiverName&quot;: &quot;李四&quot;,
&quot;receiverPhone&quot;: &quot;13700137000&quot;,
&quot;receiverProvince&quot;: &quot;北京市&quot;,
&quot;receiverCity&quot;: &quot;北京市&quot;,
&quot;receiverCounty&quot;: &quot;顺义区&quot;,
&quot;receiverAddress&quot;: &quot;北京市顺义区南法信顺捷大厦&quot;,
&quot;userOrderId&quot;: &quot;MERCHANT-ORDER-001&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;800&quot;,
&quot;isAppoint&quot;: 1,
&quot;appointType&quot;: 2,
&quot;isPersonDirect&quot;: 1,
&quot;expectTime&quot;: &quot;2024-01-22 14:00:00&quot;,
&quot;expectPickupTime&quot;: &quot;2024-01-22 10:00:00&quot;,
&quot;remark&quot;: &quot;特殊备注信息&quot;,
&quot;verifyCodeType&quot;: 3
}</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;">sfOrderId</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">顺丰订单号</td>
</tr>
<tr>
<td style="text-align: left;">userOrderId</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>
<tr>
<td style="text-align: left;">promiseDeliveryTime</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">预计配送时间，单位：分钟</td>
</tr>
<tr>
<td style="text-align: left;">settlementType</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">结算方式</td>
</tr>
<tr>
<td style="text-align: left;">deliveryDistanceMeter</td>
<td style="text-align: left;">Integer</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;">totalPayMoney</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">支付费用，单位：元</td>
</tr>
<tr>
<td style="text-align: left;">realPayMoney</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">实际支付金额，单位：元</td>
</tr>
<tr>
<td style="text-align: left;">couponsTotalFee</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;">pickupCode</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">取件码</td>
</tr>
<tr>
<td style="text-align: left;">completeCode</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">收件码</td>
</tr>
<tr>
<td style="text-align: left;">payAmount</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">企业充值账户扣款金额，单位：元</td>
</tr>
<tr>
<td style="text-align: left;">grantAmount</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">企业返现账户扣款金额，单位：元</td>
</tr>
</tbody>
</table>
<p>响应示例：</p>
<pre><code class="language-json">// 响应成功示例
{
&quot;result&quot;: {
&quot;completeCode&quot;: 8564,
&quot;couponsTotalFee&quot;: 0,
&quot;deliveryDistanceMeter&quot;: 7296,
&quot;expectTime&quot;: &quot;2024-01-25 15:30:57&quot;,
&quot;grantAmount&quot;: 0,
&quot;overflowFee&quot;: 0,
&quot;payAmount&quot;: 0,
&quot;pickupCode&quot;: 5511,
&quot;promiseDeliveryTime&quot;: 1,
&quot;pushTime&quot;: &quot;2024-01-25 15:29:58&quot;,
&quot;realPayMoney&quot;: 1,
&quot;settlementType&quot;: 3,
&quot;sfOrderId&quot;: &quot;JS4154836256960&quot;,
&quot;totalPayMoney&quot;: 1,
&quot;userOrderId&quot;: &quot;MERCHANT-ORDER-001&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>