1.3 签收
<p><strong>接口描述:</strong> </p>
<ul>
<li>合作方通过该接口推送签收订单到丽狮。</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/Shipment/Sign</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.sign”</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.sign”</td>
</tr>
<tr>
<td style="text-align: left;">eventBody</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;">signInfo</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;">consinee</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;">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;16349&quot;,
&quot;eventTarget&quot;: &quot;16348&quot;,
&quot;eventTime&quot;: &quot;2024/7/5 10:06:15&quot;,
&quot;eventType&quot;: &quot;logistics.shipment.sign&quot;
},
&quot;eventBody&quot;: {
&quot;logisticsDetail&quot;: [{
&quot;mailNo&quot;: &quot;80003018618&quot;,
&quot;occurTime&quot;: &quot;2024-07-05 10:02:43&quot;,
&quot;shipmentPlaceID&quot;: 320100,
&quot;deliveryPlaceID&quot;: 321088,
&quot;signInfo&quot;: {
&quot;mailNo&quot;: &quot;80003018618&quot;,
&quot;consinee&quot;: &quot;江都宏利&quot;,
&quot;branchCode&quot;: &quot;321088&quot;,
&quot;scanUser&quot;: &quot;254&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>