---
title: "WT CDEK для Joomla: документация PHP-библиотеки - WebTolk"
description: "WT CDEK для Joomla: подключение библиотеки и работа с API. Документация WT CDEK, параметры API СДЭК и PHP-примеры для разработчиков."
url: "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields"
date: "2026-11-02T13:04:44+00:00"
language: "ru-RU"
---

## Breadcrumbs

[Главная](https://web-tolk.ru/) > [Расширения Joomla](https://web-tolk.ru/dev) > [Библиотеки](/dev/biblioteki) > [WT CDEK library](/dev/biblioteki/wt-cdek-library-for-joomla-developers) > [Документация](/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation) > WT CDEK для Joomla: документация PHP-библиотеки

# WT CDEK для Joomla: документация PHP-библиотеки

WT CDEK library - Документация

**Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki)

[Проект](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers)[Версии](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation)[GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library)

WT CDEK в библиотеке WT CDEK для Joomla: подключение библиотеки и работа с API. На странице — назначение, параметры и примеры PHP для расширений Joomla.

WT CDEK Joomla PHP library — это нативная библиотека для Joomla 4.2.7+, Joomla 5 и Joomla 6, которая закрывает типовой сценарий интеграции со СДЭК через REST API без необходимости писать свой транспортный слой, отдельно заниматься OAuth 2.0 и вручную собирать URL для каждого метода API.

Начиная с версии `1.3.0`, библиотека построена по entity-based подходу. Это значит, что вы работаете не с одним «толстым» классом, а с фасадом `Webtolk\Cdekapi\Cdek`, который отдает специализированные Entity:

- `calculator()` — расчёт тарифов;
- `check()` — чеки;
- `delivery()` — договорённости о доставке;
- `deliverypoints()` — ПВЗ и постаматы;
- `intakes()` — вызов курьера;
- `international()` — ограничения по международным отправлениям;
- `location()` — регионы, города, индексы, подсказки;
- `oauth()` — ручное получение токена;
- `orders()` — заказы;
- `passport()` — паспортные данные для международных отправлений;
- `payment()` — наложенные платежи;
- `photoDocument()` — фотоуслуги;
- `prealert()` — преалерты;
- `print()` — печатные формы и штрихкоды;
- `reverse()` — проверка реверса;
- `webhooks()` — подписки на вебхуки.

## С чего начать

Если плагин `System - WT Cdek` уже включен и в нем заполнены `client_id` и `client_secret`, достаточно создать объект `Cdek` без аргументов.

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();
```

Если credentials нужно передать явно, это можно сделать в конструкторе:

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek(
    true,
    'your_client_id',
    'your_client_secret'
);
```

## Как читать эту документацию

В каждой Entity-странице есть:

- объяснение, зачем сущность нужна в реальной интеграции;
- список всех публичных методов;
- сигнатура метода в том виде, в котором он есть в библиотеке;
- REST endpoint и HTTP-метод;
- описание параметров, которые реально проверяет библиотека;
- описание результата;
- минимальный пример PHP-кода с нужными `namespace` и `use`.

Важно понимать разницу между двумя уровнями валидации:

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

Поэтому ситуация, когда библиотека вернула успешный HTTP-запрос, а API СДЭК ответило ошибкой в массиве `error_code` и `error_message`, является нормальной и ожидаемой.

## Общий формат ответа

Почти все методы библиотеки возвращают `array`.

Успешный ответ:

- это обычный массив данных API СДЭК;
- структура зависит от конкретного endpoint.

Ответ с ошибкой:

```
[
    'error_code'    => 400,
    'error_message' => 'Текст ошибки',
]
```

## Что библиотека делает сама

Библиотека автоматически:

- определяет боевую или тестовую среду;
- получает OAuth-токен;
- кэширует токен средствами Joomla;
- нормализует часть ошибок API;
- кэширует некоторые справочные запросы, например тарифы и ПВЗ.

## Поля Joomla Form

- [Tarifflist: список тарифов](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-tarifflist)
- [Tariffinfo: условия выбранного тарифа](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-tariffinfo)
- [Deliverypoints: ПВЗ и постаматы](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-deliverypoints)

Общее поведение полей подключается через [Watchfield WebAsset: источники и события](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-watchfield). Отдельный тип поля Watchfield не требуется.

## Entity

- [CalculatorEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-calculator)
- [CheckEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-check)
- [DeliveryEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-delivery)
- [DeliverypointsEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-deliverypoints)
- [IntakesEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-intakes)
- [InternationalEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-international)
- [LocationEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location)
- [OauthEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-oauth)
- [OrdersEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-orders)
- [PassportEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-passport)
- [PaymentEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-payment)
- [PhotoDocumentEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-photo-document)
- [PrealertEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-prealert)
- [PrintEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-print)
- [ReverseEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-reverse)
- [WebhooksEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks)
- [AbstractEntity](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-abstract-entity)

[Исходный код WT CDEK 1.4.0 на GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library/blob/v.1.4.0/lib_webtolk_wtcdek/src/Cdek.php)

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/dev",
                "name": "Расширения Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/dev/biblioteki",
                "name": "Библиотеки"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers",
                "name": "WT CDEK library"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation",
                "name": "Документация"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "WT CDEK для Joomla: документация PHP-библиотеки"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields",
            "name": "WT CDEK для Joomla: документация PHP-библиотеки - WebTolk",
            "description": "WT CDEK для Joomla: подключение библиотеки и работа с API. Документация WT CDEK, параметры API СДЭК и PHP-примеры для разработчиков.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "WT CDEK для Joomla: документация PHP-библиотеки",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields",
            "description": "WT CDEK в библиотеке WT CDEK для Joomla: подключение библиотеки и работа с API. На странице — назначение, параметры и примеры PHP для расширений Joomla.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " СДЭК API",
                " WT CDEK",
                " WT CDEK",
                " подключение библиотеки и работа с API"
            ]
        }
    ]
}
```