---
title: "OrdersEntity: заказы СДЭК через PHP API в Joomla | WT CDEK - WebTolk"
description: "OrdersEntity для Joomla: создание, изменение и возврат заказов. Документация WT CDEK, параметры API СДЭК и PHP-примеры для разработчиков."
url: "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-orders"
date: "2026-11-02T13:06:27+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) > OrdersEntity: заказы СДЭК через PHP API в Joomla

# OrdersEntity: заказы СДЭК через PHP API в Joomla

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)

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

`Webtolk\Cdekapi\Entities\OrdersEntity` — центральная Entity библиотеки. Именно через нее создают, читают, изменяют и удаляют заказы, оформляют клиентские возвраты и отказы, а также получают связанные заявки на вызов курьера.

Получение Entity:

```
$orders = $cdek->orders();
```

## `createOrder(array $request_options): array`

**Сигнатура**

```
public function createOrder(array $request_options): array
```

**REST API**

`POST /v2/orders`

**Что делает**

Создает заказ в СДЭК.

**Параметры**

Библиотека требует:

- `tariff_code`;
- `recipient`;
- `packages`;
- `recipient.name`;
- `packages[].number`;
- `packages[].weight`.

Если указан `recipient.phones`, у каждого телефона должен быть `number`.

**Что возвращает**

Асинхронный ответ API с UUID запроса и статусом создания заказа.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->orders()->createOrder([
    'type'          => 1,
    'number'        => 'ORDER-10001',
    'tariff_code'   => 136,
    'recipient'     => [
        'name'   => 'Иван Иванов',
        'phones' => [
            ['number' => '+79990000000'],
        ],
    ],
    'from_location' => ['code' => 44],
    'to_location'   => ['code' => 270],
    'packages'      => [
        [
            'number' => '1',
            'weight' => 1000,
        ],
    ],
]);
```

## `getOrderInfo(?string $uuid = '', ?string $cdek_number = '', ?string $im_number = ''): array`

**Сигнатура**

```
public function getOrderInfo(?string $uuid = '', ?string $cdek_number = '', ?string $im_number = ''): array
```

**REST API**

- `GET /v2/orders/{uuid}`, если передан UUID;
- `GET /v2/orders?cdek_number=...`, если передан номер СДЭК;
- `GET /v2/orders?im_number=...`, если передан номер заказа магазина.

**Что делает**

Возвращает информацию по ранее созданному заказу.

**Параметры**

Нужно передать хотя бы один идентификатор:

- `$uuid`;
- `$cdek_number`;
- `$im_number`.

**Что возвращает**

Массив с деталями заказа и его статусами.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$order = $cdek->orders()->getOrderInfo('', '1234567890');
```

## `updateOrder(array $request_options = []): array`

**Сигнатура**

```
public function updateOrder(array $request_options = []): array
```

**REST API**

`PATCH /v2/orders`

**Что делает**

Изменяет уже созданный заказ, пока он находится в изменяемом статусе.

**Параметры**

Библиотека требует:

- `type`;
- `recipient`;
- одно из полей `uuid` или `cdek_number`.

**Что возвращает**

Массив ответа API.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->orders()->updateOrder([
    'uuid'      => '11111111-1111-1111-1111-111111111111',
    'type'      => 1,
    'recipient' => [
        'name' => 'Петр Петров',
    ],
]);
```

## `getIntakes(string $order_uuid): array`

**Сигнатура**

```
public function getIntakes(string $order_uuid): array
```

**REST API**

`GET /v2/orders/{orderUuid}/intakes`

**Что делает**

Возвращает все заявки на вызов курьера, связанные с заказом.

**Параметры**

- `$order_uuid` — UUID заказа.

**Что возвращает**

Массив заявок на вызов курьера по заказу.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->orders()->getIntakes('11111111-1111-1111-1111-111111111111');
```

## `deleteOrder(string $uuid): array`

**Сигнатура**

```
public function deleteOrder(string $uuid): array
```

**REST API**

`DELETE /v2/orders/{uuid}`

**Что делает**

Удаляет заказ, если он находится в статусе, в котором удаление еще возможно.

**Параметры**

- `$uuid` — UUID заказа.

**Что возвращает**

Массив ответа API.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->orders()->deleteOrder('11111111-1111-1111-1111-111111111111');
```

## `clientReturn(string $uuid, array $request_options = []): array`

**Сигнатура**

```
public function clientReturn(string $uuid, array $request_options = []): array
```

**REST API**

`POST /v2/orders/{uuid}/clientReturn`

**Что делает**

Регистрирует клиентский возврат по заказу интернет-магазина.

**Параметры**

- `$uuid` — UUID исходного заказа;
- `tariff_code` — обязательный тариф для возврата.

**Что возвращает**

Массив ответа API.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->orders()->clientReturn(
    '11111111-1111-1111-1111-111111111111',
    [
        'tariff_code' => 136,
    ]
);
```

## `refuse(string $uuid): array`

**Сигнатура**

```
public function refuse(string $uuid): array
```

**REST API**

`POST /v2/orders/{uuid}/refusal`

**Что делает**

Регистрирует отказ по заказу с последующим возвратом.

**Параметры**

- `$uuid` — UUID заказа.

**Что возвращает**

Массив ответа API.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->orders()->refuse('11111111-1111-1111-1111-111111111111');
```

[Обзор и начало работы](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-joomla-form-fields)

[Исходный код WT CDEK 1.4.0 на GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library/blob/v.1.4.0/lib_webtolk_wtcdek/src/Entities/OrdersEntity.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": "OrdersEntity: заказы СДЭК через PHP API в Joomla"
            }
        }
    ]
}
```

```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-entities-orders",
            "name": "OrdersEntity: заказы СДЭК через PHP API в Joomla | WT CDEK - WebTolk",
            "description": "OrdersEntity для Joomla: создание, изменение и возврат заказов. Документация 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": "OrdersEntity: заказы СДЭК через PHP API в Joomla",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-orders",
            "description": "OrdersEntity в библиотеке WT CDEK для Joomla: создание, изменение и возврат заказов. На странице — назначение, параметры и примеры PHP для расширений Joomla.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-orders"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " СДЭК API",
                " WT CDEK",
                " OrdersEntity",
                " создание",
                " изменение и возврат заказов"
            ]
        }
    ]
}
```