狠狠色丁香婷婷综合尤物/久久精品综合一区二区三区/中国有色金属学报/国产日韩欧美在线观看 - 国产一区二区三区四区五区tv

LOGO OA教程 ERP教程 模切知識交流 PMS教程 CRM教程 開發文檔 其他文檔  
 
網站管理員

實時快遞單號查詢技術文檔
admin
2022年9月7日 19:57 本文熱度 1013
https://www.kuaidi100.com/
https://api.kuaidi100.com/document/5f0ffb5ebc8da837cbd8aefc#section_2

一、實時快遞查詢接口

用戶向接口提交快遞單號后，接口會實時調取快遞公司的單號信息并返回此單號最新的物流信息，包括物流軌跡、狀態、時間等。

注意：請控制每一單查詢頻率至少在半小時以上，否則會造成鎖單。

1.1 請求地址

https://poll.kuaidi100.com/poll/query.do

1.2 請求類型

post

1.3 輸入參數

請求參數（header）

名稱類型默認值
Content-Typestringapplication/x-www-form-urlencoded

請求參數（body）

名稱類型是否必需示例值描述
customerString是授權碼，請申請企業版獲取
signString是簽名， 用于驗證身份， 按param + key + customer 的順序進行MD5加密（注意加密后字符串一定要轉32位大寫）， 不需要加上“+”號
ΘparamObject是由其他字段拼接
└ comstring是yuantong查詢的快遞公司的編碼， 一律用小寫字母 下載編碼表格
└ numstring是12345678查詢的快遞單號， 單號的最小長度6個字符，最大長度32個字符
└ phonestring否13888888888收、寄件人的電話號碼（手機和固定電話均可，只能填寫一個，順豐速運和豐網速運必填，其他快遞公司選填。如座機號碼有分機號，分機號無需傳入。）
└ fromstring否廣東深圳出發地城市
└ tostring否北京朝陽目的地城市，到達目的地后會加大監控頻率
└ resultv2int否1添加此字段表示開通行政區域解析功能。空：關閉（默認），1：開通行政區域解析功能以及物流軌跡增加物流狀態名稱 4: 開通行政解析功能以及物流軌跡增加物流高級狀態名稱、狀態值并且返回出發、目的及當前城市信息
└showString否0返回格式：0：json格式（默認），1：xml，2：html，3：text
└orderString否desc返回結果排序:desc降序（默認）,asc 升序

1.4 請求參數示例

customer = **********
sign = ******************
param = {
    "com": "ems",
    "num": "em263999513jp",
    "phone": "13868688888",
    "from": "廣東省深圳市南山區",
    "to": "北京市朝陽區",
    "resultv2": "4",
    "show": "0",
    "order": "desc"
}

1.5 返回結果

字段名稱類型字段含義
messageString消息體，請忽略
stateString快遞單當前狀態，默認為0在途，1攬收，2疑難，3簽收，4退簽，5派件，8清關，14拒簽等10個基礎物流狀態，如需要返回高級物流狀態，請參考 resultv2 傳值
statusString通訊狀態，請忽略
conditionString快遞單明細狀態標記，暫未實現，請忽略
ischeckString是否簽收標記，0未簽收，1已簽收，請忽略，明細狀態請參考state字段
comString快遞公司編碼,一律用小寫字母
nuString單號
Θdatadata最新查詢結果，數組，包含多項，全量，倒序（即時間最新的在最前），每項都是對象，對象包含字段請展開
└ contextString內容
└ timeString時間，原始格式
└ ftimeString格式化后時間
└statusString本數據元對應的物流狀態名稱或者高級狀態名稱，實時查詢接口中提交resultv2=1或者resultv2=4標記后才會出現
└statusCodeString本數據元對應的高級物流狀態值，實時查詢接口中提交resultv2=4標記后才會出現
└areaCodeString本數據元對應的行政區域的編碼，實時查詢接口中提交resultv2=1或者resultv2=4標記后才會出現
└areaNameString本數據元對應的行政區域的名稱，實時查詢接口中提交resultv2=1或者resultv2=4標記后才會出現
└areaCenterString本數據元對應的行政區域經緯度，實時查詢接口中提交resultv2=4標記后才會出現
└locationString本數據元對應的快件當前地點，實時查詢接口中提交resultv2=4標記后才會出現
└areaPinYinString本數據元對應的行政區域拼音，實時查詢接口中提交resultv2=4標記后才會出現


1.6 運單快遞狀態（state)說明

