【顺丰快递管家】通用接口文档


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>元素&lt;请求&gt;</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&lt;FeeList&gt;</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>元素&lt;响应&gt;</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>{ &amp;quot;orderNo&amp;quot;: &amp;quot;cacbf88651b8402e849adff7fc7ab880&amp;quot;, &amp;quot;waybillNo&amp;quot;: &amp;quot;SF1380032220531&amp;quot;, &amp;quot;checkWeight&amp;quot;: 1.2, &amp;quot;checkPrice&amp;quot;: 11, &amp;quot;executeTime&amp;quot;: &amp;quot;2021-01-22 19:00:00&amp;quot;, &amp;quot;feeList&amp;quot;: [ { &amp;quot;type&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;value&amp;quot;: 11 }, { &amp;quot;type&amp;quot;: &amp;quot;67&amp;quot;, &amp;quot;value&amp;quot;: 1 } ], &amp;quot;attributes&amp;quot;:&amp;quot;{\&amp;quot;length\&amp;quot;:11.1,\&amp;quot;width\&amp;quot;:11.1,\&amp;quot;height\&amp;quot;:11.1} }</code></pre> </li> <li> <p><strong>响应报文</strong></p> <ol> <li> <p>成功报文</p> <pre><code>{ &amp;quot;status&amp;quot;:&amp;quot;OK&amp;quot; }</code></pre> </li> <li>失败报文 <pre><code>{ &amp;quot;status&amp;quot;:&amp;quot;ERR&amp;quot; }</code></pre></li> </ol> </li> </ul>

页面列表

ITEM_HTML