Информация по доставке

Получение информации по доставке с присвоением токена для дальнейшей работы с ней.Обратите внимание на параметры в ответе: time_changes и address_changes, они указывают на количество оставшихся изменений времени и адреса. Внимание!!!...

REST Endpoint: Rest API Обновлено: 2026-08-06
  • Endpoint: Rest API
  • REST-метод: [GET] delivery
  • Группа: Rest API
  • Создано: 05.08.2026 · Обновлено: 06.08.2026

Описание

Получение информации по доставке с присвоением токена для дальнейшей работы с ней.

Обратите внимание на параметры в ответе: time_changes и address_changes, они указывают на количество оставшихся изменений времени и адреса.

Внимание!!! Если в качестве адреса получения используется ПВЗ, то такой документ изменить НЕЛЬЗЯ!

Параметры запроса

Query Parameters

Параметры запроса

Параметр
Тип
Обязательно
Описание
token
string
Да
Токен доступа, находится в личном кабинете в разделе профиль - интеграция на сайт (в поле "ключ для сайта")
Пример: 2ad43148db8f1b76c05d3aea4278515b
number
string
Да
Номер накладной
Пример: 88-00000-00000000001
phone
string
Да
Номер телефона в формате +X (XXX) XXXXXXX
Пример: +7 (980) 1234567

Response Parameters

Описание параметров в ответе.

delivery возвращает объект data , содержащий следующую информацию о доставке:

Параметр
Тип
Обязательно
Описание
guid
string
Да
Идентификатор накладной
number
string
Да
Номер накладной
access_token
string
Да
Сгенерированный токен для управления доставкой
access_token_expire_at
string
Да
Время окончания жизни токена по MSK (токен генерируется на 10 минут)
courier_number
string
Да
Номер курьера
tracking
array
Да
Массив трекинга по накладной (возвращается первое и последнее значения)
dates
object
Да
Информация по дате с перечнем доступных для изменения дат
geography
object
Да
Информация по географии доставки
pvz
object
Да
Информация по ПВЗ
pvz_available
array of any
Да
Содержит массив возможных отделений для переадресации.

По структуре каждый элемент массива повторяет элемент pvz (см Response - pvz)
time_changes
number
Да
Число доступных изменений времени доставки
address_changes
number
Да
Число доступных изменений адреса доставки
cancel_reasons
array
Да
Список доступных причин для отмены. Содержит информацию в виде массива объектов вида
{
"guid": "2f7b5572-1ffe-11ea-80d7-7cd30aec6901",
"name": "Качество, брак товара"
}
где :
guid - код причины отмены
name - текстовое обозначение причины отмены
required_fields
array
Нет
Обязательные поля
disabled_fields
array
Нет
Отключенные поля
readdress
object
Нет
Содержит информацию о возможности переадресации на каждый вид доставки в виде
{
"pvz": false,
"address": true
}
cargo
object
Нет
Содержит информацию о грузе в виде:
"weight" - вес отправления в кг
"qty" - количество грузомест
"cod" - оплата при получении

Response - tracking

Содержит информацию о прошедших событиях

Параметр
Тип
Обязательно
Описание
date
datetime
Нет
Дата события в расширенном формате ISO 8601
Пример: 2021-03-25T14:53:25
name
string
Нет
Наименование события, возвращает объект содержащий значения на русском (ru) и английском (en) языке
info
string
Нет
Описание события, возвращает объект содержащий значения на русском (ru) и английском (en) языке

Response - dates

Содержит информацию о времени, фактах забора и доставки

Параметр
Тип
Обязательно
Описание
take
object
Нет
Содержит информацию о заборе, где:

enabled - логическая отметка совершен ли забор
date - дата забора в формате ISO 8601 (YYYY‑MM‑DD)
from - начало временного промежутка забора в формате ISO 8601 (HH:mm:ss)
to - конец временного промежутка забора в формате ISO 8601 (HH:mm:ss)
delivery
object
Нет
Содержит информацию о доставке, где:

enabled - логическая отметка совершен ли забор
date - дата доставки в формате ISO 8601 (YYYY‑MM‑DD)
from - начало временного промежутка доставки в формате ISO 8601 (HH:mm:ss)
to - конец временного промежутка доставки в формате ISO 8601 (HH:mm:ss)
delivery_available
array
Нет
Содержит в себе массив доступных интервалов доставки, где:

date - дата доставки в формате ISO 8601 (YYYY‑MM‑DD)
intervals - содержит время доставки from / to - начало и конец временного промежутка доставки в формате ISO 8601 (HH:mm:ss)

Response - geography

Содержит информацию о географии доставки
Параметр
Тип
Обязательно
Описание
guid
string
Нет
GUID географии доставки
country
string
Нет
Наименование страны доставки
region
string
Нет
Наименование региона доставки
city
string
Нет
Наименование города доставки
address
string
Нет
Полный адрес одной строкой
Пример: 603011, обл Нижегородская, г Нижний Новгород, ул Июльских Дней, дом 9
index
string
Нет
Индекс доставки
info
string
Нет
Дополнительная информация доставки