物流狀態值物流狀態名稱高級物流狀態值高級物流狀態名稱含義
1攬收1攬收快件攬件
101已下單已經下快件單
102待攬收待快遞公司攬收
103已攬收快遞公司已經攬收
0在途0在途快件在途中
1001到達派件城市快件到達收件人城市
1002干線快件處于運輸過程中
1003轉遞快件發往到新的收件地址
5派件5派件快件正在派件
501投柜或驛站快件已經投遞到快遞柜或者快遞驛站
3簽收3簽收快件已簽收
301本人簽收收件人正常簽收
302派件異常后簽收快件顯示派件異常，但后續正常簽收
303代簽快件已被代簽
304投柜或站簽收快件已從快遞柜或者驛站取出簽收
6退回6退回快件正處于返回發貨人的途中
4退簽4退簽此快件單已退簽
401已銷單此快件單已撤銷
14拒簽收件人拒簽快件
7轉投7轉投快件轉給其他快遞公司郵寄
2疑難2疑難快件存在疑難
201超時未簽收快件長時間派件后未簽收
202超時未更新快件長時間沒有派件或簽收
203拒收收件人發起拒收快遞,待發貨方確認
204派件異常快件派件時遇到異常情況
205柜或驛站超時未取快件在快遞柜或者驛站長時間未取
206無法聯系無法聯系到收件人
207超區超出快遞公司的服務區范圍
208滯留快件滯留在網點，沒有派送
209破損快件破損
8清關8清關快件清關
10待清關快件等待清關
11清關中快件正在清關流程中
12已清關快件已完成清關流程
13清關異常貨物在清關過程中出現異常
14拒簽\\收件人拒簽快件

注：如需物流狀態高級狀態名稱及狀態值需要 resultv2 傳 “4” 返回

1.7 正確返回示例

JSON格式

{
    "message": "ok",
    "nu": "JT0004301991791",
    "ischeck": "0",
    "com": "jtexpress",
    "status": "200",
    "data": [
        {
            "time": "2021-12-15 17:19:28",
            "context": "【杭州市】您的包裹已存放至【驛站】，記得早點來取它回家！",
            "ftime": "2021-12-15 17:19:28",
            "areaCode": "CN330102000000",//本數據元對應的行政區域編碼，resultv2=1或者resultv2=4才會展示
            "areaName": "浙江,杭州市,上城區",//本數據元對應的行政區域名稱，resultv2=1或者resultv2=4才會展示
            "status": "投柜或驛站",//本數據元對應的物流狀態名稱或者高級物流狀態名稱，resultv2=1或者resultv2=4才會展示
            "location": "浙江省 杭州市 上城區", //本數據元對應的快件當前地點，resultv2=4才會展示
            "areaCenter": "120.184349,30.25446", //本數據元對應的行政區域經緯度，resultv2=4才會展示
            "areaPinYin": "shang cheng qu",//本數據元對應的行政區域拼音，resultv2=4才會展示
            "statusCode": "501"//本數據元對應的高級物流狀態值，resultv2=4才會展示
        },
        {
            "time": "2021-12-15 14:17:31",
            "context": "【杭州市】【杭州網點】的極兔小哥正在派件",
            "ftime": "2021-12-15 14:17:31",
            "areaCode": "CN330102000000",
            "areaName": "浙江,杭州市,上城區",
            "status": "派件",
            "location": "浙江省 杭州市 上城區",
            "areaCenter": "120.184349,30.25446",
            "areaPinYin": "shang cheng qu",
            "statusCode": "5"
        },
        {
            "time": "2021-12-15 13:58:18",
            "context": "【杭州市】 快件到達【杭州網點】",
            "ftime": "2021-12-15 13:58:18",
            "areaCode": "CN330102000000",
            "areaName": "浙江,杭州市,上城區",
            "status": "在途",
            "location": "浙江省 杭州市 上城區",
            "areaCenter": "120.184349,30.25446",
            "areaPinYin": "shang cheng qu",
            "statusCode": "0"
        },
        {
            "time": "2021-12-15 04:11:20",
            "context": "【杭州市】快件離開【杭州轉運中心】已發往【杭州江干四季青網點】",
            "ftime": "2021-12-15 04:11:20",
            "areaCode": "CN330109000000",
            "areaName": "浙江,杭州市,蕭山區",
            "status": "干線",
            "location": "浙江省 杭州市 蕭山區",
            "areaCenter": "120.493286,30.28333",
            "areaPinYin": "xiao shan qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-15 02:09:52",
            "context": "【杭州市】 快件到達【杭州轉運中心】",
            "ftime": "2021-12-15 02:09:52",
            "areaCode": "CN330109000000",
            "areaName": "浙江,杭州市,蕭山區",
            "status": "干線",
            "location": "浙江省 杭州市 蕭山區",
            "areaCenter": "120.493286,30.28333",
            "areaPinYin": "xiao shan qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 21:08:34",
            "context": "【上海市】快件離開【上海浦西轉運中心】已發往【杭州轉運中心】",
            "ftime": "2021-12-14 21:08:34",
            "areaCode": "CN310118000000",
            "areaName": "上海,上海,青浦區",
            "status": "干線",
            "location": "上海 上海市 青浦區",
            "areaCenter": "121.124178,31.150681",
            "areaPinYin": "qing pu qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 20:54:22",
            "context": "【上海市】 快件到達【上海浦西轉運中心】",
            "ftime": "2021-12-14 20:54:22",
            "areaCode": "CN310118000000",
            "areaName": "上海,上海,青浦區",
            "status": "干線",
            "location": "上海 上海市 青浦區",
            "areaCenter": "121.124178,31.150681",
            "areaPinYin": "qing pu qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 17:25:58",
            "context": "【上海市】快件離開【上海楊浦黃興路網點】已發往【上海浦西轉運中心】",
            "ftime": "2021-12-14 17:25:58",
            "areaCode": "CN310110000000",
            "areaName": "上海,上海,楊浦區",
            "status": "干線",
            "location": "上海 上海市 楊浦區",
            "areaCenter": "121.526077,31.259541",
            "areaPinYin": "yang pu qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 09:03:58",
            "context": "【上海市】【上海楊浦黃興路網點】已取件。",
            "ftime": "2021-12-14 09:03:58",
            "areaCode": "CN310110000000",
            "areaName": "上海,上海,楊浦區",
            "status": "攬收",
            "location": "上海 上海市 楊浦區",
            "areaCenter": "121.526077,31.259541",
            "areaPinYin": "yang pu qu",
            "statusCode": "1"
        }
    ],
    "state": "5",
    "condition": "00",
    "routeInfo": {
        "from": {
            "number": "CN310110000000",
            "name": "上海,上海,楊浦區"
        },//本數據元對應的出發地城市信息，resultv2=4才會展示
        "cur": {
            "number": "CN330102000000",
            "name": "浙江,杭州市,上城區"
        },//本數據元對應的當前城市信息，resultv2=4才會展示
        "to": null
    },//本數據元對應的目的地城市信息，resultv2=4才會展示
    "isLoop": false
}
}

