快递查询(快递鸟,快递100,万维易源)

v1.0.0 版本
2022-04-08 版本更新时间
0 安装
1 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)

    使用方法

  1. 选择选定器
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 本数据元对应的行政区域拼音