Response - pvz

Содержит информацию о отделении доставки

Параметр
Тип
Обязательно
Описание
name
string
Нет
Написания отделения доставки
guid
string
Нет
GUID отделения доставки
type_name
string
Нет
Тип сотрудничества
geo
object
Нет
Содержит информацию о координатах отделения
Пример:
"latitude": "56.303351",
"longitude": "43.942194"
default
boolean
Нет
comment
string
Нет
Дополнительная информация о отделении, может иметь значение null
driving_directions
string
Нет
Описание местоположения отделения
services
object
Нет
Содержит информацию о лимитах и услугах предоставляемых отделением
address
string
Нет
Полный адрес отделения
phone
array
Нет
Массив контактных номеров телефона отделения
email
array
Нет
Массив email номеров телефона отделения
work_time
array
Нет
Содержит информацию о времени работы точки выдачи в виде объектов
{
"day": "Суббота",
"from": "8:01:00",
"to": "22:01:00"
}
для каждого активного дня недели

Response - pvz - services

Параметр
Тип
Обязательно
Описание
limits
object
Нет
Содержит информацию о ограничениях принятых на точке выдачи
issuance_of_shipping
boolean
Нет
Страховка доставки
payment_by_card
boolean
Нет
Оплата картой
payment_by_cash
boolean
Нет
Оплата наличными
receiving_sending
boolean
Нет
Возможность отправки с отделения
try_on
boolean
Нет
Примерка
partial_buyout
boolean
Нет
Частичный выкуп
storage_life_days
int
Нет
Срок хранения
fz54
boolean
Нет
Наличие кассы
partialPrePay
boolean
Нет
Частичная предоплата

Response - pvz - services - limits

Содержит информацию о ограничениях принятых в точке выдачи

Параметр
Тип
Обязательно
Описание
weight
number
Нет
Максимальный вес (кг) отправления, принимаемый точкой
hight
number
Нет
Максимальная высота (см) отправления, принимаемая точкой
length
number
Нет
Максимальная длинна (см) отправления, принимаемая точкой
width
number
Нет
Максимальная ширина (см) отправления, принимаемая точкой
qty
number
Нет
Максимальное количество мест в отправления, принимаемое точкой
max_dimension
number
Нет
Максимальное измерение (см) отправления, принимаемое точкой
sum_dimension
number
Нет
Максимальная сумма измерений (см) отправления, принимаемая точкой
cod
number
Нет
Максимальная стоимость отправления, принимаемая точкой

Пример запроса (Request)

JSON
curl -sk -m 20 \
  -H "Accept: application/json" \
  -w "\nHTTP:%{http_code}\n" \
  "https://lktest.cse.ru/api/delivery?token=84b416e88cdb63fc27300df837388b4e&number=TEST-000&phone=%2B7%20(900)%200000000"

Пример ответа (Response)

