1.2 创建轨迹(交接信息)
<p><strong>接口描述：</strong> </p>
<ul>
<li>合作方通过该接口推送订单轨迹(交货信息)到丽狮。</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>/api/Shipment/Handover</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.handover”</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.handover”</td>
</tr>
<tr>
<td style="text-align: left;">eventBody</td>
</tr>
<tr>
<td style="text-align: left;">transportHandovers</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;">logisticsRemark</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;">branchCode</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;">scanUser</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>
<tr>
<td style="text-align: left;">logisticsRemark</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;13649&quot;,
&quot;eventTarget&quot;: &quot;16348&quot;,
&quot;eventTime&quot;: &quot;2024/7/5 9:21:15&quot;,
&quot;eventType&quot;: &quot;logistics.shipment.handover&quot;
},
&quot;eventBody&quot;: {
&quot;transportHandovers&quot;: [{
&quot;mailNo&quot;: &quot;80003027825&quot;,
&quot;occurTime&quot;: &quot;2024-07-05 09:20:03&quot;,
&quot;logisticsRemark&quot;: &quot;陈开学进行了接货操作&quot;,
&quot;branchCode&quot;: &quot;340101&quot;,
&quot;scanUser&quot;: &quot;374&quot;,
&quot;itemDetail&quot;: [{
&quot;SKU&quot;: &quot;80003027825001&quot;,
&quot;logisticsRemark&quot;: &quot;&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
}</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>