快递查询(快递鸟,快递100,万维易源)
v1.0.2
版本
2023-12-07
版本更新时间
162
安装
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' => '' //授权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(); //默认选定器
$express = Express::make('kuaidi100');
2.快递查询
use Shopwwi\WebmanExpress\Facade\Express;
$express = Express::make(); //默认选定器
// $tracking_code 快递公司编码
// $shipping_code 物流单号
// $additional 扩展参数 详见下面说明
$express = $express->track($tracking_code, $shipping_code,$additional = [])
3.请求扩展参数区别($additional)
- 快递鸟
参数名称 | 类型 | 说明 | 必须要求 |
---|---|---|---|
OrderCode | String | 订单编号 | 否 |
CustomerName | String | ShipperCode 为JD,必填,对应京东的青龙配送编码,也叫商家编码,格式:数字+字母+数字,9 位数字加一个字母,共10 位,举例:001K123450;ShipperCode 为SF,且快递单号非快递鸟渠道返回时,必填,对应收件人/寄件人手机号后四位;ShipperCode 为SF,且快递单号为快递鸟渠道返回时,不填;ShipperCode 为其他快递时,不填 | 否 |
- 快递100
参数名称 | 类型 | 说明 | 必须要求 |
---|---|---|---|
phone | String | 收、寄件人的电话号码(手机和固定电话均可,只能填写一个,顺丰速运和丰网速运必填,其他快递公司选填。如座机号码有分机号,分机号无需传入。) | 否 |
from | String | 出发地城市 | 否 |
to | String | 目的地城市,到达目的地后会加大监控频率 | 否 |
4.返回结果说明(对各站进行了统一)
参数名称 | 类型 | 说明 |
---|---|---|
message | String | 消息体,请忽略 |
status | String | 通讯状态,请忽略 |
exp_logo | String | 快递公司logo |
exp_name | String | 快递公司名称 |
exp_ship_sn | String | 快递公司编码 |
exp_ship_code | String | 快递单号 |
exp_tel | String | 快递公司电话 |
exp_state | String | 当前快递状态 |
route_info | Array | 快递途径明细 |
exp_list | Array | 快递明细列表 |
└ time | String | 时间,原始格式 |
└ context | String | 内容 |
└ status | String | 本数据元对应的物流状态名称或者高级状态名称 |
└ status_code | String | 本数据元对应的高级物流状态值 |
└ area_name | String | 本数据元对应的行政区域的名称 |
└ area_code | String | 本数据元对应的行政区域的编码 |
└ location | String | 本数据元对应的行政区域经纬度 |
└ area_pinyin | String | 本数据元对应的行政区域拼音 |