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


8.路由推送接口

<h3>功能描述</h3> <ul> <li>该接口用于: 1.顺丰快递管家向客户系统推送国际件订单路由;</li> </ul> <h3>接口定义</h3> <table> <thead> <tr> <th style="text-align: center;">服务名称</th> <th style="text-align: center;">批量交易</th> <th style="text-align: center;">接口类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">路由推送</td> <td style="text-align: center;">不支持</td> <td style="text-align: center;">接入/POST</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求Body&gt;</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>trackUniqueId</td> <td>String</td> <td>当前此路由的唯一Id</td> </tr> <tr> <td>2</td> <td>opCode</td> <td>String</td> <td>SF国际路由操作码</td> </tr> <tr> <td>3</td> <td>opCodeTranslation</td> <td>String</td> <td>SF国际路由操作码描述</td> </tr> <tr> <td>4</td> <td>reasonCode</td> <td>String</td> <td>国际原因代码</td> </tr> <tr> <td>5</td> <td>reasonCodeTranslation</td> <td>String</td> <td>国际原因代码描述</td> </tr> <tr> <td>6</td> <td>sfWaybillNo</td> <td>String</td> <td>顺丰运单号</td> </tr> <tr> <td>7</td> <td>trackCountry</td> <td>String</td> <td>轨迹发生国家/地区</td> </tr> <tr> <td>8</td> <td>trackProvince</td> <td>String</td> <td>轨迹发生州/省</td> </tr> <tr> <td>9</td> <td>trackCity</td> <td>String</td> <td>轨迹发生城市</td> </tr> <tr> <td>10</td> <td>trackAddr</td> <td>String</td> <td>轨迹发生详细地址</td> </tr> <tr> <td>11</td> <td>trackPostCode</td> <td>String</td> <td>轨迹发生邮编</td> </tr> <tr> <td>12</td> <td>localTm</td> <td>String</td> <td>轨迹发生时间(当地时间); 格式:yyyy-MM-dd HHss</td> </tr> <tr> <td>13</td> <td>gmt</td> <td>String</td> <td>轨迹发生地所在时区 格式:GMT+08:00或GMT-08:30或GMT+00:00</td> </tr> <tr> <td>14</td> <td>trackRemark</td> <td>String</td> <td>路由轨迹对外描述</td> </tr> </tbody> </table> <h3>元素&lt;响应&gt;</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;">必填</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><strong>明文请求示例</strong></h3> <pre><code class="language-json">{         "gmt": "GMT+08:00",         "localTm": "2019-12-09 16:48:34",         "opCode": "30",         "opCodeTranslation": "装车",         "reasonCode": "",         "reasonCodeTranslation": "",         "sfWaybillNo": "885204935082",         "trackAddr": "",         "trackCity": "",         "trackCountry": "KR",         "trackPostCode": "",         "trackProvince": "",         "trackRemark": "快件在【香港新界青衣中转场】已装车,准备发往下一站",         "trackUniqueId": "2ef21f6613c3119392f27ba294d04277"     }</code></pre> <h3><strong>响应报文</strong></h3> <ol> <li> <p>成功报文</p> <pre><code>{ "status":"OK" }</code></pre> </li> <li>失败报文 <pre><code>{ "status":"ERR" }</code></pre></li> </ol>

页面列表

ITEM_HTML