1.1 创建订单
<p><strong>接口描述：</strong> </p>
<ul>
<li>合作方通过该接口提交订单到丽狮。</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>/api/Shipment/Create</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>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">msg_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>请求类型，固定为“logistics.shipment.create”</td>
</tr>
<tr>
<td style="text-align: left;">logistics_interface</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>接口请求数据Json，由以下参数组成，示例报文中的json为此参数的值</td>
</tr>
</tbody>
</table>
<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>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">logisticsEvent</td>
</tr>
<tr>
<td style="text-align: left;">eventHeader</td>
</tr>
<tr>
<td style="text-align: left;">eventSource</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>合作方ID，平台提供</td>
</tr>
<tr>
<td style="text-align: left;">eventTarget</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>丽狮ID，平台提供</td>
</tr>
<tr>
<td style="text-align: left;">eventTime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>请求时间</td>
</tr>
<tr>
<td style="text-align: left;">eventType</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>请求类型，固定为“logistics.shipment.create”</td>
</tr>
<tr>
<td style="text-align: left;">eventBody</td>
</tr>
<tr>
<td style="text-align: left;">paymentDetail</td>
</tr>
<tr>
<td style="text-align: left;">payType</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>付款方式：10-现付、20-到付、30-月结</td>
</tr>
<tr>
<td style="text-align: left;">beyongFee</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>超远费</td>
</tr>
<tr>
<td style="text-align: left;">cod</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>代收货款</td>
</tr>
<tr>
<td style="text-align: left;">deliveryFee</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>送货费</td>
</tr>
<tr>
<td style="text-align: left;">otherFee</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>其他费</td>
</tr>
<tr>
<td style="text-align: left;">packingFee</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>包装费</td>
</tr>
<tr>
<td style="text-align: left;">pickFee</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>提货费</td>
</tr>
<tr>
<td style="text-align: left;">shippingFee</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>运费</td>
</tr>
<tr>
<td style="text-align: left;">otherFeeRemark</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>否</td>
<td>备注</td>
</tr>
<tr>
<td style="text-align: left;">shippingFeeUnit</td>
<td style="text-align: left;">double</td>
<td style="text-align: left;"></td>
<td>否</td>
<td>币种</td>
</tr>
<tr>
<td style="text-align: left;">logisticsDetail</td>
<td style="text-align: left;">数组</td>
</tr>
<tr>
<td style="text-align: left;">mailNo</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>运单号</td>
</tr>
<tr>
<td style="text-align: left;">occurTime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>业务日期</td>
</tr>
<tr>
<td style="text-align: left;">shipmentPlaceID</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件网点ID</td>
</tr>
<tr>
<td style="text-align: left;">deliveryPlaceID</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件网点ID</td>
</tr>
<tr>
<td style="text-align: left;">sender</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件人姓名</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件人手机</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件人电话</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件人姓省份</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件人城市</td>
</tr>
<tr>
<td style="text-align: left;">streetAddress</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件人地址</td>
</tr>
<tr>
<td style="text-align: left;">zipCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>发件人邮编</td>
</tr>
<tr>
<td style="text-align: left;">receiver</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件人姓名</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件人手机</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件人电话</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件人姓省份</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件人城市</td>
</tr>
<tr>
<td style="text-align: left;">streetAddress</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件人地址</td>
</tr>
<tr>
<td style="text-align: left;">zipCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>收件人邮编</td>
</tr>
<tr>
<td style="text-align: left;">itemDetail</td>
<td style="text-align: left;">数组</td>
</tr>
<tr>
<td style="text-align: left;">SKU</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td>是</td>
<td>货物子标签</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code>{
&quot;logisticsEvent&quot;: {
&quot;eventHeader&quot;: {
&quot;eventSource&quot;: &quot;16349&quot;,
&quot;eventTarget&quot;: &quot;16348&quot;,
&quot;eventTime&quot;: &quot;2024/7/5 8:58:38&quot;,
&quot;eventType&quot;: &quot;logistics.shipment.create&quot;
},
&quot;eventBody&quot;: {
&quot;paymentDetail&quot;: {
&quot;payType&quot;: 20,
&quot;beyongFee&quot;: 0,
&quot;cod&quot;: 0,
&quot;deliveryFee&quot;: 0,
&quot;otherFee&quot;: 0,
&quot;otherFeeRemark&quot;: &quot;&quot;,
&quot;packingFee&quot;: 0,
&quot;pickFee&quot;: 0,
&quot;shippingFee&quot;: 20,
&quot;shippingFeeUnit&quot;: &quot;CNY&quot;
},
&quot;logisticsDetail&quot;: [
{
&quot;mailNo&quot;: &quot;240704503080&quot;,
&quot;occurTime&quot;: &quot;2024-07-05 08:57:53&quot;,
&quot;shipmentPlaceID&quot;: 420101,
&quot;deliveryPlaceID&quot;: 310000,
&quot;sender&quot;: {
&quot;name&quot;: &quot;百和&quot;,
&quot;phone&quot;: &quot;&quot;,
&quot;mobile&quot;: &quot;&quot;,
&quot;province&quot;: &quot;&quot;,
&quot;city&quot;: &quot;420101&quot;,
&quot;streetAddress&quot;: &quot;&quot;,
&quot;zipCode&quot;: &quot;000000&quot;
},
&quot;receiver&quot;: {
&quot;name&quot;: &quot;上海福磊&quot;,
&quot;phone&quot;: &quot;&quot;,
&quot;mobile&quot;: &quot;02134682085&quot;,
&quot;province&quot;: &quot;&quot;,
&quot;city&quot;: &quot;310000&quot;,
&quot;streetAddress&quot;: &quot;&quot;,
&quot;zipCode&quot;: &quot;000000&quot;
},
&quot;itemDetail&quot;: [
{
&quot;SKU&quot;: &quot;NJ-240704503080-1-1&quot;
}
]
}
]
}
}
}</code></pre>
<p><strong>返回结果</strong></p>
<pre><code>{
&quot;isSuccess&quot;: true,
&quot;message&quot;: null,
&quot;errorCode&quot;: null,
&quot;responseCode&quot;: null,
&quot;result&quot;: false
}
{
&quot;isSuccess&quot;: false,
&quot;message&quot;: &quot;将截断字符串或二进制数据。\r\n语句已终止。&quot;,
&quot;errorCode&quot;: null,
&quot;responseCode&quot;: null,
&quot;result&quot;: false
}</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;">isSuccess</td>
<td style="text-align: left;">bool</td>
<td>接口调用是否成功</td>
</tr>
<tr>
<td style="text-align: left;">errorCode</td>
<td style="text-align: left;">string</td>
<td>异常代码</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td>异常消息说明</td>
</tr>
<tr>
<td style="text-align: left;">responseCode</td>
<td style="text-align: left;">string</td>
<td>响应代码</td>
</tr>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">object</td>
<td>该字段用于查询类接口返回数据所用</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>