PHPackages                             ttatpuot/cdek-sdk2.0 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ttatpuot/cdek-sdk2.0

ActiveLibrary[API Development](/categories/api)

ttatpuot/cdek-sdk2.0
====================

Рабочий и поддерживаемый PHP SDK для API v2.0 СДЭК

1.3.0(1y ago)1315.7k↓37.5%2[1 issues](https://github.com/TTATPuOT/cdek-sdk2.0/issues)MITPHPPHP ^7.1 || ^8.0

Since Apr 19Pushed 12mo agoCompare

[ Source](https://github.com/TTATPuOT/cdek-sdk2.0)[ Packagist](https://packagist.org/packages/ttatpuot/cdek-sdk2.0)[ Docs](https://www.cdek.ru/clients/integrator.html)[ RSS](/packages/ttatpuot-cdek-sdk20/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (14)Versions (9)Used By (0)

Рабочий форк SDK2.0 для сервиса интеграции СДЭК 📦
=================================================

[](#рабочий-форк-sdk20-для-сервиса-интеграции-сдэк-)

[![Packagist](https://camo.githubusercontent.com/3e1250f3198c2045f9be909a2f736b444284d0511e057c6f991ce596e1a6f571/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7474617470756f742f6364656b2d73646b322e30)](https://packagist.org/packages/ttatpuot/cdek-sdk2.0)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/576cb25ba9e9e7f82407c4909a5977ee528680908f767da8cff41adeacbbede1/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f5454415450754f542f6364656b2d73646b322e302f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/TTATPuOT/cdek-sdk2.0/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/36770319bf4fc1c9be0cc1261912fbb871672014d7464b65a274587ef3129eac/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f5454415450754f542f6364656b2d73646b322e302f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/TTATPuOT/cdek-sdk2.0/?branch=master)[![License](https://camo.githubusercontent.com/eddc9d407c210abbf364b229be314d32b3f9f839b8f3d7ddcbc1f9354c495f6f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7474617470756f742f6364656b2d73646b322e30)](https://camo.githubusercontent.com/eddc9d407c210abbf364b229be314d32b3f9f839b8f3d7ddcbc1f9354c495f6f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7474617470756f742f6364656b2d73646b322e30)

Это рабочий и (пока что) поддерживаемый форк [cdek-it/sdk2.0](https://github.com/cdek-it/sdk2.0). Если что-то не работает или работает не так, как ожидалось, не стесняйтесь [создавать тикеты](https://github.com/TTATPuOT/cdek-sdk2.0/issues).

На данный момент исправлены трудности оригинальной библиотеки:

- Добавлена поддержка PHP 8.0+
- Исправлены мелкие PHPDoc неточности для более грамотных подсказок IDE
- Улучшены и добавлены новые юнит-тесты
- Добавлен метод `Client::calculator()` для расчёта стоимости доставки [по доступным тарифам](https://api-docs.cdek.ru/63345519.html) и [по коду тарифа](https://api-docs.cdek.ru/63345430.html)
- Улучшена [документация](docs/index.md)
- Исправлены тикеты оригинальной библиотеки:
    - [Новые значения фильтра в экшене офисов #20](https://github.com/cdek-it/sdk2.0/issues/20)
    - [При ошибках в запросе создания заказа не заполняется массив errorы у класса ApiReponse #11](https://github.com/cdek-it/sdk2.0/issues/11)

Так же доступны все функции оригинальной библиотеки. Так как это форк, в своём проекте можно просто заменить зависимость на `ttatpuot/cdek-sdk2.0` и актуальную версию. Обратная совместимость сохранится.

---

Реализация API v2.0 для [интеграции со службой доставки СДЭК](https://www.cdek.ru/clients/integrator.html). Данная SDK поможет быстрее внедрить в свой проект взаимодействие со службой доставки СДЭК.

Возможности SDK:

- создание заказа
- информация о заказе
- удаление заказа
- подписка на вебхуки (статусы заказов и статусы печатных форм)
- информация о подписке на вебхуки
- удаление подписки на вебхуки
- получение списка ПВЗ
- создание заявки на вызов курьера
- информация о заявке на вызов курьера
- удаление заявки на вызов курьера
- создание запроса на формирование печатной формы накладной
- создание запроса на формирование печатной формы ШК-места
- получение cписка городов
- получение cписка регионов

Работа со всеми методами API возможна только при наличии доступов к сервису интеграции, которые выдаются только при наличии договора с компанией СДЭК.

---

### Требования

[](#требования)

Требования — минимальны. Нужен PHP 7.1/8.0 или выше.

Данный SDK использует спецификацию [PSR-18 (HTTP-client)](https://www.php-fig.org/psr/psr-18/). Это значит в качестве HTTP-клиента можно использовать любой - клиент, поддерживающий данную спецификацию. Если у вашего клиента нет поддержки этой спецификации, можно посмотреть [имеющиеся адаптеры для большинства популярных HTTP-клиентов](http://docs.php-http.org/en/latest/clients.html)

---

### Установка

[](#установка)

Установка осуществляется с помощью менеджера пакетов Composer

```
composer require ttatpuot/cdek-sdk2.0
```

---

### Документация

[](#документация)

[Полная документация располагается тут](docs/index.md)

---

### Примеры использования

[](#примеры-использования)

```
$client = new Psr18Client();
$cdek = new \CdekSDK2\Client($client);
$cdek->setAccount('account');
$cdek->setSecure('secure');

// создание заказа
$order = \CdekSDK2\BaseTypes\Order::create([...]);
$res = $cdek->orders()->add($order);

if ($res->hasErrors()) {
    // Обрабатываем ошибки
    // Если этого не сделать, в будущем будет ошибка RequestException
    foreach ($res->getErrors() as $error) {
        //считываем ошибки
    }
}
if ($res->isOk()) {
    $cdek_order = $cdek->formatResponse($res, \CdekSDK2\BaseTypes\Order::class);
    // $cdek_order->entity->uuid;
    // Если попытаться обработать ответ без проверки $res->isOk()
    // и при этом в ответе будут ошибки, то здесь выбросится исключение RequestException
}

// получение информации о заказе
$res = $cdek->orders()->get($cdek_order->entity->uuid);
if ($res->isOk()) {
    $cdek_order = $cdek->formatResponse($res, \CdekSDK2\Dto\OrderInfo::class);
}

//получить список офисов
$res = $cdek->offices()->getFiltered(['country_code' => 'kz']);
if ($res->isOk()) {
    $pvzlist = $cdek->formatResponseList($res, \CdekSDK2\Dto\PickupPointList::class);
//    $pvzlist->items;
}
```

### Тесты

[](#тесты)

Запуск тестов:

```
$ composer test
```

### Лицензия

[](#лицензия)

Данный проект распространяется [под лицензией MIT](LICENSE).

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance48

Moderate activity, may be stable

Popularity34

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 57.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~126 days

Recently: every ~190 days

Total

7

Last Release

365d ago

Major Versions

0.0.2 → 1.0.02023-04-20

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13170867?v=4)[Anton](/maintainers/TTATPuOT)[@TTATPuOT](https://github.com/TTATPuOT)

---

Top Contributors

[![TTATPuOT](https://avatars.githubusercontent.com/u/13170867?v=4)](https://github.com/TTATPuOT "TTATPuOT (23 commits)")[![ihomyak](https://avatars.githubusercontent.com/u/22722568?v=4)](https://github.com/ihomyak "ihomyak (12 commits)")[![pozdeiev](https://avatars.githubusercontent.com/u/16384176?v=4)](https://github.com/pozdeiev "pozdeiev (4 commits)")[![JD72](https://avatars.githubusercontent.com/u/2111989?v=4)](https://github.com/JD72 "JD72 (1 commits)")

---

Tags

sdkdeliverycdekv2.0СДЭКслужба доставки

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ttatpuot-cdek-sdk20/health.svg)

```
[![Health](https://phpackages.com/badges/ttatpuot-cdek-sdk20/health.svg)](https://phpackages.com/packages/ttatpuot-cdek-sdk20)
```

###  Alternatives

[cdek-it/sdk2.0

PHP SDK для API v2.0 от сервиса интеграции компании СДЭК

3992.9k](/packages/cdek-it-sdk20)[antistress-store/cdek-sdk-v2

PHP SDK для API v2.0 от сервиса интеграции компании СДЭК

3152.8k](/packages/antistress-store-cdek-sdk-v2)[webit/w-firma-api

wFirma.pl API

1820.2k](/packages/webit-w-firma-api)[deepseek-php/deepseek-php-client

deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities.

47073.9k5](/packages/deepseek-php-deepseek-php-client)[appwilio/cdek-sdk

CDEK API SDK (cdek.ru)

406.5k](/packages/appwilio-cdek-sdk)[yoti/yoti-php-sdk

Yoti SDK for quickly integrating your PHP backend with Yoti

27539.9k1](/packages/yoti-yoti-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
