快遞查詢(快遞鳥,快遞100,萬維易源)

v1.0.2
版本
2023-12-07
版本更新時間
183
安裝
4
star
安裝
composer require shopwwi/webman-express
配置文件
//路徑 config/plugin/shopwwi/express/app.php
'default' => 'kuaidi100',
'holder' => [
'kuaidi100' => [
'driver' => \Shopwwi\WebmanExpress\Adapter\KuaiDi100AdapterFactory::class,
'api_url' => 'https://poll.kuaidi100.com/poll/query.do',
'app_id' => '', //customer
'app_key' => '' //授權(quán)KEY
],
'kdniao' => [
'driver' => \Shopwwi\WebmanExpress\Adapter\KdNiaoAdapterFactory::class,
'api_url' => 'https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx', //測試地址 http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
'app_id' => '',
'app_key' => ''
],
'showapi' => [
'driver' => \Shopwwi\WebmanExpress\Adapter\ShowApiAdapterFactory::class,
'api_url' => 'https://route.showapi.com/2650',
'app_id' => '', //showapi_appid
'app_key' => '' //secret
]
],
支持的查詢
- 快遞100 (kuaidi100)
- 快遞鳥(kdniao)
- 萬維易源 (showapi)
使用方法
- 選擇選定器
use Shopwwi\WebmanExpress\Facade\Express;
$express = Express::make(); //默認(rèn)選定器
$express = Express::make('kuaidi100');
2.快遞查詢
use Shopwwi\WebmanExpress\Facade\Express;
$express = Express::make(); //默認(rèn)選定器
// $tracking_code 快遞公司編碼
// $shipping_code 物流單號
// $additional 擴(kuò)展參數(shù) 詳見下面說明
$express = $express->track($tracking_code, $shipping_code,$additional = [])
3.請求擴(kuò)展參數(shù)區(qū)別($additional)
- 快遞鳥
參數(shù)名稱 | 類型 | 說明 | 必須要求 |
---|---|---|---|
OrderCode | String | 訂單編號 | 否 |
CustomerName | String | ShipperCode 為JD,必填,對應(yīng)京東的青龍配送編碼,也叫商家編碼,格式:數(shù)字+字母+數(shù)字,9 位數(shù)字加一個字母,共10 位,舉例:001K123450;ShipperCode 為SF,且快遞單號非快遞鳥渠道返回時,必填,對應(yīng)收件人/寄件人手機(jī)號后四位;ShipperCode 為SF,且快遞單號為快遞鳥渠道返回時,不填;ShipperCode 為其他快遞時,不填 | 否 |
- 快遞100
參數(shù)名稱 | 類型 | 說明 | 必須要求 |
---|---|---|---|
phone | String | 收、寄件人的電話號碼(手機(jī)和固定電話均可,只能填寫一個,順豐速運和豐網(wǎng)速運必填,其他快遞公司選填。如座機(jī)號碼有分機(jī)號,分機(jī)號無需傳入。) | 否 |
from | String | 出發(fā)地城市 | 否 |
to | String | 目的地城市,到達(dá)目的地后會加大監(jiān)控頻率 | 否 |
4.返回結(jié)果說明(對各站進(jìn)行了統(tǒng)一)
參數(shù)名稱 | 類型 | 說明 |
---|---|---|
message | String | 消息體,請忽略 |
status | String | 通訊狀態(tài),請忽略 |
exp_logo | String | 快遞公司logo |
exp_name | String | 快遞公司名稱 |
exp_ship_sn | String | 快遞公司編碼 |
exp_ship_code | String | 快遞單號 |
exp_tel | String | 快遞公司電話 |
exp_state | String | 當(dāng)前快遞狀態(tài) |
route_info | Array | 快遞途徑明細(xì) |
exp_list | Array | 快遞明細(xì)列表 |
└ time | String | 時間,原始格式 |
└ context | String | 內(nèi)容 |
└ status | String | 本數(shù)據(jù)元對應(yīng)的物流狀態(tài)名稱或者高級狀態(tài)名稱 |
└ status_code | String | 本數(shù)據(jù)元對應(yīng)的高級物流狀態(tài)值 |
└ area_name | String | 本數(shù)據(jù)元對應(yīng)的行政區(qū)域的名稱 |
└ area_code | String | 本數(shù)據(jù)元對應(yīng)的行政區(qū)域的編碼 |
└ location | String | 本數(shù)據(jù)元對應(yīng)的行政區(qū)域經(jīng)緯度 |
└ area_pinyin | String | 本數(shù)據(jù)元對應(yīng)的行政區(qū)域拼音 |