appwilio / cdek-sdk
CDEK API SDK (cdek.ru)
v0.5
2018-10-17 01:30 UTC
Requires
- php: >=7.1
- guzzlehttp/guzzle: ^6.3
- jms/serializer: ^1.8
Requires (Dev)
- illuminate/support: 5.1.* || 5.2.* || 5.3.* || 5.4.* || 5.5.*
- phpunit/phpunit: ^6.3
README
这将是最完整的cdek.ru SDK
功能
- 🔓 计算运费 (API计算器v1.1)
- 🔓 获取带过滤的订单提取点(PВЗ)列表
- 订单管理
- 创建新订单
- 生成PDF发票
- 删除订单
- 获取订单信息(“订单信息”报告)
- 跟踪订单(“订单状态”报告)
- 电话联系收件人
- 调用快递员
仅在与CDEK签订合同的情况下,才能使用API(除标记为:unlock: 的方法外)。
存在 此SDK的分支 — 回退到PHP 7.0,增加了对API方法的更多支持以及更完整的文档。我们计划在有机会时将这些内容全部回退...
安装
最低要求 — PHP 7.1+。
composer require appwilio/cdek-sdk
配置
Laravel 5.1+
// config/app.php 'providers' => [ // ... \Appwilio\CdekSDK\LaravelCdekServiceProvider::class // ... ] // config/services.php 'cdek' => [ 'account' => env('CDEK_ACCOUNT', ''), 'password' => env('CDEK_PASSWORD', ''), 'guzzle_options' => [ // необязательные параметры 'base_uri' => 'https://integration.cdek-asia.cn', 'timeout' => 5 ] ],
其他框架/无框架
require_once '../vendor/autoload.php'; \Doctrine\Common\Annotations\AnnotationRegistry::registerLoader('class_exists'); $client = new \Appwilio\CdekSDK\CdekClient('account', 'password', $guzzleOptions = [ 'timeout' => 5 ]);
使用
计算运费
use Appwilio\CdekSDK\Requests\CalculationRequest; // для выполнения авторизованного запроса используется // $request = CalculationRequest::withAuthorization(); $request = (new CalculationRequest()) ->setSenderCityPostCode('295000') ->setReceiverCityPostCode('652632') ->addGood([ 'weight' => 0.2, 'length' => 10, 'width' => 10, 'height' => 10, ]); $response = $client->sendCalculationRequest($request)
跟踪
use \Appwilio\CdekSDK\Common\Order; use Appwilio\CdekSDK\Requests\StatusReportRequest; $request = (new StatusReportRequest()) ->setShowHistory(); $request->addOrder(new Order(['Number' => '89754564'])); $request->addOrder(new Order(['DispatchNumber' => '2222222222'])); $response = $client->sendStatusReportRequest($request);
作者
许可证
本SDK以MIT许可证分发。