appwilio/cdek-sdk

CDEK API SDK (cdek.ru)

v0.5 2018-10-17 01:30 UTC

This package is auto-updated.

Last update: 2024-09-17 14:42:34 UTC


README

Total Downloads Latest Stable Version License

这将是最完整的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
]);

Guzzle参数

使用

计算运费

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许可证分发。