cjl/easykuaidi

一个快递SDK。

0.2.2 2018-12-07 05:06 UTC

README

对接多家快递平台的电子面单、价格查询、订阅轨迹等接口的Laravel5.5+扩展包。

Build Status StyleCI Latest Stable Version Total Downloads Latest Unstable Version License

说明

实现对接多加快递平台的电子面单、价格查询、订阅轨迹等接口。初步实现三家:中通、圆通、顺风,另外作为补充,也对接了快递100的接口。

安装

$ composer require cjl/easykuaidi

将服务提供者添加到 config/app.php 文件中的 providers 数组。如果您使用的是Laravel 5.5或更高版本,则无需执行此操作。

Cjl\Easykuaidi\EasykuaidiServiceProvider::class

配置

$ php artisan vendor:publish --provider="Cjl\Easykuaidi\EasykuaidiServiceProvider"

使用

  • 时效价格查询
$this->app('easykuaidi')->getHourPrice('无锡市','江苏','杭州市','浙江');
  • 订阅快递轨迹
$this->app('easykuaidi')->subBillLog(['680000000021'], 'test')

在App/Listeners下面新建一个注册事件订阅者,订阅事件

Cjl\Easykuaidi\Events\EasykuaidiEvent

在EventServiceProvider里注册订阅者类,例如

    protected $subscribe = [
        'App\Listeners\EasykuaidiSubscriber',
    ];
  • 电子面单
	$sender = new \Cjl\Easykuaidi\Data\ContactInfo();
    
    $sender->name = "站三";
    
    $sender->mobile = "13323233232";
    
    $sender->province = "江苏";
    
    $sender->city = "南通";
    
    $sender->country = "通州区";
    
    $sender->address = "冠华路900号";
    
    $receiver = new \Cjl\Easykuaidi\Data\ContactInfo();
    
    $receiver->name = "lisi";
    
    $receiver->mobile = "13323233232";
    
    $receiver->province = "江苏";
    
    $receiver->city = "南京";
    
    $receiver->country = "玄武区";
    
    $receiver->address = "中华路100号";
    
    $orderInfo = new \Cjl\Easykuaidi\Data\OrderInfo();
    
    $orderInfo->sender = $sender;
    
    $orderInfo->receiver = $receiver;
    
    $orderInfo->orderid = "xfs101100111011";
    
	$this->app('easykuaidi')->getElecOrder($orderInfo);

贡献

您可以通过以下三种方式之一进行贡献

  1. 使用 问题追踪器 提交错误报告。
  2. 问题追踪器 上回答问题或修复错误。
  3. 贡献新功能或更新wiki。

代码贡献过程并不非常正式。您只需确保遵循PSR-0、PSR-1和PSR-2编码规范。任何新的代码贡献都必须附有相应的单元测试(如果适用)。

许可证

MIT