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


10.清单运费查询接口

<h3>功能描述</h3> <ul> <li>该接口用于:客户在通过顺丰快递管家下订单接口提交订单后,可使用此接口查询清单运费。</li> </ul> <pre><code>注:1.该接口只能在揽收后生效; 2.测试环境如需测试该接口,请将测试环境下单后的订单号与运单号发给顺丰研发接口人,便于其生成测试揽收信息; 3.运单号+校验手机号可以查询大网数据</code></pre> <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/order/v2/getListFreight</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;">companyId</td> <td style="text-align: center;">String(20)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">分配客户sendAppId</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">trackingType</td> <td style="text-align: center;">String</td> <td style="text-align: center;">是</td> <td style="text-align: center;">1</td> <td style="text-align: left;">1:表示按订单查询 2:表示按运单查询</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">trackingNum</td> <td style="text-align: center;">String</td> <td style="text-align: center;">是</td> <td style="text-align: center;">订单号或运单号</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">phone</td> <td style="text-align: center;">String</td> <td style="text-align: center;">条件</td> <td style="text-align: center;">查询大网数据时必填。传收寄方任意一个的电话的后4位</td> </tr> <tr> <td style="text-align: center;">5</td> <td style="text-align: center;">bizTemplateCode</td> <td style="text-align: center;">String</td> <td style="text-align: center;">否</td> <td style="text-align: center;">业务配置代码,针对客户业务需求配置的一套接口处理逻辑,一个接入编码可对应多个业务配置代码</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: 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: 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: 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;">Object</td> <td style="text-align: center;">数据</td> <td style="text-align: left;">数据</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">waybillInfo</td> <td style="text-align: center;">Object</td> <td style="text-align: center;">运单详情</td> </tr> <tr> <td style="text-align: center;">5</td> <td style="text-align: center;">waybillFeeList</td> <td style="text-align: center;">List</td> <td style="text-align: center;">费用详情</td> </tr> <tr> <td style="text-align: center;">6</td> <td style="text-align: center;">waybillServiceList</td> <td style="text-align: center;">List</td> <td style="text-align: center;">增值服务信息详情</td> </tr> <tr> <td style="text-align: center;">7</td> <td style="text-align: center;">packageList</td> <td style="text-align: center;">List</td> <td style="text-align: center;">包裹信息详情</td> </tr> <tr> <td style="text-align: center;">8</td> <td style="text-align: center;">otherExtend</td> <td style="text-align: center;">String(1000)</td> <td style="text-align: center;">其它信息</td> <td style="text-align: center;">json字符串</td> </tr> </tbody> </table> <h3>&lt;响应&gt;二级子属性</h3> <ul> <li><strong>waybillInfo 字段说明</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">waybillNo</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">运单号</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">orderId</td> <td style="text-align: center;">String(64)</td> <td style="text-align: center;">客户订单号</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">waybillChilds</td> <td style="text-align: center;">String</td> <td style="text-align: center;">子单号,英文逗号分隔</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">customerAcctCode</td> <td style="text-align: center;">String(64)</td> <td style="text-align: center;">月结帐号</td> </tr> <tr> <td style="text-align: center;">5</td> <td style="text-align: center;">meterageWeightQty</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">计费重量</td> </tr> <tr> <td style="text-align: center;">6</td> <td style="text-align: center;">realWeightQty</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">实际重量</td> </tr> <tr> <td style="text-align: center;">7</td> <td style="text-align: center;">consigneeEmpCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">收件员工号</td> </tr> <tr> <td style="text-align: center;">8</td> <td style="text-align: center;">deliverEmpCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">派件员工号</td> </tr> <tr> <td style="text-align: center;">9</td> <td style="text-align: center;">cargoTypeCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">快件内容</td> </tr> <tr> <td style="text-align: center;">10</td> <td style="text-align: center;">cargoTypeName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">快件内容名称</td> </tr> <tr> <td style="text-align: center;">11</td> <td style="text-align: center;">limitTypeCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">时效类型</td> </tr> <tr> <td style="text-align: center;">12</td> <td style="text-align: center;">limitName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">时效类型名称</td> </tr> <tr> <td style="text-align: center;">13</td> <td style="text-align: center;">expressTypeCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">业务类型</td> </tr> <tr> <td style="text-align: center;">14</td> <td style="text-align: center;">expressTypeName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">业务类型名称</td> </tr> <tr> <td style="text-align: center;">15</td> <td style="text-align: center;">consValue</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">声明价值</td> </tr> <tr> <td style="text-align: center;">16</td> <td style="text-align: center;">consValueCurrencyCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">声明价值币种</td> </tr> <tr> <td style="text-align: center;">17</td> <td style="text-align: center;">productCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">产品代码</td> </tr> <tr> <td style="text-align: center;">18</td> <td style="text-align: center;">productName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">产品名称</td> </tr> <tr> <td style="text-align: center;">19</td> <td style="text-align: center;">jProvince</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">寄件省份</td> </tr> <tr> <td style="text-align: center;">20</td> <td style="text-align: center;">jCity</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">寄件城市</td> </tr> <tr> <td style="text-align: center;">21</td> <td style="text-align: center;">consignorAddr</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">寄件详细地址</td> </tr> <tr> <td style="text-align: center;">22</td> <td style="text-align: center;">consignorContName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">寄件联系人</td> </tr> <tr> <td style="text-align: center;">23</td> <td style="text-align: center;">consignorPhone</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">寄件电话号码</td> </tr> <tr> <td style="text-align: center;">24</td> <td style="text-align: center;">consignorMobile</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">寄件手机号</td> </tr> <tr> <td style="text-align: center;">25</td> <td style="text-align: center;">dProvince</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">收件省份</td> </tr> <tr> <td style="text-align: center;">26</td> <td style="text-align: center;">dCity</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">收件城市</td> </tr> <tr> <td style="text-align: center;">27</td> <td style="text-align: center;">addresseeAddr</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">收件详细地址</td> </tr> <tr> <td style="text-align: center;">28</td> <td style="text-align: center;">addresseeContName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">收件联系人</td> </tr> <tr> <td style="text-align: center;">29</td> <td style="text-align: center;">addresseePhone</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">收件电话号码</td> </tr> <tr> <td style="text-align: center;">30</td> <td style="text-align: center;">addresseeMobile</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">收件手机号</td> </tr> <tr> <td style="text-align: center;">31</td> <td style="text-align: center;">shieldFlg</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">丰巢屏蔽标识,1表示不允许投柜</td> </tr> <tr> <td style="text-align: center;">32</td> <td style="text-align: center;">noticeShieldTemplateCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">禁止投柜提示码</td> </tr> <tr> <td style="text-align: center;">33</td> <td style="text-align: center;">sourceZoneCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">原寄地</td> </tr> <tr> <td style="text-align: center;">34</td> <td style="text-align: center;">sourceZoneName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">原寄地网点名称</td> </tr> <tr> <td style="text-align: center;">35</td> <td style="text-align: center;">destZoneCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">目的地</td> </tr> <tr> <td style="text-align: center;">36</td> <td style="text-align: center;">destZoneName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">目的地网点名称</td> </tr> <tr> <td style="text-align: center;">37</td> <td style="text-align: center;">sourceCountry</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">原寄地的国家</td> </tr> <tr> <td style="text-align: center;">38</td> <td style="text-align: center;">destCountry</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">目的地国家</td> </tr> <tr> <td style="text-align: center;">39</td> <td style="text-align: center;">quantity</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">件数</td> </tr> <tr> <td style="text-align: center;">40</td> <td style="text-align: center;">distanceTypeCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">区域类型</td> </tr> <tr> <td style="text-align: center;">41</td> <td style="text-align: center;">distanceTypeName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">区域类型名称</td> </tr> <tr> <td style="text-align: center;">42</td> <td style="text-align: center;">transportTypeCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">运输类型</td> </tr> <tr> <td style="text-align: center;">43</td> <td style="text-align: center;">transportTypeName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">运输类型名称</td> </tr> <tr> <td style="text-align: center;">44</td> <td style="text-align: center;">ackbillTypeCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">回单类型</td> </tr> <tr> <td style="text-align: center;">45</td> <td style="text-align: center;">volume</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">体积</td> </tr> <tr> <td style="text-align: center;">46</td> <td style="text-align: center;">billLong</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">长</td> </tr> <tr> <td style="text-align: center;">47</td> <td style="text-align: center;">billWidth</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">宽</td> </tr> <tr> <td style="text-align: center;">48</td> <td style="text-align: center;">billHigh</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">高</td> </tr> <tr> <td style="text-align: center;">49</td> <td style="text-align: center;">unitWeight</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">重量单位</td> </tr> <tr> <td style="text-align: center;">50</td> <td style="text-align: center;">waybillStatus</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">运单状态</td> </tr> <tr> <td style="text-align: center;">51</td> <td style="text-align: center;">clientCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">客户端代码</td> </tr> <tr> <td style="text-align: center;">52</td> <td style="text-align: center;">sourceCityCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">原寄地城市编码</td> </tr> <tr> <td style="text-align: center;">53</td> <td style="text-align: center;">sourceDeptCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">原寄地机构编码</td> </tr> <tr> <td style="text-align: center;">54</td> <td style="text-align: center;">destCityCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">目的地城市编码</td> </tr> <tr> <td style="text-align: center;">55</td> <td style="text-align: center;">destDeptCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">目的地机构编码</td> </tr> <tr> <td style="text-align: center;">56</td> <td style="text-align: center;">sourceHqCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">原寄地所属经营本部编码</td> </tr> <tr> <td style="text-align: center;">57</td> <td style="text-align: center;">sourceAreaCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">原寄地所属区部编码</td> </tr> <tr> <td style="text-align: center;">58</td> <td style="text-align: center;">destHqCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">目的地所属经营本部编码</td> </tr> <tr> <td style="text-align: center;">59</td> <td style="text-align: center;">destAreaCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">目的地所属区部编码</td> </tr> <tr> <td style="text-align: center;">60</td> <td style="text-align: center;">signedBackWaybillNo</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">签回单号</td> </tr> <tr> <td style="text-align: center;">61</td> <td style="text-align: center;">orderType</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">订单类型</td> </tr> <tr> <td style="text-align: center;">62</td> <td style="text-align: center;">secondSysOrderNo</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">换一体服务:第二联系统订单号(要退换货物的原始系统订单</td> </tr> <tr> <td style="text-align: center;">63</td> <td style="text-align: center;">subscriberName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">签收人</td> </tr> <tr> <td style="text-align: center;">64</td> <td style="text-align: center;">signinTm</td> <td style="text-align: center;">Date</td> <td style="text-align: center;">签收时间</td> </tr> <tr> <td style="text-align: center;">65</td> <td style="text-align: center;">cvsCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">寄方便利店编码</td> </tr> <tr> <td style="text-align: center;">66</td> <td style="text-align: center;">receiptCvsCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">到方便利店编码</td> </tr> <tr> <td style="text-align: center;">67</td> <td style="text-align: center;">wpProductCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">微派产品信息</td> </tr> <tr> <td style="text-align: center;">68</td> <td style="text-align: center;">refundExchangeGoodsFlg</td> <td style="text-align: center;">Integer</td> <td style="text-align: center;">退换货一体标记</td> </tr> <tr> <td style="text-align: center;">69</td> <td style="text-align: center;">appointWay</td> <td style="text-align: center;">String</td> <td style="text-align: center;">CX预约方式:1:消息推送入口;2:收件方式入口;3:更改派送入口;</td> </tr> <tr> <td style="text-align: center;">70</td> <td style="text-align: center;">hiddenAddressFlag</td> <td style="text-align: center;">String</td> <td style="text-align: center;">隐址件标识,1、是,0、否;</td> </tr> <tr> <td style="text-align: center;">71</td> <td style="text-align: center;">commandType</td> <td style="text-align: center;">String</td> <td style="text-align: center;">口令类型:1、口令;2、身份证;3、口令/身份证</td> </tr> <tr> <td style="text-align: center;">72</td> <td style="text-align: center;">sourceWaybillNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">源单号</td> </tr> <tr> <td style="text-align: center;">73</td> <td style="text-align: center;">totalFee</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">总费用(根据客户与顺丰约定配置的费用项,返回总额);</td> </tr> <tr> <td style="text-align: center;">74</td> <td style="text-align: center;">unmannedVehicleInfo</td> <td style="text-align: center;">Map&lt;String, Object&gt;</td> <td style="text-align: center;">无人车派送信息,有信息则包含子元素信息;</td> </tr> <tr> <td style="text-align: center;">75</td> <td style="text-align: center;">consignorCountryCode</td> <td style="text-align: center;">String</td> <td style="text-align: center;">寄方国家代码;</td> </tr> </tbody> </table> <ul> <li><strong>unmannedVehicleInfo无人车信息详情</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">operation</td> <td style="text-align: center;">String</td> <td style="text-align: center;">操作(包括预约开始时间、预约结束时间、预约地点,分号分隔);</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">createTm</td> <td style="text-align: center;">Long</td> <td style="text-align: center;">创建时间;</td> </tr> </tbody> </table> <ul> <li><strong>waybillFeeList 字段说明</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">feeTypeCode</td> <td style="text-align: center;">String(3)</td> <td style="text-align: center;">费用类型(丰巢接入码返回);</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">feeAmt</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">费用(丰巢接入码返回);</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">type</td> <td style="text-align: center;">String(3)</td> <td style="text-align: center;">费用类型(非丰巢接入码返回);</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">name</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">费用名称(非丰巢接入码返回);</td> </tr> <tr> <td style="text-align: center;">5</td> <td style="text-align: center;">value</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">费用金额(非丰巢接入码返回);</td> </tr> <tr> <td style="text-align: center;">6</td> <td style="text-align: center;">paymentTypeCode</td> <td style="text-align: center;">String(1)</td> <td style="text-align: center;">付款类型:1、寄付;2、到付;3、第三方付</td> </tr> <tr> <td style="text-align: center;">7</td> <td style="text-align: center;">settlementTypeCode</td> <td style="text-align: center;">String(1)</td> <td style="text-align: center;">结算类型:1为现结;2为月结</td> </tr> <tr> <td style="text-align: center;">8</td> <td style="text-align: center;">serviceProdCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">增值服务代码</td> </tr> <tr> <td style="text-align: center;">9</td> <td style="text-align: center;">insuredValue</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">保价金额</td> </tr> <tr> <td style="text-align: center;">10</td> <td style="text-align: center;">customerAcctCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">月结账号</td> </tr> <tr> <td style="text-align: center;">11</td> <td style="text-align: center;">paymentChangeTypeCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">支付变更类型</td> </tr> <tr> <td style="text-align: center;">12</td> <td style="text-align: center;">currencyCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">费用单位</td> </tr> <tr> <td style="text-align: center;">13</td> <td style="text-align: center;">currencyName</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">费用名称</td> </tr> <tr> <td style="text-align: center;">14</td> <td style="text-align: center;">gatherEmpCode</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">交款人</td> </tr> <tr> <td style="text-align: center;">15</td> <td style="text-align: center;">isLaterPay</td> <td style="text-align: center;">String(30)</td> <td style="text-align: center;">是否后付费</td> </tr> <tr> <td style="text-align: center;">16</td> <td style="text-align: center;">feeAmtInd</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">个性化费用</td> </tr> </tbody> </table> <ul> <li><strong>waybillServiceList 字段说明</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">serviceName</td> <td style="text-align: center;">String</td> <td style="text-align: center;">服务名称</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">waybillNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">运单号</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">serviceProdCode</td> <td style="text-align: center;">String</td> <td style="text-align: center;">服务类型</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">materielDetailList</td> <td style="text-align: center;">List<MaterielDetail></td> <td style="text-align: center;">物料整合信息</td> </tr> </tbody> </table> <ul> <li><strong>MaterielDetail物料整合信息</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">wlCode</td> <td style="text-align: center;">String</td> <td style="text-align: center;">物料编码</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">num</td> <td style="text-align: center;">Int</td> <td style="text-align: center;">数量</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">price</td> <td style="text-align: center;">double</td> <td style="text-align: center;">单价</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">shortName</td> <td style="text-align: center;">String</td> <td style="text-align: center;">物料简称</td> </tr> </tbody> </table> <ul> <li><strong>packageList 字段说明</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">packageId</td> <td style="text-align: center;">String</td> <td style="text-align: center;">包ID</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">packageNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">包号</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">packageLong</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">长</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">packageWidth</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">宽</td> </tr> <tr> <td style="text-align: center;">5</td> <td style="text-align: center;">packageHigh</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">高</td> </tr> <tr> <td style="text-align: center;">6</td> <td style="text-align: center;">packageVolume</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">体积</td> </tr> <tr> <td style="text-align: center;">7</td> <td style="text-align: center;">packageUnitWeight</td> <td style="text-align: center;">String</td> <td style="text-align: center;">重量单位</td> </tr> <tr> <td style="text-align: center;">8</td> <td style="text-align: center;">packageWeight</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">重量</td> </tr> <tr> <td style="text-align: center;">9</td> <td style="text-align: center;">packageStatus</td> <td style="text-align: center;">String</td> <td style="text-align: center;">包状态</td> </tr> <tr> <td style="text-align: center;">10</td> <td style="text-align: center;">waybillNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">运单号</td> </tr> <tr> <td style="text-align: center;">11</td> <td style="text-align: center;">boxNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">箱号</td> </tr> <tr> <td style="text-align: center;">12</td> <td style="text-align: center;">waybillConsigns</td> <td style="text-align: center;">List<WaybillConsignForWs></td> <td style="text-align: center;">运单托寄物信息</td> </tr> </tbody> </table> <ul> <li><strong>WaybillConsignForWs托寄物信息</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> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">consignId</td> <td style="text-align: center;">String</td> <td style="text-align: center;">托寄物id</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">qtyUnit</td> <td style="text-align: center;">String</td> <td style="text-align: center;">数量单位</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">consignName</td> <td style="text-align: center;">String</td> <td style="text-align: center;">品名</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">consignQty</td> <td style="text-align: center;">String</td> <td style="text-align: center;">数量</td> </tr> <tr> <td style="text-align: center;">5</td> <td style="text-align: center;">weightQty</td> <td style="text-align: center;">Double</td> <td style="text-align: center;">重量</td> </tr> <tr> <td style="text-align: center;">6</td> <td style="text-align: center;">consignValue</td> <td style="text-align: center;">String</td> <td style="text-align: center;">价值</td> </tr> <tr> <td style="text-align: center;">7</td> <td style="text-align: center;">inputTm</td> <td style="text-align: center;">Date</td> <td style="text-align: center;">录入时间</td> </tr> <tr> <td style="text-align: center;">8</td> <td style="text-align: center;">productRecordNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">产品国检备案编号</td> </tr> <tr> <td style="text-align: center;">9</td> <td style="text-align: center;">hsCode</td> <td style="text-align: center;">String</td> <td style="text-align: center;">海关编号</td> </tr> <tr> <td style="text-align: center;">10</td> <td style="text-align: center;">remark</td> <td style="text-align: center;">String</td> <td style="text-align: center;">备注</td> </tr> <tr> <td style="text-align: center;">11</td> <td style="text-align: center;">goodsCode</td> <td style="text-align: center;">String</td> <td style="text-align: center;">商品编码</td> </tr> <tr> <td style="text-align: center;">12</td> <td style="text-align: center;">specifications</td> <td style="text-align: center;">String</td> <td style="text-align: center;">规格型号</td> </tr> <tr> <td style="text-align: center;">13</td> <td style="text-align: center;">englishQtyUnit</td> <td style="text-align: center;">String</td> <td style="text-align: center;">托寄物单位英文名称</td> </tr> <tr> <td style="text-align: center;">14</td> <td style="text-align: center;">brand</td> <td style="text-align: center;">String</td> <td style="text-align: center;">品牌</td> </tr> <tr> <td style="text-align: center;">15</td> <td style="text-align: center;">originCountry</td> <td style="text-align: center;">String</td> <td style="text-align: center;">原产国</td> </tr> <tr> <td style="text-align: center;">16</td> <td style="text-align: center;">consignExtJson</td> <td style="text-align: center;">String</td> <td style="text-align: center;">扩展json</td> </tr> <tr> <td style="text-align: center;">17</td> <td style="text-align: center;">englishConsName</td> <td style="text-align: center;">String</td> <td style="text-align: center;">寄物英文名称</td> </tr> <tr> <td style="text-align: center;">18</td> <td style="text-align: center;">productCustomsNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">商品海关备案号</td> </tr> </tbody> </table> <h3>报文范例</h3> <ul> <li> <p><strong>请求报文</strong></p> <pre><code>{ "companyId": xxx, "trackingType": "2", "trackingNum": "SFxxx", "phone": "xxxx", "bizTemplateCode": "" }</code></pre> </li> <li><strong>响应报文</strong> <ul> <li>成功报文 <pre><code>{ "result": { "otherExtend": "{\"extensionField1\":\"\",\"extensionField2\":\"\",\"extensionField3\":\"\",\"extensionFieldNames\":\"\",\"tkEmail\":\"\",\"tkInlandCharges\":\"\",\"tkInternationalDeliveryCharges\":\"\",\"tkInternationalPremiums\":\"\",\"tkTotal\":\"\",\"tkZipCode\":\"\",\"totalHeight\":\"333.336\",\"totalLength\":\"111.116\",\"totalWidth\":\"222.226\"}", "waybillInfo": { "jCity": "深圳市", "addresseePhone": "M053KcIWMrBcJuRZo6I3Cw==", "meterageWeightQty": 7.0, "orderId": "7edde055a69841ed9885296b493a32df", "limitTypeCode": "T6", "paymentTypeCode": null, "addresseeAddr": "O0l9iCSA5yY1cLsOERdVPw==", "consValueCurrencyCode": null, "customerAcctCode": null, "consValue": null, "dProvince": "安徽省", "jProvince": "广东省", "dCity": "淮北市", "consignorAddr": "O0l9iCSA5yY1cLsOERdVPw==", "consignorPhone": "y4oV3WeXfR9/IgmHEt/cWw==", "noticeShieldTemplateCode": null, "waybillChilds": "SF2060037189744,SF2060037189736", "addresseeContName": "测试单", "settlementTypeCode": null, "addresseeMobile": "ikDv10I1Cx4YxKBtaKOEdQ==", "expressTypeCode": "B1", "consignorContName": "测试单", "consignorMobile": "anl7JNw0M5ZlO+tpzLwOtw==", "waybillNo": "SF1334451716554" }, "packageList": [ { "packageVolume": null, "boxNo": null, "waybillConsigns": [ { "consignId": null, "consignName": "鞋子", "consignValue": null, "inputTm": 1652340803000, "qtyUnit": "件", "weightQty": null, "consignQty": "4", "productRecordNo": null } ], "packageWeight": null, "packageWidth": null, "packageLong": null, "packageNo": "SF1334451716554", "packageHigh": null }, { "packageVolume": null, "boxNo": null, "waybillConsigns": [ { "consignId": null, "consignName": "鞋子", "consignValue": null, "inputTm": 1652340803000, "qtyUnit": "件", "weightQty": null, "consignQty": "4", "productRecordNo": null } ], "packageWeight": null, "packageWidth": null, "packageLong": null, "packageNo": "SF1334451716554", "packageHigh": null }, { "packageVolume": null, "boxNo": null, "waybillConsigns": [ { "consignId": null, "consignName": "鞋子", "consignValue": null, "inputTm": 1652340803000, "qtyUnit": "件", "weightQty": null, "consignQty": "4", "productRecordNo": null } ], "packageWeight": null, "packageWidth": null, "packageLong": null, "packageNo": "SF1334451716554", "packageHigh": null } ], "waybillFeeList": [ { "name": "运费", "type": "1", "value": 54.0 }, { "name": "保价", "type": "3", "value": 1.0 }, { "name": "密钥认证", "type": "59", "value": 1.0 }, { "name": "包装服务", "type": "67", "value": 7.0 } ] }, "succ": "ok", "msg": null }</code></pre></li> <li>失败报文-范例 <pre><code>{ "succ": "fail", "msg":"没有运单信息", "result": null }</code></pre></li> </ul></li> </ul> <h3>涉及密文字段的加解密说明</h3> <ul> <li>1、采用AES256方式加密后转Base64传输;</li> <li>2、加密算法 CIPHER_ALGORITHM = &quot;AES/CBC/PKCS5Padding&quot;;</li> <li>3、key和向量值一样是客户编码对应的checkWork; 从前面截取16位,不足16位的在末尾补0;</li> <li>4、解密参考代码:<a href="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=dc494057f7e9aaf73c2162a5b2ce86a5" title="[ListFreightAesUtil.zip">ListFreightAesUtil.zip</a></li> </ul>

页面列表

ITEM_HTML