| 應用場景 |
| 功能説明 |
| 使用流程 |
| API參數 |
| 參數名稱 | 類型 | 説明 | 必須要求 |
|---|---|---|---|
| RequestData | String | 請求內容需進行URL(utf-8)編碼。請求內容JSON格式，須和DataType一致。 | R |
| EBusinessID | String | 商户ID，請在我的服務頁面查看。 | R |
| RequestType | String | 請求指令類型：1008 | R |
| DataSign | String | 數據內容簽名：把(請求內容(未編碼)+AppKey)進行MD5加密，然後Base64編碼，最後 進行URL(utf-8)編碼。詳細過程請查看Demo。 | R |
| DataType | String | 請求、返回數據類型：2-json； | R |
| 參數名稱 | 類型 | 説明 | 必須要求 |
|---|---|---|---|
| RequestData | String | 請求內容需進行URL(utf-8)編碼。請求內容只支持JSON格式。 | R |
| RequestType | String | 101-軌跡查詢結果, 107-貨款狀態 | R |
| DataSign | String | 數據內容簽名（把(請求內容(未編碼)+AppKey)進行MD5加密，然後Base64編碼） | R |
| 參數 | 類型 | 説明 | 必須要求 | |
|---|---|---|---|---|
| Callback | String(50) | 用户自定義回調信息 | O | |
| MemberID | String(50) | 會員標識(備用字段) | O | |
| WareHouseID | String(30) | 倉庫標識(備用字段) | O | |
| CustomerName | String | 電子面單客户賬號(與快遞網點申請) | O | |
| CustomerPwd | String | 電子面單密碼 | O | |
| SendSite | String | 收件網點標識(名稱) | O | |
| ShipperCode | String(10) | 快遞公司編碼 | R | |
| LogisticCode | String(30) | 快遞單號 | R | |
| OrderCode | String(30) | 訂單編號 | O | |
| MonthCode | String(20) | 月結編號 | O | |
| PayType | Int | 郵費支付方式:1-現付，2-到付，3-月結，4-第三方支付 | O | |
| ExpType | String(2) | 快遞類型：1-標準快件 | O | |
| Cost | Double(5) | 快遞運費 | O | |
| OtherCost | Double(5) | 其他費用 | O | |
| Receiver | Company | String(30) | 收件人公司 | O |
| Name | String(30) | 收件人 | R | |
| Tel | String(20) | 電話(電話與手機，必填一個) | R | |
| Mobile | String(20) | 手機 | R | |
| PostCode | String(10) | 收件人郵編 | O | |
| ProvinceName | String(20) | 收件省（如廣東省，不要缺少“省”） | R | |
| CityName | String(20) | 收件市（如深圳市，不要缺少“市”） | R | |
| ExpAreaName | String(20) | 收件區（如福田區，不要缺少“區”或“縣”） | R | |
| Address | String(100) | 收件人詳細地址 | R | |
| Sender | Company | String(30) | 發件人公司 | O |
| Name | String(30) | 發件人 | R | |
| Tel | String(20) | 手機與電話必填一個 | R | |
| Mobile | String(20) | 發件人手機 | R | |
| PostCode | String | 發件人郵編 | O | |
| ProvinceName | String(20) | 發件省（如廣東省，不要缺少“省”） | R | |
| CityName | String(20) | 發件市（如深圳市，不要缺少“市”） | R | |
| ExpAreaName | String(20) | 發件區（如福田區，不要缺少“區”或“縣”） | R | |
| Address | String(100) | 發件人詳細地址 | R | |
| IsNotice | Int(1) | 是否通知快遞員上門攬件：0-通知;1-不通知;默認為1 | O | |
| StartDate | String | 上門取貨時間段:"yyyy-MM-dd HH:mm:ss"格式化，本文中所有時間格式相同 | O | |
| EndDate | String | O | ||
| Weight | Double | 包裹總重量kg | O | |
| Quantity | Int(2) | 件數/包裹數 | O | |
| Volume | Double | 物品總體積m3 | O | |
| Remark | String(60) | 備註 | O | |
| IsSendMessage | Int(1) | 是否訂閲短信：0-不需要；1-需要 | O | |
| AddService(數組形式) | ||||
| AddService | Name | String(20) | 增值服務名稱 | O |
| Value | String(30) | 增值服務值 | O | |
| CustomerID | String(30) | 客户標識(選填) | O | |
| Commodity(數組形式) | ||||
| Commodity | GoodsName | String(100) | 商品名稱 | O |
| GoodsCode | String(20) | 商品編碼 | O | |
| Goodsquantity | Int(5) | 件數 | O | |
| GoodsPrice | Double(10) | 商品價格 | O | |
| GoodsWeight | Double | 商品重量kg | O | |
| GoodsDesc | String(50) | 商品描述 | O | |
| GoodsVol | Double | 商品體積m3 | O | |
| 參數名稱 | 類型 | 説明 | 必須要求 |
|---|---|---|---|
| EBusinessID | String | 用户ID | R |
| UpdateTime | String | 更新時間 YYYY-MM-DD HH24:MM:SS | R |
| Success | Bool | 成功與否：true，false | R |
| Reason | String(50) | 失敗原因 | O |
| EstimatedDeliveryTime | String | 訂單預計到貨時間yyyy-mm-dd（即將上線） | O |
| 參數名稱 | 類型 | 説明 | 必須要求 |
|---|---|---|---|
| EBusinessID | String | 用户電商ID | R |
| PushTime | String | 推送時間 | R |
| Count | String | 推送物流單號軌跡個數 | R |
| Data | String | 推送物流單號軌跡集合 | R |
| 參數 | 類型 | 説明 | 必須要求 | ||
|---|---|---|---|---|---|
| Data | EBusinessID | String | 商户ID | O | |
| ShipperCode | String | 快遞公司編碼 | R | ||
| LogisticCode | String | 快遞單號 | R | ||
| Success | Bool | 成功與否：true,false | R | ||
| Reason | String | 失敗原因 | O | ||
| State | String | 物流狀態: 0-無軌跡，1-已攬收，2-在途中，3-簽收,4-問題件 | R | ||
| CallBack | String | 訂閲接口的Bk值 | O | ||
| Traces | |||||
| Traces | AcceptTime | String | 時間 | R | |
| AcceptStation | String | 描述 | R | ||
| Remark | String | 備註 | O | ||
| EstimatedDeliveryTime | String | 預計到達時間yyyy-mm-dd | O | ||
| 參數名稱 | 類型 | 説明 | 必須要求 | |
|---|---|---|---|---|
| Data | EBusinessID | String | 用户電商ID | O |
| OrderCode | String | 訂單編號 | O | |
| ShipperCode | String | 快遞公司編碼 | R | |
| LogisticCode | String | 物流運單號 | R | |
| Success | Bool | 成功與否 | R | |
| Reason | String | 失敗原因 | O | |
| State | String | 物流狀態:0-無軌跡,1-已攬收, 2-在途中 201-到達派件城市，3-簽收,4-問題件 | R | |
| CallBack | String | 訂閲接口的Bk值 | O | |
| OrderState | String | 訂單貨款狀態：1-待出款；2-已出款；3-已收款 | O | |
| AccountName | String | 返款銀行卡開户人（例：**偉、*佳） | O | |
| AccountTel | String | 返款銀行卡手機末四位 | O | |
| AccountNum | String | 返款銀行卡末四位 | O | |
| 參數名稱 | 類型 | 説明 | 必須要求 |
|---|---|---|---|
| EBusinessID | String | 用户ID | R |
| UpdateTime | String | 時間 | R |
| Success | Bool | 成功與否：true，false | R |
| Reason | String | 失敗原因 | O |
{ "ShipperCode":"SF", "OrderCode":"SF201608081055208281", "LogisticCode":"3100707578976", "PayType":"1", "ExpType":"1", "CustomerName":"", "CustomerPwd":"", "MonthCode":"", "IsNotice":"0", "Sender":{ "Name":"1255760", "Tel":"", "Mobile":"13700000000", "ProvinceName":"廣東省", "CityName":"深圳市", "ExpAreaName":"福田區", "Address":"測試地址" }, "Receiver":{ "Name":"1255760", "Tel":"", "Mobile":"13800000000", "ProvinceName":"廣東省", "CityName":"深圳市", "ExpAreaName":"龍華新區", "Address":"測試地址2" }, "Commodity":[ { "GoodsName":"書本" } ] }{ "EBusinessID": "1151847", "UpdateTime": "2016-08-09 16:42:38", "Success": true, "Reason": "" }{ "EBusinessID": "1109259", "Count": "2", "PushTime": "2015-3-11 16:21:06", "Data": [ { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260908504", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "Traces": [ { "AcceptTime": "2015-03-06 21:16:58", "AcceptStation": "深圳市橫崗速遞營銷部已收件，（攬投員姓名：鍾定基;聯繫電話：）", "Remark": "" }, { "AcceptTime": "2015-03-07 14:25:00", "AcceptStation": "離開深圳市 發往廣州市", "Remark": "" }, { "AcceptTime": "2015-03-08 00:17:00", "AcceptStation": "到達廣東速遞物流公司廣航中心處理中心（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-08 01:15:00", "AcceptStation": "離開廣州市 發往北京市（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-09 09:01:00", "AcceptStation": "到達北京黃村轉運站處理中心（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-09 18:39:00", "AcceptStation": "離開北京市 發往呼和浩特市（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-10 18:06:00", "AcceptStation": "到達 呼和浩特市 處理中心", "Remark": "" }, { "AcceptTime": "2015-03-11 09:53:48", "AcceptStation": "呼和浩特市郵政速遞物流分公司金川攬投部安排投遞（投遞員姓名：安長虹;聯繫電話：18047140142）", "Remark": "" } ] }, { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260943004", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "Traces": [ { "AcceptTime": "2015-03-07 15:26:09", "AcceptStation": "深圳市橫崗速遞營銷部已收件，（攬投員姓名：周宏彪;聯繫電話：13689537568）", "Remark": "" }, { "AcceptTime": "2015-03-08 16:32:00", "AcceptStation": "離開深圳市 發往廣州市", "Remark": "" }, { "AcceptTime": "2015-03-09 00:58:00", "AcceptStation": "到達廣東速遞物流公司廣航中心處理中心（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-09 01:15:00", "AcceptStation": "離開廣州市 發往北京市（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-10 05:20:00", "AcceptStation": "到達北京黃村轉運站處理中心（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-10 11:59:00", "AcceptStation": "離開北京市 發往廊坊市（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-10 14:23:00", "AcceptStation": "到達廊坊市處理中心（經轉）", "Remark": "" }, { "AcceptTime": "2015-03-11 08:55:00", "AcceptStation": "離開廊坊市 發往保定市（經轉）", "Remark": "" } ] } ] }{ "EBusinessID": "1109259", "Count": "2", "PushTime": "2015-3-11 16:21:06", "Data": [ { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260908504", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "OrderState":"1", "AccountName":"張三", "AccountTel":"13800000000", "AccountNum":"0321" }, { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260908522", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "OrderState":"1", "AccountName":"張三", "AccountTel":"13800000011", "AccountNum":"0321" } ] }{ "EBusinessID": "1151847", "UpdateTime": "2016-08-09 16:42:38", "Success": true, "Reason": "" }| 接入流程 |
| demo下載 |
粵公安備案號：44030402002993