聚美智数


快递查询

<h3>接口描述</h3> <ul> <li>根据快递代号和快递单号查询实时物流信息</li> </ul> <h4>请求地址</h4> <p><code>https://api-hw.jumdata.com/express/query</code></p> <h4>请求方式</h4> <ul> <li>POST</li> </ul> <h4>请求格式</h4> <ul> <li>x-www-form-urlencoded</li> </ul> <h4>请求参数</h4> <table> <thead> <tr> <th>名称</th> <th>类型</th> <th>必须</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>appId</td> <td>String</td> <td>是</td> <td>服务商分配的唯一标识</td> </tr> <tr> <td>timestamp</td> <td>Long</td> <td>是</td> <td>当前时间戳</td> </tr> <tr> <td>sign</td> <td>String</td> <td>是</td> <td>签名,详见签名算法说明</td> </tr> <tr> <td>expressCode</td> <td>String</td> <td>否</td> <td>快递公司编号 例如圆通:YTO,详见:&lt;a href=&quot;#快递公司编码对照表&quot;&gt;快递公司编码对照表&lt;/a&gt; &lt;br&gt;快递公司编号不传时,系统会自动识别快递公司编号,但响应时间会比传递快递编号略长</td> </tr> <tr> <td>number</td> <td>String</td> <td>是</td> <td>运单编号</td> </tr> <tr> <td>mobile</td> <td>String</td> <td>否</td> <td>顺丰速运/丰网速运需要传入收/寄件人手机号或后四位手机号</td> </tr> </tbody> </table> <h4>签名算法说明</h4> <p><code>sign = sha256(appId + appSecret + timestamp)</code></p> <p>用服务商分配的 appId、服务商分配的 appSecret,当前时间时间戳 timestamp,按上述顺序拼接成字符串,再进行 sha256 哈希得到。如下:</p> <pre><code class="language-java">String appId = &amp;quot;xyzxy2121zxyz&amp;quot;; String timestamp = &amp;quot;1555378976238&amp;quot;; String appSecret = &amp;quot;efcefcef1121cefcefc1212121&amp;quot;; String str = appId + appSecret + timestamp; String sign = sha256(str);</code></pre> <h3>返回说明</h3> <h4>成功返回样例</h4> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 200, // 详见code返回码说明 &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;, // code 对应的描述 &amp;quot;charge&amp;quot;: true, // 计费标志 &amp;quot;taskNo&amp;quot;: &amp;quot;30853523396532582768&amp;quot;, // 本次请求号 &amp;quot;data&amp;quot;: { &amp;quot;expressCode&amp;quot;: &amp;quot;ZTO&amp;quot;, // 快递公司编号 &amp;quot;expressCompanyName&amp;quot;: &amp;quot;中通快递&amp;quot;, // 快递公司名称 &amp;quot;expressCompanyLogo&amp;quot;: &amp;quot;https://xxxxx/xxxx.png&amp;quot; // 快递公司logo &amp;quot;number&amp;quot;: &amp;quot;73171992731469&amp;quot;, // 运单编号 &amp;quot;logisticsStatus&amp;quot;: &amp;quot;SIGN&amp;quot;, // 物流状态,详见:物流状态编码对照表; &amp;quot;logisticsStatusDesc&amp;quot;: &amp;quot;已签收&amp;quot;, // 物流状态描述 &amp;quot;theLastMessage&amp;quot;: &amp;quot;快件已在金华孝顺签收 签收人:本人。如有疑问请电联:15888996643, 投诉电话:0579-82977127, 您的快递已经妥投。风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好?【请在评价快递员处帮忙点亮五颗星星哦~】&amp;quot;, // 运单号物流流转当前最新描述 &amp;quot;theLastTime&amp;quot;: &amp;quot;2021-11-23 12:24:58&amp;quot;, // 运单号物流流转当前最新变更时间 &amp;quot;takeTime&amp;quot;: &amp;quot;2天17小时33分&amp;quot;, //从揽收到送达所耗时间 &amp;quot;courier&amp;quot;: &amp;quot;付村二部傅军&amp;quot;, // 快递员 &amp;quot;courierPhone&amp;quot;: &amp;quot;15888996643&amp;quot;, // 快递员联系方式 &amp;quot;logisticsTraceDetails&amp;quot;: [ // 物流明细 { &amp;quot;time&amp;quot;:1632123146000, // 物流变更时间 &amp;quot;logisticsStatus&amp;quot;:&amp;quot;ACCEPT&amp;quot;, // 物流状态 详见:物流状态编码对照表 &amp;quot;subLogisticsStatus&amp;quot;:&amp;quot;ACCEPT&amp;quot;, // 物流子状态 详见:物流状态编码对照表 &amp;quot;desc&amp;quot;:&amp;quot;【杭州电商仓配揽投部】已收寄,揽投员:刘岭,电话:13754324900&amp;quot;, //物流路由信息描述内容 &amp;quot;areaCode&amp;quot;:&amp;quot;CN330100000000&amp;quot;, // 路由节点所在地区行政编码 &amp;quot;areaName&amp;quot;:&amp;quot;浙江省,杭州市&amp;quot; // 路由节路由节点所在地区 }, { &amp;quot;time&amp;quot;:1632140994000, &amp;quot;logisticsStatus&amp;quot;:&amp;quot;TRANSPORT&amp;quot;, &amp;quot;subLogisticsStatus&amp;quot;:&amp;quot;TRANSPORT&amp;quot;, &amp;quot;desc&amp;quot;:&amp;quot;离开【杭州电商仓配揽投部】,下一站【杭州萧山区东片集散中心】&amp;quot;, &amp;quot;areaCode&amp;quot;:&amp;quot;CN330100000000&amp;quot;, &amp;quot;areaName&amp;quot;:&amp;quot;浙江省,杭州市&amp;quot; }, ... ] } }</code></pre> <h4>失败返回样例</h4> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 400, &amp;quot;msg&amp;quot;: &amp;quot;运单编号为空&amp;quot; }</code></pre> <h3>返回字段说明</h3> <table> <thead> <tr> <th>字段名</th> <th>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>返回码,详见code返回码说明</td> </tr> <tr> <td>msg</td> <td>code对应的描述</td> </tr> <tr> <td>charge</td> <td>计费标志</td> </tr> <tr> <td>taskNo</td> <td>本次请求号</td> </tr> <tr> <td>data</td> <td>返回具体结果,object类型,详见data返回字段描述</td> </tr> </tbody> </table> <h4>code返回码说明</h4> <table> <thead> <tr> <th>code</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>成功(计费)</td> </tr> <tr> <td>400</td> <td>参数错误</td> </tr> <tr> <td>404</td> <td>请求地址不正确</td> </tr> <tr> <td>411</td> <td>快递公司代码不存在</td> </tr> <tr> <td>412</td> <td>运单号不符合规则</td> </tr> <tr> <td>500</td> <td>系统维护,请稍候再试</td> </tr> <tr> <td>601</td> <td>接口未开通</td> </tr> <tr> <td>602</td> <td>账号停用</td> </tr> <tr> <td>603</td> <td>余额不足请充值</td> </tr> <tr> <td>604</td> <td>接口停用</td> </tr> <tr> <td>606</td> <td>调用超限,请稍候再试</td> </tr> <tr> <td>607</td> <td>ip不在白名单</td> </tr> <tr> <td>609</td> <td>请求过于频繁,请稍候再试</td> </tr> <tr> <td>610</td> <td>请求超时</td> </tr> <tr> <td>701</td> <td>未查询到快递物流数据(计费)</td> </tr> <tr> <td>999</td> <td>其他,以实际返回为准</td> </tr> </tbody> </table> <h3>业务对照表</h3> <p>&lt;a name=&quot;快递公司编号对照表&quot;/&gt;</p> <h4>快递公司编码对照表</h4> <table> <thead> <tr> <th>序号</th> <th>快递编码</th> <th>&lt;div style=&quot;width:400px&quot;&gt;快递公司&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>SF</td> <td>顺丰快递</td> </tr> <tr> <td>2</td> <td>YTO</td> <td>圆通快递</td> </tr> <tr> <td>3</td> <td>ZTO</td> <td>中通快递</td> </tr> <tr> <td>4</td> <td>YUNDA</td> <td>韵达快递</td> </tr> <tr> <td>5</td> <td>YDKY</td> <td>韵达快运</td> </tr> <tr> <td>6</td> <td>STO</td> <td>申通快递</td> </tr> <tr> <td>7</td> <td>TTKDEX</td> <td>天天快递</td> </tr> <tr> <td>8</td> <td>JD</td> <td>京东快递</td> </tr> <tr> <td>9</td> <td>EMS</td> <td>中国邮政(其他常用名称:邮政国内小包、EMS、邮政标准快递、E邮宝、EMS经济快递、EMS特快专递、邮政快递包裹、EMS快递包裹、邮政EMS速递、邮政平邮、邮政商务小包、平邮、邮包、邮政快递,都可以使用此对照关系查询或订阅物流)</td> </tr> <tr> <td>10</td> <td>DBKD</td> <td>德邦快递</td> </tr> <tr> <td>11</td> <td>DBL</td> <td>德邦物流</td> </tr> <tr> <td>12</td> <td>DBKY</td> <td>德邦快运</td> </tr> <tr> <td>13</td> <td>SURE</td> <td>速尔快运</td> </tr> <tr> <td>14</td> <td>UC</td> <td>优速快递</td> </tr> <tr> <td>15</td> <td>JT</td> <td>极兔速递</td> </tr> <tr> <td>16</td> <td>KYE</td> <td>跨越速运</td> </tr> <tr> <td>17</td> <td>CP471906</td> <td>顺心捷达</td> </tr> <tr> <td>18</td> <td>ANE56</td> <td>安能物流</td> </tr> <tr> <td>19</td> <td>BESTQJT</td> <td>百世快运</td> </tr> <tr> <td>20</td> <td>FW</td> <td>丰网速递</td> </tr> <tr> <td>21</td> <td>YMDD</td> <td>壹米滴答</td> </tr> <tr> <td>22</td> <td>JYM</td> <td>加运美</td> </tr> <tr> <td>23</td> <td>ZTOKY</td> <td>中通快运</td> </tr> <tr> <td>24</td> <td>CP449455</td> <td>京广速递</td> </tr> <tr> <td>25</td> <td>ZJS</td> <td>宅急送</td> </tr> <tr> <td>26</td> <td>FAST</td> <td>快捷快递</td> </tr> <tr> <td>27</td> <td>FEDEX</td> <td>联邦快递</td> </tr> <tr> <td>28</td> <td>RRS</td> <td>日日顺</td> </tr> <tr> <td>29</td> <td>SNWL</td> <td>苏宁快递</td> </tr> <tr> <td>30</td> <td>ZMKM</td> <td>丹鸟</td> </tr> <tr> <td>31</td> <td>ZMKMKD</td> <td>丹鸟快递</td> </tr> <tr> <td>32</td> <td>RFD</td> <td>如风达</td> </tr> <tr> <td>33</td> <td>YCKY</td> <td>远成快运</td> </tr> <tr> <td>34</td> <td>JYXP</td> <td>九曳供应链</td> </tr> <tr> <td>35</td> <td>CP468398</td> <td>圆通承诺达</td> </tr> <tr> <td>36</td> <td>GTO</td> <td>国通快递</td> </tr> <tr> <td>37</td> <td>QFKD</td> <td>全峰快递</td> </tr> <tr> <td>38</td> <td>SDSD</td> <td>山东递速</td> </tr> <tr> <td>39</td> <td>XFWL</td> <td>信丰物流</td> </tr> <tr> <td>40</td> <td>CP443514</td> <td>百世云配</td> </tr> <tr> <td>41</td> <td>LE10032270</td> <td>韵达同城</td> </tr> <tr> <td>42</td> <td>PADTF</td> <td>平安达腾飞</td> </tr> <tr> <td>43</td> <td>HOAU</td> <td>天地华宇</td> </tr> <tr> <td>44</td> <td>STOKY</td> <td>申通快运</td> </tr> <tr> <td>45</td> <td>ZTKY</td> <td>中铁物流/飞豹快递</td> </tr> <tr> <td>46</td> <td>EWINSHINE</td> <td>万象物流</td> </tr> <tr> <td>47</td> <td>QRT</td> <td>全日通</td> </tr> <tr> <td>48</td> <td>GZFY</td> <td>凡宇快递</td> </tr> <tr> <td>49</td> <td>XBWL</td> <td>新邦物流</td> </tr> <tr> <td>50</td> <td>CRE</td> <td>中铁快运</td> </tr> <tr> <td>51</td> <td>LTS</td> <td>联昊通</td> </tr> <tr> <td>52</td> <td>SHENGHUI</td> <td>盛辉物流</td> </tr> <tr> <td>53</td> <td>HUANGMAJIA</td> <td>黄马甲配送</td> </tr> <tr> <td>54</td> <td>CHENGBANG</td> <td>晟邦物流</td> </tr> <tr> <td>55</td> <td>GZLT</td> <td>飞远配送</td> </tr> <tr> <td>56</td> <td>HZABC</td> <td>飞远(爱彼西)配送</td> </tr> <tr> <td>57</td> <td>YCT</td> <td>黑猫宅急便</td> </tr> <tr> <td>58</td> <td>COE</td> <td>COE</td> </tr> <tr> <td>59</td> <td>DTW</td> <td>大田物流</td> </tr> <tr> <td>60</td> <td>AIR</td> <td>亚风速递</td> </tr> <tr> <td>61</td> <td>WJ</td> <td>万家物流</td> </tr> <tr> <td>62</td> <td>D4PX</td> <td>递四方</td> </tr> <tr> <td>63</td> <td>UPS</td> <td>UPS</td> </tr> <tr> <td>64</td> <td>SUIJIAWL</td> <td>穗佳物流</td> </tr> <tr> <td>65</td> <td>SUTENG</td> <td>速腾快递</td> </tr> <tr> <td>66</td> <td>ANNTO</td> <td>安得智联</td> </tr> <tr> <td>67</td> <td>DISU</td> <td>D速</td> </tr> <tr> <td>68</td> <td>ZZJHTD</td> <td>郑州建华</td> </tr> <tr> <td>69</td> <td>ZTOGJ</td> <td>中通国际</td> </tr> <tr> <td>70</td> <td>SXJH</td> <td>建华快递</td> </tr> <tr> <td>71</td> <td>ZL</td> <td>四川增联供应链</td> </tr> <tr> <td>72</td> <td>JUSDA</td> <td>准时达</td> </tr> <tr> <td>73</td> <td>YDGJ</td> <td>韵达国际</td> </tr> <tr> <td>74</td> <td>FENGNIAO</td> <td>蜂鸟配送</td> </tr> <tr> <td>75</td> <td>FJGJ</td> <td>泛捷国际物流</td> </tr> <tr> <td>76</td> <td>CVP</td> <td>潮优配</td> </tr> <tr> <td>77</td> <td>LSWL</td> <td>林氏物流</td> </tr> <tr> <td>78</td> <td>CQLY</td> <td>重庆铃宇消费品供应链</td> </tr> <tr> <td>79</td> <td>XINZHIHUI</td> <td>新智慧</td> </tr> <tr> <td>80</td> <td>STOINTL</td> <td>申通国际</td> </tr> <tr> <td>81</td> <td>HBZL</td> <td>湖北众联</td> </tr> <tr> <td>82</td> <td>GOODKUAIDI</td> <td>GOOD快递</td> </tr> <tr> <td>83</td> <td>EWE_GLOBAL</td> <td>EWE GLOBAL</td> </tr> <tr> <td>84</td> <td>WDSWL</td> <td>鸿达顺物流</td> </tr> <tr> <td>85</td> <td>AXD</td> <td>安鲜达</td> </tr> <tr> <td>86</td> <td>GDNFCMFXWL</td> <td>广东南方传媒发行物流</td> </tr> <tr> <td>87</td> <td>XLOBO</td> <td>贝海国际速递</td> </tr> <tr> <td>88</td> <td>ESDEX</td> <td>卓志速运</td> </tr> <tr> <td>89</td> <td>YTOGJ</td> <td>圆通国际</td> </tr> <tr> <td>90</td> <td>STWL</td> <td>速通物流</td> </tr> <tr> <td>91</td> <td>WAJ</td> <td>沃埃家</td> </tr> <tr> <td>92</td> <td>UBON</td> <td>优邦速运</td> </tr> <tr> <td>93</td> <td>WND</td> <td>WnDirect</td> </tr> <tr> <td>94</td> <td>SXXF</td> <td>山西馨富</td> </tr> <tr> <td>95</td> <td>YC</td> <td>远长物流</td> </tr> <tr> <td>96</td> <td>BSGJ</td> <td>百世国际</td> </tr> <tr> <td>97</td> <td>YUD</td> <td>长发快递</td> </tr> <tr> <td>98</td> <td>KMYRX</td> <td>昆明云瑞祥</td> </tr> <tr> <td>99</td> <td>DHL</td> <td>DHL全球</td> </tr> <tr> <td>100</td> <td>CN7000001011758</td> <td>泰进物流</td> </tr> <tr> <td>101</td> <td>BYZH</td> <td>贝业智慧物流</td> </tr> <tr> <td>102</td> <td>JQWL</td> <td>浙江鉴强物流</td> </tr> <tr> <td>103</td> <td>ESB</td> <td>E速宝</td> </tr> <tr> <td>104</td> <td>SZXK</td> <td>苏州熙康</td> </tr> <tr> <td>105</td> <td>DDS</td> <td>点点送</td> </tr> <tr> <td>106</td> <td>SUYUN123</td> <td>58速运</td> </tr> <tr> <td>107</td> <td>SEND2CHINA</td> <td>Send2China</td> </tr> <tr> <td>108</td> <td>CYEXP</td> <td>长宇快递</td> </tr> <tr> <td>109</td> <td>TTKEU</td> <td>天天欧洲物流</td> </tr> <tr> <td>110</td> <td>SQWL</td> <td>商桥物流</td> </tr> <tr> <td>111</td> <td>WORLDCPS</td> <td>天马物流</td> </tr> <tr> <td>112</td> <td>KXTX</td> <td>卡行天下</td> </tr> <tr> <td>113</td> <td>AOYOUZGKY</td> <td>澳邮中国快运</td> </tr> <tr> <td>114</td> <td>EFS</td> <td>EFSPOST</td> </tr> <tr> <td>115</td> <td>AXWL</td> <td>安迅物流</td> </tr> <tr> <td>116</td> <td>RUSTON</td> <td>俄速通</td> </tr> <tr> <td>117</td> <td>PAKD</td> <td>平安快递</td> </tr> <tr> <td>118</td> <td>TDWL_123456</td> <td>腾达物流</td> </tr> <tr> <td>119</td> <td>XZB</td> <td>鑫泽邦物流</td> </tr> <tr> <td>120</td> <td>HCT</td> <td>新竹物流</td> </tr> <tr> <td>121</td> <td>MGSD</td> <td>美国速递</td> </tr> <tr> <td>122</td> <td>SCJXWLYXGS</td> <td>余氏东风</td> </tr> <tr> <td>123</td> <td>DD</td> <td>当当宅配</td> </tr> <tr> <td>124</td> <td>AST</td> <td>安世通</td> </tr> <tr> <td>125</td> <td>FTDKD</td> <td>富腾达快递</td> </tr> <tr> <td>126</td> <td>EHAOYAO</td> <td>好药师物流</td> </tr> <tr> <td>127</td> <td>RBYZEMS</td> <td>日本邮政EMS</td> </tr> <tr> <td>128</td> <td>CGKD</td> <td>程光快递</td> </tr> <tr> <td>129</td> <td>DOD</td> <td>门对门</td> </tr> <tr> <td>130</td> <td>YDTKD</td> <td>易达通快递</td> </tr> <tr> <td>131</td> <td>BHWL</td> <td>保宏物流</td> </tr> <tr> <td>132</td> <td>XAJ</td> <td>新安居仓配</td> </tr> <tr> <td>133</td> <td>CSZX</td> <td>城市之星</td> </tr> <tr> <td>134</td> <td>XYWL</td> <td>秀驿物流</td> </tr> <tr> <td>135</td> <td>LTJZPS</td> <td>蓝豚家装配送</td> </tr> <tr> <td>136</td> <td>DJ56</td> <td>东骏快捷</td> </tr> <tr> <td>137</td> <td>NEDA</td> <td>能达速递</td> </tr> <tr> <td>138</td> <td>CHS</td> <td>重庆中环</td> </tr> <tr> <td>139</td> <td>YXWLJT</td> <td>宇鑫物流</td> </tr> </tbody> </table> <p>[下载快递公司编号对照表](<a href="https://file.jumdata.com/support/express/express-code.xlsx">https://file.jumdata.com/support/express/express-code.xlsx</a> &quot;下载快递公司编号对照表&quot;)</p> <h4>物流状态对照表</h4> <p>&lt;a name=&quot;物流状态对照表&quot;/&gt;</p> <table> <thead> <tr> <th>序号</th> <th>&lt;div style=&quot;width:300px&quot;&gt;物流主状态&lt;/div&gt;</th> <th>&lt;div style=&quot;width:350px&quot;&gt;物流子状态&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>WAIT_ACCEPT: 待揽收</td> <td>RECEIVE: 接单中 &lt;br /&gt;WAIT_ACCEPT: 待揽收</td> </tr> <tr> <td>2</td> <td>ACCEPT: 已揽收</td> <td>ACCEPT: 已揽收</td> </tr> <tr> <td>3</td> <td>TRANSPORT: 运输中</td> <td>TRANSPORT: 运输中&lt;br/&gt;ON_THE_WAY: 在途中&lt;br/&gt;SEND_ON: 转单或修改地址转寄&lt;br/&gt;ARRIVE_CITY: 到达目的城市</td> </tr> <tr> <td>4</td> <td>DELIVERING: 派件中</td> <td>DELIVERING: 派件中&lt;br/&gt;STA_INBOUND: 已放入快递柜或驿站</td> </tr> <tr> <td>5</td> <td>AGENT_SIGN: 已代签收</td> <td>AGENT_SIGN: 已代签收</td> </tr> <tr> <td>6</td> <td>SIGN:已签收</td> <td>SIGN: 已签收&lt;br/&gt;STA_SIGN: 从快递柜或者驿站取出&lt;br/&gt;RETURN_SIGN:退回签收</td> </tr> <tr> <td>7</td> <td>FAILED:包裹异常</td> <td>FAILED: 包裹异常&lt;br/&gt;TIMEOUT_UNSIGEN: 超时未签收&lt;br/&gt;TIMEOUT_NO_UPDATE: 超时未更新&lt;br/&gt;REFUSE_SIGN: 拒收&lt;br/&gt;DELIVER_ABNORMAL: 派件异常&lt;br/&gt;STA_TIMEOUT_UNSIGEN: 快递柜或者驿站超时未取&lt;br/&gt;CONTACT_FAIL: 无法联系&lt;br/&gt;OVER_AREA: 超区&lt;br/&gt;RETENTION: 滞留件&lt;br/&gt;ISSUE: 问题件&lt;br/&gt;RETURN: 退回件&lt;br/&gt;SEND_NO_MESSAGE: 发货无信息&lt;br/&gt;DAMAGE: 破损 &lt;br/&gt;CANCEL_ORDER:揽件取消</td> </tr> </tbody> </table> <p>[下载物流状态对应表](<a href="https://file.jumdata.com/support/express/express-logistics-status.xlsx">https://file.jumdata.com/support/express/express-logistics-status.xlsx</a> &quot;下载物流状态对应表&quot;)</p>

页面列表

ITEM_HTML