创建校园订单
<h3>功能描述</h3>
<ul>
<li>该接口用于在校园管家新建订单中新建跑腿单。
<h3>接入前须知</h3></li>
<li>请联系 王歆悦 进行校园验签key及默认下单人配置</li>
</ul>
<h3>接口定义</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">服务名称</th>
<th style="text-align: center;">批量交易</th>
<th style="text-align: center;">接口类型</th>
<th style="text-align: center;">接口uri</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">新建校园订单接口</td>
<td style="text-align: center;">不支持</td>
<td style="text-align: center;">接入/POST</td>
<td style="text-align: center;">/public/schoolPub/createOrder</td>
</tr>
</tbody>
</table>
<h3>请求</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">序号</th>
<th style="text-align: center;">字段名</th>
<th style="text-align: center;">类型（约束）</th>
<th style="text-align: center;">必填</th>
<th style="text-align: center;">默认值</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">schoolAppId</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">由校园系统方提供，用来单独验证</td>
</tr>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">orderType</td>
<td style="text-align: center;">Number (2)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单类型0帮我取1帮我送2帮我寄</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">schoolId</td>
<td style="text-align: center;">Number(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">学校ID</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">expressOrderId</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">管家订单号，管家下单返回</td>
</tr>
<tr>
<td style="text-align: center;">4</td>
<td style="text-align: center;">expressOrderMailno</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">管家运单号，管家下单返回</td>
</tr>
<tr>
<td style="text-align: center;">5</td>
<td style="text-align: center;">takeCode</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">取件码，帮我取必填</td>
</tr>
<tr>
<td style="text-align: center;">6</td>
<td style="text-align: center;">takePoint</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">取件站点，帮我取必填</td>
</tr>
<tr>
<td style="text-align: center;">7</td>
<td style="text-align: center;">sender</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">寄件人姓名，帮我送/帮我寄必填</td>
</tr>
<tr>
<td style="text-align: center;">8</td>
<td style="text-align: center;">senderMobile</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">寄件人手机号，帮我送/帮我寄必填</td>
</tr>
<tr>
<td style="text-align: center;">9</td>
<td style="text-align: center;">senderAddress</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">寄件详细地址，帮我送/帮我寄必填</td>
</tr>
<tr>
<td style="text-align: center;">10</td>
<td style="text-align: center;">recipient</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">收件人姓名 帮我取/帮我送必填</td>
</tr>
<tr>
<td style="text-align: center;">11</td>
<td style="text-align: center;">recipientMobile</td>
<td style="text-align: center;">String (20)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">收件人手机号 帮我取/帮我送必填</td>
</tr>
<tr>
<td style="text-align: center;">12</td>
<td style="text-align: center;">recipientAddress</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">收件详细地址 帮我取/帮我送必填</td>
</tr>
<tr>
<td style="text-align: center;">13</td>
<td style="text-align: center;">postStation</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">快递站点 帮我寄必填</td>
</tr>
<tr>
<td style="text-align: center;">14</td>
<td style="text-align: center;">consignmentId</td>
<td style="text-align: center;">Number(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">托寄物ID</td>
</tr>
<tr>
<td style="text-align: center;">15</td>
<td style="text-align: center;">freight</td>
<td style="text-align: center;">Number(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">运费总额</td>
</tr>
<tr>
<td style="text-align: center;">16</td>
<td style="text-align: center;">expectedDeliveryTime</td>
<td style="text-align: center;">Date</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">期望送达时间 yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: center;">17</td>
<td style="text-align: center;">goods</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">物品信息</td>
</tr>
<tr>
<td style="text-align: center;">18</td>
<td style="text-align: center;">remark</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单备注</td>
</tr>
<tr>
<td style="text-align: center;">19</td>
<td style="text-align: center;">shopId</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商家ID</td>
</tr>
<tr>
<td style="text-align: center;">20</td>
<td style="text-align: center;">userCouponId</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">优惠券ID</td>
</tr>
<tr>
<td style="text-align: center;">21</td>
<td style="text-align: center;">externalOrderNo</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">三方单号</td>
</tr>
<tr>
<td style="text-align: center;">22</td>
<td style="text-align: center;">monthlyNumber</td>
<td style="text-align: center;">String(10)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">月结卡号</td>
</tr>
<tr>
<td style="text-align: center;">23</td>
<td style="text-align: center;">toLatitude</td>
<td style="text-align: center;">Double(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">收件纬度</td>
</tr>
<tr>
<td style="text-align: center;">24</td>
<td style="text-align: center;">toLongitude</td>
<td style="text-align: center;">Double(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">收件经度</td>
</tr>
</tbody>
</table>
<h3>响应</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">序号</th>
<th style="text-align: center;">字段名</th>
<th style="text-align: center;">类型（约束）</th>
<th style="text-align: center;">必填</th>
<th style="text-align: center;">字段说明</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">msg</td>
<td style="text-align: center;">String (200)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">信息</td>
<td style="text-align: left;">提示信息</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">succ</td>
<td style="text-align: center;">String (10)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">状态码</td>
<td style="text-align: left;">返回成功或失败信息(ok/fail)</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">result</td>
<td style="text-align: center;">List<PubCreateOrderRes> (/)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">数据</td>
<td style="text-align: left;">数据，可能为空</td>
</tr>
</tbody>
</table>
<h4>响应result<List></h4>
<h5>PubCreateOrderRes</h5>
<table>
<thead>
<tr>
<th style="text-align: center;">序号</th>
<th style="text-align: center;">字段名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: center;">字段说明</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">orderType</td>
<td style="text-align: center;">Number (2)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单类型0帮我取1帮我送2帮我寄</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">schoolId</td>
<td style="text-align: center;">String(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">学校ID</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">schoolName</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">所属学校名称</td>
</tr>
<tr>
<td style="text-align: center;">4</td>
<td style="text-align: center;">deptCode</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">所属网点</td>
</tr>
<tr>
<td style="text-align: center;">5</td>
<td style="text-align: center;">waybillNo</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">校园运单号</td>
</tr>
<tr>
<td style="text-align: center;">6</td>
<td style="text-align: center;">takeCode</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">取件码，帮我取必填</td>
</tr>
<tr>
<td style="text-align: center;">7</td>
<td style="text-align: center;">takePoint</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">取件站点，帮我取必填</td>
</tr>
<tr>
<td style="text-align: center;">8</td>
<td style="text-align: center;">sender</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">寄件人姓名，帮我送/帮我寄必填</td>
</tr>
<tr>
<td style="text-align: center;">9</td>
<td style="text-align: center;">senderMobile</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">寄件人手机号，帮我送/帮我寄必填</td>
</tr>
<tr>
<td style="text-align: center;">10</td>
<td style="text-align: center;">senderAddress</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">条件</td>
<td style="text-align: center;">寄件详细地址，帮我送/帮我寄必填</td>
</tr>
<tr>
<td style="text-align: center;">11</td>
<td style="text-align: center;">recipient</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">收件人姓名</td>
</tr>
<tr>
<td style="text-align: center;">12</td>
<td style="text-align: center;">recipientMobile</td>
<td style="text-align: center;">String (20)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">收件人手机号</td>
</tr>
<tr>
<td style="text-align: center;">13</td>
<td style="text-align: center;">recipientAddress</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">收件详细地址</td>
</tr>
<tr>
<td style="text-align: center;">14</td>
<td style="text-align: center;">consignmentId</td>
<td style="text-align: center;">Number(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">托寄物ID</td>
</tr>
<tr>
<td style="text-align: center;">15</td>
<td style="text-align: center;">consignmentSize</td>
<td style="text-align: center;">String (50)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">托寄物大小</td>
</tr>
<tr>
<td style="text-align: center;">16</td>
<td style="text-align: center;">freight</td>
<td style="text-align: center;">BigDecimal</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">预估基础运费</td>
</tr>
<tr>
<td style="text-align: center;">17</td>
<td style="text-align: center;">discountSpread</td>
<td style="text-align: center;">BigDecimal</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">预估优惠金额</td>
</tr>
<tr>
<td style="text-align: center;">18</td>
<td style="text-align: center;">discountFreight</td>
<td style="text-align: center;">BigDecimal</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">预估支付金额</td>
</tr>
<tr>
<td style="text-align: center;">19</td>
<td style="text-align: center;">expectedDeliveryTime</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">期望送达时间 yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: center;">20</td>
<td style="text-align: center;">goods</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">物品信息</td>
</tr>
<tr>
<td style="text-align: center;">21</td>
<td style="text-align: center;">remark</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单备注</td>
</tr>
<tr>
<td style="text-align: center;">22</td>
<td style="text-align: center;">shopId</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商家ID</td>
</tr>
<tr>
<td style="text-align: center;">23</td>
<td style="text-align: center;">shopName</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商家名称</td>
</tr>
<tr>
<td style="text-align: center;">24</td>
<td style="text-align: center;">userCouponId</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">优惠券ID</td>
</tr>
<tr>
<td style="text-align: center;">25</td>
<td style="text-align: center;">userCouponName</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">优惠券名称</td>
</tr>
<tr>
<td style="text-align: center;">26</td>
<td style="text-align: center;">createUser</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">创建人</td>
</tr>
<tr>
<td style="text-align: center;">27</td>
<td style="text-align: center;">createTm</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">创建时间 yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: center;">28</td>
<td style="text-align: center;">externalOrderNo</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">三方单号</td>
</tr>
<tr>
<td style="text-align: center;">29</td>
<td style="text-align: center;">monthlyNumber</td>
<td style="text-align: center;">String(10)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">月结卡号</td>
</tr>
</tbody>
</table>
<h3>报文范例</h3>
<ul>
<li>
<p><strong>请求报文</strong></p>
<pre><code>{
&quot;schoolAppId&quot;: &quot;a&quot;,
&quot;orderType&quot;: 0,
&quot;schoolId&quot;: 884328609426243584,
&quot;takeCode&quot;: &quot;333&quot;,
&quot;takePoint&quot;: &quot;444&quot;,
&quot;recipient&quot;: &quot;jsx&quot;,
&quot;recipientMobile&quot;: &quot;17610652218&quot;,
&quot;recipientAddress&quot;: &quot;g1g1g&quot;,
&quot;consignmentId&quot;: &quot;887562859614674944&quot;,
&quot;expectedDeliveryTime&quot;:&quot;2024-07-30 17:30:30&quot;
}</code></pre>
</li>
<li><strong>响应报文</strong>
<ul>
<li>成功报文
<pre><code>{
&quot;result&quot;: {
&quot;waybillNo&quot;: &quot;XY978185555512373248&quot;,
&quot;takeCode&quot;: &quot;333&quot;,
&quot;takePoint&quot;: &quot;444&quot;,
&quot;recipient&quot;: &quot;jsx&quot;,
&quot;recipientMobile&quot;: &quot;17610652218&quot;,
&quot;recipientAddress&quot;: &quot;g1g1g&quot;,
&quot;expressCompany&quot;: &quot;&quot;,
&quot;sender&quot;: &quot;&quot;,
&quot;senderMobile&quot;: &quot;&quot;,
&quot;senderAddress&quot;: &quot;&quot;,
&quot;remark&quot;: &quot;&quot;,
&quot;expectedDeliveryTime&quot;: &quot;2024-07-30 17:30:30&quot;,
&quot;goods&quot;: &quot;&quot;,
&quot;consignmentId&quot;: 887562859614674944,
&quot;consignmentSize&quot;: &quot;三毛&quot;,
&quot;freight&quot;: 0.3,
&quot;discountSpread&quot;: 0,
&quot;discountFreight&quot;: 0.3,
&quot;orderType&quot;: 0,
&quot;schoolName&quot;: &quot;测试学校&quot;,
&quot;schoolId&quot;: 884328609426243584,
&quot;shopName&quot;: &quot;&quot;,
&quot;shopId&quot;: null,
&quot;createUser&quot;: &quot;jsx127116840&quot;,
&quot;createTm&quot;: &quot;2024-07-30 16:47:00&quot;,
&quot;userCouponId&quot;: null,
&quot;userCouponName&quot;: &quot;&quot;
},
&quot;succ&quot;: &quot;ok&quot;,
&quot;msg&quot;: null,
&quot;extendResult&quot;: null
}</code></pre></li>
<li>失败报文-范例1
<pre><code>{
&quot;result&quot;: null,
&quot;succ&quot;: &quot;fail&quot;,
&quot;msg&quot;: &quot;所选订单类型不存在&quot;
}</code></pre></li>
<li>失败报文-范例2
<pre><code>{
&quot;msg&quot;:&quot;未校验到下单人数据&quot;,
&quot;result&quot;: null,
&quot;succ&quot;: &quot;fail&quot;
}</code></pre></li>
</ul></li>
</ul>