appwilio/cdek-sdk

CDEK API SDK (cdek.ru)

SDK для СДЭК

, _(*1)

Это будет самое полное SDK для cdek.ru

Возможности:, _(*2)

• :unlock:расчёт стоимости доставки (API калькулятора v1.1)
• :unlock:получение списка пунктов выдачи заказов (ПВЗ) с фильтрацией
• управление заказами
  • формирование новых заказов
  • генерация квитанции в PDF
  • удаление заказов
  • получение информации по заказам (отчёт «Информация по заказам»)
  • трекинг заказов (отчёт «Статусы заказов»)
  • [ ] прозвон получателя
  • [ ] вызов курьера

Работа с API возможна только при наличии договора с СДЭК (кроме методов, отмеченных как:unlock:)., _(*3)

Существует хард-форк этого SDK — с даунгрейдом до PHP 7.0, большей поддержкой методов API и более полной документацией. Мы планируем сделаем бэкпорт всего этого добра, как только дойдут руки..., _(*4)

Установка

Минимальные требования — PHP 7.1+., _(*5)

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, _(*6)

Использование

Расчёт стоимости доставки

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);

Авторы

• greabock
• JhaoDa

Лицензия

Данный SDK распространяется под лицензией MIT., _(*7)