PHPackages                             magdv/kontur-logistics - 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. magdv/kontur-logistics

ActiveLibrary[API Development](/categories/api)

magdv/kontur-logistics
======================

Kontur.Logistics API implementation

1.0.14(2mo ago)25.8k↓76.2%MITPHPPHP >=8.0

Since Nov 30Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/magdv/kontur-logistics)[ Packagist](https://packagist.org/packages/magdv/kontur-logistics)[ RSS](/packages/magdv-kontur-logistics/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (22)Versions (32)Used By (0)

Клиент API Контур Логистики.
----------------------------

[](#клиент-api-контур-логистики)

---

- URL -
- API -

---

Внимание!!!
===========

[](#внимание)

Библиотека пока активно редактируется и могут быть несовместимые изменения. Учтите этот момент.
-----------------------------------------------------------------------------------------------

[](#библиотека-пока-активно-редактируется-и-могут-быть-несовместимые-изменения-учтите-этот-момент)

Пример отправки ТРН
-------------------

[](#пример-отправки-трн)

```
Надо сделать свой локальный класс для сериализатора

declare(strict_types=1);

use GuzzleHttp\Client;
use MagDv\Logistics\ClientConfig;

class LocalConfig extends ClientConfig
{
    public function getCachePath(): ?string
    {
        return 'dfdf/df/df/df'; // здесь указываем путь, куда кешируем. Не обязательно, но желательно. Влияет на скорость
    }

    public function getIsDebug(): bool
    {
        return false; // тут надо указать, включать ли дебаг в дев режиме можете включить, чтобы видеть ошибки
    }

    public function getUrl(): string
    {
        return 'URL к апи';
    }

    public function getApiKey(): string
    {
        return 'apiKey';
    }

    public function getClient(): HttpClientInterface
    {
         // PSR-18 совместимый клиент
        return new Client();
    }
}
        $request = new SendWaybillRequest();
        $request->waybill = 'xml content';
        $request->waybillFileName = 'name.xml';
        $request->waybillSignFileName = 'sign_name.sig';
        $request->waybillSign = 'sig_content';

        $logistics = new LogisticsDocuments(new LocalConfig());
        $response = $logistics->sendWaybill($request);

        // Текущий статус ответа
        echo $response->statusCode;
        // Проверка, что удачный запрос
        echo $response->isOk();

        // Проверка статуса и вывод ошибки
        if (!$response->isOk()) {
         echo $response->error->message;
        }

        $response->transportationId;
```

Сделаны и протестированы методы
-------------------------------

[](#сделаны-и-протестированы-методы)

### Минтранс

[](#минтранс)

- `GET v1/mintransgateway/uuid`

### Документы (Транспортные накладные)

[](#документы-транспортные-накладные)

- `POST v1/documents/waybill` — Отправка ТРН
- `POST v1/documents/waybill/draft` — Черновик документа

### Перевозки

[](#перевозки)

- `GET v1/transportations` — Список перевозок
- `GET v1/transportations/{id}` — Информация о перевозке
- `GET v1/transportations/{id}/print-form` — Печатная форма ТРН
- `GET v1/transportations/{id}/titles/{titleId}` — Титул грузополучателя
- `GET v1/transportations/{id}/full-docflow` — Полный документооборот перевозки
- `PUT v1/transportations/{id}/archive` — Архивация/разархивация перевозки
- `POST v1/transportations/documents/draft` — Черновик документов для перевозки

### Организации

[](#организации)

- `GET v1/organizations/requisites` — Реквизиты организации

Работа с ошибками
-----------------

[](#работа-с-ошибками)

Класс `Error` содержит метод `getAllErrorMessagesByJsonString()`, который возвращает полный список ошибок в JSON-формате:

```
if (!$response->isOk()) {
    // Отдельное сообщение
    echo $response->error->message;

    // Все ошибки в JSON
    echo $response->error->getAllErrorMessagesByJsonString();
}
```

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance85

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~47 days

Recently: every ~59 days

Total

27

Last Release

80d ago

Major Versions

0.1.7 → 1.0.02023-01-20

PHP version history (4 changes)0.0.1PHP ^7.2

1.0.0PHP ^7.4

1.0.2PHP >=7.4

1.0.3PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8c7be182b031a590a466a7e993ef5fe82737ea6c95d7210c5f857fa1cdba5ab0?d=identicon)[denis-korolev](/maintainers/denis-korolev)

![](https://www.gravatar.com/avatar/44694b98f5d6cef0da13dec37e3bc422db04e3dc3d13b75de41c0cd22c3b795d?d=identicon)[magdv](/maintainers/magdv)

![](https://www.gravatar.com/avatar/01443eca2b637ef891683ee6c536e6d6afdde539d256b2df249e0edd02679fd2?d=identicon)[aywan](/maintainers/aywan)

---

Top Contributors

[![denis-korolev](https://avatars.githubusercontent.com/u/9027091?v=4)](https://github.com/denis-korolev "denis-korolev (6 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm, Rector

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/magdv-kontur-logistics/health.svg)

```
[![Health](https://phpackages.com/badges/magdv-kontur-logistics/health.svg)](https://phpackages.com/packages/magdv-kontur-logistics)
```

###  Alternatives

[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k28.0M318](/packages/openai-php-client)[mollie/mollie-api-php

Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque.

60216.0M85](/packages/mollie-mollie-api-php)[deeplcom/deepl-php

Official DeepL API Client Library

2607.3M114](/packages/deeplcom-deepl-php)[mailgun/mailgun-php

The Mailgun SDK provides methods for all API functions.

1.1k30.8M182](/packages/mailgun-mailgun-php)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

1003.9M50](/packages/getbrevo-brevo-php)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.7k409.0k6](/packages/theodo-group-llphant)

PHPackages © 2026

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