DeliveryEntity: CDEK delivery intervals in Joomla

DeliveryEntity manages delivery arrangements and available date/time intervals for orders.

Access the entity through the Cdek facade:

$delivery = $cdek->delivery();

create()

Signature

public function create(array $request_options = []): array

REST API

• POST /v2/delivery

Purpose

Registers a delivery arrangement for an existing order.

Parameters

Required date and one of cdek_number/order_uuid. Optional time_from, time_to, comment, delivery_point, to_location.

Returns

An asynchronous response. ACCEPTED means the request was accepted; use getByUuid() to check the final result.

Example

<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->delivery()->create([
    'date'        => '2026-04-20',
    'order_uuid'  => '11111111-1111-1111-1111-111111111111',
    'time_from'   => '10:00',
    'time_to'     => '14:00',
    'comment'     => 'Позвонить за час до приезда',
]);

getEstimatedIntervals()

Signature

public function getEstimatedIntervals(array $request_options = []): array

REST API

• POST /v2/delivery/estimatedIntervals

Purpose

Retrieves available delivery intervals before order creation.

Parameters

Required date_time, tariff_code, to_location, to_location.address. If supplied, from_location requires address. Optional shipment_point.

Returns

Available delivery intervals and slots.

Example

<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->delivery()->getEstimatedIntervals([
    'date_time'    => '2026-04-20T10:00:00+03:00',
    'tariff_code'  => 137,
    'to_location'  => [
        'address' => 'Новосибирск, Красный проспект, 1',
    ],
]);

getIntervals()

Signature

public function getIntervals(array $request_options = []): array

REST API

• GET /v2/delivery/intervals

Purpose

Retrieves delivery intervals for an existing order.

Parameters

Supply cdek_number or order_uuid.

Returns

Available dates and intervals.

Example

<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->delivery()->getIntervals([
    'cdek_number' => '1234567890',
]);

getByUuid()

Signature

public function getByUuid(string $uuid): array

REST API

• GET /v2/delivery/{uuid}

Purpose

Retrieves one delivery arrangement.

Parameters

$uuid: arrangement UUID.

Returns

Arrangement details and status.

Example

<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->delivery()->getByUuid('11111111-1111-1111-1111-111111111111');

Overview and getting started

WT CDEK 1.4.0 source code on GitHub