1.8 錯誤返回示例

JSON格式

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

1.8 信息代碼含義

信息代碼信息內容描述原因及建議處理方式
200查詢成功查詢成功
400找不到對應公司提交數據不完整或者賬號未充值, 檢查提交的格式是否為x-www-form-urlencoded的post格式
500查詢無結果，請隔段時間再查表示查詢失敗，或沒有POST提交
501服務器錯誤快遞100的服務器出現間歇或臨時性異常，有時如果因為不按規范提交請求，比如快遞公司參數沒有按照文檔規定填寫等，也會報此錯誤
502服務器繁忙快遞100的服務器出現間歇或臨時性異常，請聯系快遞100排查原因
503驗證簽名失敗請檢查加密方式，param + key + customer 的順序進行MD5加密，加密后字符串轉大寫
601key已過期沒有可用單量，賬號需要充值使用

二、快遞公司編碼

下載表格

如果您需要的公司不在此列表，請聯系在線客服添加

三、demo下載

JAVA示例代碼    PHP示例代碼    PYTHON示例代碼    .NET示例代碼

四、注意事項

1、貴司連續5次com字段為空或者不符合《快遞100快遞公司編碼規則》，快遞100API將會通過快遞單號的數據自動調用智能識別接口，判斷合適的快遞公司編號，返回對應的快遞信息。

2、貴司com字段數據符合《快遞100快遞公司編碼規則》時，同一錯誤快遞單號連續調用接口5次，快遞100API接口將返回500（查詢無結果，請隔段時間再查）。需要注意的是：該次調用的單號會列入貴司的調用數據內，列入計費賬單內。


該文章在 2022/9/7 19:57:53 編輯過
關鍵字查詢
相關文章
正在查詢...
點晴ERP是一款針對中小制造業的專業生產管理軟件系統,系統成熟度和易用性得到了國內大量中小企業的青睞。
點晴PMS碼頭管理系統主要針對港口碼頭集裝箱與散貨日常運作、調度、堆場、車隊、財務費用、相關報表等業務管理，結合碼頭的業務特點，圍繞調度、堆場作業而開發的。集技術的先進性、管理的有效性于一體，是物流碼頭及其他港口類企業的高效ERP管理信息系統。
點晴WMS倉儲管理系統提供了貨物產品管理,銷售管理,采購管理,倉儲管理,倉庫管理,保質期管理,貨位管理,庫位管理,生產管理,WMS管理系統,標簽打印,條形碼,二維碼管理,批號管理軟件。
點晴免費OA是一款軟件和通用服務都免費，不限功能、不限時間、不限用戶的免費OA協同辦公管理系統。
Copyright 2010-2025 ClickSun All Rights Reserved