PHPackages                             antonmaslennikov/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. antonmaslennikov/cdek-sdk2.0

ActiveLibrary[API Development](/categories/api)

antonmaslennikov/cdek-sdk2.0
============================

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

06PHP

Since Feb 28Pushed 2y agoCompare

[ Source](https://github.com/antonMaslennikov/sdk2.0)[ Packagist](https://packagist.org/packages/antonmaslennikov/cdek-sdk2.0)[ RSS](/packages/antonmaslennikov-cdek-sdk20/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Обновлённый SDK2.0 для сервиса интеграции СДЭК
==============================================

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

[![Build Status](https://camo.githubusercontent.com/3fa3fd53cfd063c7b022ed594069251a0e0b1490242d100dc587b4628a696d80/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6364656b2d69742f73646b322e302f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/cdek-it/sdk2.0/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/faabf3f105830175efdfc7a8eb2aaf5a03c1c5255ffce50387b95914c61d3918/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6364656b2d69742f73646b322e302f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/cdek-it/sdk2.0/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/d85752155fdcd2619c1f5ccf6f646e38189b02179eef448a5cc7ded3a254fcac/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6364656b2d69742f73646b322e302f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/cdek-it/sdk2.0/?branch=master)[![Packagist](https://camo.githubusercontent.com/d6bc19241ebf4902f858c0d94bc12e6dc4392a89bebe9cc9eb5e8a19aca173e3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6364656b2d69742f73646b322e30)](https://camo.githubusercontent.com/d6bc19241ebf4902f858c0d94bc12e6dc4392a89bebe9cc9eb5e8a19aca173e3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6364656b2d69742f73646b322e30)

Список обновлений в библиотеке от [TTATPuOT](https://github.com/TTATPuOT):

- Добавлена поддержка 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)

---

Реализация 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 cdek-it/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

14

—

LowBetter than 2% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity19

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/c81a2b0fb08c93a366cd21c7c2e285f48a433188f3921cd2cbe617757b704fac?d=identicon)[AntonMaslennikov](/maintainers/AntonMaslennikov)

---

Top Contributors

[![TTATPuOT](https://avatars.githubusercontent.com/u/13170867?v=4)](https://github.com/TTATPuOT "TTATPuOT (21 commits)")[![ihomyak](https://avatars.githubusercontent.com/u/22722568?v=4)](https://github.com/ihomyak "ihomyak (12 commits)")[![antonMaslennikov](https://avatars.githubusercontent.com/u/3268804?v=4)](https://github.com/antonMaslennikov "antonMaslennikov (8 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)")[![vermorag](https://avatars.githubusercontent.com/u/25276845?v=4)](https://github.com/vermorag "vermorag (1 commits)")

### Embed Badge

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

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

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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