JSON
{
    "data": {
        "guid": "62df69d6-6035-11ec-833a-005056bbb928",
        "number": "88-495-0003118",
        "access_token": "c1fc1b43f3719cf668c2d4f561a53114",
        "access_token_expire_at": "2021-12-20T14:30:36",
        "courier_number": "",
        "tracking": [
            {
                "date": "2021-12-18T22:04:56",
                "name": {
                    "ru": "Зарегистрирована накладная",
                    "en": "Create document"
                },
                "info": {
                    "ru": "По документу: Заказ 88-495-0003118 от 14.12.2021 18:06:52, зарегистрирована накладная: 88-495-0003118",
                    "en": ""
                }
            }
        ],
        "dates": {
            "take": {
                "enabled": true,
                "date": "2021-12-15",
                "from": "09:00:00",
                "to": "18:00:00"
            },
            "delivery": {
                "enabled": true,
                "date": "2021-12-17",
                "from": "09:00:00",
                "to": "18:00:00"
            },
            "delivery_available": [
                {
                    "date": "2021-12-21",
                    "intervals": [
                        {
                            "from": "09:00:00",
                            "to": "18:00:00"
                        }
                    ]
                },
                {
                    "date": "2021-12-22",
                    "intervals": [
                        {
                            "from": "09:00:00",
                            "to": "18:00:00"
                        }
                    ]
                }
                //……………………………
                ]},

   "geography": {
                    "guid": "d9881c7c-442b-11dc-9497-0015170f8c09",
                    "country": "РОССИЯ",
                    "region": "Нижегородская обл",
                    "city": "Нижний Новгород г",
                    "address": "603011, обл Нижегородская, г Нижний Новгород, ул Июльских Дней, дом 9",
                    "index": "",
                    "info": ""
                },
    "pvz": {
                    "name": "ПВЗ 5post на кассе Пятерочки 30EY",
                    "guid": "7d70ad34-017a-11eb-80dc-7cd30aec6901",
                    "type_name": "Agent",
                    "geo": {
                        "latitude": "56.303351",
                        "longitude": "43.942194"
                    },
                    "default": false,
                    "comment": null,
                    "driving_directions": "Выдача заказов осуществляется на кассе магазина «Пятёрочка»",
                    "services": {
                        "limits": {
                            "weight": 15,
                            "hight": 36,
                            "length": 0,
                            "width": 40,
                            "qty": 1,
                            "max_dimension": 120,
                            "sum_dimension": 0,
                            "cod": 100000
                        },
                        "issuance_of_shipping": true,
                        "payment_by_card": true,
                        "payment_by_cash": true,
                        "receiving_sending": false,
                        "try_on": false,
                        "partial_buyout": false,
                        "storage_life_days": 7,
                        "fz54": true,
                        "partialPrePay": false
                    },
                    "address": ", 603011, обл Нижегородская, г Нижний Новгород, ул Июльских Дней, дом 9",
                    "phone": [],
                    "email": [],
                    "work_time": [
                        {
                            "day": "Суббота",
                            "from": "8:01:00",
                            "to": "22:01:00"
                        },
                        {
                            "day": "Воскресенье",
                            "from": "8:01:00",
                            "to": "22:01:00"
                        },
                        {
                            "day": "Понедельник",
                            "from": "8:01:00",
                            "to": "22:01:00"
                        },
                        {
                            "day": "Вторник",
                            "from": "8:01:00",
                            "to": "22:01:00"
                        },
                        {
                            "day": "Среда",
                            "from": "8:01:00",
                            "to": "22:01:00"
                        },
                        {
                            "day": "Четверг",
                            "from": "8:01:00",
                            "to": "22:01:00"
                        },
                        {
                            "day": "Пятница",
                            "from": "8:01:00",
                            "to": "22:01:00"
                        }
                    ]
                },
    "pvz_available": [
                    {
                        "name": "Офис Черкесск на ул. Первомайская",
                        "guid": "8cb28d8c-c183-11e8-80c9-7cd30aebf951",
                        "type_name": "Office",
                        "geo": {
                            "latitude": "44.226626",
                            "longitude": "42.051272"
                        },
                        "default": false,
                        "comment": null,
                        "driving_directions": "Остановка \"Первомайская\". От остановки пройти прямо, по Первомайской улице, на восток 400м. С левой стороны, на углу дома 35 на пересечении с ул.Пушкинская, вход в магазин \"Гранд\". Войти в магазин, ПВЗ во втором зале справа.",
                        "services": {
                            "limits": {
                                "weight": 30,
                                "hight": 0,
                                "length": 0,
                                "width": 0,
                                "qty": 0,
                                "max_dimension": 0,
                                "sum_dimension": 0,
                                "cod": 200000
                            },
                            "issuance_of_shipping": true,
                            "payment_by_card": true,
                            "payment_by_cash": true,
                            "receiving_sending": true,
                            "try_on": true,
                            "partial_buyout": true,
                            "storage_life_days": 14,
                            "fz54": true,
                            "partialPrePay": true
                        },
                        "address": ", 369000 Респ Карачаево-Черкесская, г Черкесск, ул Первомайская, дом 35",
                        "phone": [
                            [
                                "89886156567"
                            ]
                        ],
                        "email": [],
                        "work_time": [
                            {
                                "day": "Понедельник",
                                "from": "9:00:00",
                                "to": "18:00:00"
                            },
                            {
                                "day": "Вторник",
                                "from": "9:00:00",
                                "to": "18:00:00"
                            },
                            {
                                "day": "Среда",
                                "from": "9:00:00",
                                "to": "18:00:00"
                            },
                            {
                                "day": "Четверг",
                                "from": "9:00:00",
                                "to": "18:00:00"
                            },
                            {
                                "day": "Пятница",
                                "from": "9:00:00",
                                "to": "18:00:00"
                            }
                        ]
                    }
                //…………………………………..    
                    ],

"time_changes": 5,
"address_changes": 5,
"cancel_reasons": [
                        {
                            "guid": "2f7b5572-1ffe-11ea-80d7-7cd30aec6901",
                            "name": "Качество, брак товара"
                        },
                        {
                            "guid": "7ca03899-1ffe-11ea-80d7-7cd30aec6901",
                            "name": "Не подошел товар"
                        },
                        {
                            "guid": "892c3793-1ffe-11ea-80d7-7cd30aec6901",
                            "name": "Неполная комплектация заказа"
                        },
                        {
                            "guid": "9767d14e-1ffe-11ea-80d7-7cd30aec6901",
                            "name": "Нет необходимости в заказе"
                        },
                        {
                            "guid": "9dbaee43-1ffe-11ea-80d7-7cd30aec6901",
                            "name": "Не устраивают условия доставки"
                        },
                        {
                            "guid": "aa27ed77-1ffe-11ea-80d7-7cd30aec6901",
                            "name": "Долгое ожидание заказа"
                        }
                          //…………………………………..    
                    ],
                    "required_fields": [],
                    "disabled_fields": [],
                    "readdress": {
                        "pvz": false,
                        "address": true
                    },
                    "cargo": {
                        "weight": 0.1,
                        "qty": 1,
                        "cod": 0
                    }
                }
            }