31.订单核重核价推送接口
<h3>功能描述</h3>
<ul>
<li>该接口用于:用于小件员在上门取件时,寄件人将快件给快递员之后,小哥录入重量体积信息操作揽收后(54节点之前,50节前之前),向接入方发起核重核价请求,需配合客户标签管理SOP02001使用,以触发接口调用</li>
<li>客户需提供一个符合以下规范的HTTP/HTTPS URL,以接收顺丰快递管家通用接口推送的信息:
1.核重核价信息为JSON格式,通过HTTP/HTTPS POST方式推送给客户;
2.在客户处理完核重核价信息后,向顺丰快递管家通用接口返回响应JSON信息,响应JSON报文结果只能为OK/ERR,如为ERR,顺丰快递管家通用接口将重新推送该运费信息,失败3次后不再推送;</li>
</ul>
<p>注:此接口建议客户方系统做验签功能,规避被恶意攻击的风险;</p>
<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;">客户方提供</td>
</tr>
</tbody>
</table>
<h3>元素<请求></h3>
<ul>
<li><strong>主体</strong></li>
</ul>
<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: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">orderNo</td>
<td style="text-align: center;">String(64)</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;">waybillNo</td>
<td style="text-align: center;">String(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">顺丰运单号</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">executeTime</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">操作时间(如:2023-11-09 13:50:12)</td>
</tr>
<tr>
<td style="text-align: center;">4</td>
<td style="text-align: center;">checkWeight</td>
<td style="text-align: center;">Double</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">核重重量,单位千克</td>
</tr>
<tr>
<td style="text-align: center;">5</td>
<td style="text-align: center;">realWeight</td>
<td style="text-align: center;">Double</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">实际重量,单位千克</td>
</tr>
<tr>
<td style="text-align: center;">6</td>
<td style="text-align: center;">meterageType</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">计费类型 0: 重量计费 1: 体积计费 2: 其他</td>
</tr>
<tr>
<td style="text-align: center;">7</td>
<td style="text-align: center;">checkPrice</td>
<td style="text-align: center;">Double</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">核重价格,单位元</td>
</tr>
<tr>
<td style="text-align: center;">8</td>
<td style="text-align: center;">attributes</td>
<td style="text-align: center;">String(6094)</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">扩展字段</td>
</tr>
<tr>
<td style="text-align: center;">9</td>
<td style="text-align: center;">feeList</td>
<td style="text-align: center;">List<FeeList></td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">费用:List形式 费用列表 1:主费用 3:保价 67:包装</td>
</tr>
</tbody>
</table>
<ul>
<li><strong>FeeList 字段说明</strong></li>
</ul>
<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: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">type</td>
<td style="text-align: center;">String(100)</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;">value</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">值</td>
</tr>
</tbody>
</table>
<h3>元素<响应></h3>
<ul>
<li><strong>主体</strong></li>
</ul>
<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;">status</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-成功,ERR-失败;失败会重推两次,共推送三次,全部返回ERR则不再推送。</td>
</tr>
</tbody>
</table>
<h3>报文范例</h3>
<ul>
<li>
<p><strong>请求报文</strong></p>
<pre><code>{
&quot;orderNo&quot;: &quot;cacbf88651b8402e849adff7fc7ab880&quot;,
&quot;waybillNo&quot;: &quot;SF1380032220531&quot;,
&quot;checkWeight&quot;: 1.2,
&quot;checkPrice&quot;: 11,
&quot;executeTime&quot;: &quot;2021-01-22 19:00:00&quot;,
&quot;feeList&quot;: [
{
&quot;type&quot;: &quot;1&quot;,
&quot;value&quot;: 11
},
{
&quot;type&quot;: &quot;67&quot;,
&quot;value&quot;: 1
}
],
&quot;attributes&quot;:&quot;{\&quot;length\&quot;:11.1,\&quot;width\&quot;:11.1,\&quot;height\&quot;:11.1}
}</code></pre>
</li>
<li>
<p><strong>响应报文</strong></p>
<ol>
<li>
<p>成功报文</p>
<pre><code>{
&quot;status&quot;:&quot;OK&quot;
}</code></pre>
</li>
<li>失败报文
<pre><code>{
&quot;status&quot;:&quot;ERR&quot;
}</code></pre></li>
</ol>
</li>
</ul>