harriescc/kdniao

快递鸟API集成

0.0.6 2022-03-29 02:53 UTC

Requires

• php: >7.0
• illuminate/support: >=5.1

Requires (Dev)

• phpunit/phpunit: >=5.4.3
• squizlabs/php_codesniffer: ^2.3

MIT

• HarriesChen

• laravel
• 快递鸟
• kdniao

README

集成了 快递鸟 官方的Api，当前包含订阅物流信息 查询物流信息 电子面单下单 即时查询 三个接口。

安装

1. 安装包文件

   $ composer require harriescc/kdniao

配置

1. 在 .env 文件中增加如下两项配置：

   • KDNIAO_EBUSINESS_ID：快点鸟用户ID。

   • KDNIAO_API_KEY：快点鸟ApiKey。

使用

1. 获取快递公司列表

      Harries\KDNiao\KDNiao::expresses();

2. 根据快递公司编码反查快递公司

      $code = 'SF';
      Harries\KDNiao\KDNiao::getExpressByCode($code);

3. 订阅物流信息

      $orderSn = '业务订单号';
      $expressCode = '物流公司编码';
      $orderSn = '物流单号';
      Harries\KDNiao\KDNiao::subExpressInfo($orderSn, $expressCode, $expressSn);

   订阅结果字段：

   参数	类型	说明	可为空
   EBusinessID	String	用户ID	N
   UpdateTime	String	时间	N
   Success	Bool	成功与否：true，false	N
   Reason	String	失败原因Y，Success为false时有值	Y

4. 查询物流信息

      $orderSn = '业务订单号';
      $expressCode = '物流公司编码';
      $orderSn = '物流单号';
      Harries\KDNiao\KDNiao::queryExpressInfo($orderSn, $expressCode, $expressSn);

   查询结果字段：

   参数	类型	说明	可为空
   EBusinessID	String	用户ID	N
   OrderCode	String	订单编号	Y
   ShipperCode	String	快递公司编码	N
   LogisticCode	String	物流运单号	Y
   Success	Bool	成功与否：true，false	N
   Reason	String	失败原因Y，Success为false时有值	Y
   State	String	物流状态：2-在途中,3-签收,4-问题件	N
   Traces	JsonArray	物流信息，详细字段见下表	Y

   Traces(物流信息)字段：

   参数	类型	说明	可为空
   AcceptTime	String	时间	N
   AcceptStation	String	描述	N
   Remark	String	备注	Y

License

The MIT License (MIT). Please see License File for more information.