快遞100地圖軌跡查詢API接口案例

1、 快遞查詢地圖軌跡

1.1 接口格式

提供統一格式的HTTP POST或GET調用接口,並返回格式支持JSON，xml，text，html數據。

1.2 請求地址

https://poll.kuaidi100.com/po...

請求參數：

參數名	是否必填	類型	說明
customer	是	string	受權碼，請申請企業版獲取
sign	是	string	簽名， 用於驗證身份， 按param + key + customer 的順序進行MD5加密（注意加密後字符串必定要轉32位大寫）， 不須要加上「+」號
param	是	param	由其餘字段拼接

param數據結構：

參數名	是否必填	類型	說明
com	是	string	查詢的快遞公司的編碼， 一概用小寫字母
num	是	string	查詢的快遞單號， 單號的最大長度是32個字符
phone	否	string	收、寄件人的電話號碼（手機和固定電話都可，只能填寫一個，順豐單號必填，其餘快遞公司選填。如座機號碼有分機號，分機號無需上傳。）
from	是	string	出發地信息，如：廣東省深圳市南山區金蝶軟件園
to	是	string	目的地信息，如：北京朝陽區國際金融大廈
show	否	string	返回格式：0：json格式（默認），1：xml，2：html，3：text
order	否	string	返回結果排序:desc降序（默認）,asc 升序
orderTime	否	string	訂單下單時間，格式爲（yyyy-MM-dd HH:mm:ss）如：2020-12-16 12:59:59

1.3 請求實例

customer=**
  sign=**
  param={
    "com":"ems",
    "num":"em263999513jp",
    "phone":"13868688888",
    "from":"廣東省深圳市南山區金蝶軟件園",
    "to":"北京朝陽區國際金融大廈",
    "show":"0",
    "order":"desc",
    "orderTime":"2020-12-16 12:59:59"
  }

1.4 返回結果

字段名稱	類型	字段含義
message	String	消息體，請忽略
state	Integer	快遞單當前狀態，包括0在途，1攬收，2疑難，3簽收，4退籤，5派件，6退回，7轉單，10待清關，11清關中，12已清關，13清關異常，14收件人拒籤等13個狀態
status	Integer	通信狀態，請忽略
condition	String	快遞單明細狀態標記，暫未實現，請忽略
ischeck	Integer	是否簽收標記，請忽略，明細狀態請參考state字段
com	String	快遞公司編碼,一概用小寫字母
nu	String	單號
trailUrl	String	軌跡地圖連接
arrivalTime	String	預計到達時間
totalTime	String	平均耗時
remainTime	String	到達還需多少時間
isLoop	Boolean	是否存在環路
ΘrouteInfo		路由信息
└Θfrom		出發地行政區信息
└number		政區信息編碼
└name		政區信息名
└Θcur		當前地行政區信息
└number		政區信息編碼
└name		政區信息名
└Θto		目的地行政區信息
└number		政區信息編碼
└name		政區信息名
Θdata	data	最新查詢結果，數組，包含多項，全量，倒序（即時間最新的在最前），每項都是對象，對象包含字段請展開
└ context	String	內容
└ time	String	時間，原始格式
└ ftime	String	格式化後時間
└status	String	本數據元對應的簽收狀態，只有實時查詢接口中提交resultv2標記後纔會出現
└areaCode	String	本數據元對應的行政區域的編碼，只有實時查詢接口中提交resultv2標記後纔會出現
└areaName	String	本數據元對應的行政區域的名稱，只有實時查詢接口中提交resultv2標記後纔會出現

1.5 提供數據內容

{
    "message": "ok",
    "nu": "YT4781863654577",
    "ischeck": "1",
    "com": "yuantong",
    "status": "200",
    "data": [{
        "time": "2020-11-30 13:19:56",
        "context": "圓通合做點【喵站】快件已到達財富金街院裏3號底商驛站,聯繫電話18744663997",
        "ftime": "2020-11-30 13:19:56",
        "areaCode": null,
        "areaName": null,
        "status": "在途"
    }, {
        "time": "2020-09-12 17:40:58",
        "context": "【廣東省深圳市平湖公司】 已收件 取件人: 劉傑珍 (18128837173)",
        "ftime": "2020-09-12 17:40:58",
        "areaCode": "CN440307003000",
        "areaName": "廣東,深圳市,龍崗區,平湖",
        "status": "攬收"
    }],

    "state": "3",
    "condition": "00",
    "routeInfo": {
        "from": {
            "number": "CN4403",
            "name": "廣東,深圳市"
        },
        "cur": {
            "number": "CN6101",
            "name": "陝西,西安市"
        },
        "to": {
            "number": "CN6101",
            "name": "陝西,西安市"
        }
    },
    "isLoop": false,
       "trailUrl":"https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3",
    "arrivalTime": "2020-12-19 12:00",
    "totalTime": "2天1小時",
    "remainTime": "1天2小時"
}

