2017 © Pedro Peláez
 

library cdek-sdk

CDEK API SDK (cdek.ru)

image

appwilio/cdek-sdk

CDEK API SDK (cdek.ru)

  • Tuesday, July 24, 2018
  • by JhaoDa
  • Repository
  • 7 Watchers
  • 17 Stars
  • 573 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 4 Forks
  • 0 Open issues
  • 1 Versions
  • 93 % Grown

The README.md

SDK для СДЭК

Total Downloads Latest Stable Version License, (*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);

Авторы

Лицензия

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

The Versions

24/07 2018

dev-master

9999999-dev https://github.com/appwilio/cdek-sdk

CDEK API SDK (cdek.ru)

  Sources   Download

MIT

The Requires

 

The Development Requires

by Roman Sokharev

sdk delivery cdek