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


6.预估运费查询接口

<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> <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;">/public/internationalOrder/v1/freight</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> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>companyId</td> <td>String(50)</td> <td>Y</td> <td>分配客户sendAppId</td> </tr> <tr> <td>2</td> <td>version</td> <td>String(10)</td> <td>否</td> <td>版本号(默认为空即可)</td> </tr> <tr> <td>3</td> <td>senderCountry</td> <td>String</td> <td>是</td> <td>寄件国家/地区的二字码采用ISO 3166 标准 Alpha-2 code如:CN,US,JP,KR,SG,MY</td> </tr> <tr> <td>4</td> <td>receiverCountry</td> <td>String</td> <td>是</td> <td>收件国家/地区的二字码采用ISO 3166 标准 Alpha-2 code如:CN,US,JP,KR,SG,MY</td> </tr> <tr> <td>5</td> <td>senderPostCode</td> <td>String</td> <td>是</td> <td>寄方邮编</td> </tr> <tr> <td>6</td> <td>receiverPostCode</td> <td>String</td> <td>是</td> <td>到方邮编</td> </tr> <tr> <td>7</td> <td>interProductCode</td> <td>String</td> <td>是</td> <td>产品统一映射码</td> </tr> <tr> <td>8</td> <td>consignedTm</td> <td>Date</td> <td>否</td> <td>寄件时间,YYYY-MM-DD HH:mm:ss(默认当前时间)</td> </tr> <tr> <td>9</td> <td>weight</td> <td>String</td> <td>是</td> <td>实际重量(KG)</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;">msg</td> <td style="text-align: center;">String (200)</td> <td style="text-align: center;">否</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;">succ</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/fail)</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">result</td> <td style="text-align: center;">String (/)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">数据</td> <td style="text-align: left;">数据</td> </tr> </tbody> </table> <h3><strong>元素&lt;响应&gt;**</strong>result**</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>currency</td> <td>String</td> <td>币种</td> </tr> <tr> <td>2</td> <td>totalFreight</td> <td>String</td> <td>总费用</td> </tr> <tr> <td>3</td> <td>weight</td> <td>String</td> <td>重量</td> </tr> </tbody> </table> <h3><strong>明文请求示例</strong></h3> <pre><code class="language-json">{     "companyId": "xxx",     "interProductCode": "INT0014",     "receiverCountry": "SG",     "receiverPostCode": "499938",     "senderCountry": "CN",     "senderPostCode": "518052",     "weight": "12.01" }</code></pre> <h3><strong>明文响应示例</strong></h3> <pre><code class="language-json">{     "succ": "ok",     "result": {         "currency": "CNY",         "totalFreight": "50",         "weight": "12"     },     "msg": "" }</code></pre>

页面列表

ITEM_HTML