1.6 運單簽收狀態服務說明

狀態值	名稱	含義
0	在途	快件處於運輸過程當中
1	攬收	快件已由快遞公司攬收
2	疑難	快遞100沒法解析的狀態，或者是須要人工介入的狀態， 比方說收件人電話錯誤。
3	簽收	正常簽收
4	退籤	貨物退回發貨人並簽收
5	派件	貨物正在進行派件
6	退回	貨物正處於返回發貨人的途中
7	轉投	貨物轉給其餘快遞公司郵寄
10	待清關	貨物等待清關
11	清關中	貨物正在清關流程中
12	已清關	貨物已完成清關流程
13	清關異常	貨物在清關過程當中出現異常
14	拒籤	收件人明確拒收

1.7 軌跡連接應用示例

<img src="https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/782a47be14834488bd62d3bd4163c37d~tplv-k3u1fbpfcp-zoom-1.image" style="zoom:60%">

1.8 錯誤返回示例

{
"result":false,
"returnCode":"400",
"message":"找不到對應公司"
}

信息代碼	信息內容描述	緣由及建議處理方式
200	查詢成功	查詢成功
400	參數權限問題	數據不完整，找不到對應公司，非法IP，請申請受權，不支持此快遞公司，單號問題等
500	查詢無結果，請隔段時間再查	表示查詢失敗，去快遞公司沒獲取有效數據
501	服務器錯誤	快遞100的服務器出理間隙或臨時性異常，有時若是由於不按規範提交請求，好比快遞公司參數沒有按照文檔規定填寫等，也會報此錯誤
502	服務器繁忙	快遞100的服務器出理間隙或臨時性異常，請聯繫快遞100排查緣由
503	驗證簽名失敗	請檢查加密方式，param + key + customer 的順序進行MD5加密，加密後字符串轉大寫
601	沒該功能權限	沒有可用單量或沒有開啓權限

1、快遞查詢地圖軌跡API產品介紹

快遞100快遞查詢地圖軌跡接口提供給企業及最終用戶快遞單號的地圖軌跡展現、物流節點文字信息及預計送達時間，可視化展現物流軌跡信息。

經過調用地圖軌跡接口，可展現地圖軌跡、物流節點信息、預計到達時間、快遞單狀態等信息，多樣化物流信息展現維度，提升客戶查詢體驗。

2、快遞查詢地圖軌跡API應用場景

1. 在電商網頁/APP/小程序中，顧客在訂單詳情裏查看購買商品的物流地圖軌跡；
2. 和物流軌跡文字信息一同展現給顧客，可視化訂單的在途狀態；
3. 得到物流途徑城市的信息，監控快遞時效；
4. 預估包裹的到達時間，以及提示包裹還需多長時間到達，識別快遞狀態·，發送提醒客戶簽收短信；

3、快遞查詢地圖軌跡API收費模式

1.收費方式

快遞查詢地圖軌跡屬於增值類服務，該服務同時支持物流文字信息以及地圖連接，即包含了實時查詢接口的功能。註冊快遞100企業帳號後能夠在企業管理後臺查看地圖軌跡套餐價格併購買。

2.收費價格

新品限時特惠，活動時間：2021年1月1日-2021年3月31日，充值後便可開通使用。

原價/元	優惠價/元	單量	贈送/單	優惠單價/元
3000	2000	20000	5000	0.08
1500	1000	10000	2000	約0.084
750	500	5000	500	約0.09
150	100	1000		0.1

快遞查詢地圖軌跡按單計費，一個天然月內同一個運單屢次查詢只收一次費用。該接口單獨計費。

3.開具發票

快遞100支持開具增值稅發票，用戶購買完成後可在企業管理後臺-費用中心-支付記錄-請求開票。默認開具電子增值稅普通發票，1000元以上可支持開具增值稅專用發票。

官方源文檔：

http://api.kuaidi100.com/docu...

http://api.kuaidi100.com/docu...