{
"openapi" : "3.0.1",
"info" : {
"title" : "Клиентский протокол интеграции с логистикой",
"version" : "1.0.0"
},
"servers" : [ {
"url" : "https://api.cdek.ru",
"description" : "Рабочая среда"
}, {
"url" : "https://api.edu.cdek.ru",
"description" : "Тестовая среда"
} ],
"tags" : [ {
"name" : "common",
"description" : "# Введение\n\nПортал документации CDEK API предоставляет разработчикам и партнёрам компании СДЭК доступ к подробной информации и инструментам для интеграции с логистической платформой. С его помощью можно эффективно использовать API-методы для автоматизации процессов доставки и управления заказами.\n\nПортал документации содержит в себе:\n\n • Описание возможностей и функционала API СДЭК, включая доступные методы и их применение\n\n • Пошаговые инструкции по подключению и настройке взаимодействия с системой СДЭК\n\n • Справочник методов с фильтром по категориям (работа с заказами, расчет стоимости и т.д.), внутри которых содержится детальное описание каждого метода API, включая параметры запросов и ответов с примерами\n \nПортал документации обеспечивает удобную навигацию и доступ к актуальной информации для успешной интеграции с сервисами СДЭК.\n\n# Подключение к сервису\n\n\n\nДанные для подключения к сервису\n\n| **Среда** | **URL** |\n|---|---|\n| Тестовая | https://api.edu.cdek.ru |\n| Рабочая | \thttps://api.cdek.ru |\n\nДля интеграции с ИС СДЭК по протоколу обмена данными необходимо:\n\n
1. Заключить договор со СДЭК\n
2. Ознакомиться с документацией и часто задаваемыми вопросами, представленными на сайте www.cdek.ru/clients/integrator.html\n
3. Осуществить реализацию, настройку и тестирование на тестовой среде `api.edu.cdek.ru` с помощью тестовый учетной записи:\n\n| **Параметр** | **Значение** |\n|---|---|\n| Account | wqGwiQx0gg8mLtiEKsUinjVSICCjtTEP |\n| Secure password | RmAmgvSgSl1yirlz9QupbzOJVqhCxcP5 |\n\nУ тестовой учетной записи имеются следующие ограничения:\n\n
- заказы клиента, созданные под тестовой учетной записью, не отображаются в личном кабинете клиента на сайте https://lk.cdek.ru/;\n
- тестовая учетная запись не имеет привязки к договору, следовательно, для нее не работают скидки и наценки, установленные в договоре;\n
- посылки для тестовых учетных записей не будут обрабатываться и доставляться.\n\n\n
4. После того как все проверено (протестировано, все вопросы решены), вам следует создать ключ для доступа к боевой учетной записи. Когда ваш договор в статусе \\\"Подписан\\\", на почту автоматически будет отправлено письмо с ключами доступа. Также ключи можно получить в личном кабинете: в разделе \\\"Интеграция\\\" нажать кнопку \\\"Создать ключ\\\", затем в этом разделе появится идентификатор аккаунта и пароль.
5. Запустить решение в продакшн, используя хост api.cdek.ru для подключения к методам.\n\n
ИМ имеет возможность получать уведомления о результате отправки данных на электронную почту.
Уведомления содержат информацию как об удачной загрузке заказов, так и об ошибках передачи данных.
От данных уведомлений можно отписаться, но следует помнить, что все рассылки о проведении технических работ и изменениях в протоколе также высылаются на данный адрес.
Все уведомления приходят с электронного адреса: noreply@cdek.ru в формате UTF-8.
Для подключения уведомлений необходимо обратиться в службу технической поддержки по почте integrator@cdek.ru \nлибо в чат-бот Тая на портале https://apidoc.cdek.ru/ с указанием вашего номера договора. \n\n\n\n# История изменений\n| **Фактическая/плановая дата изменений** | **Описание изменений** |\n|----------------------------------------|------------------------|\n| 08 июля 2026 | Добавлены ДУ BOX_LINER_FOR_1_BOTTLE_UNIVERSAL, BOX_FOR_1_BOTTLE_3KG15X14X38CM, DOCUMENT_BOX_6KG36X29X7CM, BOX_LIGHT_8KILOS60X40X40CM, BOX_LIGHT_3KILOS35X25X12CM.|\n| 29 июня 2026 | Добавлены ДУ COURIER_SERVICE, GREEN_ENVELOPE_CDEK, DESCENT_FROM_THE_FLOOR.|\n| 25 июня 2026 | В метод получения списка офисов (/v2/deliverypoints) добавлен атрибут status.|\n| 20 мая 2026 | Реализована возможность передачи офиса отправителя и получателя в методах расчета стоимости доставки (v2/calculator/*) для более точного расчёта сроков доставки.|\n| 29 апреля 2026 | Реализована возможность выгрузки документации в OpenAPI формате.|\n| 13 апреля 2026 | Обновлен функционал по работе с фото документов (/v2/photoDocument).|\n| 6 апреля 2026 | Добавлена возможность получения списка офисов (/v2/deliverypoints) по параметрам упаковки.|\n| 19 февраля 2026 | Прекращена работа метода получения информации о переводе наложенных платежей (v2/payment).|\n| 12 февраля 2026 | Прекращена поддержка устаревшей услуги \"Прозвон\" (код CALL).|\n| 28 января 2026 | Добавили новый тип подписки на вебхуки COURIER_INFO (получение информации о курьере, назначенном по заказу/заявке).|\n| 14 января 2026 | Добавили поддержку новых параметров офиса, отвечающих за доставку сборных грузов - ltl_acceptance_partners и ltl_issuance_partners.|\n| 28 ноября 2025 | Добавили в ответы методов получения информации по заказу причины задержки доставки delay_reasons.|\n| 23 октября 2025 | Возобновили работу с доп. услугой \"Фото документов\".|\n| 15 октября 2025 | Добавили список доп. услуг для таможенного оформления.|\n| 13 октября 2025 | Обновили лимиты по попыткам доставки вебхуков.| \n| 26 августа 2025 | Обновили логику создания заявки: к заявкам на забор груза необходимо создавать накладную, т.е если нужен консолидированный забор груза (забор груза сразу по нескольким накладным), то перед созданием заявки важно создать новый заказ по тарифу \"Забор груза дверь-склад\" (код тарифа 158) и передать в запросе на создание заявки номер или UUID заказа, тем самым связав заявку с заказом. Но если к заявке на забор груза не будет создана накладная, то мы создадим её автоматически за вас.| \n| 11 августа 2025 | Переход на новый признак has_reverse_order при создания реверсного заказа и отображения этого признака в информации о заказе. Важно! Для обратной совместимости мы оставили возможность добавления признака наличия реверса в запросах на создание/изменение прямого заказа по старому процессу - через доп. услугу REVERSE, однако, в таком случае, она не будет отображаться в информации о заказе, вместо неё будет отображаться признак has_reverse_order. Рекомендуем перейти на передачу нового признака, так как в дальнейшем будет произведен полный отказ от возможности передачи доп. услуги REVERSE.| \n| 4 августа 2025 | Добавлены новый доп. тип заказа \"ТО для последней мили\" (код 15) и поддержка полей, необходимых для таможенного оформления | \n| 3 июня 2025 | Добавлена возможность передавать реквизиты истинного продавца по каждому из товаров в заказе в блоке packages.items.seller. | \n| 3 июня 2025 | Добавлена возможность передавать IDTOP (идентификатор подразделения компании продавца в ЛК ГИИС) в поле packages.items.seller.giis_subdivision_id.
IDTOP необходим, чтобы ГИИС ДМ ДК имели возможность понять какое обособленное подразделение производит передачу УИН в курьерскую компанию. |\n| 21 мая 2025\t | Добавлен новый метод \"Проверка доступности реверса\" (раздел Реверс). С помощью метода можно проверить доступность реверса до создания прямого заказа.|\n| 06 мая 2025 | Изменены правила страхования заказов с типом \"Доставка. Для заказов типа \"Доставка\", если услуга не передана пользователем в services.code, она будет добавляться автоматически с параметром services.parameter = 1. Данное значение будет обработано системой так, что страховка будет бесплатной. |\n| 05 мая 2025 | В раздел \"Расчет стоимости доставки\" добавлен новый метод - получение списка всех доступных тарифов по договору |\n| 23 апреля 2025 | В методы \"Расчет по доступным тарифам\" и \"Расчет по коду тарифа\" добавлен новый параметр в ответе: `delivery_date_range` — прогнозируемый диапазон дат доставки.
Как это работает:
• Даты рассчитываются на основе производственного календаря
• В зависимости от скорости тарифа учитываются или календарные, или рабочие дни. Если рабочие дни учитываются, то выходные и праздники пропускаются |\n| 23 марта 2025 | В раздел \"Договорённость о доставке\" добавлен метод Получения интервалов до создания заказа, который позволяет получить доступные интервалы доставки \"до двери\" до создания заказа, тем самым предоставляя возможность рассчитать доступные слоты для регистрации договоренности о доставке заранее, в зависимости от направления и выбранного тарифа. |\n| 25 февраля 2025 | Добавлена возможность передавать УИН ювелирного изделия при регистрации заказа |\n| 23 февраля 2025 | На Портал документации добавлен новый раздел для Партнёрских интеграций |\n| 20 февраля 2025 | Реализовали новый метод для получения доступных дат вызова курьера для населенных пунктов |\n| 23 января 2025 | В методы \"Калькулятор. Расчёт по коду тарифа\" и \"Калькулятор. Расчёт по доступным тарифам\" добавлено поле contragent_type, которое позволяет указать тип отправителя/получателя - ЮЛ или ФЛ. |\n| 22 января 2025 | В методы \"Подписка на вебхуки (Webhooks)\" и \"Вебхуки (Webhooks)\" добавлен вебхук на получение информации об изменении режима заказа. |\n| 16 января 2025 | В метод \"Регистрация заказа\", \"Информация о заказе\" и \"Калькулятор. Расчёт по коду тарифа\" добавлены доп. услуги: \"Коробка (18 кг 60х35х30см)\", Внутренняя обрешётка \"Коробка XL\", Внутренняя обрешётка \"Коробка Вес до 20кг\", Внутренняя обрешётка \"Коробка Вес до 30кг\", Пакет курьерский «Лайт» А2 (белый), Пакет курьерский «Лайт» А3 (белый), Пакет курьерский «Лайт» А4 (белый), Пакет курьерский «Лайт» А5 (белый) |\n| 19 декабря 2024 | В метод \"Регистрация заказа\", \"Калькулятор. Расчёт по коду тарифа\" и \"Калькулятор. Расчёт по доступным тарифам\" добавлен тариф \"Фулфилмент выдача\" (код тарифа: 358) |\n| 19 декабря 2024 | В методы \"Подписка на вебхуки (Webhooks)\" и \"Вебхуки (Webhooks)\" добавлен вебхук на получение информации о проблемах доставки по заказу |\n| 09 декабря 2024 | В методы \"Подписка на вебхуки (Webhooks)\" и \"Вебхуки (Webhooks)\" добавлен вебхук на получение информации об изменении даты договоренности о доставке |\n| 20 ноября 2024 | Добавили возможность передавать номер смены в чеке для метода \"Информация о чеке\" |\n| 24 октября 2024 | Добавлен метод для получения ограничений по международным заказам |\n| 23 октября 2024 | Добавлено поле для кода ТН ВЭД |\n| 10 октября 2024 | Добавили поддержку тёмной темы для Портала документации |\n| 03 октября 2024 | Номер ШК упаковки в системе СДЭК (barcode) |\n| 01 октября 2024 | Добавлен доп. тип заказа для СДЭК Шоппинг |\n| 12 сентября 2024 | Добавлен метод \"Подбор локации по названию города\". |\n| 28 августа 2024 | Добавлена поддержка вебхука с возможностью передачи информации об изменениях стоимости доставки. |\n| 28 августа 2024 | Добавлена возможность передавать реквизиты истинного продавца по каждому из товаров в заказе в блоке packages.items.seller. | \n| 28 августа 2024 | Добавлена возможность передавать IDTOP (идентификатор подразделения компании продавца в ЛК ГИИС) в поле packages.items.seller.giis_subdivision_id.
IDTOP необходим, чтобы ГИИС ДМ ДК имели возможность понять какое обособленное подразделение производит передачу УИН в курьерскую компанию. |\n\n\n# Глоссарий\n\n**ИС** — информационная система, это может быть ERP – решение, сайт ИМ, любое другое программное обеспечение.\n\n**Интеграция** — передача данных, находящихся в различных источниках (ИС) и предоставление данных пользователям в унифицированном виде.\n\n**API (англ. Application Programming Interface)** – интерфейс прикладного программирования, интерфейс программирования приложений. Это набор готовых функций, структур и констант, предоставляемых приложением (библиотекой, сервисом) для использования во внешних программных продуктах (ИС).\n\n**HTTP (англ. Hyper Text Transfer Protocol)** – протокол передачи гипертекста. Это протокол прикладного уровня передачи данных (изначально – в виде гипертекстовых документов в формате HTML).\n\n**HTTPS (англ. Hyper Text Transfer Protocol Secure)** – расширение протокола HTTP, поддерживающее шифрование. Данные, передаваемые по протоколу HTTP, «упаковываются» в криптографический протокол SSL или TLS. В отличие от HTTP для HTTPS по умолчанию используется ТСР-порт 443.\n\n**XML (англ. eXtensibleMarkupLanguage)** — расширяемый язык разметки.\n\n**JSON (англ. JavaScript Object Notation)** — текстовый формат обмена данными, основанный на JavaScript.\n\n**ИМ** — интернет-магазин, клиент или партнер СДЭК с договором интернет-магазина.\n\n**Место (грузоместо, упаковка)** — неделимая единица груза, отправляемая ИМ (может быть несколько в одном заказе).\n\n**Отправление (заказ)** — сумма всех мест, единовременно отправляемых ИМ по одному направлению.\n\n**Объемный вес** — расчетное значение веса, измеряется в кг. Расчет может быть произведен из указанных габаритов места по формуле длина * высота * ширина/5000. Это общепринятый у транспортных компаний алгоритм пересчета.\n\n**Физический вес** – определяется взвешиванием погрузочного места на весах. Существуют вес груза нетто и брутто. Нетто — это чистый вес груза без упаковки, а брутто — вес груза в упакованном виде.\n\n**Расчетный вес** – вес, максимальный среди объемного и физического. Расчет стоимости услуг производится исходя из расчетного веса.\n\n**ПВЗ** – пункт выдачи заказов получателю. Место, где получатель может самостоятельно забрать свой груз. ПВЗ могут быть как собственные склады СДЭК, так и терминалы выдачи грузов партнеров.\n\n**СД** – курьерская служба доставки СДЭК.\n\n**ГМ** - грузоместо (упаковка)\n\n**ШК** - штрихкод, идентифицирующий конкретное грузоместо\n\n**Международный заказ** - заказ, у которого страна отправителя не равна стране получателя и хотя бы одна страна не входит в Таможенный союз. \n\n# Базовые типы данных\n\nВ протоколе обмена используются следующие типы данных:\n\n**string(n)** - текстовая строка, где n - максимальное количество символов.\n\n**integer** - целочисленное значение из интервала от 0 до 1 000 000.\n\n**float** - число с плавающей точкой, в качестве разделителя используется точка.\n\n**boolean** - логическое значение (возможные значения: true или false).\n\n**dateTime** - дата и время в формате ISO 8601: YYYY-MM-DDThh:mm:ss±hhmm.\n\n**date** - дата в формате ISO 8601: YYYY-MM-DD.\n\n**time** - время в формате ISO 8601: hh:mm.\n\n**UUID** - уникальный идентификатор, представляет собой 16-байтный номер. Например: 8dea00e3-9aab-4d8e-887c-ef2aaa546456.\n\n**money** - стоимость услуги/товара с учетом налогообложения\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|-------------------------------------------------------|--------------|--------------------|\n| value | Сумма в валюте | float | да |\n| vat_sum | Сумма НДС | float | нет |\n| vat_rate | Ставка НДС (значение - 0, 5, 7, 10, 16, 22, null - без НДС) | integer | нет |\n\n**threshold** - дополнительный сбор за доставку в зависимости от стоимости товара\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|----------------------------------------------------------------------------------------|--------------|--------------------|\n| threshold | Порог стоимости товара (действует по условию меньше или равно) в целых единицах валюты | integer | да |\n| sum | Доп. сбор за доставку товаров, общая стоимость которых попадает в интервал | float | да |\n| vat_sum | Сумма НДС, включённая в доп. сбор за доставку | float | нет |\n| vat_rate | Ставка НДС (значение - 0, 5, 7, 10, 16, 22, null - без НДС) | integer | нет |\n\n**contact** - данные контрагента (отправителя, получателя)\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|---------------------------------|---------------------------------------------|--------------|--------------------|\n| company | Наименование компании | string(255) | нет |\n| name | Ф.И.О контактного лица | string(255) | да |\n| email | Эл. адрес | string(255) | нет |\n| phones | Список телефонов | phone[] | да |\n| passport_series | Серия паспорта | string(255) | нет |\n| passport_number | Номер паспорта | string(255) | нет |\n| passport_date_of_issue | Дата выдачи паспорта | date | нет |\n| passport_organization | Орган выдачи паспорта | string(255) | нет |\n| passport_date_of_birth | Дата рождения | date | нет |\n| tin | ИНН | string(255) | нет |\n| passport_requirements_satisfied | Требования по паспортным данным удовлетворены (актуально для международных заказов): true - паспортные данные собраны или не требуются false - паспортные данные требуются и не собраны | boolean | нет |\n\n**phone** - номер телефона (мобильный/городской)\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|---------------------------------------------------------------------------------------------------------------------------|--------------|--------------------|\n| number | Номер телефона
Необходимо передавать в международном формате: код страны (для России +7) и сам номер (10 и более цифр) | string(255) | да |\n| additional | Дополнительная информация (добавочный номер) | string(255) | нет |\n\n**seller** - данные истинного продавца\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|------------------------------------------------------------------------------|--------------|--------------------|\n| name | Наименование истинного продавца | string(255) | нет |\n| inn | ИНН истинного продавца | string(20) | нет |\n| phone | Телефон истинного продавца | string(255) | да, если заказ - международный |\n| ownership_form | Код формы собственности | integer | нет |\n| address | Адрес истинного продавца. Используется при печати инвойсов для отображения адреса настоящего продавца товара, либо торгового названия | string(255) | нет |\n\n**location** - адрес местоположения контрагента (отправителя, получателя), включая геолокационные данные\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|-----------------------------------------------------------------|--------------|--------------------|\n| code | Код населенного пункта СДЭК (метод \\\"Список населенных пунктов\\\") | integer | нет |\n| fias_guid | Уникальный идентификатор ФИАС | UUID | нет |\n| postal_code | Почтовый индекс | string(255) | нет |\n| longitude | Долгота | float | нет |\n| latitude | Широта | float | нет |\n| country_code | Код страны в формате ISO_3166-1_alpha-2 | string(2) | нет |\n| region | Название региона | string(255) | нет |\n| sub_region | Название района региона | string(255) | нет |\n| city | Название города | string(255) | нет |\n| address | Строка адреса | string(255) | да |\n\n**service** - данные о дополнительных услугах\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|--------------------------------|--------------|--------------------|\n| code | Код дополнительной услуги | string | да |\n| parameter | Параметр дополнительной услуги | string | нет |\n\n**package** - информация о местах заказа\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|--------------------------------------------|--------------|--------------------|\n| number | Номер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиента | string(255) | да |\n| weight | Общий вес (в граммах) | integer | да |\n| length | Габариты упаковки. Длина (в сантиметрах) | integer | нет |\n| width | Габариты упаковки. Ширина (в сантиметрах) | integer | нет |\n| height | Габариты упаковки. Высота (в сантиметрах) | integer | нет |\n| comment | Комментарий к упаковке | string(255) | нет |\n| items | Позиции товаров в упаковке | item[] | нет |\n\n**item** - информация о товарах места заказа (только для заказа типа \\\"интернет-магазин\\\" и международного заказа типа \\\"доставка\\\"))\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|-------------------------------------------------------------------------------|--------------|----------------|\n| name | Наименование товара (может также содержать описание товара: размер, цвет) | string(255) | да |\n| ware_key | Идентификатор/артикул товара | string(20) | да |\n| payment | Оплата за товар при получении (за единицу товара в указанной валюте, значение >=0) — наложенный платеж, в случае предоплаты значение = 0 | money | да |\n| cost | Объявленная стоимость товара (за единицу товара в указанной валюте, значение >=0). С данного значения рассчитывается страховка | float | да |\n| weight | Вес (за единицу товара, в граммах) | integer | да |\n| weight_gross | Вес брутто | integer | нет |\n| amount | Количество единиц товара (в штуках) | integer | да |\n| name_i18n | Наименование на иностранном языке | string(255) | нет |\n| brand | Бренд на иностранном языке | string(255) | нет |\n| country_code | Код страны в формате ISO_3166-1_alpha-2 | string(2) | нет |\n| material | Код материала | string(255) | нет |\n| wifi_gsm | Содержит wifi/gsm | boolean | нет |\n| url | Ссылка на сайт интернет-магазина с описанием товара | string(255) | нет |\n\n**error** - данные об ошибке обработки запроса на стороне ИС СДЭК\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|-----------------|--------------|--------------------|\n| code | Код ошибки | string(255) | да |\n| message | Описание ошибки | string(255) | да |\n\n**status** - статус заказа, заявки\n\n| **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------------------|----------------------------------------------------------------|--------------|--------------------|\n| code | Код статуса | string(255) | да |\n| name | Название статуса | string(255) | да |\n| date_time | Дата и время установки статуса (формат yyyy-MM-dd'T'HH:mm:ssZ) | datetime | да |\n| reason_code | Дополнительный код статуса | string(2) | нет |\n| city | Наименование места возникновения статуса | string(255) | нет |\n\n# Описание сервиса\n\n\nСервис информационного взаимодействия реализует набор методов, необходимых для передачи и синхронизации данных между компанией СДЭК и клиентом интернет-магазином или партнером, представляющим интернет-магазин.\n\nВзаимодействие с сервисом происходит в режиме онлайн с помощью стандартного протокола HTTPS и формата JSON.\n\nИнициатором запросов является как ИС клиента, так и СДЭК (в части вебхуков).\n\n# Режим взаимодействия\n\nСервисы интеграции СДЭК работают в асинхронном режиме с синхронным возвратом ответа на запрос.\n\n## Общая схема работы\n\n1. Клиент отправляет запрос на выполнение действия над сущностью (заказ, заявка, договорённость и т.д.).\n2. Система синхронно выполняет первичную (статичную) валидацию:\n * корректность структуры запроса;\n * наличие и формат обязательных параметров.\n3. При успешном прохождении первичной валидации возвращается ответ HTTP 202 (ACCEPTED) с UUID сущности.\n4. Параллельно запускается асинхронный фоновый процесс, включающий:\n * полную бизнес-валидацию (маршрут, тариф, доступность и др.);\n * выполнение операции в основной системе СДЭК.\n\n## Статусы обработки запроса\n\n* ACCEPTED - запрос успешно принят и прошёл первичную валидацию. \n\n**❗️ Важно! Статус относится к запросу, а не к создаваемой сущности и не гарантирует её создание.**\n\n* SUCCESSFUL - сущность успешно создана в ИС СДЭК.\n* INVALID - при создании сущности возникла ошибка; требуется исправить данные и повторно отправить запрос на создание.\n\n## Получение результата асинхронной обработки\nРезультаты обработки доступны через методы получения информации о сущностях:\n\n**По UUID сущности**\n\n* Получение информации о заказе по UUID\n* Получение информации о заявке по UUID\n* Получение информации о договорённости о доставке\n* Получение информации о преалерте\n* Получение квитанции к заказу\n* Получение ШК места к заказу\n\n**По альтернативным параметрам**\n\n* Получение информации о заказе по номеру СДЭК / номеру ИМ\n\n**Через события**\n\n* Вебхуки (при наличии активной подписки)\n\n**Время асинхронной обработки**\n\nОбычное время перехода запроса на создание сущности из состояния ACCEPTED в SUCCESSFUL/INVALID составляет 200-500 мс.\n\nПри пиковой нагрузке и задержках во взаимодействии между сервисами ИС СДЭК время обработки может увеличиваться до 30-60 секунд.\n\n**Рекомендация**\n\nДля корректного получения статуса обработки запроса рекомендуется:\n\n* устанавливать таймаут 2-3 секунды между запросом на создание сущности и первым запросом на получение информации о ней;\n* при необходимости использовать повторные проверки статуса или вебхуки.\n\n**Пример обработки ошибки**\n\nЕсли при вызове метода \"Получение информации о заказе по UUID\" был возвращен статус запроса INVALID и ошибка с кодом \"error_validate_im_dep_number_has_already_had_integration\", это означает, что заказ с таким номером ИМ по данному договору уже существует и находится в активном статусе.\n\n**Решение**: повторно отправить запрос на регистрацию заказа, передав другое значение номера ИМ.\n\nС полным списком возможных ошибок, которые могут возникнуть при выполнении запроса, можно ознакомиться в подразделе \"Список возможных ошибок\".\n\n**Хранение данных**\n\nИнформация о сущностях, созданных через сервис Интеграции, хранится в базе Интеграции в течение 1 года.\n\nДля получения данных по сущностям, созданным ранее, необходимо обратиться к закреплённому менеджеру СДЭК.\n\n# Лимиты и производительность\n\nДля обеспечения стабильной работы сервиса, для всех методов API (синхронных и асинхронных) установлен порог гарантированной обработки в 200 RPS (запросов в секунду). При превышении данной нагрузки корректная и своевременная обработка запросов не гарантируется. Мы рекомендуем настраивать интенсивность вызовов на стороне клиента с учетом этих параметров.\n\n# Правила формирования сообщений\n\nПри формировании сообщения необходимо руководствоваться следующими правилами:\n\n
• В заголовке обязательно необходимо передавать токен авторизации.\n
• Обмен сообщениями должен осуществляться в кодировке UTF-8.\n
• Если элемент сообщения является необязательным, то такой элемент в сообщении может отсутствовать, либо значение элемента может быть пустым.\n
• Если элемент сообщения является обязательным, то он не может быть пустым.\n\n# Описание структуры вебхуков\n\nВебхуки предназначены для отправки на URL клиента событий:\n\n
• об изменении статуса заказа\n
• о готовности печатной формы\n
• получение информации о закрытии преалерта\n
• получение информации об изменении доступности офиса\n
• получение информации об изменении заказа\n
• получение информации о транспорте для СНТ\n
• получение информации об изменении договоренности о доставке\n
• получение информации о проблемах доставки по заказу\n
• с данными курьера, назначенного по заказу/заявке\n
• получение фото документов по заказам\n\n
Примечания: \n
• Таймаут подключения - 15 секунд. При возникновении ошибки таймаута подключения система автоматически повторяет отправку вебхука.\n
• Ограничение повторных попыток - при многократных ошибках таймаута действует система лимитов:\n
- максимум 12 попыток отправки в течение 75 минут;\n
- при превышении лимита система прекращает дальнейшие попытки доставки вебхука;\n
- если лимит повторных попыток исчерпан, все активные подписки, связанные с проблемным URL-адресом, автоматически отключаются для предотвращения системных сбоев.\n
• Если отправка вебхуков неуспешна и ошибка не связана с таймаутом, т.е. наш сервис не получил от клиента ответ 200 ОК, то подписка, на которую была попытка отправить вебхуки, будет удалена через 24 часа.\n
• Существует ограничение на количество подписок на вебхуки. У каждого клиента может быть не более двух подписок.\n\nПосле подключения подписки на вебхуки, на указанный клиентом URL приходит событие в формате JSON:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|--------------------------------|--------------|--------------------|\n| 1 | type | Тип события:
- ORDER_STATUS - событие по статусам
- PRINT_FORM - готовность печатной формы
- PREALERT_CLOSED - получение информации о закрытии преалерта
- ACCOMPANYING_WAYBILL - получение информации о транспорте для СНТ
- OFFICE_AVAILABILITY - получение информации об изменении доступности офиса
- ORDER_MODIFIED - получение информации об изменении заказа
- DELIV_AGREEMENT - получение информации об изменении договоренности о доставке
- DELIV_PROBLEM - получение информации о проблемах доставки по заказу
- COURIER_INFO - данные курьера, назначенного по заказу/заявке
- DOWNLOAD_PHOTO - получение фото документов по заказам | string | да |\n| 2 | date_time | Дата и время события в формате ISO 8601:
для ORDER_STATUS - дата установки нового статуса
для PRINT_FORM - дата формирования URL с pdf-файлом
для PREALERT_CLOSED - дата получения преалерта
для ACCOMPANYING_WAYBILL - дата получения информации о транспорте для СНТ
для OFFICE_AVAILABILITY - дата получения информации об изменении доступности офиса
для ORDER_MODIFIED - дата получения информации об изменении заказа
для DELIV_AGREEMENT - дата получения информации о договоренности
для DELIV_PROBLEM - дата получения информации о проблеме доставки
для COURIER_INFO - дата получение данных о назначении курьера
для DOWNLOAD_PHOTO - дата формирования фото документов | datetime | да |\n| 3 | uuid | Идентификатор сущности:
для ORDER_STATUS - заказа
для PRINT_FORM - печатной формы (квитанции или ШК)
для PREALERT_CLOSED - UUID преалерта
для ACCOMPANYING_WAYBILL - заказа
для OFFICE_AVAILABILITY - офиса
для ORDER_MODIFIED - заказа
для DELIV_AGREEMENT - заказа
для DELIV_PROBLEM - заказа
для COURIER_INFO - заказа для task_type = DELIVERY, заявки для task_type = DEMAND
для DOWNLOAD_PHOTO - фото документов | UUID | да |\n| 4 | attributes | Атрибуты события | | да |\n\nДля типа события ORDER_STATUS attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|--------|--------------------|------------------|--------------|--------------------|\n| 4.1 | is_return | Признак возвратного заказа:
true - является возвратной
false - является прямой
| boolean | да |\n| 4.2 | cdek_number | Номер заказа СДЭК | string() | да |\n| 4.3 | number | Номер заказа в ИС Клиента | string() | нет |\n| 4.4 | status_code | Код статуса (устаревшее поле) | string() | да |\n| 4.5 | status_reason_code | Код дополнительного статуса (подробнее см. Приложение 2) | string() | нет |\n| 4.6 | status_date_time | Дата и время установки статуса | datetime | да |\n| 4.7 | city_name | Наименование города возникновения статуса | string() | нет |\n| 4.8 | city_code | Код города возникновения статуса (не возвращается для статуса \\\"Создан\\\") | string() | нет |\n| 4.9 | code | Код статуса (подробнее см. Приложение 1) | string() | да |\n| 4.10 | is_reverse | Признак реверсного заказа | boolean | да |\n| 4.11 | is_client_return | Признак клиентского возврата | boolean | да |\n| 4.12 | related_entities | Связанные сущности, массив объектов | [ ] | нет |\n| 4.12.1 | type | Тип связанной сущности, может принимать значения:
direct_order - прямой заказ
client_direct_order - прямой заказ, по которому оформлен клиентский возврат | string() | да |\n| 4.12.2 | cdek_number | Номер заказа СДЭК | string() | да |\n| 4.12.3 | uuid | Идентификатор связанной сущности | UUID | да |\n| 4.13 | deleted | Признак удаления статуса (применяется к ДД) | boolean | нет |\n\nДля типа события PRINT_FORM attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|-----------------------|-------------------|--------------------|\n| 4.1 | type | Тип печатной формы:
WAYBILL - квитанция к заказу
BARCODE - ШК места к заказу | string() | да |\n| 4.2 | url | Ссылка на скачивание файла:
Формат: https://api.cdek.ru/v2/print/orders/{uuid}.pdf для квитанции
https://api.cdek.ru/v2/print/barcodes/{uuid}.pdf для ШК места | string() | да |\n\nДля типа события PREALERT_CLOSED attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|---------------------|----------------------------------------------------|--------------|--------------------|\n| 4.1 | prealert_number | Номер СДЭК закрытого преалерта | string() | да |\n| 4.2 | closed_date | Дата закрытия | dateTime | да |\n| 4.3 | fact_shipment_point | Фактический ПВЗ, в который были переданы заказы | string() | да |\n\nДля типа события ACCOMPANYING_WAYBILL attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|------------------------------|-----------------------------------------------------------------------|--------------|--------------------|\n| 4.1 | cdek_number | Номер заказа СДЭК | string() | да |\n| 4.2 | client_name | Наименование юр.лица клиента, создающего СНТ | string() | да |\n| 4.3 | flight_number | Номер авиарейса | string() | нет |\n| 4.4 | air_waybill_numbers | Накладные перевозчика для авиарейса | [] | нет |\n| 4.5 | vehicle_numbers | Номера транспортных средств | [] | нет |\n| 4.6 | vehicle_driver | Водитель транспортного средства | string() | нет |\n| 4.7 | planned_departure_date_time | Плановая дата и время отправления (формат YYYY-MM-DDThh:mm:ss±hhmm) | dateTime | да |\n\nДля типа события OFFICE_AVAILABILITY attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|---------------|--------------|--------------------|\n| 4.1 | type | Тип офиса по доступности. Может принимать значение:
AVAILABLE_OFFICE (офис доступный)
UNAVAILABLE_OFFICE (офис недоступный) | string() | да |\n| 4.2 | code | Код офиса | string() | да |\n\nДля типа события ORDER_MODIFIED attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|-------------------|--------------|--------------------|\n| 4.1 | modification_type | Тип изменения заказа. Может принимать значения:
PLANED_DELIVERY_DATE_CHANGED (добавление плановой даты доставки)
DELIVERY_SUM_CHANGED (изменение стоимости доставки)
DELIVERY_MODE_CHANGED (изменение режима заказа) | string() | да |\n| 4.2 | new_value | Новое значение | | да |\n| 4.2.1 | type | Тип нового значения. Может принимать значения:
DATE (дата: формат YYYY-MM-DD)
FLOAT (числовое значение с плавающей точкой)
INTEGER (целочисленное значение) | string() | да |\n| 4.2.2 | value | Новое значение | string() | да |\n\nДля типа события DELIV_AGREEMENT attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|--------------------|--------------|--------------------|\n| 4.1 | delivery_uuid | UUID новой договоренности | UUID | да |\n| 4.2 | date_time | Дата создания договоренности | dateTime | да |\n| 4.3 | cdek_number | Номер заказа, по которому зарегистрирована новая договоренность | string() | да |\n| 4.4 | date | Дата доставки, согласованная с получателем. Для типа договоренности WAREHOUSE и POSTAMAT эта дата не влияет на сроки доставки и может быть произвольной. | date | нет |\n| 4.5 | time_from | Время начала ожидания курьера (согласованное с получателем) | time | нет |\n| 4.6 | time_to | Время окончания ожидания курьера (согласованное с получателем) | time | нет |\n| 4.7 | comment | Комментарий | string() | нет |\n| 4.8 | source | Источник создания договоренности, может принимать значения:
DAILY_CALL_TASK - согласование в рамках задания на прозвон
COURIER_SUPPORT - согласование при решении проблем курьеров в ходе доставки
EK5_INTEGRATION - согласование через интеграцию
WEB_SITE - согласование при отслеживании заказа на сайте
MOBILE_APPLICATION - согласование при отслеживании заказа в мобильном приложении
SELF_CARE - согласование через ЛК ЮЛ
CABINET - согласование через ЛК ФЛ
MIA_BOT - согласование через голосовой бот \\\"Миа\\\"
WEB_SITE_BOT - согласование через чат-бот на сайте
MESSENGER_BOT - согласование через бот в мессенджере | string() | да |\n| 4.9 | type | Тип договоренности, может принимать значения:
DOOR - до двери
WAREHOUSE - до ПВЗ
POSTAMAT - до постамата | string() | да |\n| 4.10 | delivery_point | Код офиса СДЭК (ПВЗ/постамата), на который будет доставлена посылка | string() | нет |\n\nДля типа события DELIV_PROBLEM attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|--------------------------------------------------------------------------|--------------|--------------------|\n| 4.1 | cdek_number | Номер заказа, по которому появилась проблема | string() | да |\n| 4.2 | number | Номер заказа в системе интернет-магазина, по которому появилась проблема | string() | нет |\n| 4.3 | code | Код проблемы (подробнее см. Приложение 3) | string() | да |\n| 4.4 | create_date | Дата возникновения проблемы | dateTime | да |\n\nДля типа события COURIER_INFO attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|--------------------------------------------------------------------------|--------------|--------------------|\n| 4.1 | task_type | Тип задания курьера. Может принимать значения: DELIVERY (доставка до получателя), DEMAND (забор груза у отправителя) | string() | да |\n| 4.2 | intake_number | Номер заявки, для task_type = DEMAND | string() | нет |\n| 4.3 | сdek_number | Номер заказа, для task_type = DELIVERY | string() | нет |\n| 4.4 | courier | Данные курьера | object() | нет |\n| 4.4.1 | name | ФИО курьера | string() | нет |\n| 4.4.2 | car_model | Марка автомобиля | string() | нет |\n| 4.4.3 | registration_mark | Госномер автомобиля | string() | нет |\n| 4.4.4 | phone | Телефон курьера | string() | нет |\n\nДля типа события DOWNLOAD_PHOTO attributes содержит:\n\n| **№** | **Название поля** | **Описание** | **Тип поля** | **Обязательность** |\n|-------|-------------------|--------------------------------------------------------------------------------|--------------|--------------------|\n| 4.1 | cdek_number | Номер заказа СДЭК | string() | да |\n| 4.2 | link | Ссылка на скачивание файла Формат: https://api.cdek.ru/v2/photoDocument/{uuid} | string() | да |\n| 4.3 | create_date | Дата создания задания на фотографирование | datetime | нет |\n\nПример события (ORDER_STATUS)\n```json \n{\n \"type\": \"ORDER_STATUS\",\n \"date_time\": \"2023-11-28T07:44:45+0000\",\n \"uuid\": \"72753031-1820-4f99-9240-aab139f05ca5\",\n \"attributes\": {\n \"is_return\": false,\n \"is_reverse\": false,\n \"is_client_return\": false,\n \"cdek_number\": \"1100285492\",\n \"number\": \"17011574744791\",\n \"related_entities\": [],\n \"code\": \"RECEIVED_AT_SHIPMENT_WAREHOUSE\",\n \"status_code\": \"3\",\n \"status_date_time\": \"2023-11-28T07:44:45+0000\",\n \"city_name\": \"Новосибирск\",\n \"city_code\": \"270\",\n \"deleted\": false\n }\n}\n```\n\nПример события (PRINT_FORM)\n```json \n{\n \"type\": \"PRINT_FORM\",\n \"date_time\": \"2023-11-28T09:03:31+0000\",\n \"uuid\": \"72753031-e1f1-4fc8-97ee-d58a010b6a67\",\n \"attributes\": {\n \"type\": \"BARCODE\",\n \"url\": \"http://api.cdek.ru/v2/print/barcodes/72753031-e1f1-4fc8-97ee-d58a010b6a67.pdf\"\n }\n}\n```\n\nПример события (PREALERT_CLOSED)\n```json \n{\n \"type\": \"PREALERT_CLOSED\",\n \"date_time\": \"2023-01-23T10:20:02+0000\",\n \"uuid\": \"72753031-a1d3-4266-bc9f-8052f0fc3b2c\",\n \"attributes\": {\n \"prealert_number\": \"PA/7/583\",\n \"closed_date\": \"2023-01-17T07:59:18+0000\",\n \"fact_shipment_point\": \"NSK1\"\n }\n}\n```\n\nПример события (ACCOMPANYING_WAYBILL)\n```json \n{\n \"type\": \"ACCOMPANYING_WAYBILL\",\n \"date_time\": \"2024-08-01T05:40:09+0000\",\n \"uuid\": \"72753034-7bb8-4221-bf65-5b4ab9ddb15a\",\n \"attributes\": {\n \"cdek_number\": \"10000000123\",\n \"client_name\": \"Имя Клиента\",\n \"flight_number\": \"S511111\",\n \"air_waybill_numbers\": [\n \"A1111111\",\n \"B5263589\"\n ],\n \"planned_departure_date_time\": \"2024-08-05T13:00:00+0000\"\n }\n}\n```\n\nПример события (OFFICE_AVAILABILITY)\n```json \n{\n \"type\": \"OFFICE_AVAILABILITY\",\n \"date_time\": \"2024-08-19T03:01:10+0000\",\n \"uuid\": \"fc3ef89a-0727-4a26-8d07-81a0bfd11d22\",\n \"attributes\": {\n \"type\": \"AVAILABLE_OFFICE\",\n \"code\": \"MSK123\"\n }\n}\n```\n\nПример события (ORDER_MODIFIED)\n```json \n{\n \"type\": \"ORDER_MODIFIED\",\n \"date_time\": \"2024-08-19T10:02:15+0000\",\n \"uuid\": \"72753034-23a3-46a5-974d-8b1239d515e1\",\n \"attributes\": {\n \"modification_type\": \"PLANED_DELIVERY_DATE_CHANGED\",\n \"new_value\": {\n \"type\": \"DATE\",\n \"value\": \"2024-08-21\"\n }\n }\n}\n```\n\nПример события (DELIV_AGREEMENT)\n```json \n{\n \"type\": \"DELIV_AGREEMENT\",\n \"date_time\": \"2024-12-06T11:32:31+0000\",\n \"uuid\": \"72753031-680b-47dd-83e7-027e35e831b3\",\n \"attributes\": {\n \"delivery_uuid\": \"72753031-68d6-4d18-b52a-45e9da153bdc\",\n \"date_time\": \"2024-12-06T11:32:31.608716Z\",\n \"cdek_number\": \"10000063729\",\n \"date\": \"2024-12-13\",\n \"time_from\": \"11:00:00\",\n \"time_to\": \"18:00:00\",\n \"comment\": \"Доставка до двери\",\n \"source\": \"EK5_INTEGRATION\",\n \"type\": \"DOOR\"\n }\n}\n```\n\nПример события (DELIV_PROBLEM)\n```json \n{\n \"type\": \"DELIV_PROBLEM\",\n \"date_time\": \"2024-12-18T07:49:33+0000\",\n \"uuid\": \"72753031-a5c5-4e30-8234-bd9daf53ad59\",\n \"attributes\": {\n \"cdek_number\": \"10000077777\",\n \"number\": \"IM-123456789\",\n \"code\": \"45\",\n \"create_date\": \"2024-12-18T11:35:57Z\"\n }\n}\n```\n\n Пример события (COURIER_INFO)\n```json \n{\n\"type\": \"COURIER_INFO\",\n\"date_time\": \"2026-01-27T11:51:13+0000\",\n\"uuid\": \"26d20be9-01b9-4283-bb13-d5a91e90c4e4\",\n\"attributes\": {\n \"task_type\": \"DELIVERY\",\n \"cdek_number\": \"10000000123\",\n \"courier\": {\n \"name\": \"\",\n \"car_model\": \"\",\n \"registration_mark\": \"\",\n \"phone\": \"+79999999999, доб. 123\"\n }\n\n```\n\nПример события (DOWNLOAD_PHOTO)\n\n```json\n{\n \"type\": \"DOWNLOAD_PHOTO\",\n \"date_time\": \"2026-01-01T10:11:12+0700\",\n \"uuid\": \"72753031-6417-44d2-8c0d-649a1d4b4721\",\n \"attributes\": {\n \"cdek_number\": \"10123456789\",\n \"link\": \"https://api.cdek.ru/v2/photoDocument/72753031-e1f1-4fc8-97ee-d58a010b6a68\",\n \"create_date\": \"2026-01-01T10:11:12+0000\"\n }\n}\n```\n\n# Требования к идентификаторам посылок и информации на ярлыке\n\n
Предпочтительным для компании СДЭК является использование ее собственных ярлыков (квитанций или ШК заказа), которые можно получить через следующие методы:\n\n
• Формирования квитанции к заказу\n
• Формирование ШК-места к заказу\n
\nВ случае использования собственного ярлыка он обязательно должен содержать информацию о получателе (ФИО, адрес, телефон) и любой из идентификаторов.\n
\nИдентификатор посылки СДЭК:\n
• В штрих-коде рекомендуется указывать номер накладной СДЭК (в формате обмена данными — это атрибут «cdek_number»).\n
• Идентификатор заказа ИМ — это номер заказа в ИС Клиента (атрибут «number»).\n
• Идентификатор грузоместа (упаковки) — это штрих-код упаковки (атрибут «packages.number»).\n\n
Все штрих-коды должны иметь расшифровку закодированного текста под или над штрих-кодом, чтобы иметь возможность вводить вручную закодированную информацию.\nРекомендуется для печати использовать стандарт Code 128. \n\n# Список возможных ошибок\n\n Если полученная ошибка не указана в списке ниже, просим сообщить на почту integrator@cdek.ru \nили в чат-бот Тая на портале https://apidoc.cdek.ru/\n\nСообщение об ошибке:\n\n```json \n{\n ...\n \"errors\": [\n {\n \"code\": \"code\",\n \"message\": \"message\"\n }\n ]\n}\n```\n\nПример ошибки: \n\n```json \n{\n ...\n \"requests\": [\n {\n \"request_uuid\": \"72753031-......\",\n \"type\": \"CREATE\",\n \"date_time\": \"2017-11-19T14:48:13+0700\",\n \"state\": \"INVALID\",\n \"errors\": [\n {\n \"code\": \"error_validate_im_dep_number_has_already_had_integration\",\n \"message\": \"Введенный номер отправления ИМ не уникальный. Введите уникальный номер.\"\n }\n ]\n }\n ]\n}\n```\n\n| **Код ошибки** | **Текст ошибки** | **Пояснение** | **В каком методе возвращается** |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| v2_internal_error | Internal error | Запрос выполнился с системной ошибкой | Для всех методов протокола |\n| v2_internal_error | Unknown unique error {uuid} | Ошибка несоответствия типов: недопустимое значение | Регистрация заказа, Изменение заказа |\n| v2_similar_request_still_processed | Similar request is still being processed {uuid} | Предыдущий запрос такого же типа над этой же сущностью еще не выполнился | Изменение заказа;
Регистрация отказа;
Регистрация заявки;
Регистрация договоренности |\n| v2_update_forbidden | Operation is forbidden. Orders can only be updated in \"CREATED\" or \"ACCEPTED\" statuses | Заказ уже принят к перевозке, в таком состоянии изменять заказ запрещено | Изменение заказа |\n| v2_bad_request | Bad request | Передан некорректный запрос | Для всех методов протокола |\n| v2_invalid_format | Invalid value [{0}] in [{1}] parameter | Передано некорректное значение | Для всех методов протокола |\n| v2_field_is_empty | {Название поля} is empty | Не передано обязательное поле | Для всех методов протокола |\n| v2_parameters_empty | All parameters are empty | Все параметры запроса пустые или не переданы | Для всех методов протокола |\n| v2_invalid_value_type | Invalid value type in {Название поля} field | Передан некорректный тип данных | Для всех методов протокола |\n| v2_entity_not_found | Entity is not found by uuid {0} | Сущность (заказ, заявка и т.д.) с указанным идентификатором не существует, либо удалена | Методы работы с уже созданными сущностями. Например: с заказами, заявками, печатными формами, и т.д. |\n| v2_entity_forbidden | Entity is forbidden {0} | Сущность (заказ, заявка и т.д.) с указанным идентификатором существует, но принадлежит другому клиенту | Методы работы с уже созданными сущностями. Например: с заказами, заявками, печатными формами, и т.д. |\n| v2_entity_invalid | Entity is invalid {0} | Сущность (заказ, заявка и т.д.) с указанным идентификатором существует, но некорректна | Методы работы с уже созданными сущностями. Например: с заказами, заявками, печатными формами, и т.д. |\n| v2_order_not_found | Order not found by cdek_number {0} | Заказ с указанным номером не существует, либо удален | Методы, в которые можно передать номер заказа. Например: создание заявки/договоренности о доставке, инфо о чеках/паспортных данных |\n| v2_order_forbidden | Order forbidden {0} | Заказ с указанным номером существует, но принадлежит другому клиенту | Методы, в которые можно передать номер заказа. Например: создание заявки/договоренности о доставке, инфо о чеках/паспортных данных |\n| v2_order_number_empty | Order number and order uuid are empty | Не переданы номер и идентификатор заказа | Методы, в которые можно передать номер заказа. Например: создание заявки/договоренности о доставке, инфо о чеках/паспортных данных |\n| v2_shipment_address_multivalued | Sender address and sender shipment point can't be filled both | Одновременно переданы ПВЗ отправителя и адрес отправителя. Необходимо указать 1 параметр | Регистрация заказа |\n| v2_delivery_address_multivalued | Recipient address and recipient delivery point can't be filled both | Одновременно переданы ПВЗ получателя и адрес получателя. Необходимо указать 1 параметр. | Регистрация заказа |\n| v2_sender_location_not_recognized | Sender location is not recognized | Не удалось определить город отправителя | Методы, в которые можно передать локации. Например: метод регистрации/обновления заказа/заявки, методы калькулятора |\n| v2_recipient_location_not_recognized | Recipient location is not recognized | Не удалось определить город получателя | Методы, в которые можно передать локации. Например: метод регистрации/обновления заказа/заявки, методы калькулятора |\n| v2_number_items_is_more_126 | The number of commodity items is more than 126 | Количество позиций товаров в заказе свыше 126 | Регистрация заказа |\n| orders_number_is_empty | Entity is empty. All orders are incorrect | Все заказы с указанными номерами и идентификаторами некорректны | Формирование ШК/ПФ. Получение информации о ШК/ПФ |\n| v2_entity_not_found_im_number | Entity is not found by number {0} | Сущность с указанным идентификатором не существует, либо удалена | Информация о заказе |\n| v2_package_id_is_empty | Package_id for {number} package is empty | Не передан идентификатор уже существующей упаковки заказа | Изменение заказа |\n| v2_impossible_register_date | It is impossible to register date for parcel terminal | Истинный режим переданного заказа - \\\"До постамата\\\" | Регистрация договорённости о доставке |\n| v2_intake_exists_by_order | Intake exists by order {0} | К переданному заказу уже привязана заявка | Регистрация заявки на вызов курьера |\n| v2_intake_exists_by_date_address | Intake exists by date and address | На переданную дату и в переданный адрес уже есть заявка | Регистрация заявки на вызов курьера |\n| v2_webhook_type_incorrect | Webhook type is incorrect | Передан некорректный тип события | Создание вебхука (webhooks) |\n| v2_entity_empty | Entity is empty. All orders are incorrect | Все заказы с указанными номерами и идентификаторами некорректны | Информация о паспортных данных |\n| v2_wrong_interval | Wrong date interval | Передан некорректный промежуток времени | Получение заказов с готовыми фото |\n| v2_entity_empty | Entity is empty. All orders are incorrect. | Квитанция с указанным идентификатором не сформировалась, так как все заказы некорректны | Информация о паспортных данных |\n| v2_unable_add_service | Unable to add service {0} to order. | Не удалось добавить услугу {0} к заказу. | Регистрация заказа |\n| v2_order_item_amount_incorrect | Marked item amount is incorrect | Ошибка при регистрации заказа с количеством единиц маркированного товара более 1 | Регистрация заказа |\n| v2_entity_has_final_status | Operation is forbidden. Entity has final status {0} | Заявку в конечном статусе нельзя удалить | Метод удаления заявки |\n| v2_entity_not_ready | v2_entity_not_ready | Сущность, над которой требуется выполнить действие, еще не готова. Например: заказы, переданные в метод создания ШК/ПФ, еще не получили номер | Методы работы с уже созданными сущностями. Например: с заказами, заявками, печатными формами, и т.д. |\n| v2_outdated_tariff | Tariff {0} is outdated | Передан устаревший тариф | Калькулятор. Расчет по коду тарифа |\n| v2_exceeded_size | The size parameter cannot exceed 10000 | Запрашиваемое количество локаций на странице выше чем лимит | Список населённых пунктов |\n| v2_token_expired | Access token is expired: {0} | Время жизни токена истекло | Для всех методов протокола |\n| v2_authorization_incorrect | Authorization header is incorrect | Некорректный токен | Для всех методов протокола |\n| | | | |\n| error_validate_order_cash_on_delivery_currency_invalid | Валюта наложенного платежа не совпадает с валютой страны получателя. | | |\n| error_validate_order_cash_on_delivery_currency_not_equals_declared_cost | Валюта наложенного платежа не совпадает с валютой объявленной стоимости | | |\n| error_validate_declare_cost_currency_not_equals_payer_currency | Валюта объявленной стоимости должна совпадать с валютой плательщика | | |\n| error_validate_method_of_payment_receiver_city_limit_payment_exceeded | Наложенный платеж больше ограничения суммы наложенного платежа в городе получателя | | |\n| error_validate_courier_invitation_time_expired | Вы не можете вызвать курьера на указанное время т.к. в городе отправителя это время уже в прошлом | | |\n| ve_package_weight_too_small | Физический вес < | | |\n| ve_package_weight_too_large | Физический вес > | | |\n| ve_currency_not_corresponds_to_contract | Указан договор плательщика и валюта не совпадает с валютой договора | | |\n| ve_currency_not_corresponds_to_contragent | Не указан договор плательщика и валюта не совпадает с валютой контрагента | | |\n| ve_currency_not_corresponds_to_city | Указанная валюта не совпадает с валютой в городе получения | | |\n| error_validate_sender_name_incorrect_symbol | Некорректно указан отправитель: невозможно использование символа \\\"/\\\" | | |\n| error_validate_sender_name_only_digits | Некорректно указан отправитель: наименование контрагента не может содержать только цифры | | |\n| error_validate_receiver_name_incorrect_symbol | Некорректно указан получатель: невозможно использование символа \\\"/\\\" | | |\n| error_validate_receiver_name_only_digits | Некорректно указан получатель: наименование контрагента не может содержать только цифры | | |\n| error_validate_receiver_city_cash_limit | Превышен лимит на наложенный платеж в городе получателе. | | |\n| ve_receiver_phone_type_incorrect | Указан невалидный тип телефона получателя {0} | | |\n| ve_receiver_pickup_point_empty | При режиме «до склада» ПВЗ для доставки обязателен | | |\n| error_validate_receiver_delivery_point_calc_weight_small | Расчетный вес заказа выходит за рамки весового ограничения выбранного офиса получателя | | |\n| error_validate_receiver_delivery_point_calc_weight_large | Расчетный вес заказа выходит за рамки весового ограничения выбранного офиса получателя | | |\n| ve_receiver_pickup_point_take_only | Выбранный ПВЗ не предусматривает выдачу груза только прием | | |\n| error_validate_package_number_not_unique | Номер места в заказе должен быть уникален | | |\n| error_validate_package_one_of_size_is_zero | Один из габаритов места заказе равен 0 | | |\n| error_validate_package_count_to_pochtomat | Заказ до постамата должен иметь только 1 место в заказе | | |\n| error_validate_good_article_is_not_unique | Артикул товара не уникален | | |\n| ve_as_forbidden | Дополнительная услуга {0} не доступна | ДУ нельзя использовать конкретному клиенту или с определенными параметрами заказа | |\n| error_validate_additional_service_param_declared_cost_is_required | Объявленная стоимость обязательна для дополнительной услуги {0} | | |\n| error_validate_additional_service_param_unsupported_param | Дополнительная услуга не поддерживается | Передан некорректный параметр доп. услуги | |\n| error_internal_cannot_set_vat | Невозможно установить НДС | | |\n| error_validate_package_article_not_unique | Артикул не уникален в пределах места заказа | | |\n| error_calculator_calculate | При обращении к калькулятору произошла ошибка | | |\n| error_validate_additional_service_param_declared_cost_is_does_not_match_with_goods | Стоимость товаров не совпадает с объявленной стоимостью | | |\n| jv_the_number_of_orders_at_the_request_of_more_than_1000 | Количество заказов в запросе превысило 1000 | | |\n| error_validate_dd_date_delivery_before_order_date | Дата доставки не может быть раньше даты заказа | | |\n| ve_as_reverse_only_to_door | Дополнительная услуга \\\"реверс\\\" доступна только при режимах доставки \\\"До двери\\\" | | |\n| ve_as_reverse_contract_forbidden | По данному договору плательщика услуга реверс не доступна | | |\n| ve_as_reverse_sender_address_empty | Отсутствует адрес отправителя при указанной услуге Реверс и режимом возврата для Реверса: Отправителю заказа | | |\n| error_validate_package_im_wrong_amount | Количество товаров может быть не более 999 | | |\n| error_validate_package_number_has_alreasy_used | Место с указанным номером уже существует | | |\n| error_validate_good_vat_rate_diff | Сумма НДС в товаре с артикулом \\\"{0}\\\" не соответствует выбранной Ставке НДС. Рекомендуется {1} | | |\n| error_validate_good_vat_rate_is_not_selected | При наличии наложенного платежа за единицу товара НДС обязательна | | |\n| error_validate_good_vat_rate_sum_empty | Сумма НДС не соответствует указанной ставке НДС | | |\n| error_validate_good_vat_rate_sum_not_appropriate | Сумма НДС не соответствует указанной ставке НДС | | |\n| error_validate_good_article_has_already | Артикул товара с указанным номером уже существует в текущем месте | | |\n| error_validate_good_payment_not_suite | Нельзя указать “Оплату с получателя за единицу товара” для заказа типа “Доставка“ | | |\n| error_validate_online_shop_price_threshold_can_not_be_duplicate | Пороги стоимости не должны дублироваться | | |\n| error_validate_online_shop_price_threshold_surcharge_vat_sum_incorrect | Указана некорректная сумма НДС для порога стоимости | | |\n| error_dsd_validate_vat_sum_difference_between | Сумма НДС (у порога {0}) не соответствует ставки НДС. Рекомендуется {1} | | |\n| error_validate_online_shop_price_threshold_cost_less_min_value | Стоимость доставки у порога стоимости не должна быть меньше {0} | | |\n| error_dsd_validate_vat_rate_code_incorrect | Код ставки НДС для порога стоимости указан неверно | | |\n| ve_receiver_pickup_point_wrong_city | Неверно указан офис получателя, офис получателя не находится в городе получателе! | | |\n| error_validate_declared_cost_of_insurance_not_eq_to_dc_of_goods | Объявленная стоимость услуги страхование не соответствует объявленной стоимости товаров. | | |\n| error_validate_good_gros_weight_less_than_net_weight | Вес брутто не может быть меньше веса нетто. | | |\n| error_validate_im_dep_number_has_already_had_integration | Введенный номер отправления ИМ не уникальный. Введите уникальный номер. | | |\n| error_validate_online_shop_seller_ownership_form_incorrect | Неверно указана форма собственности продавца | | |\n| error_validate_good_label_count_is_over_limit | Количество товаров в строке с указанной маркировкой должно быть равно 1 | | |\n| error_validate_order_delete_status | Ошибка удаления заказа. Заказ может быть удален только в статусе Создан. | | |\n| error_validate_order_delete_documents_in_warehouse_is_not_empty | Ошибка удаления заказа. По заказу есть операции на складе. | | |\n| error_validate_order_delete_claims_is_not_empty | Ошибка удаления заказа. По заказу зарегистрирована претензия. | | |\n| error_validate_postamat_package_count | В заказе с режимом \\\"До постамата\\\" количество мест не может быть больше 1 | | |\n| error_validate_postamat_package_weight | Вес места не должен превышать 15 кг для заказов с режимом \\\"до постамата\\\" | | |\n| error_validate_postamat_pvz_not_postamat | Выбранный офис не является постаматом | | |\n| error_validate_delivery_detail_postamat_part_delivery | Частичная доставка не доступна для заказов с режимом \\\"до постамата\\\" | | |\n| error_internal_reverse_overweight | Максимальный вес по Обратному заказу не может превышать 30 кг | | |\n| error_validate_reverse_deny_change_sender_city | В обратном заказе запрещено изменять город отправителя, если прямой заказ в конечном статусе | | |\n| error_validate_reverse_deny_change_sender_address | В обратном заказе запрещено изменять адрес отправителя, если прямой заказ в конечном статусе | | |\n| error_validate_build_ci_from_order | Создание заявки из заказа возможно только по новым заказам при режиме \\\"от двери\\\" | | |\n| error_validate_courier_invitation_time_expired | Вы не можете вызвать курьера на указанное время т.к. в городе отправителя это время уже истекло | | |\n| ve_ci_pickup_date_expired | На указанную дату уже невозможно вызвать курьера | | |\n| ve_ci_pickup_time_too_small | Приезд курьера может осуществляться с {0} | | |\n| ve_ci_pickup_time_too_large | Приезд курьера не может осуществляться после {0} | | |\n| ve_ci_pickup_time_selfcare_too_large | Заявки на сегодняшний день можно создавать до {0} | | |\n| ve_ci_pickup_time_to_before_from | Время приезда курьера с должно быть раньше \\\"времени приезда курьера по\\\" | | |\n| ve_ci_pickup_lunch_too_small | Некорректное начальное время обеда: раньше чем приезд курьера | | |\n| ve_ci_pickup_lunch_too_large | Некорректное конечное время обеда: позже чем приезд курьера | | |\n| ve_ci_pickup_lunch_interval_incorrect | Некорректное конечное время обеда: меньше начального времени обеда | | |\n| ve_ci_pickup_lunch_interval_zero | Время обеда \\\"с\\\" и Время обеда \\\"по\\\" не должны совпадать | | |\n| ve_ci_pickup_date_too_large | Дата приезда курьера слишком большая | | |\n| ve_ci_status_for_change_date_incorrect | Дату и время приезда курьера можно изменять только в статусах \\\"{0}\\\", \\\"{1}\\\" или \\\"{2}\\\" | | |\n| ve_tariff_mode_not_from_door | Заявка не может быть оформлена с режимом от склада без доп. услуги “Забор отправления” | | |\n| ve_tariff_mode_warehouse_unavailable | Заявка не может быть оформлена по данному тарифу | | |\n| ve_delivery_time_empty | Требуется время доставки | | |\n| error_validate_receiver_city_cash_limit | Превышен лимит НП в городе получателе. | | |\n| ve_receiver_phone_type_incorrect | Указан некорректный тип телефона получателя в записи {0} | | |\n| ve_receiver_pickup_point_incorrect | Указан некорректный офис получателя | | |\n| ve_payer_contract_status_incorrect | Договор плательщика находится в статусе {0}, при котором нельзя создавать заявки. Указание оплаты по договору может быть только в статусе договора \\\"Подписан\\\". | | |\n| error_validate_receiver_delivery_point_calc_weight_small | Для ПВЗ получателя слишком маленкий вес отправления. | | |\n| error_validate_receiver_delivery_point_calc_weight_large | Для ПВЗ получателя слишком большой вес отправления. | | |\n| error_validate_online_shop_number_departure_is_not_unique | Номер отправления не уникальный | | |\n| error_validate_package_one_of_size_is_zero | Один из размеров места равен 0 | | |\n| error_validate_package_count_to_pochtomat | Заказ до постамата должен быть с одним местом | | |\n| ve_as_part_deliv_count | Недостаточно товаров для частичной доставки | | |\n| ve_as_part_deliv_forbidden | Запрещена частичная доставка | | |\n| ve_as_get_up_floor_any_checked | Невозможно единовременно выбрать ручной подъем и подъем лифтом | | |\n| error_validate_tariff_not_supported_for_this_direction | Услуга не поддерживается на выбранном направлении | | |\n| error_validate_additional_service_param_declared_cost_is_required | Объявленная стоимость обязательна для дополнительной услуги {0} | | |\n| error_validate_additional_service_param_cant_part_deliv_one_good | Частичная доставка невозможна | | |\n| error_validate_package_article_not_unique | Артикул не уникален в пределах места в заказе | | |\n| error_validate_good_net_weight_per_unit_is_required | Не указан вес нетто для товара | | |\n| ve_reverse_straight_order_not_found | Прямого заказа с таким не номером не существует, нельзя сгенерировать заявку на обратный курьерский забор | | |\n| ie_reverse_mode_not_supported | Тип реверса не поддерживается | | |\n| ve_reverse_tariff_not_available | Нет тарифов по данному направлению | | |\n| err_result_service_empty | По данному направлению при заданных условиях выбранный тариф недоступен | | |\n| err_result_servicelist_empty | По данному направлению при заданных условиях нет доступных тарифов | | |\n| err_addservice_getup_floor_elevator | Невозможно одновременное применение взаимоисключающих доп. услуг 'Подъем на этаж ручной' и 'Подъем на этаж лифтом' | | |\n| err_invalid_tariff_with_datetimeordersend | В указанную дату создания заказа выбранная услуга не доступна | | |\n| err_invalid_tariff_with_ordertype | Несоответствие выбранной услуги типу заказа | | |\n| err_invalid_tariff_with_dimentions | Для выбранной услуги превышены габариты или вес | | |\n| err_pvz_with_tariff_mistake | При тарифе с режимом доставки от/до склада, склад должен существовать в городе-отправителе и/или городе-получателе соответственно | | |\n| ERR_PVZ_WEIGHT_LIMIT | Расчетный вес заказа выходит за рамки весового ограничения выбранного офиса получателя | | |\n| ve_calc_as_order_type | Применение доп услуги {0} невозможно с заданным типом заказа | | |\n| error_validate_good_invalid_label | Некорректный код маркировки товара: [наименование товара] - [не валидный код маркировки] | | |\n| ve_calc_as_not_compatible ИЛИ err_addservice_ban_attachment_inspection_incompatible_part_deliv, err_addservice_ban_attachment_inspection_incompatible_trying_on | Невозможно одновременное применение взаимоисключающих доп. услуг \\\"Запрет осмотра вложения\\\" и \\\"Примерка на дому\\\", Невозможно одновременное применение взаимоисключающих доп. услуг \\\"Запрет осмотра вложения\\\" и \\\"Частичная доставка\\\" | | |\n| error_validate_goods_label_count_is_over_limit | Количество товаров с маркировкой [код маркировки] в заказе должно быть равно 1 | | |\n| The pick-up point doesn't meet the requirements and no other suitable pick-up point found | Пункт самовывоза не соответствует требованиям и другого подходящего пункта самовывоза не найдено | | |\n| code_invalid | Передано недопустимое значение кода ПВЗ отправителя / получателя (shipment_point или delivery_point) | | |\n| VE_ADDITIONAL_SERVICE_UNAVAILABLE | | Доп. услуга (ДУ) недоступна для конкретного заказа | |\n| PA_02 | Плановая дата доставки должна быть позже. | До переданной planned_date осталось меньше времени, чем задано в условиях вашего договора на обработку преалерта (т.е. плановая дата передачи planned_date должна быть впереди от текущего момента не менее, чем на сутки). Обычно срок составляет 24 часа. Для уточнения информации по сроку обработки преалерта либо для его изменения вы можете обратиться к вашему закрепленному менеджеру СДЭК. | |\n| PA_17 | Договор не найден | По договору не подключена услуга Преалерт, по вопросу подключения необходимо обратиться к закрепленному по договору менеджеру / в закрепленный офис | |\n| PA_11 | Грузоместо ... из заказа ... удалено | Одна из упаковок в заказе удалена (может наблюдаться при внесении изменений в заказ, необходимо проверить текущую информацию по заказу) | |\n| unauthorized | Full authentication is required to access this resource | Может передаваться в двух случаях - если в запросе к методу не передан токен, либо (для метода Авторизация) - если данные переданы в соответствии с описанием в https://api-docs.cdek.ru/29923918.html , но используется некорректный тип запроса - например, GET вместо POST | |\n\n# Список возможных предупреждений\n\n| **Код предупреждения** | **Текст предупреждения** | **Пояснение** |\n|------------------------------|---------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|\n| v2_entity_not_found | Entity not found by uuid {номер uuid} | Заказ с указанным идентификатором не существует, либо удален |\n| v2_order_not_found | Order not found by cdek_number {номер заказа} | Заказ с указанным номером заказа не существует, либо удален |\n| v2_entity_forbidden | Entity forbidden {uuid} | Заказ с указанным идентификатором существует, но был создан другим клиентом |\n| v2_order_forbidden | Order forbidden {номер заказа}. Entity uuid is {uuid} | Заказ с указанным номером заказа существует, но был создан другим клиентом |\n| v2_entity_invalid | Entity is invalid {номер uuid} | Заказ с указанным идентификатором существует, но некорректный |\n| v2_cost_change_by_tariff | New tariff code can trigger change order cost | Передан новый тариф по заказу |\n| v2_cost_change_by_services | New services can trigger change order cost | Передан новый список дополнительных услуг по заказу |\n| v2_cost_change_by_location | New location can trigger change order cost | Передан новый город получателя по заказу |\n| v2_cost_change_by_parameters | New parameters (weight, dimensions, items cost) can trigger change order cost | Передан новый список информации по местам (упаковкам) по заказу |\n| v2_late_intake | Intake may be completed tomorrow | Передана заявка на приезд курьера на сегодняшнюю дату после 15:00 |\n| v2_shipment_point_changed | Order cannot be processed by shipment point {код офиса}. Shipment point has been changed to {код офиса} | Заказ невозможно доставить в выбранный офис отправителя, поэтому произошла переадресация на ближайший доступный офис |\n| v2_delivery_point_changed | Order cannot be processed by delivery point {код офиса}. Shipment point has been changed to {код офиса} | Заказ невозможно доставить в выбранный офис получателя, поэтому произошла переадресация на ближайший доступный офис |\n| v2_sender_email_ignored | The senders email {0} is incorrect and will be ignored | Электронная почта отправителя некорректна, поэтому будет проигнорирована |\n| v2_recipient_email_ignored | The recipients email {0} is incorrect and will be ignored | Электронная почта получателя некорректна, поэтому будет проигнорирована |\n\n# FAQ. Часто задаваемые вопросы\n\n**1 Вопрос:**\n\nПочему при создании заказа от двери заявка не создается автоматически?\n\n**Ответ:**\n\nДействительно, при создании Заказа от двери через API Заявка на вызов курьера не создается автоматически, \nтак как являются разными бизнес процессами. Необходимо воспользоваться методом \\\"Регистрация заявки на вызов курьера\\\" . \nЕсли в запросе не передан атрибут \\\"cdek_number\\\" и \\\"order_uuid\\\", то создается заявка на забор консолидированного груза \n(сразу нескольких заказов с одного адреса отправителя).\n\n
**2 Вопрос:**\n\nКак мне узнать код тарифа/код дополнительной услуги?\n\n**Ответ:**\n\n• С кодами Тарифов можно ознакомиться в разделе \"Приложение 4. Тарифы СДЭК\" по ссылке https://apidoc.cdek.ru/#tag/common/Prilozheniya/Prilozhenie-4.-Tarify-SDEK, \nлибо получить актуальный на текущий момент список тарифов, доступных для вашего договора (если интеграция уже подключена) с помощью метода \"Список доступных тарифов\" https://apidoc.cdek.ru/#tag/calculator/operation/availableTariffs\n
• С кодами Дополнительных услуг можно ознакомиться в нашей документации Приложение 6 по ссылке: https://apidoc.cdek.ru/#tag/common/Prilozheniya/Prilozhenie-6.-Dopolnitelnye-uslugi\n\n
**3 Вопрос:**\n\nВ чем отличие доп. сбора за доставку delivery_recipient_cost и динамического доп. сбора delivery_recipient_cost_adv в запросе на регистрацию заказа? В каких случаях какой использовать?\n\n**Ответ:**\n\nВ случае, если требуется взять с получателя дополнительный сбор за доставку при вручении заказа - необходимо передать тег delivery_recipient_cost (поля value, vat_sum, vat_rate)\nТакже эта сумма может быть динамической - в таком случае можно использовать тег delivery_recipient_cost_adv, указать в нем порог выкупа и сбор за доставку. Например, при выкупе менее 5000 рублей, получатель должен оплатить за доставку 500 рублей, а при большем выкупе - доставка будет бесплатной, тогда необходимо будет указать такие значения:\n```json\n\"delivery_recipient_cost_adv\" : [{\n \"sum\" : 500,\n \"threshold\" : 5000\n}]\n```\nПорогов можно задавать любое количество.\nЕсли при превышении последнего порога стоимости не надо брать сумму за доставку, необходимо передать значение «Доп.сбор за доставку с получателя» delivery_recipient_cost_adv 0 рублей.\nЕсли при превышении последнего порога выкупа надо брать плату за доставку, то необходимо передать значение фиксированного доп.сбора за доставку в поле «Доп.сбор за доставку с получателя» delivery_recipient_cost_adv.\n\n
**4 Вопрос:**\n\nПочему не могу передать только название города при Регистрации заказа?\n\n**Ответ:**\n\nИдентификация города производится по следующему алгоритму в порядке приоритетности:\n
• По переданному коду ПВЗ.\n
• По уникальному коду населенного пункта СДЭК. Значения передаются в атрибутах и to_location.code.\n
• По координатам: необходимо передавать значения долготы (_location_longitude) и широты (_location_latitude).\n
• По уникальному идентификатору ФИАС (код адресного объекта, подробнее: https://fias.nalog.ru/). \nЗначения передаются в атрибутах from_location.fias_guid и to_location.fias_guid.\n
• По почтовому индексу города, коду страны, названию региона и названию города: \n*_location.code + *_location.country_code + *_location.region + *_location.city. \nТакже в качестве уточняющего параметра может быть передан район региона - *_location.sub_region.\n
• По строке адреса. Если атрибуты, используемые в предыдущем пункте не пустые, \nто из них формируется адресная строка + используется атрибут *_location.address, если он не пуст.\n\nОпираясь на вышеописанный алгоритм, рекомендуем передавать в запросах код города / индекс + наименование НП / ФИАС/ наименование НП + наименование региона.\n\n
**5 Вопрос:**\n\nЧто означает ошибка \\\"shipment location is not recognized\\\"?\n\n**Ответ:**\n\n\\\"shipment location is not recognized\\\" - Не определен город Отправителя, так как передан не корректный город Отправления. \nОбычно передан индекс без наименования, рекомендуем так же в паре передавать уточняющий параметр \nнаименование населенного пункта (код города / индекс + наименование НП / ФИАС/ наименование НП + наименование региона).\nОстальные ошибки описаны в разделе \\\"Список ошибок интеграции\\\".\n\n
**6 Вопрос:**\n\nПочему тестовая среда и реальная разные? Например у вас есть ПВЗ YEKB46, но на тестовой среде его нет.\n\n**Ответ:**\n\nТестовая среда предназначена только для тестирования методов интеграции. Данные по ПВЗ/городам на тестовой среде различаются.\n\n
**7 Вопрос:**\n\nКакие габариты требуется передавать при вызове курьера в случае если нет возможности точно рассчитать ДВШ всех товарных позиций?\n\n**Ответ:**\n\n1-1-1 в соответствующих атрибутах \n\n
**8 Вопрос:**\n\nЧто будет, если в запросе на регистрацию заказа передать офис, который закрыт/не принимает грузы?\n\n**Ответ:**\n\nЕсли в запросе указывается код офиса, но он не подходит по параметрам, то офис подменяется на ближайший с подходящими характеристиками. Подмена работает по этим параметрам, если они указываются при регистрации заказа: есть приём наложенного платежа и есть приём/выдача заказов.\n\nТакже ПВЗ/постамат должен быть активен и у нас есть ограничение, что ПВЗ выбирается только в том же городе (если код города совпадает).\n\nЕсли заказ оформляется в постамат, но этот постамат и ближайшие постаматы не подходят по размерам ячейки, то заказ будет автоматически перенаправлен на ближайший ПВЗ в городе (если подходящие ПВЗ есть).\n\nС ПВЗ на постамат переадресации не происходит.\n\n
**9 Вопрос:**\n\nПроисходит ли валидация номеров телефонов, переданных в запросах?\n\n**Ответ:**\n\nНомер телефона отправителя (sender) валидируется на соответствие формату телефонов в стране отправителя (телефонный код, количество символов).\n\nИсключение: если телефон не соответствует формату страны отправителя, но соответствует формату телефонов России, Казахстана, Китая или Малазии, заказ будет зарегистрирован успешно.\n\nНомер телефона получателя (recipient) валидируется на соответствие формату телефонов в стране получателя (телефонный код, количество символов).\n\nИсключение: если телефон не соответствует формату страны отправителя, но соответствует формату телефонов России, Казахстана, Китая или Малазии, заказ будет зарегистрирован успешно.\n\nНомер телефона продавца (seller) валидируется на соответствие формату телефонов в стране получателя (телефонный код, количество символов), а также соответствие кода оператора пулу номеров активных телефонных операторов.\n\n
**10 Вопрос:**\n\nКакую пользу приносит интеграция?\n\n**Ответ:**\n\nАвтоматизация бизнес-процессов с помощью интеграции позволит упростить работу, сэкономить средства и время, а также обрабатывать большее количество заказов. Интеграция (установка связи) происходит с обеих сторон. СДЭК предоставляет бесплатную и открытую реализацию обмена данными (API). Интернет-магазин выбирает программное решение и настраивает взаимодействие со СДЭКом на своей стороне.\n\n
**11 Вопрос:**\n\nЧто такое готовый модуль?\n\n**Ответ:**\n\nГотовое приложение/плагин.\nОптимальное решение для тех, кто:\n- пользуется CRM, CMS\n- работает через маркетплейс\n\nБывают бесплатными и платными в зависимости от выбранного модуля\nСможете подключить самостоятельно\n\n
**12 Вопрос:**\n\nЧто такое прямая интеграция через API?\n\n**Ответ:**\n\nПрямое подключение к API интеграции СДЭК без использования готовых модулей или иных программных прослоек между Вашей информационной системой и API СДЭК.\nПодойдет в случае, если у вас:\n- самописное решение\n- ваше решение значительно дорабатывалось\n\nСтоимость зависит от сложности реализации. Вы платите за работу разработчика.\nПодключение осуществляется разработчиками.\n\n
**13 Вопрос:**\n\nЗачем мне интеграция?\n\n**Ответ:**\n\nЕсли кратко, то для автоматизации, упрощения и экономии.\n\nВместо ежедневного формирования таблиц с заказами и загрузкой через личный кабинет, заказы могут отправляться в СДЭК автоматически, без вашего участия. Это позволяет интернет-магазинам значительно сэкономить время и повысить эффективность своих бизнес-процессов. Больше свободного времени и высокая эффективность работы ведут к увеличению количества заказов, которые вы можете обрабатывать и, соответственно, к росту вашей выручки.\n\n
**14 Вопрос:**\n\nСколько это стоит?\n\n**Ответ:**\n\nИнтеграция со СДЭК сама по себе абсолютно бесплатна. Вы можете настроить прямую интеграцию с API СДЭК, ваши вложения будут заключаться в стоимости разработки (время разработчика).\nЕсли вы хотите работать через готовое решение (модуль) без самостоятельной разработки, то стоимость интеграции можно оценить посмотрев на условия нужного вам модуля - некоторые полностью бесплатные, некоторые платные. В большинстве случаев вы можете настроить модуль без привлечения разработчиков.\n\n
**15 Вопрос:**\n\nЧто умеет делать «Интеграция СДЭК»?\n\n**Ответ:**\n\nПолучение списка регионов, городов и ПВЗ;\nПередача информации по заказу в систему СДЭК (создание/изменение/удаление);\nФормирование печатной формы квитанции к заказу и печать ШК-места;\nПолучение информации о заказе, в том числе где он сейчас;\nСоздание заявки на вызов курьера и регистрация даты договоренности о доставки с получателем;\nРасчет стоимости доставки: получение стоимости услуг по выбранному направлению и примерных сроков доставки.\n\n
**16 Вопрос:**\n\nПредоставляет ли СДЭК услуги программной реализации на стороне интернет-магазина? Производит ли техническая поддержка настройку модуля?\n\n**Ответ:**\n\nПрограммную реализацию вы производите самостоятельно. Мы можем порекомендовать компании-разработчиков, которые могут реализовать интеграцию для вас.\n\n
**17 Вопрос:**\n\nСуществует ли тестовый личный кабинет?\n\n**Ответ:**\n\nСуществует тестовая учетная запись интеграции на тестовой среде - ключи являются общими для всех клиентов. По этой причине зайти в тестовый ЛК СДЭК нет возможности (он является общим).\n\n
**18 Вопрос:**\n\nГде можно посмотреть пример готовой интеграции со СДЭК?\n\n**Ответ:**\n\nК сожалению, мы не ведем базу сайтов клиентов и не можем дать рекомендации к просмотру.\n\n
**19 Вопрос:**\n\nКак я смогу проверить корректность создания заказа, если нет тестового личного кабинета для клиента?\n\n**Ответ:**\n\nПри использовании тестовых ключей, заказ создается в тестовой базе данных по всем правилам. Следовательно, Вам доступны любые манипуляции с ним через API, в том числе получение полной информации о заказе.\n\n
**20 Вопрос:**\n\nМожно ли использовать API-калькулятора тарифов без договора?\n\n**Ответ:**\n\nНет, параметры учетной записи (Account и Secure) являются обязательными для работы со всеми методами актуального протокола API инетграции доставки СДЭК.\n\n
**21 Вопрос:**\n\nМожно ли использовать тестовые ключи интеграции для расчета стоимости доставки?\n\n**Ответ:**\n\nМожно, но просьба учитывать, что данные для сервисов калькулятора на тестовой среде обновляются редко, персональные скидки не учитываются, поэтому цена может отличаться от фактической стоимости.\n\n
**22 Вопрос:**\n\nAPI интеграции позволяет обмениваться данными?\n\n**Ответ:**\n\nДа, обмениваться данными между интернет-магазином и системой СДЭК возможно посредством внутреннего протокола через API интеграции доставки СДЭК.\nСДЭК предоставляет протокол обмена, уже настроенный на получение и передачу информации из своей системы. Интернет-магазину необходимо также реализовать взаимодействие своего ПО с данным протоколом.\n\n
**23 Вопрос:**\n\nМожно ли использовать одни ключи API для нескольких сайтов?\n\n**Ответ:**\n\nМожно использовать одни и те же ключи, более чем на одном сайте. Технические ограничения со стороны компании СДЭК отсутствуют. Важно учитывать, что по договору не может быть двух активных заказов с одинаковым номером заказа. Из чего следует, что на всех сайтах клиента необходима разная нумерация заказов, которая не будет пересекаться, например номера заказов будут начинаться с разных букв.\n\n
**24 Вопрос:**\n\nГде найти готовое решение (модуль/плагин/приложение) для инетграции?\n\n**Ответ:**\n\nГотовые решения для различных платформ Вы можете найти по ссылке: https://www.cdek.ru/ru/integration/modules\nЕсли там нет подходящего решения, то Вы можете разработать его самостоятельно с привлечением разработчиков и по нашей документации.\nДокументация по работе с API интеграции СДЭК: https://apidoc.cdek.ru/\n\n
**25 Вопрос:**\n\nЕсть ли интеграция СДЭК с AliExpress?\n\n**Ответ:**\n\nНа данный момент официального решения для интеграции с Aliexpress, от компании СДЭК нет.\nРекомендуем по данному вопросу обратиться в техподдержку платформы aliexpress через личный кабинет продавца.\nПо вопросам настройки рекомендуем написать на почту: russian.seller@aliexpress.com\n\n
**26 Вопрос:**\n\nКак начать работу через интеграцию?\n\n**Ответ:**\n\nОбщий план действий для интеграции с компанией СДЭК выглядит следующим образом:\n\nШаг 1: Интеграция возможна только при наличии договора (интернет-магазина или договора на оказание курьерских услуг), и если он имеет статус “Подписан” в наших системах. Поэтому, если у Вас нет договора, либо он еще не переведен в статус \"Подписан\", свяжитесь с менеджером продаж СДЭК, либо заключите договор по ссылке: https://cdek.ru/contract\n\nШаг 2: Необходимо выбрать вариант интеграции. Готовые решения для различных платформ Вы можете найти по ссылке: https://www.cdek.ru/ru/integration/modules\nЕсли ни одно из предложенных решений Вам не подойдет, то Вы можете нанять программиста (если нет в штате) и по нашей технической документации разработать интеграцию.\n\nДокументация по работе с API СДЭК: https://apidoc.cdek.ru/\n\nШаг 3: Провести программную реализацию.\n\nШаг 4: Провести тестирование с тестовыми ключами, если такая возможность предусмотрена Вашим модулем.\nДанные для тестовой учётной записи являются общими и указаны в документации по ссылке: https://apidoc.cdek.ru/#tag/Obshaya-informaciya/Podklyuchenie-k-servisu\n\nШаг 5: Получите ключи API в личном кабинете СДЭК - раздел \"Интеграция\": https://lk.cdek.ru/integration/index\n\n
**27 Вопрос:**\n\nЧем отличается физический и объемный вес?\n\n**Ответ:**\n\nРасчетный вес – вес, максимальный среди объемного и физического. Расчет стоимости услуг производится исходя из расчетного веса.\n\nОбъемный вес – расчетное значение веса, измеряется в кг. Расчет может быть произведен из указанных габаритов места по формуле д * в * ш / 5000 (для тарифов \"Сборный груз\" формула д * в * ш / 4000).\n\nФизический вес – определяется взвешиванием погрузочного места на весах. Существуют вес груза нетто и брутто. Нетто — это чистый вес груза без упаковки, а брутто — вес груза в упакованном виде.\n\n
**28 Вопрос:**\n\nКак получить тестовую учетную запись для API интеграции доставки СДЭК?\n\n**Ответ:**\n\nДанные для тестовой учётной записи являются общими и указаны в документации по ссылке: https://apidoc.cdek.ru/#tag/Obshaya-informaciya/Podklyuchenie-k-servisu\n\nУ тестовой учетной записи есть ряд ограничений:\n- При тестировании заказы не отображаются в личном кабинете клиента, так как ключи являются общими для всех клиентов.\n- Посылки для тестовых учетных записей не будут обрабатываться и доставляться.\n\nПросьба иметь в виду, что при работе с тестовыми ключами необходимо обращаться на тестовые URL:\n- тестовый хост: api.edu.cdek.ru\n\n
**29 Вопрос:**\n\nКакие требования к собственному ШК (собственная этикетка) есть со стороны СДЭК?\n\n**Ответ:**\n\nПредпочтительным для компании СДЭК является использование ее собственных ярлыков (квитанций или ШК заказа), которые можно получить через следующие методы:\n• Формирования квитанции к заказу\n• Формирование ШК-места к заказу\n\nВ случае использования собственного ярлыка он обязательно должен содержать информацию о получателе (ФИО, адрес, телефон) и любой из идентификаторов.\n\nИдентификатор посылки СДЭК:\n• В штрих-коде рекомендуется указывать номер накладной СДЭК (в формате обмена данными — это атрибут «cdek_number»).\n• Идентификатор заказа ИМ — это номер заказа в ИС Клиента (атрибут «number»).\n• Идентификатор грузоместа (упаковки) — это штрих-код упаковки (атрибут «packages.number»).\n\nВсе штрих-коды должны иметь расшифровку закодированного текста под или над штрих-кодом, чтобы иметь возможность вводить вручную закодированную информацию. Рекомендуется для печати использовать стандарт Code 128.\n\n
**30 Вопрос:**\n\nКак получить файл со списком всех ПВЗ СДЭК?\n\n**Ответ:**\n\nВыгрузки подобного плана не предусмотрены в рамках IT поддержки СДЭК.\nПри необходимости Вы можете самостоятельно выгрузить список ПВЗ со всей информацией по ним с помощью метода API интеграции СДЭК \"Список офисов\": https://apidoc.cdek.ru/#tag/delivery_point\n\nТакже Ваш менеджер СДЭК может выгрузить для Вас список ПВЗ через корпоративное ПО в разделе \"Офисы (Структура компании)\".\n\n
**31 Вопрос:**\n\nВы настраиваете интеграцию?\n\n**Ответ:**\n\nНастройка или реализация интеграции не предусмотрена в рамках IT поддержки СДЭК (даже на платной основе).\nРекомендуем по вопросам настройки, работы или доработки интеграции на своем сайте обратиться в техподдержку платформы сайта, к разработчику сайта или модуля интеграции, который планируете использовать.\nКонтакты разработчика модуля обычно указаны на странице, откуда скачивали/устанавливали модуль.\n\nВ случае если необходима базовая установка готового решения для интеграции доставки СДЭК (модуля интеграции), то такая услуга есть и она предоставляется бесплатно.\nУсловия предоставления данной услуги:\n- Установка осуществляется только тех модулей, которые указаны на странице: https://www.cdek.ru/ru/integration/modules - кроме виджета ПВЗ СДЭК.\n- Выбор подходящего решения осуществляется самостоятельно.\n- Заявки на установку принимаются только от сотрудников СДЭК.\n- Необходимо заполнить форму (взять ее у менеджера СДЭК) и передать ее менеджеру СДЭК, который, в свою очередь, сформирует заявку через Портал услуг ЭК5 в раздел \"IT поддержка\" с категорией \"Интеграция\" и темой обращения \"Установка готового решения для интеграции СДЭК в интернет-магазин\". В заявку нужно либо приложить форму, либо указать данные из нее в описании заявки.\nОтметим, что в форме каждое поле обязательно.\n\n
**32 Вопрос:**\n\nМы получили статус ACCEPTED при регистрации заказа. Почему заказ не зарегестрировался в СДЭК?\n\n**Ответ:**\n\nСтатус \"ACCEPTED\" и получение UUID в ответ на запрос на регистрацию заказа не гарантирует, что заказ создан в ИС СДЭК. Этот статус относится к запросу (запрос успешно принят), но не к заказу, и говорит о том, что запрос прошел первичные валидации и структурно составлен корректно.\nПараллельно с данным ответом заказ проходит полную валидацию. Описано в пункте документации по ссылке: https://apidoc.cdek.ru/#tag/common/Opisanie-servisa\nУзнать результат запроса можно с помощью метода \"Информация о заказе\": https://apidoc.cdek.ru/#tag/order/operation/get_2 - используя полученный в ответе entity.uuid.\nВ ответе будет, либо в первых строках присвоенный номер накладной \"cdek_number\", либо в конце будет список ошибок интеграции \"errors\".\nЕсли в заказе были ошибки, их необходимо обработать (выявить и устранить причины в теле запроса) и повторно отправить исправленный запрос методом \"Регистрация заказа\".\n\n
**33 Вопрос:**\n\nМожно ли отслеживать статусы всех заказов всех клиентов?\n\n**Ответ:**\n\nОтслеживание всех заказов доступно через сервис \"Отслеживание\" (Tracing).\nСервис \"Отслеживание\" (Tracing) предназначен для информирования клиента о статусе заказа, истории статусов.\nС помощью API отслеживания возможно получать текущие статусы и историю движения по всем заказам СДЭК.\nОсобых условий использования данного сервиса нет.\nДля предоставления доступа потребуется согласование функционального руководителя сервиса отслеживания.\nПеред запросом доступа необходимо детально изучить документацию по API отслеживания.\nСсылка на документацию: https://docs.google.com/document/d/1NOQYH6VF1fPnoZri2uX-0b8_pg-8AScqrCNBtCJHmPg/edit#heading=h.p8bz8lc2p4eb\n\nЕсли после изучения документации принято решение, что сервис подходит, то для получения доступа необходимо создать обращение на integrator@cdek.ru от заказчика с темой обращения \"Доступ к API отслеживания (Tracing)\".\nВ описании указать следующее:\n- сайт или ресурс, на котором будет использоваться сервис\n- цель использования сервиса (почему необходимо отслеживание всех заказов?)\n- email, что бы пользователя уведомляли об изменениях в трейсинге (также на него будет направлен логин/пароль)\n\nПосле получения запроса мы согласуем доступ, и в случае положительного ответа, направим данные для доступа на указанный email.\n\n
**34 Вопрос:**\n\nКак создать заказ через интеграцию с оплатой получателем за услуги доставки?\n\n**Ответ:**\n\nПри оформлении заказа через интеграцию оплата за услуги доставки всегда взимается с оформителя заказа по договору, чьи ключи интеграции использовались, в рамках условий взаиморасчета.\nДля компенсации затрат на доставку оформитель может передавать необходимость доп. сбора за доставку с получателя, который включается в наложенный платеж.\nВ методе регистрации заказа по протоколу API 2.0 для доп. сбора за доставку с получателя используются следующие поля:\n- \"delivery_recipient_cost\" - Доп. сбор за доставку, которую ИМ берет с получателя (фиксированный сбор). Сумма доп. сбора передается в атрибуте value внутри тега delivery_recipient_cost.\n- \"delivery_recipient_cost_adv\"- Доп. сбор за доставку (которую ИМ берет с получателя) в зависимости от суммы заказа (динамический сбор с настройкой порогов выкупа товаров). Сумма доп. сбора передается в атрибуте sum внутри тега delivery_recipient_cost_adv в паре с порогом стоимости выкупаемых товаров threshold.\n\nБолее подробно данные поля описаны в нашей документации по методу \"Регистрация заказа\": https://apidoc.cdek.ru/#tag/order/operation/register_1\n\n
**35 Вопрос:**\n\nОсуществляет ли СДЭК вывод маркировки (Честный знак) из оборота?\n\n**Ответ:**\n\nСДЭК несет ответственность только за наличие или отсутствие маркировки товаров в чеке. Внутреннее содержимое, а также вывод маркировки из оборота находится под ответственностью продавца.\nТо есть Вам необходимо самостоятельно проверять данные и выводить маркировку из оборота.\nБолее подробную консультацию по выводу маркировки Вы можете получить у Вашего закрепленного менеджера СДЭК, а также в техподдержке Честного знака.\n\n # Приложения\n\n## Приложение 1. Статусы заказов\n\n| **Status code** | **Code** | **Статус** | **Комментарий** |\n|-----------------|------------------------------------------------------------------------|--------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 0 | ACCEPTED | Принят | Заказ создан в информационной системе СДЭК, но требуются дополнительные валидации |\n| 1 | CREATED | Создан | Заказ зарегистрирован в базе данных СДЭК |\n| 2 | REMOVED | Удален | Заказ отменен ИМ после регистрации в системе до прихода груза на склад СДЭК в городе-отправителе |\n| 3 | RECEIVED_AT_SHIPMENT_WAREHOUSE | Принят на склад отправителя | Оформлен приход на склад СДЭК в городе-отправителе |\n| 4 | DELIVERED | Вручен | Успешно доставлен и вручен адресату (конечный статус) |\n| 5 | NOT_DELIVERED | Не вручен | Покупатель отказался от покупки, возврат в ИМ (конечный статус) |\n| 6 | READY_FOR_SHIPMENT_IN_SENDER_CITY | Готов к отправке в городе-отправителе | Оформлен расход со склада СДЭК в городе отправителя. Груз подготовлен к отправке (консолидирован с другими заказами) |\n| 7 | TAKEN_BY_TRANSPORTER_FROM_SENDER_CITY | Сдан перевозчику в городе-отправителе | Зарегистрирована отправка в городе отправителе. Консолидированный груз передан на доставку (в аэропорт/загружен машину) |\n| 8 | SENT_TO_RECIPIENT_CITY | Отправлен в город-получатель | Зарегистрирована отправка в город получателя, заказ в пути |\n| 9 | ACCEPTED_IN_RECIPIENT_CITY | Встречен в городе-получателе | Зарегистрирована встреча заказа в городе получателя |\n| 10 | ACCEPTED_AT_RECIPIENT_CITY_WAREHOUSE | Принят на склад доставки | Оформлен приход на склад города-получателя, ожидает доставки до двери |\n| 11 | TAKEN_BY_COURIER | Выдан на доставку | Добавлен в курьерскую карту, выдан курьеру на доставку |\n| 12 | ACCEPTED_AT_PICK_UP_POINT | Принят на склад до востребования | Оформлен приход на склад города-получателя. Доставка до склада, посылка ожидает забора клиентом - покупателем ИМ |\n| 13 | ACCEPTED_AT_TRANSIT_WAREHOUSE | Принят на склад транзита | Оформлен приход в городе-транзите |\n| 16 | RETURNED_TO_SENDER_CITY_WAREHOUSE | Возвращен на склад отправителя | Повторно оформлен приход в городе-отправителе (не удалось передать перевозчику по какой-либо причине).
Примечание: этот статус не означает возврат груза отправителю. |\n| 17 | RETURNED_TO_TRANSIT_WAREHOUSE | Возвращен на склад транзита | Повторно оформлен приход в городе-транзите (груз возвращен на склад).
Примечание: этот статус не означает возврат груза отправителю. |\n| 18 | RETURNED_TO_RECIPIENT_CITY_WAREHOUSE | Возвращен на склад доставки | Оформлен повторный приход на склад в городе-получателе. Доставка не удалась по какой-либо причине, ожидается очередная попытка доставки.
Примечание: этот статус не означает возврат груза отправителю |\n| 19 | READY_FOR_SHIPMENT_IN_TRANSIT_CITY | Выдан на отправку в городе-транзите | Оформлен расход в городе-транзите |\n| 20 | TAKEN_BY_TRANSPORTER_FROM_TRANSIT_CITY | Сдан перевозчику в городе-транзите | Зарегистрирована отправка у перевозчика в городе-транзите |\n| 21 | SENT_TO_TRANSIT_CITY | Отправлен в город-транзит | Зарегистрирована отправка в город-транзит. Проставлены дата и время отправления у перевозчика |\n| 22 | ACCEPTED_IN_TRANSIT_CITY | Встречен в городе-транзите | Зарегистрирована встреча в городе-транзите |\n| 27 | SENT_TO_SENDER_CITY | Отправлен в город-отправитель | Зарегистрирована отправка в город-отправитель, груз в пути |\n| 28 | ACCEPTED_IN_SENDER_CITY | Встречен в городе-отправителе | Зарегистрирована встреча груза в городе-отправителе |\n| 1000 | ENTERED_TO_TRANSIT_WAREHOUSE | Поступил в город транзита | Оформлена приемка в городе-транзите |\n| 1000 | ENTERED_TO_RECIPIENT_CITY_WAREHOUSE | Поступил на склад доставки | Оформлена приемка на складе города получателя по заказу до двери |\n| 1000 | ENTERED_TO_PICK_UP_POINT | Поступил на склад до востребования | Оформлена приемка на складе города получателя по заказу до склада |\n| 1000 | IN_CUSTOMS_INTERNATIONAL | Таможенное оформление в стране отправления | В процессе таможенного оформления в стране отправителя (для международных заказов) |\n| 1000 | SHIPPED_TO_DESTINATION | Отправлено в страну назначения | Отправлен в страну назначения, заказ в пути (для международных заказов) |\n| 1000 | PASSED_TO_TRANSIT_CARRIER | Передано транзитному перевозчику | Передано транзитному перевозчику |\n| 1000 | IN_CUSTOMS_LOCAL | Таможенное оформление в стране назначения | Таможенное оформление в стране назначения |\n| 1000 | CUSTOMS_COMPLETE | Таможенное оформление завершено | Завершено таможенное оформление заказа (для международных заказов) |\n| 1000 | POSTOMAT_POSTED | Заложен в постамат | Заложен в постамат, заказ ожидает забора клиентом - покупателем ИМ |\n| 1000 | POSTOMAT_SEIZED | Изъят из постамата курьером | Истек срок хранения заказа в постамате, возврат в ИМ s |\n| 1000 | POSTOMAT_RECEIVED | Изъят из постамата клиентом | Успешно изъят из постамата клиентом - покупателем ИМ |\n| 404 | INVALID | Некорректный заказ | Заказ содержит некорректные данные |\n\n## Приложение 2. Дополнительные статусы заказов\n\n| **Код** | **Доп. статус** | **Услуга доставки оказана (0-нет, 1- да)** | **Соответствующий статус** |\n|---------|----------------------------------------------------------------------------------|--------------------------------------------|----------------------------|\n| 1 | Возврат, неверный адрес | 0 | Не вручен |\n| 2 | Возврат, не дозвонились | 0 | Не вручен |\n| 3 | Возврат, адресат не проживает | 0 | Не вручен |\n| 4 | Возврат, не должен выполняться: вес отличается от заявленного более, чем на X г. | 0 | Не вручен |\n| 5 | Возврат, не должен выполняться: фактически нет отправления (на бумаге есть) | 0 | Не вручен |\n| 6 | Возврат, не должен выполняться: дубль номера заказа в одном акте приема-передачи | 0 | Не вручен |\n| 7 | Возврат, не должен выполняться: не доставляем в данный город/регион | 0 | Не вручен |\n| 8 | Возврат, повреждение упаковки, при приемке от отправителя | 0 | Не вручен |\n| 9 | Возврат, повреждение упаковки, у перевозчика | 0 | Не вручен |\n| 10 | Возврат, повреждение упаковки, на нашем складе/доставке у курьера | 0 | Не вручен |\n| 11 | Возврат, отказ от получения: Без объяснения | 1 | Не вручен |\n| 12 | Возврат, отказ от получения: Претензия к качеству товара | 1 | Не вручен |\n| 13 | Возврат, отказ от получения: Недовложение | 1 | Не вручен |\n| 14 | Возврат, отказ от получения: Пересорт | 1 | Не вручен |\n| 15 | Возврат, отказ от получения: Не устроили сроки | 1 | Не вручен |\n| 16 | Возврат, отказ от получения: Уже купил | 1 | Не вручен |\n| 17 | Возврат, отказ от получения: Передумал | 1 | Не вручен |\n| 18 | Возврат, отказ от получения: Ошибка оформления | 1 | Не вручен |\n| 19 | Возврат, отказ от получения: Повреждение упаковки, у получателя | 1 | Не вручен |\n| 20 | Частичная доставка | 1 | Вручен |\n| 21 | Возврат, отказ от получения: Нет денег | 1 | Не вручен |\n| 22 | Возврат, отказ от получения: Товар не подошел/не понравился | 1 | Не вручен |\n| 23 | Возврат, истек срок хранения | 0 | Не вручен |\n| 24 | Возврат, не прошел таможню | 0 | Не вручен |\n| 25 | Возврат, не должен выполняться: является коммерческим грузом | 0 | Не вручен |\n| 26 | Утерян | 0 | Не вручен |\n| 27 | Не востребован, утилизация | 0 | Не вручен |\n| 31 | Возврат, по запросу отправителя | 0 | Не вручен |\n| 32 | Возврат, по запросу плательщика | 0 | Не вручен |\n| 33 | СНТ не получено, возврат отправителю | 0 | Не вручен |\n| 34 | Передать информацию в КЛС CDEK Shopping. Истек срок хранения | 0 | Не вручен |\n\n## Приложение 3. Проблемы доставки\n\n| **Код** | **Причины** |\n|---------|------------------------------------------------|\n| 1 | Телефон неверный |\n| 9 | Груз не готов |\n| 11 | Отказ от оплаты |\n| 13 | Контактное лицо отсутствует |\n| 17 | Организация не работает |\n| 19 | Смена адреса |\n| 35 | Не успеваю |\n| 36 | Самозабор |\n| 37 | Постамат переполнен |\n| 38 | Постамат не работает |\n| 39 | Груз не влез в ячейку постамата |\n| 40 | Отказ от получения |\n| 41 | Отказ от заявки |\n| 42 | Требуется пропуск |\n| 43 | Платный въезд |\n| 44 | Закрытая территория |\n| 45 | Нет документа удостоверяющего личность |\n| 46 | Смена города |\n| 47 | Адрес не существует |\n| 48 | Доставка в А/Я |\n| 49 | Опасный груз |\n| 52 | Отказ с адреса |\n| 53 | Изменение интервала по согласованию с клиентом |\n| 54 | Постаматное приложение не работает |\n| 55 | Груз не найден |\n| 56 | Передача на ПВЗ |\n| 57 | Не могу доставить на ПВЗ |\n\n ## Приложение 4. Тарифы СДЭК\n\n**Тарифы для ИМ**\n\n| **Код** | **Название тарифа** | **Режим доставки** | **Ограничение по весу** | **Услуга** | **Описание** |\n|---------|----------------------------------------------|----------------------|--------------------------------------------------------------------------------------------------------|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 7 | Международный экспресс документы дверь-дверь | Дверь-дверь (Д-Д) | до 5 кг | Международный экспресс | Экспресс-доставка за/из-за границы документов и писем. |\n| 8 | Международный экспресс грузы дверь-дверь | Дверь-дверь (Д-Д) | до 30 кг | Международный экспресс | Экспресс-доставка за/из-за границы грузов и посылок до 30 кг. |\n| 136 | Посылка склад-склад | Склад-склад (С-С) | до 50 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 137 | Посылка склад-дверь | Склад-дверь (С-Д) | до 50 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 138 | Посылка дверь-склад | Дверь-склад (Д-С) | до 50 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 139 | Посылка дверь-дверь | Дверь-дверь (Д-Д) | до 50 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 231 | Экономичная посылка дверь-дверь | Дверь-дверь (Д-Д) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 232 | Экономичная посылка дверь-склад | Дверь-склад (Д-С) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 233 | Экономичная посылка склад-дверь | Склад-дверь (С-Д) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 234 | Экономичная посылка склад-склад | Склад-склад (С-С) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 291 | E-com Express склад-склад | Склад-склад (С-С) | до 500 кг | E-com Express | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n| 293 | E-com Express дверь-дверь | Дверь-дверь (Д-Д) | до 500 кг | E-com Express | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n| 294 | E-com Express склад-дверь | Склад-дверь (С-Д) | до 500 кг | E-com Express | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n| 295 | E-com Express дверь-склад | Дверь-склад (Д-С) | до 500 кг | E-com Express | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n| 509 | E-com Express дверь-постамат | Дверь-постамат (Д-П) | в зависимости от ограничений конкретного постамата | E-com Express | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n| 510 | E-com Express склад-постамат | Склад-постамат (С-П) | в зависимости от ограничений конкретного постамата | E-com Express | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n| 366 | Посылка дверь-постамат | Дверь-постамат (Д-П) | до 30 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 368 | Посылка склад-постамат | Склад-постамат (С-П) | до 30 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 378 | Экономичная посылка склад-постамат | Склад-постамат (С-П) | до 30 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров для компаний, осуществляющих дистанционную торговлю. |\n| 184 | E-com Standard дверь-дверь | Дверь-дверь (Д-Д) | | E-com Standard | Стандартная экспресс-доставка. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. Доступно для заказов с типом \\\"ИМ\\\" и \\\"Доставка\\\". |\n| 185 | E-com Standard склад-склад | Склад-склад (С-С) | | E-com Standard | Стандартная экспресс-доставка. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. Доступно для заказов с типом \\\"ИМ\\\" и \\\"Доставка\\\". |\n| 186 | E-com Standard склад-дверь | Склад-дверь (С-Д) | | E-com Standard | Стандартная экспресс-доставка. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. Доступно для заказов с типом \\\"ИМ\\\" и \\\"Доставка\\\". |\n| 187 | E-com Standard дверь-склад | Дверь-склад (Д-С) | | E-com Standard | Стандартная экспресс-доставка. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. Доступно для заказов с типом \\\"ИМ\\\" и \\\"Доставка\\\". |\n| 497 | E-com Standard дверь-постамат | Дверь-постамат (Д-П) | | E-com Standard | Стандартная экспресс-доставка. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. Доступно для заказов с типом \\\"ИМ\\\" и \\\"Доставка\\\". |\n| 498 | E-com Standard склад-постамат | Склад-постамат (С-П) | | E-com Standard | Стандартная экспресс-доставка. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. Доступно для заказов с типом \\\"ИМ\\\" и \\\"Доставка\\\". |\n| 2261 | Documents Express | Дверь-дверь (Д-Д) | Индивидуальные ограничения в зависимости от направления | Documents Express | Быстрая международная доставка документов |\n| 2266 | Documents Express | Дверь-постамат (Д-П) | Индивидуальные ограничения в зависимости от направления | Documents Express | Быстрая международная доставка документов |\n| 2262 | Documents Express | Дверь-склад (Д-С) | Индивидуальные ограничения в зависимости от направления | Documents Express | Быстрая международная доставка документов |\n| 2263 | Documents Express | Склад-дверь (С-Д) | Индивидуальные ограничения в зависимости от направления | Documents Express | Быстрая международная доставка документов |\n| 2267 | Documents Express | Склад-постамат (С-П) | Индивидуальные ограничения в зависимости от направления | Documents Express | Быстрая международная доставка документов |\n| 2264 | Documents Express | Склад-склад (С-С) | Индивидуальные ограничения в зависимости от направления | Documents Express | Быстрая международная доставка документов |\n| 19 | Экономичный экспресс дверь-дверь | Дверь-дверь (Д-Д) | Индивидуальные ограничения в зависимости от направления. Максимальные габариты одной стороны - 300 см | Экономичный экспресс | Экономичная доставка шин. Необходимо передавать дополнительный тип заказа \\\"10\\\" в поле additional_order_types. |\n| 2321 | Экономичный экспресс дверь-склад | Дверь-склад (Д-С) | Индивидуальные ограничения в зависимости от направления. Максимальные габариты одной стороны - 300 см | Экономичный экспресс | Экономичная доставка шин. Необходимо передавать дополнительный тип заказа \\\"10\\\" в поле additional_order_types. |\n| 2322 | Экономичный экспресс склад-дверь | Склад-дверь (С-Д) | Индивидуальные ограничения в зависимости от направления. Максимальные габариты одной стороны - 300 см | Экономичный экспресс | Экономичная доставка шин. Необходимо передавать дополнительный тип заказа \\\"10\\\" в поле additional_order_types. |\n| 2323 | Экономичный экспресс склад-склад | Склад-склад (С-С) | Индивидуальные ограничения в зависимости от направления. Максимальные габариты одной стороны - 300 см | Экономичный экспресс | Экономичная доставка шин. Необходимо передавать дополнительный тип заказа \\\"10\\\" в поле additional_order_types. |\n| 2360 | Доставка день в день | Дверь-дверь (Д-Д) | до 25 кг (не более 50 см на одну из сторон) | Доставка день в день | Забор и доставка груза курьером в течение нескольких часов без заезда на склад. Курьер после получения груза у отправителя, сразу едет к получателю. |\n| 2536 | Один офис (ИМ) | Склад-склад (С-С) | до 30 кг | Один офис (ИМ) | Услуга «Один офис (ИМ)» предоставляет возможность отправки и получения посылок в одном офисе, при условии, что офис отправителя и получателя совпадают. |\n| 358 | Фулфилмент выдача | Склад-склад (С-С) | | Фулфилмент выдача | Тариф предназначен для самовывоза/самозабора заказа со склада Фулфилмента. При выборе данного тарифа ПВЗ должен совпадать с ПВЗ склада, на котором хранится груз и собран заказ. |\n| 2483 | E-com Express. | Дверь-дверь (Д-Д) | до 500 кг | E-com Express. | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n| 2485 | E-com Express. | Склад-склад (С-С) | до 500 кг | E-com Express. | Самая быстрая экспресс-доставка в режиме авиа. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. |\n\n**Тарифы для обычной доставки**\n
По типу заказа ИМ можно использовать тарифы обычной доставки (* есть тарифы исключения)\n\n| **Код** | **Название тарифа** | **Режим доставки** | **Ограничение по весу** | **Услуга** | **Описание** |\n|---------|------------------------------------|-------------------------|-------------------------|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 3 | Супер-экспресс до 18 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 57 | Супер-экспресс до 9 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 58 | Супер-экспресс до 10 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 59 | Супер-экспресс до 12 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 60 | Супер-экспресс до 14 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 61 | Супер-экспресс до 16 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 777 | Супер-экспресс до 12 | дверь-склад (Д-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 786 | Супер-экспресс до 14 | дверь-склад (Д-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 795 | Супер-экспресс до 16 | дверь-склад (Д-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 804 | Супер-экспресс до 18 | дверь-склад (Д-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 778 | Супер-экспресс до 12 | склад-дверь (С-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 787 | Супер-экспресс до 14 | склад-дверь (С-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 796 | Супер-экспресс до 16 | склад-дверь (С-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 805 | Супер-экспресс до 18 | склад-дверь (С-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 779 | Супер-экспресс до 12 | склад-склад (С-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 788 | Супер-экспресс до 14 | склад-склад (С-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 797 | Супер-экспресс до 16 | склад-склад (С-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 806 | Супер-экспресс до 18 | склад-склад (С-С) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 722 | Супер-экспресс до 18 | склад-постамат (С-П) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за сутки). |\n| 62 | Магистральный экспресс склад-склад | склад-склад (С-С) | | Экономичная доставка | Быстрая экономичная доставка грузов. |\n| 121 | Магистральный экспресс дверь-дверь | дверь-дверь (Д-Д) | | Экономичная доставка | Быстрая экономичная доставка грузов. |\n| 122 | Магистральный экспресс склад-дверь | склад-дверь (С-Д) | | Экономичная доставка | Быстрая экономичная доставка грузов. |\n| 123 | Магистральный экспресс дверь-склад | дверь-склад (Д-С) | | Экономичная доставка | Быстрая экономичная доставка грузов. |\n| 480 | Экспресс дверь-дверь | дверь-дверь (Д-Д) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 481 | Экспресс дверь-склад | дверь-склад (Д-С) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 482 | Экспресс склад-дверь | склад-дверь (С-Д) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 483 | Экспресс склад-склад | склад-склад (С-С) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 485 | Экспресс дверь-постамат | дверь-постамат (Д-П) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 486 | Экспресс склад-постамат | склад-постамат (С-П) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 605 | Экспресс постамат-дверь | постамат-дверь (П-Д) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 606 | Экспресс постамат-склад | постамат-склад (П-С) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 607 | Экспресс постамат-постамат | постамат-постамат (П-П) | | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу |\n| 748 | Сборный груз дверь-дверь | дверь-дверь (Д-Д) | от 60 кг до 100.000 кг | Сборный груз | Экономичная наземная доставка сборных грузов. Для создания заказа с тарифом \"Сборный груз\", обязательна передача доп. типа заказа с кодом \"2\" - \"Сборный груз\". |\n| 749 | Сборный груз дверь-склад | дверь-склад (Д-С) | от 60 кг до 100.000 кг | Сборный груз | Экономичная наземная доставка сборных грузов. Для создания заказа с тарифом \"Сборный груз\", обязательна передача доп. типа заказа с кодом \"2\" - \"Сборный груз\". |\n| 750 | Сборный груз склад-дверь | склад-дверь (С-Д) | от 60 кг до 100.000 кг | Сборный груз | Экономичная наземная доставка сборных грузов. Для создания заказа с тарифом \"Сборный груз\", обязательна передача доп. типа заказа с кодом \"2\" - \"Сборный груз\". При создании заказов с режимом \"от склада\", офис отправителя обязательно должен быть передан.|\n| 751 | Сборный груз склад-склад | склад-склад (С-С) | от 60 кг до 100.000 кг | Сборный груз | Экономичная наземная доставка сборных грузов. Для создания заказа с тарифом \"Сборный груз\", обязательна передача доп. типа заказа с кодом \"2\" - \"Сборный груз\". При создании заказов с режимом \"от склада\", офис отправителя обязательно должен быть передан.|\n| 676 | Супер-экспресс до 10.00 | дверь-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 677 | Супер-экспресс до 10.00 | дверь-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 678 | Супер-экспресс до 10.00 | склад-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 679 | Супер-экспресс до 10.00 | склад-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 686 | Супер-экспресс до 12.00 | дверь-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 687 | Супер-экспресс до 12.00 | дверь-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 688 | Супер-экспресс до 12.00 | склад-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 689 | Супер-экспресс до 12.00 | склад-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 696 | Супер-экспресс до 14.00 | дверь-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 697 | Супер-экспресс до 14.00 | дверь-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 698 | Супер-экспресс до 14.00 | склад-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 699 | Супер-экспресс до 14.00 | склад-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 706 | Супер-экспресс до 16.00 | дверь-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 707 | Супер-экспресс до 16.00 | дверь-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 708 | Супер-экспресс до 16.00 | склад-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 709 | Супер-экспресс до 16.00 | склад-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 716 | Супер-экспресс до 18.00 | дверь-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 717 | Супер-экспресс до 18.00 | дверь-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 718 | Супер-экспресс до 18.00 | склад-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 719 | Супер-экспресс до 18.00 | склад-склад | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» к определенному часу (доставка за 1-2 суток). |\n| 533 | СДЭК документы дверь-дверь | Дверь-дверь (Д-Д) | 0.5 кг | СДЭК документы | Экспресс доставка документов со спец. условием от 90 документов за 90 дней. Доступно только для заказов с типом \\\"доставка\\\". |\n| 534 | СДЭК документы дверь-склад | Дверь-склад (Д-С) | 0.5 кг | СДЭК документы | Экспресс доставка документов со спец. условием от 90 документов за 90 дней. Доступно только для заказов с типом \\\"доставка\\\". |\n| 535 | СДЭК документы склад-дверь | Склад-дверь (С-Д) | 0.5 кг | СДЭК документы | Экспресс доставка документов со спец. условием от 90 документов за 90 дней. Доступно только для заказов с типом \\\"доставка\\\". |\n| 536 | СДЭК документы склад-склад | Склад-склад (С-С) | 0.5 кг | СДЭК документы | Экспресс доставка документов со спец. условием от 90 документов за 90 дней. Доступно только для заказов с типом \\\"доставка\\\". |\n| 2536 | Один офис (ИМ) | Склад-склад (С-С) | до 30 кг | Один офис (ИМ) | Услуга «Один офис (ИМ)» предоставляет возможность отправки и получения посылок в одном офисе, при условии, что офис отправителя и получателя совпадают. |\n| 358 | Фулфилмент выдача | Склад-склад (С-С) | | Фулфилмент выдача | Тариф предназначен для самовывоза/самозабора заказа со склада Фулфилмента. При выборе данного тарифа ПВЗ должен совпадать с ПВЗ склада, на котором хранится груз и собран заказ. |\n\n## Приложение 5. Форма собственности\n\n| **Код** | **Форма собственности** |\n|---------|----------------------------------------------|\n| 9 | Акционерное общество |\n| 61 | Закрытое акционерное общество |\n| 63 | Индивидуальный предприниматель |\n| 119 | Открытое акционерное общество |\n| 137 | Общество с ограниченной ответственностью |\n| 147 | Публичное акционерное общество |\n| 179 | Товарищество с ограниченной ответственностью |\n \n## Приложение 6. Дополнительные услуги\n\n| **Код услуги** | **Название** | **Описание** |\n|---------------------------------------|---------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| INSURANCE | СТРАХОВАНИЕ | Обеспечение страховой защиты посылки.
Для заказов типа \"Интернет-магазин\" размер дополнительного сбора страхования вычисляется от размера объявленной стоимости отправления и услуга начисляется автоматически, не разрешена для самостоятельной передачи в поле services.code.
Для заказов типа \"Доставка\", если услуга не передана пользователем в services.code, добавляется автоматически с параметром services.parameter = 1. Данное значение будет обработано системой так, что страховка будет бесплатной. Однако, рекомендуем передавать реальные значения объявленной стоимости отправления. |\n| TAKE_SENDER | ЗАБОР В ГОРОДЕ ОТПРАВИТЕЛЕ | Дополнительный сервис по забору грузов от клиента до офиса СДЭК внутри города в рамках перевозки по \\\"Сборному грузу (LTL)\\\". Дополнительная услуга забора груза в городе отправителя, при условии, что тариф доставки с режимом «от склада» (не доступна для тарифов Посылка) |\n| DELIV_RECEIVER | ДОСТАВКА В ГОРОДЕ ПОЛУЧАТЕЛЕ | Дополнительная услуга доставки груза в городе получателя, при условии, что тариф доставки с режимом «до склада» (только для тарифа «Сборный груз»). Не применимо к заказам до постаматов. |\n| TRYING_ON | ПРИМЕРКА | Курьер доставляет покупателю несколько единиц товара (одежда, обувь и пр.) для примерки. Только для клиентов с договором типа ИМ. Не применима в одном заказе с дополнительной услугой «Запрет осмотра вложения». Не применимо к заказам до постаматов. |\n| PART_DELIV | ЧАСТИЧНАЯ ДОСТАВКА | Во время доставки товара покупатель может отказаться от одной или нескольких позиций, и выкупить только часть заказа. Если в заказе указано одно вложение, услуга не подключается (проверку невозможно добавить без Фото). Не применимо к заказам до постаматов и доступно только для ИМ. |\n| DANGER_CARGO | ОПАСНЫЙ ГРУЗ | Кроме обычных документов и грузов, компания СДЭК готова доставить отправления, содержащие опасные грузы (кроме запрещенных к перевозке). В связи с определенным риском стоимость доставки грузов, относящихся к категории опасных, увеличивается в 1,5 раза. |\n| SMS | Уведомление о вручении заказа | Компания СДЭК предлагает каждому клиенту оформить услугу \\\"СМС-уведомление о доставке\\\".
Отправителю высылается сообщение с датой и временем доставки. Стоимость услуги 10 рублей.
Отправитель получает СМС-сообщение с информацией о дате/времени доставки и ФИО получателя. При режиме доставки до склада и указании мобильного телефона получателя, Компания \\\"СДЭК\\\" предоставляет всем клиентам бесплатную услугу: \\\"СМС-уведомление о приходе груза на склад\\\" или уведомления в виде PUSH-сообщений в мобильное приложение СДЭК или в месседжеры. Получателю будет отправлено сообщение с информацией об адресе забора отправления и времени работы офиса. |\n| THERMAL_MODE | Тепловой режим | Услуга доступна только с режимом доставки склад-склад. Направления, по которым возможна доставка с тепловым режимом: Кемерово-Новокузнецк, Новосибирск-Красноярск, Новосибирск-Кемерово, Новосибирск-Томск, Новосибирск-Омск, Новосибирск-Барнаул, Барнаул-Горно-Алтайск И В ОБРАТНЫХ НАПРАВЛЕНИЯХ! |\n| COURIER_PACKAGE_A2 | Пакет курьерский А2 | Стоимость — 70 руб. |\n| PACKAGE_A_2_LIGHT_EXPRESS | Пакет курьерский «Лайт» А2 (белый) | Курьерский пакет без дизайна (белый) из влагонепроницаемого многослойного полиэтилена. |\n| PACKAGE_A_3_LIGHT_EXPRESS | Пакет курьерский «Лайт» А3 (белый) | Курьерский пакет без дизайна (белый) из влагонепроницаемого многослойного полиэтилена. |\n| PACKAGE_A_4_LIGHT_EXPRESS | Пакет курьерский «Лайт» А4 (белый) | Курьерский пакет без дизайна (белый) из влагонепроницаемого многослойного полиэтилена. |\n| PACKAGE_A_5_LIGHT_EXPRESS | Пакет курьерский «Лайт» А5 (белый) | Курьерский пакет без дизайна (белый) из влагонепроницаемого многослойного полиэтилена. |\n| NOTIFY_ORDER_CREATED | Уведомление о создании заказа в СДЭК | Уведомление получателя по СМС о создании заказа в СДЭК.
Применяется при создании заказа.
Страны города получателя: Россия, Казахстан, Беларусь.
При добавлении доп. услуги, номер для уведомлений будет браться из переданных данных получателя. Актуальную стоимость уточняйте у закреплённого менеджера. |\n| NOTIFY_ORDER_DELIVERY | Уведомление о приеме заказа на доставку | СМС-оповещение о доставке на мобильный телефон. Страны города получателя: Россия, Казахстан, Беларусь. При добавлении доп. услуги, номер для уведомлений будет браться из переданных данных получателя. Актуальную стоимость уточняйте у закреплённого менеджера. |\n| CARTON_BOX_XS | Коробка XS (0,5 кг 17х12х9 см) | Коробка из трехслойного гофрокартона размером 170x125x95 мм. Максимальная вместимость - 0,5 кг.
Доступные режимы: склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_S_2_KILOS | Коробка S (2 кг 23х19х10 см) | Коробка из трехслойного гофрокартона размером 230x190x100 мм. Максимальная вместимость - 2 кг.
Доступные режимы: склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_M | Коробка M (5 кг 33х25х15 см) | Коробка из трехслойного гофрокартона размером 330x250x155 мм. Максимальная вместимость - 5 кг.
Доступные режимы: склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_2KG | Коробка (2 кг 34х24х10 см) | Коробка из трехслойного гофрокартона размером 340x240x100 мм. Максимальная вместимость - 2 кг.
Доступные режимы: дверь-дверь, дверь-склад, склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_3KG | Коробка (3 кг 24х24х21 см) | Коробка из трехслойного гофрокартона размером 240x240x210 мм. Максимальная вместимость - 3 кг.
Доступные режимы: дверь-дверь, дверь-склад, склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_5KG | Коробка (5 кг 40х24х21 см) | Коробка из трехслойного гофрокартона размером 400x240x210 мм. Максимальная вместимость - 5 кг.
Доступные режимы: дверь-дверь, дверь-склад, склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_10KG | Коробка (10 кг 40х35х28 см) | Коробка из трехслойного гофрокартона размером 400x350x280 мм. Максимальная вместимость - 10 кг.
Доступные режимы: склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_L_12_KILOS | Коробка (12 кг 31х25х38 см) | Коробка из трехслойного гофрокартона размером 310x250x380 мм. Максимальная вместимость - 12 кг.
Доступные режимы: склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_XL_18_KILOS | Коробка (18 кг 60х35х30см) | Коробка из трехслойного гофрокартона размером 600x350x300 мм. Максимальная вместимость - 18 кг.
Доступные режимы: склад-дверь, склад-склад, склад-постамат |\n| CARTON_BOX_20KG | Коробка (20 кг 47х40х43 см) | Коробка из трехслойного гофрокартона размером 470x400x430 мм. Максимальная вместимость - 20 кг.
Доступные режимы: склад-дверь, склад-склад |\n| CARTON_BOX_30KG | Коробка (30 кг 69х39х42 см) | Коробка из трехслойного гофрокартона размером 690x390x420 мм. Максимальная вместимость - 30 кг.
Доступные режимы: склад-дверь, склад-склад |\n| BUBBLE_WRAP | Воздушно-пузырчатая пленка | Полиэтилен высокого давления, двухслойный. Является дополнительным упаковочным материалом для упаковки отправлений в транспортную упаковку.
Доступна для всех тарифов от склада. |\n| WASTE_PAPER | Макулатурная бумага | Упаковочная бумага (макулатурная, класса Е). Ширина 0,42 м.
Предназначена для упаковки различных видов отправлений (грузов) и заполнения пустот внутри упаковки.
Доступные режимы: дверь-дверь, дверь-склад, склад-дверь, склад-склад, дверь-постамат, склад-постамат |\n| CARTON_FILLER | Прессованный картон \\\"филлер\\\" (55х14х2,3 см) | Вставка защитная из листового прессованного картона.
Применяется для:
- внутренней обрешетки внутри гофрокороба
- оборачивания и разделения вложений внутри гофрокороба
- заполнения пустот.
Доступна для всех тарифов от склада. |\n| XL_BOX_INNER_CRATE | Внутренняя обрешётка \\\"Коробка XL\\\" | Вставка защитная (амортизационный картонный каркас), вкладывается внутрь коробки. Каркас сконструирован для конкретной коробки \\\"Коробка (18 кг 60х35х30см)\\\". Данную доп. услугу необходимо передавать только в паре с соответсвующей коробкой CARTON_BOX_XL_18_KILOS |\n| 20_KG_BOX_INNER_CRATE | Внутренняя обрешётка \\\"Коробка Вес до 20кг\\\" | Вставка защитная (амортизационный картонный каркас), вкладывается внутрь коробки. Каркас сконструирован для конкретной коробки \\\"Коробка (20 кг 47х40х43 см)\\\". Данную доп. услугу необходимо передавать только в паре с соответсвующей коробкой CARTON_BOX_20KG |\n| 30_KG_BOX_INNER_CRATE | Внутренняя обрешётка \\\"Коробка Вес до 30кг\\\" | Вставка защитная (амортизационный картонный каркас), вкладывается внутрь коробки. Каркас сконструирован для конкретной коробки \\\"Коробка (30 кг 69х39х42 см)\\\". Данную доп. услугу необходимо передавать только в паре с соответсвующей коробкой CARTON_BOX_30KG |\n| BAN_ATTACHMENT_INSPECTION | Запрет осмотра вложения | Предоставляет возможность запрета осмотра вложения. Предоставляется для интернет-магазинов. Не совместима с доп.услугами \\\"Примерка на дому\\\" и \\\"Частичная доставка\\\". Услуга не передается до постамата.Только для клиентов с договором типа ИМ. Стоимость - 0 рублей. |\n| GET_UP_FLOOR_BY_HAND | Подъём на этаж (по лестнице) | Ручной подъем на этаж, есть доп. параметр - количество этажей. Услуга предоставляется при необходимости подъёма на этаж крупногабаритных и тяжёлых отправлений (весом от 10 кг). (ограничение 150 кг) |\n| DESCENT_FROM_THE_FLOOR | Спуск с этажа ручной (по лестнице) | Ручной спуск с этажа, есть доп. параметр - количество этажей. Услуга предоставляется при необходимости спуска с этажа крупногабаритных и тяжёлых отправлений (весом от 10 кг). (ограничение 150 кг) |\n| GET_UP_FLOOR_BY_ELEVATOR | Подъём на этаж (на лифте) | Подъем на лифте на этаж, без доп. параметра. Услуга предоставляется при необходимости подъёма на этаж крупногабаритных и тяжёлых отправлений (весом от 10 кг). (ограничение 150 кг) |\n| ADULT_GOODS | 18+ | Сервис проверки возраста получателя (товары 18+). Услуга предлагается в доступных только при наличии в договоре признака 18+ |\n| LOADING_OPERATIONS_AT_THE_SENDER | Погрузо-разгрузочные работы у отправителя | Погрузка и разгрузка по адресу клиента.
Доп. услуга доступна только для тарифов:
Магистральный супер-экспресс
Магистральный экспресс
Сборный груз
Экономичная посылка
Экспресс |\n| LOAD_THE_OPERATION_AT_THE_RECIPIENT | Погрузо-разгрузочные работы у получателя | Погрузка и разгрузка по адресу клиента, если вес грузовых мест не превышает 80 кг.
Доп. услуга доступна только для тарифов:
Магистральный супер-экспресс
Магистральный экспресс
Сборный груз
Экономичная посылка
Экспресс |\n| GREEN_ENVELOPE_CDEK | Конверт (картон, А4) | Конверт зеленый CDEK |\n| COURIER_SERVICE | Аренда курьера у отправителя | Аренда курьера у отправителя |\n| CUSTOMS_CLEARANCE | Таможенное оформление | Таможенное оформление в рамках сервиса международной доставки грузов В2В. Начисляется автоматически при создании международных заказов с тарифами \"Business Standard\"/\"Business Express\". |\n| ANOTHER | Прочее | Услуга по добавлению дополнительных сервисов, начисляется менеджером СДЭК. Не разрешена для самостоятельной передачи в поле services.code. |\n| SMS_NOTIFICATIONS_FOR_THE_RECIPIENT | СМС-уведомление о прибытии заказа | СМС-уведомление о прибытии заказа для получателя. Доступна для заказов с типом \"ИМ\". |\n| SMS_NOTIFICATIONS_FOR_EXPIRATION_DATE | СМС-уведомление об окончании срока хранения | СМС-уведомление об окончании срока хранения для получателя. Доступна для заказов с типом \"ИМ\". |\n| EXP_REGIST_WITH_DOC\t | Экспортное таможенное оформление (с документами)\t| Экспортное таможенное оформление (с пакетом документов)\t|\n| EXP_REGIST_WITHOUT_DOC\t | Экспортное таможенное оформление (без документов)\t| Экспортное таможенное оформление (без пакета документов)\t|\n| EXP_REGIST\t | Экспортное таможенное оформление\t | Экспортное таможенное оформление\t |\n| CUSTOM_CLEARENCE_FOR_LAST_MILE_B2B_200 | ТО для последней мили B2B 200-\t | ТО для последней мили B2B 200-\t |\n| CUSTOMS_CLEARANCE_FOR_THE_LAST_MILE\t | ТО для последней мили\t | ТО для последней мили\t |\n| CUSTOM_CLEARENCE_FOR_LAST_MILE_B2B_200469\t| ТО для последней мили B2B 200+\t | ТО для последней мили B2B 200+\t |\n| CUSTOM_CLEARENCE_FOR_B2B_1000_EXPORT\t | Таможенное оформление B2B 1000+ экспорт\t | Таможенное оформление B2B 1000+ экспорт\t |\n| CUSTOM_CLEARENCE_FOR_B2B_200_IMPORT\t | Таможенное оформление B2B 200+ импорт\t | Таможенное оформление B2B 200+ импорт\t |\n| SELF_CLEARING_CUSTOMS_FOR_B2B_EXPORT\t | Самостоятельное таможенное оформление B2B экспорт\t| Самостоятельное таможенное оформление B2B экспорт\t |\n| SELF_CLEARING_CUSTOMS_FOR_B2B_IMPORT\t | Самостоятельное таможенное оформление B2B импорт\t| Самостоятельное таможенное оформление B2B импорт\t |\n| PHOTO_OF_DOCUMENTS \t | Фото документов \t| Предназначена для выполнения доставок продуктов (грузы, документы), с идентификацией получателя, фотографированием товара клиента/подписанных документов\t |\n| BOX_LINER_FOR_1_BOTTLE_UNIVERSAL | Вкладыш для 1 бутылки (до 1 л.) \t| Вкладыш для 1 бутылки (универсальный)\t |\n| BOX_FOR_1_BOTTLE_3KG15X14X38CM | Коробка для 1 бутылки (3кг 15х14х38см) \t| Короб для 1 бутылки (3кг 15х14х38см)\t |\n| DOCUMENT_BOX_6KG36X29X7CM | Коробка Вес до 6кг (6кг 36х29х7см) \t| Коробка Вес до 6кг (6кг 36х29х7см)\t |\n| BOX_LIGHT_3KILOS35X25X12CM | Коробка Лайт 4 (3кг 35х25х12см) \t| Короб Лайт 35х25х12 (3 кг)\t |\n| BOX_LIGHT_8KILOS60X40X40CM | Коробка Лайт 1 (8кг 60х40х40см) \t| Короб Лайт 60х40х40 (8 кг)\t |\n\n **Дополнительные услуги не подключаемые через интеграцию**\n\n| **Код услуги** | **Добавление в заказе** | **Название** | **Описание** |\n|----------------|-----------------------------------|--------------------------|---------------------------------------------------------------------------------------|\n| 42 | Не подключается через интеграцию | Агентское вознаграждение | Выбрать нельзя. Добавляется к заказу, если она передана. Связана с атрибутом \\\"price\\\". |\n| 20 | Не подключается через интеграцию | Пеня | Выбрать нельзя. Насчитывается на созданный заказ. |\n\n## Приложение 7. Код материала товара\n\n| **Код** | **Название материала** |\n|---------|------------------------|\n| 1 | Полиэстер |\n| 2 | Нейлон |\n| 3 | Флис |\n| 4 | Хлопок |\n| 5 | Текстиль |\n| 6 | Лён |\n| 7 | Вискоза |\n| 8 | Шелк |\n| 9 | Шерсть |\n| 10 | Кашемир |\n| 11 | Кожа |\n| 12 | Кожзам |\n| 13 | Искусственный мех |\n| 14 | Замша |\n| 15 | Полиуретан |\n| 16 | Спандекс |\n| 17 | Резина |\n\n## Приложение 8. Причины недозвона\n\n| **Код** | **Причины** |\n|---------|-------------------------|\n| 1 | Телефон занят |\n| 2 | Абонент не берет трубку |\n| 3 | Абонент недоступен |\n| 4 | Неверный номер |\n| 5 | Телефон не указан |\n| 6 | «Тишина» |\n| 7 | Сброс |\n| 8 | Бросил трубку |\n\n## Приложение 9. Статусы заявок\n\n| **Код** | **Название статуса** | **Комментарий** |\n|-----------------------|----------------------|-------------------------------------------------------------------------------------|\n| ACCEPTED | Принят | Заявка создана в информационной системе СДЭК, но требуются дополнительные валидации |\n| CREATED | Создан | Заявка создана в информационной системе СДЭК и прошла необходимые валидации |\n| REMOVED | Отменена | Заявка отменена ИМ после регистрации в системе |\n| READY_FOR_APPOINTMENT | Готова к назначению | Заявка готова к назначению |\n| APPOINTED_COURIER | Назначен курьер | По заявке назначен курьер |\n| DONE | Выполнена | Заявка выполнена |\n| PROBLEM_DETECTED | Выявлена проблема | По заявке выявлена проблема |\n| PROCESSING_REQUIRED | Требует обработки | Заявка создана в информационной системе СДЭК, но требуется дополнительная обработка |\n| INVALID | Некорректная заявка | Заявка содержит некорректные данные |\n\n## Приложение 10. Статусы квитанции\n\n| **Код** | **Название статуса** | **Комментарий** |\n|---------------|----------------------|-------------------------------------------------------------|\n| ACCEPTED | Принят | Запрос на формирование квитанции принят |\n| PROCESSING | Формируется | Файл с квитанцией формируется |\n| READY | Сформирован | Файл с квитанцией и ссылка на скачивание файла сформированы |\n| REMOVED | Удален | Истекло время жизни ссылки на скачивание файла с квитанцией |\n| INVALID | Некорректный запрос | Некорректный запрос на формирование квитанции |\n\n## Приложение 11. Статусы ШК места\n\n| **Код** | **Название статуса** | **Комментарий** |\n|------------|----------------------|-----------------------------------------------------------|\n| ACCEPTED | Принят | Запрос на формирование ШК места принят |\n| PROCESSING | Формируется | Файл с ШК места формируется |\n| READY | Сформирован | Файл с ШК места и ссылка на скачивание файла сформированы |\n| REMOVED | Удален | Истекло время жизни ссылки на скачивание файла с ШК места |\n| INVALID | Некорректный запрос | Некорректный запрос на формирование ШК места |\n\n## Приложение 12. Статусы договоренности о доставке\n\n| **Код** | **Название статуса** | **Комментарий** |\n|------------|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ACCEPTED | Принята | Договоренность создана в информационной системе СДЭК, но требуются дополнительные проверки |\n| PROCESSING | Зарегистрирована | Договоренность прошла необходимые проверки на возможность осуществления доставки в оговоренное время, место |\n| INVALID | Некорректна | Договоренность содержит некорректные данные |\n| CANCEL | Аннулирована | \\t• Договоренность аннулирована из-за появления новой договоренности (поступление новой согласованной доставки)
• Изменение параметров заказа: режим, офис получателя, город получателя, адрес получателя |\n\n## Приложение 13. Ответ на запрос получения списка офисов\n\n| **Название поля** | **Описание** | **Тип поля** |\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| owner_code | Принадлежность офиса компании:
CDEK— офис принадлежит компании СДЭК
Градусы — офис принадлежит компании Градусы
Телепорт — офис принадлежит компании Телепорт
Tastamat — офис принадлежит компании Tastamat
Халва — офис принадлежит компании Халва
PickPoint — офис принадлежит компании PickPoint
OmniCDEK — офис принадлежит компании OmniCDEK
OmniCDEK (franchise) — офис принадлежит компании OmniCDEK (франчайзи)
OmniCDEK (self-employed) — офис принадлежит компании OmniCDEK (самозанятые)
\\\"Нет бренда\\\" — офис принадлежит компании без бренда | | \n\n ## Приложение 14. Код валюты для методов расчета стоимости\n\n| **Код** | **Валюта** | **Код валюты** |\n|---------|-------------------|-----------------|\n| 1 | Российский рубль | RUB | \n| 2 | Тенге | KZT |\n| 3 | Доллар США | USD | \n| 4 | Евро | EUR | \n| 5 | Фунт Стерлингов | GBP | \n| 6 | Китайский юань | CNY | \n| 7 | Белорусский рубль | BYR | \n| 8 | Гривна | UAH | \n| 9 | Киргизский сом | KGS | \n| 10 | Армянский драм | AMD | \n| 11 | Турецкая лира | TRY | \n| 12 | Тайский бат | THB | \n| 13 | Вон | KRW | \n| 14 | Дирхам | AED | \n| 15 | Узбекский сум | UZS | \n| 16 | Тугрик | MNT | \n| 17 | Злотый | PLN | \n| 18 | Манат | AZN | \n| 19 | Лари | GEL | \n| 55 | Йена | JPY | \n| 704 | Вьетнамский донг | VND | \n\n \n## Приложение 15. Режимы доставки\n\n| **Код** | **Режим** | \n|---------|-------------------|\n| 1 | дверь-дверь |\n| 2 | дверь-склад |\n| 3 | склад-дверь | \n| 4 | склад-склад |\n| 6 | дверь-постамат | \n| 7 | склад-постамат |\n| 8 | постамат-дверь | \n| 9 | постамат-склад | \n| 10 | постамат-постамат | ",
"x-displayName" : "Общая информация"
}, {
"name" : "auth",
"description" : "API для получения токена авторизации",
"x-displayName" : "Авторизация в сервисе"
}, {
"name" : "location",
"description" : "API для работы с локациями",
"x-displayName" : "Получение списка локаций"
}, {
"name" : "delivery_point",
"description" : "API для работы с офисами",
"x-displayName" : "Офисы",
"x-sortOrder" : 1
}, {
"name" : "calculator",
"description" : "API для работы с калькулятором",
"x-displayName" : "Расчет стоимости доставки",
"x-sortOrder" : 2
}, {
"name" : "restriction_hints",
"description" : "API для проверки ограничений по международным заказам",
"x-displayName" : "Ограничения международных заказов",
"x-sortOrder" : 3
}, {
"name" : "order",
"description" : "",
"x-displayName" : "Заказ",
"x-sortOrder" : 4
}, {
"name" : "schedule",
"description" : "",
"x-displayName" : "Договоренность о доставке",
"x-sortOrder" : 5
}, {
"name" : "intake",
"description" : "",
"x-displayName" : "Заявка на вызов курьера",
"x-sortOrder" : 6
}, {
"name" : "prealert",
"description" : "API для работы с преалертами",
"x-displayName" : "Преалерт",
"x-sortOrder" : 7
}, {
"name" : "print",
"description" : " ",
"x-displayName" : "Печатная форма накладной и ШК",
"x-sortOrder" : 8
}, {
"name" : "registries",
"description" : "Информация о реестрах наложенных платежей",
"x-displayName" : "Наложенные платежи",
"x-sortOrder" : 9
}, {
"name" : "passport",
"description" : "API получения инфо о паспортных данных",
"x-displayName" : "Паспортные данные",
"x-sortOrder" : 10
}, {
"name" : "receipt",
"description" : "API протокола для работы с чеками",
"x-displayName" : "Чеки",
"x-sortOrder" : 11
}, {
"name" : "reverse",
"description" : "API для работы с реверсом",
"x-displayName" : "Реверс",
"x-sortOrder" : 12
}, {
"name" : "photo",
"description" : "API для получения фото",
"x-displayName" : "Фото документов",
"x-sortOrder" : 13
}, {
"name" : "webhook",
"description" : "API для работы с вебхуками.
Подробное описание структуры вебхуков содержится в разделе Общая информация. Описание структуры вебхуков. ",
"x-displayName" : "Вебхуки"
} ],
"paths" : {
"/v2/oauth/token" : {
"post" : {
"tags" : [ "auth" ],
"summary" : "Получение токена авторизации",
"description" : "Взаимодействие с сервисом требует клиентской авторизации. Авторизация обеспечивается с применением протокола OAuth 2.0. Метод предназначен для получения токена авторизации.",
"operationId" : "getOAuthToken",
"parameters" : [ {
"name" : "grant_type",
"in" : "query",
"description" : "Тип аутентификации. Доступное значение: client_credentials",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "client_credentials"
}, {
"name" : "client_id",
"in" : "query",
"description" : "Идентификатор клиента",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "skhfkjdh65874jkhhdfk8598"
}, {
"name" : "client_secret",
"in" : "query",
"description" : "Секретный ключ клиента",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "snckdshfkj47jksfnhjshdvcshj"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/AuthResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ErrorDto"
}
}
}
}
}
}
},
"/v2/location/suggest/cities" : {
"get" : {
"tags" : [ "location" ],
"summary" : "Подбор локации по названию города",
"description" : "Метод позволяет получать подсказки по подбору населенного пункта по его наименованию.
\n Список населенных пунктов может быть ограничен характеристиками, задаваемыми пользователем.",
"operationId" : "suggestCities",
"parameters" : [ {
"name" : "name",
"in" : "query",
"description" : "Наименование населенного пункта СДЭК",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "Москва"
}, {
"name" : "country_code",
"in" : "query",
"description" : "Код страны в формате ISO_3166-1_alpha-2",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "RU"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SuggestCityResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/location/regions" : {
"get" : {
"tags" : [ "location" ],
"summary" : "Получение списка регионов",
"description" : "Метод предназначен для получения детальной информации о регионах.
\nСписок регионов может быть ограничен характеристиками, задаваемыми пользователем.",
"operationId" : "regions",
"parameters" : [ {
"name" : "country_codes",
"in" : "query",
"description" : "Список кодов стран в формате ISO_3166-1_alpha-2",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "[RU, EN]"
}, {
"name" : "fias_region_guid",
"in" : "query",
"description" : "Уникальный идентификатор ФИАС региона. Устаревшее поле",
"required" : false,
"deprecated" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"example" : "dd71e526-d850-46db-97db-164391414c5b"
}, {
"name" : "size",
"in" : "query",
"description" : "Ограничение выборки результата. По умолчанию 1000. Обязателен, если указан page",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"example" : 15
}, {
"name" : "page",
"in" : "query",
"description" : "Номер страницы выборки результата. По умолчанию 0",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"example" : 5
}, {
"name" : "lang",
"in" : "query",
"description" : "Локализация. По умолчанию rus (доступны eng и zho)",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "RU"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/RegionsResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/location/postalcodes" : {
"get" : {
"tags" : [ "location" ],
"summary" : "Получение почтовых индексов города",
"description" : "Метод предназначен для получения списка почтовых индексов.",
"operationId" : "postalcodes",
"parameters" : [ {
"name" : "code",
"in" : "query",
"description" : "Код города, которому принадлежат почтовые индексы",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"example" : 44
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/PostcodesResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/location/coordinates" : {
"get" : {
"tags" : [ "location" ],
"summary" : "Получение локации по координатам",
"description" : "Метод позволяет определить локацию по переданным в запросе координатам",
"operationId" : "getCityByCoordinates",
"parameters" : [ {
"name" : "latitude",
"in" : "query",
"description" : "Широта",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "number",
"nullable" : false
},
"example" : 44.7594235
}, {
"name" : "longitude",
"in" : "query",
"description" : "Долгота",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "number",
"nullable" : false
},
"example" : 55.7594235
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/V2LocationCityByCoordinatesDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/location/cities" : {
"get" : {
"tags" : [ "location" ],
"summary" : "Получение списка населенных пунктов",
"description" : "Метод предназначен для получения детальной информации о населенных пунктах.
\n Список населенных пунктов может быть ограничен характеристиками, задаваемыми пользователем.",
"operationId" : "cities",
"parameters" : [ {
"name" : "country_codes",
"in" : "query",
"description" : "Массив кодов стран в формате ISO_3166-1_alpha-2",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "[RU, EN]"
}, {
"name" : "region_code",
"in" : "query",
"description" : "Код региона (справочник СДЭК)",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"example" : 152
}, {
"name" : "kladr_region_code",
"in" : "query",
"description" : "Код КЛАДР региона",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : 152
}, {
"name" : "fias_region_guid",
"in" : "query",
"description" : "Уникальный идентификатор ФИАС региона. Устаревшее поле",
"required" : false,
"deprecated" : true,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"example" : "dd71e526-d850-46db-97db-164391414c5b"
}, {
"name" : "kladr_code",
"in" : "query",
"description" : "Код КЛАДР населенного пункта",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : 152
}, {
"name" : "fias_guid",
"in" : "query",
"description" : "Уникальный идентификатор ФИАС населенного пункта",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"example" : "dd71e526-d850-46db-97db-164391414c5b"
}, {
"name" : "postal_code",
"in" : "query",
"description" : "Почтовый индекс",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : 630055
}, {
"name" : "code",
"in" : "query",
"description" : "Код населенного пункта СДЭК",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"example" : 147
}, {
"name" : "city",
"in" : "query",
"description" : "Название населенного пункта. Должно соответствовать полностью",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "Москва"
}, {
"name" : "payment_limit",
"in" : "query",
"description" : "Ограничение на сумму наложенного платежа. Особые значения: -1 - ограничения нет; 0 - наложенный платеж не принимается;",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "number",
"format" : "double",
"nullable" : false
},
"example" : 127.682
}, {
"name" : "size",
"in" : "query",
"description" : "Ограничение выборки результата. По умолчанию 1000. Обязателен, если указан page",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"example" : 15
}, {
"name" : "page",
"in" : "query",
"description" : "Номер страницы выборки результата. По умолчанию 0",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"example" : 5
}, {
"name" : "lang",
"in" : "query",
"description" : "Язык локализации ответа",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "string",
"nullable" : false
},
"example" : "RU"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/V2LocationCityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/print/orders" : {
"post" : {
"tags" : [ "print" ],
"summary" : "Формирование квитанции к заказу",
"description" : "Метод используется для формирования квитанции в формате pdf к заказу/заказам.
\nВо избежание перегрузки платформы нельзя передавать более 100 номеров заказов в одном запросе.",
"operationId" : "waybillPrint",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/WaybillRequestDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/WaybillPrintResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 1
}
},
"/v2/prealert" : {
"post" : {
"tags" : [ "prealert" ],
"summary" : "Регистрация преалерта",
"description" : "Метод предназначен для регистрации преалерта (реестра заказов, которые клиент собирается передать на склад СДЭК для дальнейшей доставки) - информирования со стороны интернет-магазина (далее ИМ) о желании передать некоторое количество заказов в СДЭК, чтобы к этому моменту принимающий офис подготовил необходимые документы. \nПреалерт нужен, только если ИМ собирается передавать большое количество заказов одновременно. Для работы с преалертом необходимо, чтобы услуга \"Преалерт\" была подключена по договору. По этому вопросу необходимо обратиться напрямую к закрепленному менеджеру или в закрепленный офис СДЭК (с кем подписывался договор).
\nПреалерт не связан с заявкой на вызов курьера.",
"operationId" : "register",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/RegisterPrealertRequestDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/RegisterPrealertResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 1
}
},
"/v2/orders" : {
"get" : {
"tags" : [ "order" ],
"summary" : "Получение информации о заказе по номеру СДЭК/ИМ",
"description" : "Метод предоставляет возможность получить детальную информацию о ранее созданном заказе по номеру СДЭК/ИМ заказа. В ответе содержатся данные о статусе заказа, деталях доставки и информации о получателе.
\nЕсть возможность получить информацию, в том числе о заказах, которые были созданы через другие каналы (личный кабинет, вручную менеджером и др.), но только по тем, которые были созданы после первой авторизации по ключам интеграции.",
"operationId" : "get",
"parameters" : [ {
"name" : "cdek_number",
"in" : "query",
"description" : "Номер заказа СДЭК, по которому необходима информация",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"format" : "int64"
}
}, {
"name" : "im_number",
"in" : "query",
"description" : "Номер заказа в ИС Клиента, по которому необходима информация",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoOrderResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 1
},
"post" : {
"tags" : [ "order" ],
"summary" : "Регистрация заказа",
"description" : "Метод предназначен для создания в ИС СДЭК заказа на доставку товаров до покупателей. В запросе передается информация об отправителе, получателе, параметрах доставки и содержимом отправления. В ответе возвращается уникальный идентификатор заказа и текущий статус запроса*.
\nВыделяется 2 типа заказов:
\n“интернет-магазин” - может быть только у клиента с типом договора “Интернет-магазин”;
\n“доставка” может быть создан любым клиентом с договором (но доступны тарифы только для обычной доставки).
\n\n*Метод работает асинхронно. Статус \"ACCEPTED\" в ответе на запрос не гарантирует, что заказ создан в ИС СДЭК. Этот статус относится к запросу (запрос успешно принят) и говорит о том, что запрос прошел первичные валидации и структурно составлен корректно. Далее запрос проходит остальные валидации, результат можно получить с помощью методов получения информации о заказе. Статус запроса \"SUCCESSFUL\" - сущность успешно создана в системе, статус \"INVALID\" - при создании возникла ошибка, необходимо её исправить и повторно отправить запрос на регистрацию заказа.",
"operationId" : "register_1",
"parameters" : [ {
"name" : "developer-key",
"in" : "header",
"required" : false,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/OrderCreateRequestDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 1
},
"patch" : {
"tags" : [ "order" ],
"summary" : "Изменение заказа",
"description" : "Метод используется для изменения созданного ранее заказа.
\nУсловием возможности изменения заказа является отсутствие движения груза на складе СДЭК (т.е. статус заказа «Создан»).",
"operationId" : "update",
"parameters" : [ {
"name" : "developer-key",
"in" : "header",
"required" : false,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/OrderUpdateRequestDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 1
}
},
"/v2/intakes/availableDays" : {
"post" : {
"tags" : [ "intake" ],
"summary" : "Получение дат вызова курьера для НП",
"description" : "Метод позволяет получить доступные даты для забора груза курьером со склада интернет-магазина для населенного пункта, в котором находится склад. В методе не предусмотрены валидации по часовому поясу пользователя, совершившего запрос (не учитываются графики работы офисов, которые осуществляют забор груза из данного города), так как метод является информационным и оперирует только диапазонами дат, в которые возможен забор груза в населенном пункте.",
"operationId" : "getAvailableDays",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/IntakeAvailableDaysRequestDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/IntakeAvailableDaysResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 1
}
},
"/v2/intakes" : {
"post" : {
"tags" : [ "intake" ],
"summary" : "Регистрация заявки на вызов курьера",
"description" : "Метод позволяет осуществить вызов курьера для забора груза со склада интернет-магазина с последующей доставкой до склада СДЭК. Рекомендуемый минимальный диапазон времени для приезда курьера не менее 3-х часов. В теле запроса передаются данные об адресе отправителя, контактном лице, дате и интервале времени забора, количестве и характеристиках мест отправления. В ответе возвращается уникальный идентификатор заявки и текущий статус запроса*.
\n\n*Метод работает асинхронно. Статус \"ACCEPTED\" в ответе на запрос не гарантирует, что заявка создана в ИС СДЭК. Этот статус относится к запросу (запрос успешно принят) и говорит о том, что запрос прошел первичные валидации и структурно составлен корректно. Далее запрос проходит остальные валидации, результат можно получить с помощью метода получения информации о заявке. Статус запроса \"SUCCESSFUL\" - сущность успешно создана в системе, статус \"INVALID\" - при создании возникла ошибка, необходимо её исправить и повторно отправить запрос на регистрацию заявки на вызов курьера.",
"operationId" : "create",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/IntakeDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 2
},
"patch" : {
"tags" : [ "intake" ],
"summary" : "Изменение статуса заявки на вызов курьера",
"description" : "Метод позволяет изменить статус по действующей заявке на вызов курьера на \"Требует обработки\" с передачей дополнительных статусов, если по заявке требуются дополнительные операции, такие как прозвон или предоставление документов. \n Перейти в статус \"Требует обработки\" могут заявки, которые имеют текущий статус Требует обработки/Готова к назначению/Назначен курьер.",
"operationId" : "changeStatus",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/IntakeChangeStatusDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/IntakeChangeStatusResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 4
}
},
"/v2/print/orders/{uuid}" : {
"get" : {
"tags" : [ "print" ],
"summary" : "Получение квитанции к заказу",
"description" : "Метод используется для получения ссылки на квитанцию в формате pdf к заказу/заказам.
\nСсылка на файл с квитанцией к заказу/заказам доступна в течение 1 часа.
\n
\nВ ответе метода возвращается набор статусов entity->statuses. Их значения могут быть следующими\n| Код | Название статуса | Комментарий |\n|-----------|---------------------|--------------|\n| ACCEPTED | Принят | Запрос на формирование квитанции принят |\n| INVALID | Некорректный запрос | Некорректный запрос на формирование квитанции |\n| PROCESSING| Формируется | Файл с квитанцией формируется |\n| READY | Сформирован | Файл с квитанцией и ссылка на скачивание файла сформированы|\n| REMOVED | Удален\t | Истекло время жизни ссылки на скачивание файла с квитанцией|",
"operationId" : "waybillGet",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : {
"format" : "uuid"
}
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/WaybillGetResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 2
}
},
"/v2/prealert/{uuid}" : {
"get" : {
"tags" : [ "prealert" ],
"summary" : "Получение информации о преалерте",
"description" : "Метод предназначен для получения информации по заданному преалерту",
"operationId" : "get_1",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор преалерта в ИС СДЭК, по которому необходима информация",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/GetPrealertResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 2
}
},
"/v2/orders/{uuid}" : {
"get" : {
"tags" : [ "order" ],
"summary" : "Получение информации о заказе по UUID",
"description" : "Метод предоставляет возможность получить детальную информацию о ранее созданном заказе по его идентификатору. В ответе содержатся данные о статусе заказа, деталях доставки и информации о получателе.
\nЕсть возможность получить информацию, в том числе о заказах, которые были созданы через другие каналы (личный кабинет, вручную менеджером и др.), но только по тем, которые были созданы после первой авторизации по ключам интеграции.",
"operationId" : "get_2",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор заказа в ИС СДЭК, по которому необходима информация",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoOrderResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 2
},
"delete" : {
"tags" : [ "order" ],
"summary" : "Удаление заказа",
"description" : "С помощью этого метода можно удалить ранее созданный заказ из системы CDEK. В запросе указывается идентификатор заказа, который необходимо удалить. В ответе возвращается подтверждение успешного удаления или информация об ошибке, если удаление невозможно.
\nУсловием возможности удаления заказа является отсутствие движения груза на складе СДЭК (статус заказа «Создан»).",
"operationId" : "delete",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор заказа в ИС СДЭК, который необходимо удалить",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 2
}
},
"/v2/delivery/intervals" : {
"get" : {
"tags" : [ "schedule" ],
"summary" : "Получение интервалов доставки",
"description" : "Метод используется для получения доступных интервалов доставки по номеру/идентификатору уже созданного заказа. Позволяет узнать о свободных датах и временных интервалах, определенных в ИС СДЭК, для регистрации договоренности о доставке заказа покупателю.",
"operationId" : "getIntervals",
"parameters" : [ {
"name" : "cdek_number",
"in" : "query",
"description" : "Номер заказа",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : 1000014101
}, {
"name" : "order_uuid",
"in" : "query",
"description" : "Идентификатор заказа",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : "72753031-e66b-4146-ab8c-52179ef4020a"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/AvailableDeliveryIntervalsResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 2
}
},
"/v2/delivery" : {
"post" : {
"tags" : [ "schedule" ],
"summary" : "Регистрация договоренности о доставке",
"description" : "В зависимости от типа договоренности, метод позволяет фиксировать оговоренные с клиентом дату и время доставки (приезда курьера), а также изменять адрес доставки. В ответе возвращается уникальный идентификатор договоренности и текущий статус запроса*. \nДоговоренность \"до двери\" позволяет изменить по запросу клиента адрес, дату и время доставки. \nДоговоренность \"до склада\" позволяет изменить по запросу клиента адрес ПВЗ, куда будет доставлен груз. \n\n*Метод работает асинхронно. Статус \"ACCEPTED\" в ответе на запрос не гарантирует, что договоренность создана в ИС СДЭК. Этот статус относится к запросу (запрос успешно принят) и говорит о том, что запрос прошел первичные валидации и структурно составлен корректно. Далее запрос проходит остальные валидации, результат можно получить с помощью метода получения информации о договоренности. Статус запроса \"SUCCESSFUL\" - сущность успешно создана в системе, статус \"INVALID\" - при создании возникла ошибка, необходимо её исправить и повторно отправить запрос на регистрацию договоренности о доставке.",
"operationId" : "register_2",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ScheduleDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 3
}
},
"/v2/print/orders/{uuid}.pdf" : {
"get" : {
"tags" : [ "print" ],
"summary" : "Скачивание готовой квитанции",
"description" : "Скачивание квитанции в формате pdf к заказу/заказам.",
"operationId" : "waybillDownload",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : {
"format" : "uuid"
}
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"*/*" : {
"schema" : {
"format" : "byte"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 3
}
},
"/v2/orders/{orderUuid}/intakes" : {
"get" : {
"tags" : [ "order" ],
"summary" : "Получение информации о всех заявках по заказу",
"description" : "Метод предназначен для получения информации о всех созданных заявках на вызов курьера по идентификатору заказа.",
"operationId" : "getIntakes",
"parameters" : [ {
"name" : "orderUuid",
"in" : "path",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : {
"format" : "uuid"
}
}, {
"name" : "uuid",
"in" : "query",
"description" : "Идентификатор заказа в ИС СДЭК, по всем заявкам которого нужно получить информацию",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"items" : {
"$ref" : "#/components/schemas/IntakeInfoResponseEntity"
}
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 3
}
},
"/v2/intakes/{uuid}" : {
"get" : {
"tags" : [ "intake" ],
"summary" : "Получение информации о заявке по UUID",
"description" : "Метод предназначен для получения информации по UUID заявки.",
"operationId" : "getByUuid",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор заявки в ИС СДЭК, по которому необходима информация",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/IntakeInfoDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 3
},
"delete" : {
"tags" : [ "intake" ],
"summary" : "Удаление заявки",
"description" : "Метод предназначен для удаления заявки на вызов курьера.
\nЗаявку через интеграцию можно удалить в любом статусе, отличном от финального.",
"operationId" : "deleteByUuid",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор заявки в ИС СДЭК, которую необходимо удалить",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 5
}
},
"/v2/print/barcodes" : {
"post" : {
"tags" : [ "print" ],
"summary" : "Формирование ШК места к заказу",
"description" : "Метод используется для формирования ШК места в формате pdf к заказу/заказам.
\nВо избежание перегрузки платформы нельзя передавать более 100 номеров заказов в одном запросе.",
"operationId" : "barcodePrint",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/BarcodeRequestDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/BarcodePrintResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 4
}
},
"/v2/orders/{uuid}/refusal" : {
"post" : {
"tags" : [ "order" ],
"summary" : "Регистрация отказа",
"description" : "Метод предназначен для регистрации отказа по заказу и дальнейшего возврата данного заказа в интернет-магазин.
После успешной регистрации отказа статус заказа переходит в \"Не вручен\" (код NOT_DELIVERED) с дополнительным статусом \"Возврат, отказ от получения: Без объяснения\" (код 11). Заказ может быть отменен в любом статусе*, пока не установлен статус \"Вручен\" или \"Не вручен\".
* Не рекомендуется использовать метод для заказов, которые находятся в статусе \"Создан\" и не планируются к отгрузке на склады СДЭК. В случае применения метода отказа для заказов, находящихся в статусе \"Создан\", по ним будут начислены операции и заказы будут включены в Акт оказанных услуг. Для отмены заказа в статусе \"Создан\" воспользуйтесь методом \"Удаление заказа\".",
"operationId" : "refuse",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор заказа в ИС СДЭК, по которому необходимо зарегистрировать отказ",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 4
}
},
"/v2/delivery/{uuid}" : {
"get" : {
"tags" : [ "schedule" ],
"summary" : "Получение информации о договоренности о доставке",
"description" : "Метод используется для получения информации об оговоренных с клиентом дате и времени доставки (приезда курьера), а так же возможном новом адресе доставки.",
"operationId" : "get_3",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор договоренности о доставке в ИС СДЭК",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoScheduleInfoDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 4
}
},
"/v2/orders/{uuid}/clientReturn" : {
"post" : {
"tags" : [ "order" ],
"summary" : "Регистрация клиентского возврата",
"description" : "Метод предназначен для оформления клиентских возвратов для интернет-магазинов.
\nКлиентский возврат — это возврат, который оформляет сам клиент уже после получения (вручения) заказа (создается только для заказов интернет-магазина в конечном статусе \"Вручен\").
\nОтличие от обычного возврата в конечном статусе прямого заказа: у клиентских возвратов конечный статус \"вручен\" и возврат оформляет сам клиент, у обычных возвратов, конечный статус \"Не вручен\" и возврат оформляется СДЭКом. Для частично врученных заказов можно оформить и клиентский возврат и обычный возврат. \nКлиентский возврат связывается с прямым заказом СДЭК. Если прямая доставка осуществлялась не СДЭК, для создания обратного заказа необходимо использовать метод \"Регистрация заказа\" - если заказ оформляется как клиентский возврат, необходимо в запросе на регистрацию передать поле is_client_return = true.",
"operationId" : "clientReturn",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор прямого заказа в ИС СДЭК, по которому необходимо зарегистрировать клиентский возврат",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CreateClientReturnRequestDto"
}
}
},
"required" : true
},
"responses" : {
"202" : {
"description" : "Accepted",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoRootEntityDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 5
}
},
"/v2/print/barcodes/{uuid}" : {
"get" : {
"tags" : [ "print" ],
"summary" : "Получение ШК места к заказу",
"description" : "Метод используется для получения ШК места в формате pdf к заказу/заказам.\nСсылка на файл с ШК местом к заказу/заказам доступна в течение 1 часа.\n\nВ ответе метода возвращается набор статусов entity->statuses. Их значения могут быть следующими\n| Код | Название статуса | Комментарий |\n|-----------|---------------------|-------------|\n| ACCEPTED | Принят | Запрос на формирование квитанции принят |\n| INVALID | Некорректный запрос | Некорректный запрос на формирование квитанции |\n| PROCESSING| Формируется | Файл с квитанцией формируется |\n| READY | Сформирован | Файл с квитанцией и ссылка на скачивание файла сформированы|\n| REMOVED | Удален\t | Истекло время жизни ссылки на скачивание файла с квитанцией|",
"operationId" : "barcodeGet",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : {
"format" : "uuid"
}
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/BarcodeGetResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 5
}
},
"/v2/print/barcodes/{uuid}.pdf" : {
"get" : {
"tags" : [ "print" ],
"summary" : "Скачивание готового ШК",
"description" : "Скачивание ШК места в формате pdf к заказу/заказам",
"operationId" : "barcodeDownload",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : {
"format" : "uuid"
}
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"*/*" : {
"schema" : {
"format" : "byte"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ],
"x-methodSortOrder" : 6
}
},
"/v2/reverse/availability" : {
"post" : {
"tags" : [ "reverse" ],
"summary" : "Проверка доступности реверса",
"description" : "Метод позволяет проверить доступность реверса до создания прямого заказа. Для выполнения проверки необходимо передать в запросе данные, аналогичные тем, которые будут использоваться при создании заказа, включая направление, данные отправителя и получателя, офис отправки/доставки и выбранный тариф. \nЕсли реверс доступен, API вернёт пустой ответ с кодом 200. В случае недоступности услуги или при наличии ошибок в запросе, в ответе будет возвращено сообщение об ошибке с соответствующим описанием.",
"operationId" : "checkAvailability",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ReverseValidateRequestDto"
}
}
}
},
"responses" : {
"200" : {
"description" : "OK"
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/photoDocument" : {
"post" : {
"tags" : [ "photo" ],
"summary" : "Получение заказов с готовыми фото",
"description" : "Метод используется для получения перечня заказов с ссылками на готовые к скачиванию архивы с фото. В запросе необходимо передать либо период, за который необходимо вернуть перечень заказов, либо список заказов. Если переданы и период, и список заказов, то период игнорируется.
\nДля корректной работы метода, для договора должна быть подключена фотоуслуга, а также настроен фотопроект.",
"operationId" : "getReadyOrders",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/PhotoRequestDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/PhotoResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/international/package/restrictions" : {
"post" : {
"tags" : [ "restriction_hints" ],
"summary" : "Получение ограничений по международным заказам",
"description" : "Метод предназначен для получения ограничений по направлению и тарифу для международного заказа.",
"operationId" : "checkPackagesRestrictions",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/RestrictionHintsRequestDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"*/*" : {
"schema" : {
"$ref" : "#/components/schemas/RestrictionHintsResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"*/*" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/delivery/estimatedIntervals" : {
"post" : {
"tags" : [ "schedule" ],
"summary" : "Получение интервалов доставки до создания заказа",
"description" : "Метод позволяет получить доступные интервалы доставки \"до двери\" до создания заказа, тем самым предоставляя возможность рассчитать доступные слоты для регистрации договоренности о доставке заранее, в зависимости от направления и выбранного тарифа. Если в total_count передано значение доставок, например, равное 100, а в agreed_count количество согласованных доставок - 98, это означает, что данном интервале осталось два доступных слота для регистрации договоренности о доставке. После того как все доступные слоты будут заняты, данный интервал станет недоступен для регистрации договоренности.",
"operationId" : "getEstimatedIntervals",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/EstimatedDeliveryIntervalsRequestDto"
}
}
}
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/EstimatedDeliveryIntervalsResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/calculator/tarifflist" : {
"post" : {
"tags" : [ "calculator" ],
"summary" : "Расчет по доступным тарифам",
"description" : "Метод используется клиентами для расчета стоимости и сроков доставки по всем доступным тарифам.",
"operationId" : "tariffList",
"parameters" : [ {
"name" : "developer-key",
"in" : "header",
"required" : false,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CalculatorTariffListRequestDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CalculatorTariffListResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/calculator/tariff" : {
"post" : {
"tags" : [ "calculator" ],
"summary" : "Расчет по коду тарифа",
"description" : "Метод используется для расчета стоимости и сроков доставки по конкретному коду тарифа по указанному направлению с учетом весо-габаритных характеристик груза. В ответе предоставляется информация о доступных тарифах, их стоимости и сроках доставки. \nВ данном методе возможно произвести расчет стоимость доставки с учетом стоимости дополнительных услуг.",
"operationId" : "tariff",
"parameters" : [ {
"name" : "developer-key",
"in" : "header",
"required" : false,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CalculatorRequestDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CalculatorResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/calculator/tariffAndService" : {
"post" : {
"tags" : [ "calculator" ],
"summary" : "Расчет по доступным тарифам и дополнительным услугам",
"description" : "Метод используется клиентами для расчета стоимости и сроков доставки по доступным тарифам, с учётом переданных дополнительных услуг.",
"operationId" : "tariffWithServices",
"parameters" : [ {
"name" : "developer-key",
"in" : "header",
"required" : false,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CalculatorTariffWithServicesRequestDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CalculatorTariffWithServicesListResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/registries" : {
"get" : {
"tags" : [ "registries" ],
"summary" : "Получение информации о реестрах НП",
"description" : "Метод предназначен для получения информации о реестрах наложенных платежей, по которым клиенту был переведен наложенный платеж в заданную клиентом дату. Доступна информация только о тех документах, которые были созданы после даты первой авторизации по ключам интеграции (активации учетной записи интеграции). Документы, созданные в период деактивации учетной записи, после повторной активации доступны не будут",
"operationId" : "get_4",
"parameters" : [ {
"name" : "date",
"in" : "query",
"description" : "Дата, за которую необходимо вернуть реестры наложенных платежей, по которым был переведен наложенный платеж.",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"format" : "date"
},
"example" : "2024-05-21"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/RegistriesResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/photoDocument/{uuid}" : {
"get" : {
"tags" : [ "photo" ],
"summary" : "Скачивание готового архива",
"description" : "Метод используется для скачивания готового архива с фото документов в zip-формате по заказу. Для скачивания архива, необходимо выполнить GET-запрос с авторизацией по ссылке, полученной в ответе метода \"Получение заказов с готовыми фото\", и сохранить тело ответа как файл.",
"operationId" : "getPhotoDocument",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор сформированной ссылки",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK"
},
"404" : {
"description" : "Not Found"
},
"403" : {
"description" : "Forbidden"
},
"502" : {
"description" : "Bad Gateway"
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/passport" : {
"get" : {
"tags" : [ "passport" ],
"summary" : "Получение информации о паспортных данных",
"description" : "Метод используется для получения информации о паспортных данных (сообщает о готовности передавать заказы на таможню) по международным заказу/заказам.",
"operationId" : "get_5",
"parameters" : [ {
"name" : "cdek_number",
"in" : "query",
"description" : "Номер заказа",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : 1000014101
}, {
"name" : "order_uuid",
"in" : "query",
"description" : "UUID заказа",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : "72753031-e66b-4146-ab8c-52179ef4020a"
}, {
"name" : "client",
"in" : "query",
"description" : "Клиент, по которому будет выведена информация о паспортных данных.
\nЕсли значение не передано, то информация о паспортных данных будет выводиться и по отправителю, и по получателю.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : "SENDER, RECEIVER, ALL"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/PassportResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/deliverypoints" : {
"get" : {
"tags" : [ "delivery_point" ],
"summary" : "Получение списка офисов",
"description" : "Метод предназначен для получения списка действующих офисов СДЭК.
\n
\nМы не рекомендуем использовать статичный список офисов, т.к. в этом случае офисы могут быть неактуальны.
\nРекомендуем делать запрос к методу и обновлять список офисов раз в сутки для корректного отображения актуального списка ПВЗ и постаматов.",
"operationId" : "search",
"parameters" : [ {
"name" : "code",
"in" : "query",
"description" : "Код ПВЗ",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"maxLength" : 255
},
"example" : "NSK1"
}, {
"name" : "type",
"in" : "query",
"description" : "Тип офиса. Принимает значения \"POSTAMAT\", \"PVZ\", \"ALL\". При отсутствии параметра принимается значение по умолчанию «ALL».",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ "POSTAMAT", "PVZ", "ALL" ]
},
"example" : "PVZ"
}, {
"name" : "postal_code",
"in" : "query",
"description" : "Почтовый индекс города, для которого необходим список офисов",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"maxLength" : 255
},
"example" : 630000
}, {
"name" : "city_code",
"in" : "query",
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"format" : "int32"
},
"example" : 270
}, {
"name" : "country_code",
"in" : "query",
"description" : "Код страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”)",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"maxLength" : 2,
"minLength" : 2
},
"example" : "RU"
}, {
"name" : "region_code",
"in" : "query",
"description" : "Код региона СДЭК",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"format" : "int32"
},
"example" : 5
}, {
"name" : "have_cashless",
"in" : "query",
"description" : "Наличие терминала оплаты. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "have_cash",
"in" : "query",
"description" : "Есть прием наличных. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "allowed_cod",
"in" : "query",
"description" : "Разрешен наложенный платеж. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "is_dressing_room",
"in" : "query",
"description" : "Наличие примерочной. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "weight_max",
"in" : "query",
"description" : "Максимальный вес в кг, который может принять офис (значения больше 0 - передаются офисы, которые принимают этот вес; 0 - офисы с нулевым весом не передаются; значение не указано - все офисы)",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"minimum" : 0,
"format" : "int32"
},
"example" : 10
}, {
"name" : "weight_min",
"in" : "query",
"description" : "Минимальный вес в кг, который принимает офис (при переданном значении будут выводиться офисы с минимальным весом до указанного значения)",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"minimum" : 0,
"format" : "int32"
},
"example" : 5
}, {
"name" : "length",
"in" : "query",
"description" : "Длина грузоместа в см, планируемого к отправке. Фильтрация всегда допускает поворот груза, поэтому даже при одном переданном параметре (габарите груза) достаточно, чтобы хотя бы одно из трёх ограничений офиса было не меньше этого значения или отсутствовало. Если не передан ни один из параметров (length, width, height) - возвращается весь список офисов.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"minimum" : 0,
"format" : "int32"
},
"example" : 10
}, {
"name" : "width",
"in" : "query",
"description" : "Ширина грузоместа в см, планируемого к отправке. Фильтрация всегда допускает поворот груза, поэтому даже при одном переданном параметре (габарите груза) достаточно, чтобы хотя бы одно из трёх ограничений офиса было не меньше этого значения или отсутствовало. Если не передан ни один из параметров (length, width, height) - возвращается весь список офисов.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"minimum" : 0,
"format" : "int32"
},
"example" : 10
}, {
"name" : "height",
"in" : "query",
"description" : "Высота грузоместа в см, планируемого к отправке. Фильтрация всегда допускает поворот груза, поэтому даже при одном переданном параметре (габарите груза) достаточно, чтобы хотя бы одно из трёх ограничений офиса было не меньше этого значения или отсутствовало. Если не передан ни один из параметров (length, width, height) - возвращается весь список офисов.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"minimum" : 0,
"format" : "int32"
},
"example" : 10
}, {
"name" : "lang",
"in" : "query",
"description" : "Локализация офиса.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"default" : "rus"
},
"example" : "rus"
}, {
"name" : "take_only",
"in" : "query",
"description" : "Является ли офис только пунктом выдачи. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "is_handout",
"in" : "query",
"description" : "Является пунктом выдачи. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "is_reception",
"in" : "query",
"description" : "Есть ли в офисе приём заказов. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "is_marketplace",
"in" : "query",
"description" : "Офис для доставки \"До маркетплейса\". Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "is_ltl",
"in" : "query",
"description" : "Работает ли офис с LTL (сборный груз). Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "ltl_acceptance_partners",
"in" : "query",
"description" : "Принимает заказы LTL, которые будут доставляться партнерами. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "ltl_issuance_partners",
"in" : "query",
"description" : "Выдает заказы LTL, которые были доставлены партнерами. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "fulfillment",
"in" : "query",
"description" : "Офис с зоной фулфилмента. Может принимать значения:
\n«1», «true» - есть;
\n«0», «false» - нет.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"enum" : [ false, true, false, false ]
},
"example" : true
}, {
"name" : "fias_guid",
"in" : "query",
"description" : "Код города ФИАС",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"format" : "uuid"
},
"example" : "e33970a6-0db6-4e35-832c-cc3312a1833e"
}, {
"name" : "size",
"in" : "query",
"description" : "Ограничение выборки результата (размер страницы)",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"minimum" : 0,
"format" : "int32"
},
"example" : 1000
}, {
"name" : "page",
"in" : "query",
"description" : "Номер страницы выборки результата",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"minimum" : 0,
"format" : "int32"
},
"example" : 2
} ],
"responses" : {
"200" : {
"description" : "OK",
"headers" : {
"X-Current-Page" : {
"style" : "simple",
"explode" : false,
"schema" : { }
},
"X-Total-Elements" : {
"style" : "simple",
"explode" : false,
"schema" : { }
},
"X-Total-Pages" : {
"style" : "simple",
"explode" : false,
"schema" : { }
}
},
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/OfficeDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/check" : {
"get" : {
"tags" : [ "receipt" ],
"summary" : "Получение информации о чеках",
"description" : "Метод используется для получения информации о чеке по заказу или за выбранный день.",
"operationId" : "get_6",
"parameters" : [ {
"name" : "order_uuid",
"in" : "query",
"description" : "Идентификатор заказа в ИС СДЭК, по которому необходимо получить чек. Обязательно, если не переданы остальные параметры",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : "72753031-e66b-4146-ab8c-52179ef4020a"
}, {
"name" : "cdek_number",
"in" : "query",
"description" : "Номер заказа СДЭК, по которому необходимо получить чек. Обязательно, если не переданы остальные параметры",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : 1000014101
}, {
"name" : "date",
"in" : "query",
"description" : "Дата создания чека в формате yyyy-MM-dd. Обязательно, если не переданы остальные параметры",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : { },
"example" : "2000-10-31"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CheckResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/calculator/alltariffs" : {
"get" : {
"tags" : [ "calculator" ],
"summary" : "Список доступных тарифов",
"description" : "Метод позволяет получить список всех доступных и актуальных тарифов по договору.",
"operationId" : "availableTariffs",
"parameters" : [ {
"name" : "X-User-Lang",
"in" : "header",
"description" : "Язык вывода информации о тарифах.
Возможные значения: rus, eng, zho.
По умолчанию - rus",
"required" : false,
"style" : "simple",
"explode" : false,
"schema" : { }
}, {
"name" : "developer-key",
"in" : "header",
"required" : false,
"style" : "simple",
"explode" : false,
"schema" : { }
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CalculatorAvailableTariffsResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/SimplifiedResponseDto1"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/webhooks" : {
"get" : {
"tags" : [ "webhook" ],
"summary" : "Получение информации о подписках на вебхуки",
"description" : "Метод предназначен для получения информации о всех активных подписках интернет-магазина на получение вебхуков.",
"operationId" : "getAll",
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"items" : {
"$ref" : "#/components/schemas/WebhookDto"
}
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
},
"post" : {
"tags" : [ "webhook" ],
"summary" : "Добавление подписки на вебхуки",
"description" : "Метод предназначен для подключения подписки на отправку на URL клиента событий, связанных с заказом. Существуют следующие типы подписок:
• об изменении статуса заказа
• о готовности печатной формы
• получение информации о закрытии преалерта
• получение информации об изменении доступности офиса
• получение информации об изменении заказа
• получение информации о транспорте для СНТ
• получение информации об изменении договоренности о доставке
• получение информации о проблемах доставки по заказу
• получение информации о курьере
• получение фото документов по заказам
Если у клиента уже есть подписка с указанным типом, то будет создана еще одна подписка с таким же типом.",
"operationId" : "createWebhook",
"requestBody" : {
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/WebhookDto"
}
}
},
"required" : true
},
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoWebhookResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
},
"/v2/webhooks/{uuid}" : {
"get" : {
"tags" : [ "webhook" ],
"summary" : "Получение информации о подписке по UUID",
"description" : "Метод предназначен для получения информации о подписке клиента на вебхуки по UUID",
"operationId" : "getById",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор вебхука, который необходимо найти",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { },
"example" : "dd71e526-d850-46db-97db-164391414c5b"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoWebhookDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
},
"delete" : {
"tags" : [ "webhook" ],
"summary" : "Удаление подписки по UUID",
"description" : "Метод предназначен для удаления подписки на получение вебхуков",
"operationId" : "deleteById",
"parameters" : [ {
"name" : "uuid",
"in" : "path",
"description" : "Идентификатор вебхука, который необходимо удалить",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : { },
"example" : "dd71e526-d850-46db-97db-164391414c5b"
} ],
"responses" : {
"200" : {
"description" : "OK",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDtoWebhookResponseDto"
}
}
}
},
"400" : {
"description" : "Bad Request",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/ResponseDto"
}
}
}
}
},
"security" : [ {
"bearerAuth" : [ ]
} ]
}
}
},
"components" : {
"schemas" : {
"ErrorDto" : {
"title" : "ErrorDto",
"type" : "object",
"properties" : {
"error" : {
"type" : "string",
"description" : "Код ошибки",
"nullable" : false,
"example" : "error_code"
},
"error_description" : {
"type" : "string",
"description" : "Сообщение об ошибке",
"nullable" : false,
"example" : "Error message"
}
},
"description" : "Информация об ошибке",
"nullable" : false
},
"AuthResponseDto" : {
"title" : "AuthResponseDto",
"type" : "object",
"properties" : {
"access_token" : {
"type" : "string",
"description" : "JWT-токен",
"format" : "uuid",
"nullable" : false
},
"token_type" : {
"type" : "string",
"description" : "Тип токена. Всегда принимает значение bearer",
"nullable" : false,
"example" : "bearer"
},
"expires_in" : {
"type" : "integer",
"description" : "Срок действия токена (по умолчанию 3600 секунд)",
"format" : "date-time",
"nullable" : false,
"example" : 3599
},
"scope" : {
"type" : "string",
"description" : "Область действия токена (доступ к объектам и операциям над ними)",
"nullable" : false,
"example" : "order:all"
},
"jti" : {
"type" : "string",
"description" : "Уникальный идентификатор токена",
"nullable" : false,
"example" : "78d15dbc-95ed-46h0-8d1c-12740ddf4a07"
}
},
"description" : "200 OK",
"nullable" : false
},
"SuggestCityResponseDto" : {
"required" : [ "city_uuid", "code", "country_code", "full_name" ],
"type" : "object",
"properties" : {
"city_uuid" : {
"maxLength" : 255,
"type" : "string",
"description" : "Идентификатор населенного пункта СДЭК",
"format" : "uuid",
"nullable" : false
},
"code" : {
"type" : "integer",
"description" : "Код населенного пункта СДЭК",
"format" : "int32",
"nullable" : false
},
"full_name" : {
"maxLength" : 255,
"type" : "string",
"description" : "Наименование населенного пункта СДЭК (город, район, регион, страна)",
"nullable" : false
},
"country_code" : {
"maxLength" : 255,
"type" : "string",
"description" : "Код страны в формате ISO_3166-1_alpha-2",
"nullable" : false
}
},
"description" : "Транспорт ответа подбора города по названию",
"nullable" : false
},
"SimplifiedResponseDto" : {
"type" : "object",
"properties" : {
"errors" : {
"type" : "array",
"description" : "Список ошибок",
"nullable" : false,
"items" : {
"$ref" : "#/components/schemas/ErrorDto1"
}
}
},
"description" : "Транспорт с ошибками и предупреждениями",
"nullable" : false
},
"RegionsResponseDto" : {
"required" : [ "country", "country_code", "region" ],
"type" : "object",
"properties" : {
"country_code" : {
"maxLength" : 2,
"type" : "string",
"description" : "Код страны в формате ISO_3166-1_alpha-2",
"nullable" : false
},
"country" : {
"maxLength" : 255,
"type" : "string",
"description" : "Название страны региона",
"nullable" : false
},
"region" : {
"maxLength" : 255,
"type" : "string",
"description" : "Название региона",
"nullable" : false
},
"region_code" : {
"type" : "integer",
"description" : "Код региона СДЭК",
"format" : "int32",
"nullable" : false
},
"fias_region_guid" : {
"type" : "string",
"description" : "Уникальный идентификатор ФИАС региона. Устаревшее поле.",
"format" : "uuid",
"nullable" : false,
"deprecated" : true
},
"kladr_region_code" : {
"type" : "string",
"description" : "Код КЛАДР региона населенного пункта",
"nullable" : false
}
},
"description" : "Транспорт ответа на запрос на поиск регионов",
"nullable" : false
},
"PostcodesResponseDto" : {
"required" : [ "code", "postal_codes" ],
"type" : "object",
"properties" : {
"code" : {
"type" : "integer",
"description" : "Код города, которому принадлежат почтовые индексы",
"format" : "int32",
"nullable" : false
},
"postal_codes" : {
"type" : "array",
"description" : "Почтовые индексы города",
"nullable" : false,
"items" : {
"type" : "string",
"nullable" : false
}
}
},
"description" : "Транспорт ответа на запрос на поиск индексов по коду города",
"nullable" : false
},
"V2LocationCityByCoordinatesDto" : {
"required" : [ "city", "city_uuid", "code" ],
"type" : "object",
"properties" : {
"code" : {
"type" : "integer",
"description" : "Код населенного пункта СДЭК",
"format" : "int32",
"nullable" : false
},
"city_uuid" : {
"type" : "string",
"description" : "Идентификатор населенного пункта в ИС СДЭК",
"format" : "uuid",
"nullable" : false
},
"city" : {
"maxLength" : 255,
"type" : "string",
"description" : "Название населенного пункта",
"nullable" : false
},
"fias_guid" : {
"type" : "string",
"description" : "Уникальный идентификатор ФИАС населенного пункта",
"format" : "uuid",
"nullable" : false
}
},
"description" : "Транспорт ответа на запрос получения списка населенных пунктов",
"nullable" : false
},
"V2LocationCityDto" : {
"required" : [ "city", "city_uuid", "code", "country", "country_code", "payment_limit", "region" ],
"type" : "object",
"properties" : {
"code" : {
"type" : "integer",
"description" : "Код населенного пункта СДЭК",
"format" : "int32",
"nullable" : false
},
"city_uuid" : {
"type" : "string",
"description" : "Идентификатор населенного пункта в ИС СДЭК",
"format" : "uuid",
"nullable" : false
},
"city" : {
"maxLength" : 255,
"type" : "string",
"description" : "Название населенного пункта",
"nullable" : false
},
"fias_guid" : {
"type" : "string",
"description" : "Уникальный идентификатор ФИАС населенного пункта",
"format" : "uuid",
"nullable" : false
},
"country_code" : {
"maxLength" : 2,
"type" : "string",
"description" : "Код страны населенного пункта в формате ISO_3166-1_alpha-2",
"nullable" : false
},
"country" : {
"maxLength" : 255,
"type" : "string",
"description" : "Название страны населенного пункта",
"nullable" : false
},
"region" : {
"maxLength" : 255,
"type" : "string",
"description" : "Название региона населенного пункта",
"nullable" : false
},
"region_code" : {
"type" : "integer",
"description" : "Код региона СДЭК",
"format" : "int32",
"nullable" : false
},
"fias_region_guid" : {
"type" : "string",
"description" : "Уникальный идентификатор ФИАС региона населенного пункта. Устаревшее поле",
"format" : "uuid",
"nullable" : false,
"deprecated" : true
},
"sub_region" : {
"maxLength" : 255,
"type" : "string",
"description" : "Название района региона населенного пункта",
"nullable" : false
},
"longitude" : {
"type" : "number",
"description" : "Долгота центра населенного пункта",
"format" : "double",
"nullable" : false
},
"latitude" : {
"type" : "number",
"description" : "Широта центра населенного пункта",
"format" : "double",
"nullable" : false
},
"time_zone" : {
"maxLength" : 255,
"type" : "string",
"description" : "Часовой пояс населенного пункта",
"nullable" : false
},
"payment_limit" : {
"type" : "number",
"description" : "Ограничение на сумму наложенного платежа в населенном пункте. Особые значения: -1 - ограничения нет; 0 - наложенный платеж не принимается;",
"format" : "double",
"nullable" : false
}
},
"description" : "Транспорт ответа на запрос получения списка населенных пунктов",
"nullable" : false
},
"LocationRegionSearchDto" : {
"title" : "LocationRegionSearchDto",
"type" : "object",
"properties" : {
"countryCodes" : {
"type" : "array",
"nullable" : false,
"items" : {
"type" : "string",
"nullable" : false
}
},
"regionFiasGuid" : {
"type" : "string",
"nullable" : false
},
"size" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"page" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
}
},
"nullable" : false
},
"RegionDto" : {
"title" : "RegionDto",
"type" : "object",
"properties" : {
"regionUuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"regionName" : {
"type" : "string",
"nullable" : false
},
"prefix" : {
"type" : "string",
"nullable" : false
},
"regionCode" : {
"type" : "string",
"nullable" : false
},
"regionCodeExt" : {
"type" : "string",
"nullable" : false
},
"regionFiasGuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"countryName" : {
"type" : "string",
"nullable" : false
},
"countryCode" : {
"type" : "string",
"nullable" : false
},
"countryCodeExt" : {
"type" : "string",
"nullable" : false
}
},
"description" : "Транспорт регионов",
"nullable" : false
},
"LocationPostcodeDto" : {
"title" : "LocationPostcodeDto",
"type" : "object",
"properties" : {
"postcode" : {
"type" : "string",
"nullable" : false
},
"cityUuid" : {
"type" : "string",
"nullable" : false
},
"cityCode" : {
"type" : "string",
"nullable" : false
}
},
"description" : "Транспорт почтового индекса",
"nullable" : false
},
"LocationSearchDto" : {
"title" : "LocationSearchDto",
"type" : "object",
"properties" : {
"cityUuids" : {
"type" : "array",
"nullable" : false,
"items" : {
"type" : "string",
"nullable" : false
}
},
"cityCode" : {
"type" : "string",
"nullable" : false
},
"cityName" : {
"type" : "string",
"nullable" : false
},
"countryCodes" : {
"type" : "array",
"items" : {
"type" : "string",
"nullable" : false
},
"default" : null
},
"country" : {
"type" : "string",
"nullable" : false
},
"regionCode" : {
"type" : "string",
"nullable" : false
},
"region" : {
"type" : "string",
"nullable" : false
},
"subRegion" : {
"type" : "string",
"nullable" : false
},
"postcode" : {
"type" : "string",
"nullable" : false
},
"address" : {
"type" : "string",
"nullable" : false
},
"fiasGuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"size" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"page" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"paymentLimit" : {
"type" : "number",
"nullable" : false
},
"creationPermitIgnore" : {
"type" : "boolean",
"nullable" : false
},
"showPostcodes" : {
"type" : "boolean",
"nullable" : false
}
},
"nullable" : false
},
"LocationDto" : {
"title" : "LocationDto",
"type" : "object",
"properties" : {
"addressString" : {
"type" : "string",
"nullable" : false
},
"cityName" : {
"type" : "string",
"nullable" : false
},
"cityCode" : {
"type" : "string",
"nullable" : false
},
"cityUuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"country" : {
"type" : "string",
"nullable" : false
},
"countryCode" : {
"type" : "string",
"nullable" : false
},
"countryCodeCdek" : {
"type" : "string",
"nullable" : false
},
"region" : {
"type" : "string",
"nullable" : false
},
"regionCode" : {
"type" : "string",
"nullable" : false
},
"regionCodeExt" : {
"type" : "string",
"nullable" : false
},
"regionFiasGuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"regionUuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"subRegion" : {
"type" : "string",
"nullable" : false
},
"subRegionUuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"street" : {
"type" : "string",
"nullable" : false
},
"house" : {
"type" : "string",
"nullable" : false
},
"flat" : {
"type" : "string",
"nullable" : false
},
"postcode" : {
"type" : "string",
"nullable" : false
},
"postcodes" : {
"type" : "array",
"nullable" : false,
"items" : {
"type" : "string",
"nullable" : false
}
},
"latitude" : {
"type" : "number",
"nullable" : false
},
"longitude" : {
"type" : "number",
"nullable" : false
},
"coordinateTarget" : {
"type" : "string",
"nullable" : false
},
"timezone" : {
"type" : "string",
"nullable" : false
},
"kladr" : {
"type" : "string",
"nullable" : false
},
"fiasGuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"fiasLevel" : {
"type" : "integer",
"format" : "int32",
"nullable" : false
},
"houseGuid" : {
"type" : "string",
"format" : "uuid",
"nullable" : false
},
"nearestCity" : {
"$ref" : "#/components/schemas/NearestCityDto"
},
"iqdqValid" : {
"type" : "boolean",
"nullable" : false
},
"iqdqErrorMessage" : {
"type" : "string",
"nullable" : false
},
"iqdqStatusError" : {
"type" : "string",
"nullable" : false
},
"paymentLimit" : {
"type" : "number",
"nullable" : false
},
"creationPermit" : {
"type" : "boolean",
"nullable" : false
},
"priority" : {
"type" : "boolean",
"nullable" : false
}
},
"description" : "Транспорт локации",
"nullable" : false
},
"NearestCityDto" : {
"title" : "NearestCityDto",
"type" : "object",
"properties" : {
"code" : {
"type" : "string",
"nullable" : false
},
"name" : {
"type" : "string",
"nullable" : false
},
"fullName" : {
"type" : "string",
"nullable" : false
},
"latitude" : {
"type" : "number",
"nullable" : false
},
"longitude" : {
"type" : "number",
"nullable" : false
},
"distance" : {
"type" : "number",
"format" : "double",
"nullable" : false
}
},
"description" : "Транспорт ближайшего найденного города",
"nullable" : false
},
"ErrorDto1" : {
"title" : "ErrorDto",
"required" : [ "code", "message" ],
"type" : "object",
"properties" : {
"code" : {
"type" : "string",
"description" : "Код ошибки",
"nullable" : false
},
"message" : {
"type" : "string",
"description" : "Описание ошибки",
"nullable" : false
}
},
"description" : "Ошибка, или предупреждение, возникшие в ходе выполнения запроса",
"nullable" : false
},
"AdditionalServiceRequestDto" : {
"properties" : {
"code" : {
"maxLength" : 16,
"description" : "Тип дополнительной услуги"
},
"parameter" : {
"description" : "Параметр дополнительной услуги
1. Количество для услуг PACKAGE_1, PACKAGE_A_2_LIGHT_EXPRESS, PACKAGE_A_3_LIGHT_EXPRESS, PACKAGE_A_4_LIGHT_EXPRESS, PACKAGE_A_5_LIGHT_EXPRESS, CARTON_BOX_XS, CARTON_BOX_S, CARTON_BOX_M, CARTON_BOX_2KG, CARTON_BOX_3KG, CARTON_BOX_5KG, CARTON_BOX_10KG, CARTON_BOX_XL_18_KILOS, CARTON_BOX_20KG, CARTON_BOX_30KG, CARTON_FILLER, XL_BOX_INNER_CRATE, 20_KG_BOX_INNER_CRATE, 30_KG_BOX_INNER_CRATE (для всех типов заказа)
2. Объявленная стоимость заказа для услуги INSURANCE (только для заказов с типом \"доставка\")
3. Длина для услуг BUBBLE_WRAP, WASTE_PAPER (для всех типов заказа)
4. Номер телефона для услуги SMS
5. Код фотопроекта для услуги PHOTO_OF_DOCUMENTS (добавление услуги доступно только при создании заказа)"
},
"sum" : {
"description" : "Стоимость услуги",
"format" : "float",
"readOnly" : true
},
"total_sum" : {
"description" : "Стоимость услуги с НДС и скидкой",
"format" : "float",
"readOnly" : true
},
"discount_percent" : {
"description" : "Процент скидки",
"format" : "float",
"readOnly" : true
},
"discount_sum" : {
"description" : "Сумма скидки",
"format" : "float",
"readOnly" : true
},
"vat_rate" : {
"description" : "Процент НДС",
"format" : "float",
"readOnly" : true
},
"vat_sum" : {
"description" : "Сумма НДС",
"format" : "float",
"readOnly" : true
}
},
"description" : "Дополнительная услуга"
},
"DeliveryCostThresholdDto" : {
"properties" : {
"threshold" : {
"description" : "Порог стоимости товара (действует по условию меньше или равно), в целых единицах валюты",
"format" : "int32"
},
"sum" : {
"description" : "Доп. сбор за доставку товаров, общая стоимость которых попадает в интервал. Сумма не может быть больше 50000000 в валюте города получателя.",
"format" : "float"
},
"vat_sum" : {
"description" : "Сумма НДС. Обязательно, если передано delivery_recipient_cost_adv.threshold.vat_rate",
"format" : "float"
},
"vat_rate" : {
"description" : "Ставка НДС с 01.01.2026 (значение - 0, 5, 7, 10, 16, 22, null - без НДС)",
"format" : "int32"
}
},
"description" : "Доп. сбор за доставку (которую ИМ берет с получателя) в зависимости от суммы заказа"
},
"DeliveryRecipientCostRequestDto" : {
"required" : [ "value" ],
"properties" : {
"value" : {
"description" : "Сумма платежа, включая НДС. Сумма не может быть больше 50000000 в валюте города получателя. Если передано значение 0, ставка НДС не применяется.",
"format" : "float"
},
"vat_sum" : {
"description" : "Сумма НДС. Обязательно, если передано payment.vat_rate",
"format" : "float"
},
"vat_rate" : {
"description" : "Ставка НДС с 01.01.2026 (значение - 0, 5, 7, 10, 16, 22, null - без НДС)",
"format" : "int32"
}
},
"description" : "Доп. сбор за доставку, которую ИМ берет с получателя. Только для заказов \"интернет-магазин\".
Для направлений Беларусь-Беларусь и РФ-Беларусь это поле игнорируется."
},
"ItemRequestDto" : {
"required" : [ "amount", "cost", "name", "payment", "ware_key", "weight" ],
"properties" : {
"name" : {
"maxLength" : 255,
"description" : "Наименование товара (может также содержать описание товара: размер, цвет).
\nСогласно законодательству РФ, название товара или услуги должно быть конкретным, понятным, позволяющим идентифицировать товар или услугу, должны быть отражены конкретные товарные позиции.
\nПример:
\n\"товар 1\" - некорректное наименование
\n\"Джинсы мужские Henry, размер M\" - корректное наименование"
},
"ware_key" : {
"maxLength" : 50,
"description" : "Идентификатор/артикул товара.
\n Артикул товара может содержать только символы: [A-z А-я 0-9 ! @ \" # № $ ; % ^ : & ? * () _ - + = ? < > , .{ } [ ] / , пробел].
\n При передаче одинаковых артикулов в рамках одной упаковки, артикул будет заменяться на: {ware_key}_* , где * – это 7 случайных символов."
},
"marking" : {
"description" : "Маркировка товара согласно системе и кодам маркировки «Честный знак».
\nЕсли для товара/вложения указана маркировка, amount не может быть больше 1.
\nДля корректного отображения маркировки товара в чеке требуется передавать НЕ РАЗОБРАННЫЙ тип маркировки, который может выглядеть следующим образом:
\n
\n1. Код товара в формате GS1
\nПример: 010468008549838921AAA0005255832GS91EE06GS92VTwGVc7wKCc2tqRncUZ1RU5LeUKSXjWbfNQOpQjKK+A
\n
\n2. Последовательность допустимых символов общей длиной в 29 символов.
\nПример: 00000046198488X?io+qCABm8wAYa
\n
\n3. Меховые изделия. Имеют собственный формат.
\nПример: RU-430302-AAA7582720
\n
\n(GS следует передавать, как символ ASCII 29)"
},
"payment" : {
"$ref" : "#/components/schemas/MoneyDto"
},
"weight" : {
"description" : "Вес",
"format" : "int32"
},
"weight_gross" : {
"description" : "Вес брутто. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\".",
"format" : "int32"
},
"amount" : {
"description" : "Количество единиц товара (в штуках). Количество одного товара в заказе может быть от 1 до 999",
"format" : "int32"
},
"name_i18n" : {
"maxLength" : 255,
"description" : "Наименование на иностранном языке. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"brand" : {
"maxLength" : 255,
"description" : "Бренд на иностранном языке. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны производителя товара в формате ISO_3166-1_alpha-2
\nОбязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"material" : {
"description" : "Код материала (см. Приложение 7). Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"wifi_gsm" : {
"description" : "Содержит wifi/gsm. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"url" : {
"maxLength" : 255,
"description" : "Ссылка на сайт интернет-магазина с описанием товара. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"seller" : {
"$ref" : "#/components/schemas/SellerItemDto"
},
"cost" : {
"description" : "Объявленная стоимость товара (за единицу товара в валюте взаиморасчетов, значение >=0).
\nС данного значения рассчитывается страховка."
},
"feacn_code" : {
"maxLength" : 255,
"description" : "Код ТН ВЭД"
},
"jewel_uin" : {
"description" : "УИН ювелирного изделия"
},
"used" : {
"description" : "Признак товара б/у, применим для c2c заказов."
}
},
"description" : "Описание товара"
},
"MoneyDto" : {
"required" : [ "value" ],
"properties" : {
"value" : {
"description" : "Сумма платежа, включая НДС. Сумма не может быть больше 50000000 в валюте города получателя. Если передано значение 0, ставка НДС не применяется.",
"format" : "float"
},
"vat_sum" : {
"description" : "Сумма НДС. Обязательно, если передано payment.vat_rate",
"format" : "float"
},
"vat_rate" : {
"description" : "Ставка НДС с 01.01.2026 (значение - 0, 5, 7, 10, 16, 22, null - без НДС)",
"format" : "int32"
}
},
"description" : "Доп. сбор за доставку, которую ИМ берет с получателя. Только для заказов \"интернет-магазин\".
Для направлений Беларусь-Беларусь и РФ-Беларусь это поле игнорируется."
},
"OrderCreateRequestDto" : {
"required" : [ "packages", "recipient", "tariff_code" ],
"properties" : {
"type" : {
"description" : "Тип заказа.
\n- 1 - \"интернет-магазин\" (только для договора типа \"Договор с ИМ\"),
\n- 2 - \"доставка\" (для любого договора).",
"format" : "int32"
},
"additional_order_types" : {
"uniqueItems" : true,
"description" : "Дополнительные типы заказа:
\n- 2 - для сборного груза (LTL). Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 4 - для Forward. Совместим с типом заказа \"ИМ\",
\n- 6 - для \"Фулфилмент. Приход\". Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 7 - для \"Фулфилмент. Отгрузка\". Совместим с типом заказа \"ИМ\",
\n- 9 - для Форвард.Экспресс (Forward.Express). Совместим с типом заказа \"ИМ\",
\n- 10 - для доставки шин по тарифу \"Экономичный экспресс\". Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 11 - для доставки в рамках одного офиса \"Один офис (ИМ)\" (при условии, что офис отправителя и получателя совпадают). Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 14 - для CDEK.Shopping. Совместим с типом заказа \"ИМ,
\n- 15 - для \"ТО для последней мили\" (отправка доместик (РФ-РФ) заказов по доп.типу \"ТО+посл.миля\" возможна только из МСК и складов: MSK662, 1 Рейсовая MSK1938, ТО, Москва, Москва-Карго, 1, RU и KHME33, ТО, Химки, Шереметьевское шоссе, 9, RU). Совместим с типом заказа \"ИМ\"/\"Доставка\".",
"items" : {
"format" : "int32"
}
},
"number" : {
"maxLength" : 40,
"description" : "Номер заказа в ИС клиента (только для заказов типа «интернет-магазин»). Допустимые символы: цифры, латинские буквы, спецсимволы (ASCII). В пределах одного договора среди активных (успешно созданных) неудаленных заказов номер заказа должен быть уникален. Исключение: если заказ с таким же номером находится в финальном статусе (DELIVERED / NOT_DELIVERED), создание нового заказа с повторным номером разрешено."
},
"accompanying_number" : {
"maxLength" : 255,
"description" : "Номер сопроводительной накладной на товар (СНТ)"
},
"tariff_code" : {
"description" : "Код тарифа",
"format" : "int32"
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к заказу"
},
"shipment_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом. Обязательное поле, если заказ с тарифом \"от склада\". Не может использоваться одновременно с from_location"
},
"delivery_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет доставлена посылка. Обязательное поле, если заказ с тарифом \"до склада\" или \"до постамата\". Не может использоваться одновременно с to_location"
},
"date_invoice" : {
"description" : "Дата инвойса. Обязательное поле, если заказ - международный с типом \"интернет-магазин\".
\nЕсли поле заполнено, то заказ автоматически становится международным.",
"format" : "date"
},
"shipper_name" : {
"maxLength" : 255,
"description" : "Грузоотправитель. Обязательное поле, если заказ - международный с типом \"интернет-магазин\".
\nЕсли поле заполнено, то заказ автоматически становится международным."
},
"shipper_address" : {
"maxLength" : 255,
"description" : "Адрес грузоотправителя. Обязательное поле, если заказ - международный с типом \"интернет-магазин\".
\nЕсли поле заполнено, то заказ автоматически становится международным."
},
"delivery_recipient_cost" : {
"$ref" : "#/components/schemas/DeliveryRecipientCostRequestDto"
},
"delivery_recipient_cost_adv" : {
"description" : "Доп. сбор за доставку (которую ИМ берет с получателя) в зависимости от суммы заказа (ДСД).\n
\nТолько для заказов \"интернет-магазин\". Возможно указать несколько порогов.
\nДСД применима только с доп. услугой «ЧАСТИЧНАЯ ДОСТАВКА» - в случае,
\nесли получатель купил одну или несколько позиций, или получатель полностью отказался от выкупа товара.\n
\nЕсли при полном отказе от товара оплачивать доп. сбор не требуется, тогда при настройке порогов стоимости необходимо передавать дополнительную товарную позицию «Доставка» в количестве 1 шт. стоимостью 0 рублей, дополнительный сбор за доставку - 0 рублей и далее пороги ДСД.
\n
\nЕсли при полном отказе от товара необходимо взять доп. сбор за доставку, то при настройке порогов в интеграции, необходимо указать дополнительную товарную позицию «Доставка» в количестве 1 шт. стоимостью 0 рублей, сумму доп.сбора за доставку с получателя необходимо задать при минимальном пороге стоимости, далее пороги ДСД, комментарии к заказу о необходимости вручения позиции \"Доставка\".",
"items" : {
"$ref" : "#/components/schemas/DeliveryCostThresholdDto"
}
},
"sender" : {
"$ref" : "#/components/schemas/SenderContactDto"
},
"seller" : {
"$ref" : "#/components/schemas/SellerDto"
},
"recipient" : {
"$ref" : "#/components/schemas/RecipientContactDto"
},
"from_location" : {
"$ref" : "#/components/schemas/RequestFromLocationDto"
},
"to_location" : {
"$ref" : "#/components/schemas/RequestToLocationDto"
},
"services" : {
"description" : "Дополнительные услуги",
"items" : {
"$ref" : "#/components/schemas/AdditionalServiceRequestDto"
}
},
"packages" : {
"description" : "Список информации по местам (упаковкам). Количество мест в заказе может быть от 1 до 255",
"items" : {
"$ref" : "#/components/schemas/PackageRequestDto"
}
},
"delivery_types" : {
"items" : { }
},
"print" : {
"maxLength" : 7,
"description" : "Тип печатной формы, которую необходимо сформировать по заказу",
"enum" : [ "WAYBILL", "BARCODE" ]
},
"widgetToken" : {
"description" : "Токен CMS, содержащий дополнительные данные для заполнения данных о заказе"
},
"is_client_return" : {
"description" : "Признак клиентского возврата.
\nНеобходимо использовать, если прямой заказ доставлялся другой курьерской службой, либо по прямому заказу необходимо вернуть не все товары.
\nИначе необходимо использовать отдельный метод \"Клиентские возвраты\" (POST /v2/orders/{order_uuid}/clientReturn)"
},
"has_reverse_order" : {
"description" : "Признак необходимости создания реверсного заказа"
},
"developer_key" : {
"description" : "Ключ разработчика"
}
},
"description" : "Запрос на создание заказа в рамках протокола"
},
"PackageRequestDto" : {
"required" : [ "number", "weight" ],
"properties" : {
"number" : {
"maxLength" : 30,
"description" : "Номер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиента"
},
"weight" : {
"description" : "Общий вес (в граммах)",
"format" : "int32"
},
"length" : {
"description" : "Габариты упаковки. Длина (в сантиметрах). Обязателен в случаях,
\n если указаны остальные габариты или
\n если заказ до постамата или
\n если общий вес >= 100 гр",
"format" : "int32"
},
"width" : {
"description" : "Габариты упаковки. Ширина (в сантиметрах). Обязателен в случаях,
\n если указаны остальные габариты или
\n если заказ до постамата или
\n если общий вес >= 100 гр",
"format" : "int32"
},
"height" : {
"description" : "Габариты упаковки. Высота (в сантиметрах). Обязателен в случаях,
\n если указаны остальные габариты или
\n если заказ до постамата или
\n если общий вес >= 100 гр",
"format" : "int32"
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к упаковке. Обязательно и только для заказа типа \"Доставка\""
},
"items" : {
"description" : "Позиции товаров в упаковке. Заполняется (обязательно) только для заказов \"интернет-магазин\".
\nМаксимум 126 уникальных позиций в заказе.
\nОбщее количество товаров в заказе может быть от 1 до 999999",
"items" : {
"$ref" : "#/components/schemas/ItemRequestDto"
}
},
"package_id" : {
"description" : "Уникальный номер упаковки в ИС СДЭК. Обязательно для уже существующей в заказе упаковки"
}
},
"description" : "Информация об упаковке"
},
"PhoneDto" : {
"required" : [ "number" ],
"properties" : {
"number" : {
"maxLength" : 24,
"description" : "Номер телефона"
},
"additional" : {
"maxLength" : 255,
"description" : "Дополнительная информация (добавочный номер)"
}
},
"description" : "Информация о телефонах"
},
"RecipientContactDto" : {
"required" : [ "name", "phones" ],
"properties" : {
"company" : {
"maxLength" : 255,
"description" : "Название компании"
},
"name" : {
"maxLength" : 255,
"description" : "ФИО контактного лица"
},
"contragent_type" : {
"maxLength" : 255,
"description" : "Тип получателя. Возможные значения: LEGAL_ENTITY - юридическое лицо, INDIVIDUAL - физическое лицо"
},
"passport_series" : {
"maxLength" : 4,
"description" : "Серия паспорта"
},
"passport_number" : {
"maxLength" : 30,
"description" : "Номер паспорта"
},
"passport_date_of_issue" : {
"description" : "Дата выдачи паспорта",
"format" : "date"
},
"passport_organization" : {
"maxLength" : 255,
"description" : "Орган выдачи паспорта"
},
"tin" : {
"maxLength" : 12,
"description" : "ИНН"
},
"passport_date_of_birth" : {
"description" : "Дата рождения",
"format" : "date"
},
"email" : {
"maxLength" : 255,
"description" : "Эл. адрес"
},
"phones" : {
"description" : "Список телефонов. Не более 10 номеров.",
"items" : {
"$ref" : "#/components/schemas/PhoneDto"
}
},
"passport_requirements_satisfied" : {
"description" : "Требования по паспортным данным удовлетворены",
"readOnly" : true
}
},
"description" : "Получатель"
},
"RequestFromLocationDto" : {
"required" : [ "address" ],
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"description" : "Название страны населенного пункта"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid"
},
"sub_region" : {
"maxLength" : 255,
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"time_zone" : {
"description" : "Часовой пояс населенного пункта"
},
"payment_limit" : {
"description" : "Ограничение на сумму наложенного платежа в населенном пункте",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
}
},
"description" : "Адрес отправления. Не может использоваться одновременно с shipment_point. Обязателен, если заказ с тарифом \"от двери\"."
},
"RequestToLocationDto" : {
"required" : [ "address" ],
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"description" : "Название страны населенного пункта"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid"
},
"sub_region" : {
"maxLength" : 255,
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"time_zone" : {
"description" : "Часовой пояс населенного пункта"
},
"payment_limit" : {
"description" : "Ограничение на сумму наложенного платежа в населенном пункте",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
}
},
"description" : "Адрес получения. Не может использоваться одновременно с delivery_point. Обязательное поле, если заказ с тарифом \"до двери\""
},
"SellerDto" : {
"properties" : {
"name" : {
"maxLength" : 255,
"description" : "Наименование истинного продавца"
},
"inn" : {
"maxLength" : 12,
"description" : "ИНН истинного продавца"
},
"phone" : {
"maxLength" : 255,
"description" : "Телефон истинного продавца. Обязательно, если заполнен inn"
},
"ownership_form" : {
"description" : "Код формы собственности"
},
"address" : {
"maxLength" : 255,
"description" : "Адрес истинного продавца"
}
},
"description" : "Реквизиты истинного продавца. Если требуется, чтобы реквизиты продавца отображались в чеках, то обязательно необходимо передать поля name, inn, phone. Если какое-то из полей не будет передано, в чеке будут отображены данные контрагента по договору."
},
"SellerItemDto" : {
"properties" : {
"name" : {
"maxLength" : 255,
"description" : "Наименование истинного продавца"
},
"inn" : {
"maxLength" : 12,
"description" : "ИНН истинного продавца"
},
"phone" : {
"description" : "Телефон истинного продавца"
},
"ownership_form" : {
"description" : "Код формы собственности"
},
"address" : {
"maxLength" : 255,
"description" : "Адрес истинного продавца. Используется при печати инвойсов для отображения адреса настоящего продавца товара либо торгового названия. Только для международных заказов \"интернет-магазин\""
},
"giis_subdivision_id" : {
"description" : "Идентификатор подразделения компании продавца в ЛК ГИИС"
}
},
"description" : "Реквизиты истинного продавца. Используется, когда нужно отобразить в заказе и чеке данные истинных продавцов по товарам, либо для передачи IDTOP (идентификатор подразделения компании продавца в ЛК ГИИС), если в товарах передается УИН ювелирного изделия. IDTOP необходим, чтобы ГИИС ДМ ДК имели возможность понять какое обособленное подразделение производит передачу УИН в курьерскую компанию.
\nЕсли требуется, чтобы реквизиты истинного продавца отображались в чеках, то обязательно необходимо передать поля name, inn, phone. Если какое-то из полей не будет передано, в чеке будут отображены данные контрагента по договору."
},
"SenderContactDto" : {
"required" : [ "name" ],
"properties" : {
"company" : {
"maxLength" : 255,
"description" : "Название компании"
},
"name" : {
"maxLength" : 255,
"description" : "ФИО контактного лица"
},
"contragent_type" : {
"maxLength" : 255,
"description" : "Тип отправителя. Возможные значения: LEGAL_ENTITY - юридическое лицо, INDIVIDUAL - физическое лицо",
"enum" : [ "LEGAL_ENTITY", "INDIVIDUAL" ]
},
"passport_series" : {
"maxLength" : 4,
"description" : "Серия паспорта"
},
"passport_number" : {
"maxLength" : 30,
"description" : "Номер паспорта"
},
"passport_date_of_issue" : {
"description" : "Дата выдачи паспорта",
"format" : "date"
},
"passport_organization" : {
"maxLength" : 255,
"description" : "Орган выдачи паспорта"
},
"tin" : {
"maxLength" : 12,
"description" : "ИНН"
},
"passport_date_of_birth" : {
"description" : "Дата рождения",
"format" : "date"
},
"email" : {
"maxLength" : 255,
"description" : "Эл. адрес"
},
"phones" : {
"description" : "Список телефонов. Не более 10 номеров. Обязательно для заполнения, если при регистрации заказа не был указан номер отправителя",
"items" : {
"$ref" : "#/components/schemas/PhoneDto"
}
},
"passport_requirements_satisfied" : {
"description" : "Требования по паспортным данным удовлетворены",
"readOnly" : true
}
},
"description" : "Отправитель. Не обязателен для заполнения, если заказ типа \"интернет-магазин\", обязателен, если заказ типа \"доставка\""
},
"RequestDto" : {
"required" : [ "date_time", "state", "type" ],
"properties" : {
"request_uuid" : {
"description" : "Идентификатор запроса в ИС СДЭК",
"format" : "uuid"
},
"type" : {
"description" : "Тип запроса
\nМожет принимать значения: CREATE, UPDATE, DELETE, AUTH, GET, CREATE_CLIENT_RETURN"
},
"date_time" : {
"description" : "Дата и время установки текущего состояния запроса",
"format" : "date-time"
},
"state" : {
"maxLength" : 255,
"description" : "Текущее состояние запроса. Может принимать значения:
\n- ACCEPTED - пройдена предварительная валидация и запрос принят
\n- WAITING - запрос ожидает обработки (зависит от выполнения другого запроса)
\n- SUCCESSFUL - запрос обработан успешно
\n- INVALID - запрос обработался с ошибкой"
},
"errors" : {
"description" : "Ошибки, возникшие в ходе выполнения запроса",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Предупреждения, возникшие в ходе выполнения запроса",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
}
},
"description" : "Информация о запросе над сущностью"
},
"WarningDto" : {
"required" : [ "code", "message" ],
"properties" : {
"code" : {
"description" : "Код предупреждения"
},
"message" : {
"description" : "Описание предупреждения"
}
},
"description" : "Предупреждение, возникшее в ходе выполнения запроса"
},
"RelatedEntityDto" : {
"required" : [ "type", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор сущности в ИС СДЭК",
"format" : "uuid"
},
"type" : {
"description" : "Тип связанной сущности.
\nМожет принимать значения:
\n- return_order - возвратный заказ (возвращается для прямого, если заказ не вручен и по нему уже был сформирован возвратный заказ)
\n- direct_order - прямой заказ (возвращается для возвратного и реверсного заказа)
\n- waybill - квитанция к заказу (возвращается для заказа, по которому есть сформированная квитанция)
\n- barcode - ШК места к заказу (возвращается для заказа, по которому есть сформированный ШК места)
\n- reverse_order - реверсный заказ (возвращается для прямого заказа, если подключен реверс)
\n- delivery - актуальная договоренность о доставке
\n- client_return_order - заказ клиентский возврат (возвращается для прямого заказа, к которому привязан клиентский возврат)
\n- client_direct_order - прямой заказ, по которому оформлен клиентский возврат",
"enum" : [ "return_order", "direct_order", "client_return_order", "client_direct_order", "waybill", "barcode", "reverse_order", "delivery" ]
},
"url" : {
"maxLength" : 255,
"description" : "Ссылка на скачивание печатной формы. Только для типов waybill и barcode"
},
"create_time" : {
"description" : "Время создания связанной сущности",
"format" : "date-time"
},
"cdek_number" : {
"maxLength" : 255,
"description" : "Номер заказа СДЭК. Только для типов return_order, direct_order, reverse_order"
},
"date" : {
"description" : "Дата доставки, согласованная с получателем",
"format" : "date"
},
"time_from" : {
"pattern" : "",
"description" : "Время начала ожидания курьера",
"example" : "15:00"
},
"time_to" : {
"pattern" : "",
"description" : "Время окончания ожидания курьера",
"example" : "15:00"
}
},
"description" : "Связанная сущность"
},
"ResponseDtoOrderCreateRequestDto" : {
"required" : [ "requests" ],
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/OrderCreateRequestDto"
},
"requests" : {
"description" : "Информация о запросах, относящихся к сущности.",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на запрос"
},
"ReverseValidateRequestDto" : {
"required" : [ "recipient", "sender", "tariff_code" ],
"properties" : {
"from_location" : {
"$ref" : "#/components/schemas/ReverseValidateRequestFromLocationDto"
},
"shipment_point" : {
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом. Не может использоваться одновременно с from_location. \nЕсли при создании заказа еще не известен ПВЗ отправки, можно указать любой ПВЗ в населенном пункте, из которого будет производится отправка, либо передать только сам населенный пункт отправки в from_location"
},
"to_location" : {
"$ref" : "#/components/schemas/ReverseValidateRequestToLocationDto"
},
"delivery_point" : {
"description" : "Код ПВЗ СДЭК, на который будет доставлена посылка. Обязательное поле, если тариф с режимом \"до склада\" или \"до постамата\". Не может использоваться одновременно с to_location"
},
"tariff_code" : {
"description" : "Код тарифа",
"format" : "int32"
},
"sender" : {
"$ref" : "#/components/schemas/ReverseValidateRequestSenderDto"
},
"recipient" : {
"$ref" : "#/components/schemas/ReverseValidateRequestRecipientDto"
}
},
"description" : "Запрос на проверку доступности реверса по данным прямого заказа"
},
"ReverseValidateRequestFromLocationDto" : {
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"postal_code" : {
"description" : "Почтовый индекс"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"country_code" : {
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"region" : {
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"sub_region" : {
"description" : "Название района региона"
},
"city" : {
"description" : "Название населенного пункта"
},
"address" : {
"description" : "Строка адреса"
}
},
"description" : "Адрес отправления. Не может использоваться одновременно с shipment_point. Обязателен, если тариф с режимом \"от двери\"."
},
"ReverseValidateRequestPhoneDto" : {
"required" : [ "number" ],
"properties" : {
"number" : {
"description" : "Номер телефона\n\nДолжен передаваться в международном формате: код страны и сам номер"
},
"additional" : {
"description" : "Дополнительная информация (добавочный номер)"
}
}
},
"ReverseValidateRequestRecipientDto" : {
"required" : [ "phones" ],
"properties" : {
"contragent_type" : {
"description" : "Тип получателя\n\nВозможные значения:\n\nLEGAL_ENTITY - юридическое лицо\n\nINDIVIDUAL - физическое лицо",
"enum" : [ "LEGAL_ENTITY", "INDIVIDUAL" ]
},
"phones" : {
"description" : "Список телефонов.\n\nНе более 10 номеров",
"items" : {
"$ref" : "#/components/schemas/ReverseValidateRequestPhoneDto"
}
}
},
"description" : "Получатель"
},
"ReverseValidateRequestSenderDto" : {
"required" : [ "phones" ],
"properties" : {
"contragent_type" : {
"description" : "Тип отправителя\n\nВозможные значения:\n\nLEGAL_ENTITY - юридическое лицо\n\nINDIVIDUAL - физическое лицо",
"enum" : [ "LEGAL_ENTITY", "INDIVIDUAL" ]
},
"phones" : {
"description" : "Список телефонов.\n\nНе более 10 номеров",
"items" : {
"$ref" : "#/components/schemas/ReverseValidateRequestPhoneDto"
}
}
},
"description" : "Отправитель"
},
"ReverseValidateRequestToLocationDto" : {
"required" : [ "address" ],
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"postal_code" : {
"description" : "Почтовый индекс"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"country_code" : {
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"region" : {
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"sub_region" : {
"description" : "Название района региона"
},
"city" : {
"description" : "Название населенного пункта"
},
"address" : {
"description" : "Строка адреса"
}
},
"description" : "Адрес получения. Не может использоваться одновременно с delivery_point. Обязательное поле, если тариф с режимом \"до двери\""
},
"PrintOrderDto" : {
"properties" : {
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не указан номер заказа",
"format" : "uuid"
},
"cdek_number" : {
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа",
"format" : "int64"
}
},
"description" : "Заказ к печати"
},
"WaybillRequestDto" : {
"required" : [ "orders" ],
"properties" : {
"orders" : {
"description" : "Список заказов",
"items" : {
"$ref" : "#/components/schemas/PrintOrderDto"
}
},
"copy_count" : {
"description" : "Число копий одной квитанции на листе. Рекомендовано указывать не менее 2, одна приклеивается на груз, вторая остается у отправителя",
"format" : "int32",
"default" : 2
},
"type" : {
"maxLength" : 255,
"description" : "Форма квитанции. По умолчанию будет выбрана форма на русском языке",
"enum" : [ "tpl_china", "tpl_armenia", "tpl_russia", "tpl_english", "tpl_italian", "tpl_korean", "tpl_latvian", "tpl_lithuanian", "tpl_german", "tpl_turkish", "tpl_czech", "tpl_thailand", "tpl_invoice" ]
}
},
"description" : "Запрос на формирование квитанции к заказу"
},
"WaybillPrintResponseDto" : {
"required" : [ "requests" ],
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/WaybillResponseRootEntityDto"
},
"requests" : {
"description" : "Информация о запросах над квитанцией к заказу",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на формирование квитанции к заказу"
},
"WaybillResponseRootEntityDto" : {
"properties" : {
"uuid" : {
"description" : "Идентификатор квитанции к заказу в ИС СДЭК",
"format" : "uuid"
}
},
"description" : "Информация о квитанции к заказу"
},
"BarcodeRequestDto" : {
"required" : [ "orders" ],
"properties" : {
"orders" : {
"description" : "Список заказов",
"items" : {
"$ref" : "#/components/schemas/PrintOrderDto"
}
},
"copy_count" : {
"description" : "Число копий. По умолчанию 1",
"format" : "int32",
"default" : 1
},
"format" : {
"maxLength" : 2,
"description" : "Формат печати. Может принимать значения: A4, A5, A6, A7 (A - буква латинского алфавита).",
"default" : "A4",
"enum" : [ "A4", "A5", "A6", "A7" ]
},
"lang" : {
"maxLength" : 3,
"description" : "Язык печатной формы. Возможные языки в кодировке ISO - 639-3:
\nРусский - RUS
\nАнглийский - ENG",
"enum" : [ "RUS", "ENG" ]
}
},
"description" : "Запрос на формирование ШК места к заказу"
},
"BarcodePrintResponseDto" : {
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/BarcodeResponseRootEntityDto"
},
"requests" : {
"description" : "Информация о запросах над ШК местом к заказу",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на формирование ШК места к заказу"
},
"BarcodeResponseRootEntityDto" : {
"properties" : {
"uuid" : {
"description" : "Идентификатор ШК места к заказу в ИС СДЭК",
"format" : "uuid"
}
},
"description" : "Информация о ШК места к заказу"
},
"RegisterPrealertRequestDto" : {
"required" : [ "orders", "planned_date", "shipment_point" ],
"properties" : {
"planned_date" : {
"description" : "Планируемая дата передачи заказов в СДЭК",
"format" : "date-time"
},
"shipment_point" : {
"description" : "Код ПВЗ, в который планируется передать заказы"
},
"orders" : {
"description" : "Список заказов, которые планируется передать в СДЭК",
"items" : {
"$ref" : "#/components/schemas/RegisterPrealertRequestDtoOrderDto"
}
}
},
"description" : "Запрос на регистрацию преалерта"
},
"RegisterPrealertRequestDtoOrderDto" : {
"properties" : {
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не указан номер заказа",
"format" : "uuid"
},
"cdek_number" : {
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа",
"format" : "int64"
},
"im_number" : {
"maxLength" : 40,
"description" : "Номер заказа в ИС Клиента"
}
},
"description" : "Заказ, которые планируется передать в СДЭК"
},
"EntityDto" : {
"properties" : {
"uuid" : {
"description" : "Идентификатор преалерта в ИС СДЭК",
"format" : "uuid"
}
}
},
"RegisterPrealertResponseDto" : {
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/EntityDto"
},
"requests" : {
"description" : "Информация о запросах над преалертом",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Преалерт"
},
"PhotoOrderDto" : {
"properties" : {
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не указан номер заказа",
"format" : "uuid"
},
"cdek_number" : {
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа",
"format" : "int64"
}
},
"description" : "Заказ, по которому нужно получить фото"
},
"PhotoRequestDto" : {
"properties" : {
"period_begin" : {
"pattern" : "yyyy-MM-dd'T'HH:mm:ssZ",
"description" : "Начало периода поиска",
"format" : "date-time",
"example" : "2025-03-24T14:15:22+0000"
},
"period_end" : {
"pattern" : "yyyy-MM-dd'T'HH:mm:ssZ",
"description" : "Конец периода поиска",
"format" : "date-time",
"example" : "2025-03-28T14:15:22+0000"
},
"orders" : {
"description" : "Список заказов",
"items" : {
"$ref" : "#/components/schemas/PhotoOrderDto"
}
}
},
"description" : "Запрос на получение списка заказов с готовыми фото"
},
"PhotoReadyOrderDto" : {
"properties" : {
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не указан номер заказа",
"format" : "uuid"
},
"cdek_number" : {
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа"
},
"link" : {
"description" : "Ссылка на скачивание архива с фотографиями
Формат: https://api.cdek.ru/v2/photoDocument/{uuid}
Для получения архива воспользуйтесь методом \"Скачивание готового архива\""
},
"status" : {
"description" : "Статус задания на фотографирование, в рамках которого был сформирован архив с фото документов.
Может принимать значения:
CREATED - Создано\t
READY_FOR_EXECUTION - Готово к исполнению
IN_PROGRESS - В работе
DONE - Выполнено
SENT - Отправлено
DELIVERED - Доставлено
NOT_DELIVERED - Не вручено
ERROR - Ошибка
Архив является готовым к скачиванию, когда задание приобретает статус DONE.",
"enum" : [ "CREATED", "READY_FOR_EXECUTION", "IN_PROGRESS", "DONE", "SENT", "DELIVERED", "NOT_DELIVERED", "ERROR" ]
},
"create_date" : {
"description" : "Дата создания задания",
"format" : "date-time"
}
},
"description" : "Готовый к скачиванию заказ"
},
"PhotoResponseDto" : {
"properties" : {
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
},
"orders" : {
"description" : "Перечень готовых к скачиванию заказов",
"items" : {
"$ref" : "#/components/schemas/PhotoReadyOrderDto"
}
}
},
"description" : "Ответ на получение списка заказов с готовыми фото"
},
"ResponseDtoRootEntityDto" : {
"required" : [ "requests" ],
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/RootEntityDto"
},
"requests" : {
"description" : "Информация о запросах, относящихся к сущности.",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на запрос"
},
"RootEntityDto" : {
"required" : [ "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор сущности в ИС СДЭК",
"format" : "uuid"
}
}
},
"CreateClientReturnRequestDto" : {
"required" : [ "tariff_code" ],
"properties" : {
"tariff_code" : {
"description" : "Код тарифа",
"format" : "int32"
}
},
"description" : "Запрос на создание клиентского возврата."
},
"RestrictionHintsRequestDto" : {
"properties" : {
"tariff_code" : {
"description" : "Код тарифа. Обязателен для расчета по коду тарифа",
"format" : "int32"
},
"from_location" : {
"$ref" : "#/components/schemas/LocationDto1"
},
"to_location" : {
"$ref" : "#/components/schemas/LocationDto1"
},
"packages" : {
"description" : "Список информации по местам (упаковкам)",
"items" : {
"$ref" : "#/components/schemas/RestrictionPackageRequestDto"
}
}
},
"description" : "Запрос на проверку ограничений по международным заказам"
},
"RestrictionItemRequestDto" : {
"properties" : {
"name" : {
"description" : "Наименование товара (может также содержать описание товара: размер, цвет).
\nСогласно законодательству РФ, название товара или услуги должно быть конкретным, понятным, позволяющим идентифицировать товар или услугу, должны быть отражены конкретные товарные позиции.
\nПример:
\n\"товар 1\" - некорректное наименование
\n\"Джинсы мужские Henry, размер M\" - корректное наименование"
},
"amount" : {
"description" : "Количество единиц товара (в штуках). Количество одного товара в заказе может быть от 1 до 999",
"format" : "int32"
},
"itemId" : {
"description" : "Идентификатор товара",
"writeOnly" : true
},
"feacn_code" : {
"description" : "Код ТН ВЭД"
}
},
"description" : "Описание товара"
},
"RestrictionPackageRequestDto" : {
"properties" : {
"weight" : {
"description" : "Общий вес (в граммах)",
"format" : "int32"
},
"length" : {
"description" : "Габариты упаковки. Длина (в сантиметрах)",
"format" : "int32"
},
"width" : {
"description" : "Габариты упаковки. Ширина (в сантиметрах)",
"format" : "int32"
},
"height" : {
"description" : "Габариты упаковки. Высота (в сантиметрах)",
"format" : "int32"
},
"items" : {
"description" : "Позиции товаров в упаковке. Заполняется (обязательно) только для заказов \"интернет-магазин\".
\nМаксимум 126 уникальных позиций в заказе.
\nОбщее количество товаров в заказе может быть от 1 до 999999",
"items" : {
"$ref" : "#/components/schemas/RestrictionItemRequestDto"
}
},
"package_id" : {
"description" : "Уникальный номер упаковки в ИС СДЭК. Обязательно для уже существующей в заказе упаковки"
}
},
"description" : "Информация об упаковке"
},
"HintReasonDto" : {
"properties" : {
"code" : {
"description" : "Код причины ограничения. Может принимать значения: FEACN_RESTRICTION, GENERAL_RESTRICTION.\nТак как статусы FORBIDDEN, LIMITED, ALLOWED у грузоместа могут быть порождены как самим грузоместом, так и товарами в нем, то для уточнения передаем причину статуса ограничения:\n\nFEACN_RESTRICTION - ограничение на товар(ы) по направлению. Ограничение на конкретные товары внутри грузоместа:\nGENERAL_RESTRICTION - общее ограничение на грузоместо(а) по направлению. Не зависит от конкретного содержимого грузоместа. Для выставления данного ограничения анализируются весогабаритные характеристики грузоместа, его цена, количество мест в заказе и пр.."
},
"name" : {
"description" : "Наименование причины"
}
},
"description" : "Причина статуса"
},
"HintStatusDto" : {
"properties" : {
"code" : {
"description" : "Код статуса ограничения. Может принимать значения: FORBIDDEN, LIMITED, ALLOWED.\n FORBIDDEN - строгий запрет создания заказа;\n LIMITED - не блокирует создание заказа, но предъявляет определенные условия или комментарии, например, \"Необходим инвойс\" или \"Только в стеклянной таре\";\n ALLOWED - разрешено."
},
"name" : {
"description" : "Наименование статуса"
},
"reason" : {
"$ref" : "#/components/schemas/HintReasonDto"
}
},
"description" : "Статус подсказки по ограничениям"
},
"ItemHintDto" : {
"properties" : {
"item_id" : {
"description" : "Уникальный идентификатор товара"
},
"feacn_code" : {
"description" : "Код товара ТН ВЭД"
},
"status" : {
"$ref" : "#/components/schemas/HintStatusDto"
},
"limitations" : {
"description" : "Ограничения по товару",
"items" : { }
},
"documents" : {
"description" : "Список документов",
"items" : { }
}
},
"description" : "Описание ограничений по товарам"
},
"PackageHintDto" : {
"properties" : {
"package_id" : {
"description" : "Уникальный идентификатор упаковки"
},
"status" : {
"$ref" : "#/components/schemas/HintStatusDto"
},
"description" : {
"description" : "Описание ограничения"
},
"items" : {
"description" : "Список ограничений по товарам",
"items" : {
"$ref" : "#/components/schemas/ItemHintDto"
}
}
},
"description" : "Описание ограничений по упаковке"
},
"RestrictionHintsResponseDto" : {
"properties" : {
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
},
"packages" : {
"description" : "Список ограничений по упаковке",
"items" : {
"$ref" : "#/components/schemas/PackageHintDto"
}
}
},
"description" : "Ответ на запрос ограничений"
},
"IntakeContactDto" : {
"required" : [ "name" ],
"properties" : {
"company" : {
"maxLength" : 255,
"description" : "Название компании"
},
"name" : {
"maxLength" : 255,
"description" : "ФИО контактного лица"
},
"contragent_type" : {
"maxLength" : 255,
"description" : "Тип отправителя. Возможные значения: LEGAL_ENTITY - юридическое лицо, INDIVIDUAL - физическое лицо"
},
"passport_series" : {
"maxLength" : 4,
"description" : "Серия паспорта"
},
"passport_number" : {
"maxLength" : 30,
"description" : "Номер паспорта"
},
"passport_date_of_issue" : {
"description" : "Дата выдачи паспорта",
"format" : "date"
},
"passport_organization" : {
"maxLength" : 255,
"description" : "Орган выдачи паспорта"
},
"tin" : {
"maxLength" : 12,
"description" : "ИНН"
},
"passport_date_of_birth" : {
"description" : "Дата рождения",
"format" : "date"
},
"email" : {
"maxLength" : 255,
"description" : "Эл. адрес"
},
"phones" : {
"description" : "Список телефонов. Не более 10 номеров. Обязательно для заполнения, если при регистрации заказа не был указан номер отправителя",
"items" : {
"$ref" : "#/components/schemas/PhoneDto"
}
},
"passport_requirements_satisfied" : {
"description" : "Требования по паспортным данным удовлетворены",
"readOnly" : true
}
},
"description" : "Отправитель. Необходимо заполнять, если не передан номер заказа. Если номер заказа передан, данные об отправителе будут взяты из этого заказа"
},
"IntakeDto" : {
"required" : [ "intake_date", "intake_time_from", "intake_time_to" ],
"properties" : {
"cdek_number" : {
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа"
},
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не указан номер заказа"
},
"intake_date" : {
"description" : "Дата ожидания курьера Дата ожидания курьера не может быть больше текущей более чем на 31 день. Заявка, созданная на текущую дату после 15:00 по времени отправителя, может быть выполнена на следующий день"
},
"intake_time_from" : {
"pattern" : "HH:mm",
"description" : "Время начала ожидания курьера. Не ранее 9:00 местного времени",
"example" : "09:00"
},
"intake_time_to" : {
"pattern" : "HH:mm",
"description" : "Время окончания ожидания курьера. Не позднее 22:00 местного времени",
"example" : "18:00"
},
"lunch_time_from" : {
"pattern" : "HH:mm",
"description" : "Время начала обеда, должно входить в диапазон [intake_time_from; intake_time_to]",
"example" : "14:00"
},
"lunch_time_to" : {
"pattern" : "HH:mm",
"description" : "Время окончания обеда, должно входить в диапазон [intake_time_from; intake_time_to]",
"example" : "15:00"
},
"name" : {
"maxLength" : 255,
"description" : "Описание груза. Необходимо заполнять, если не передан номер заказа. Иначе значение берется из заказа"
},
"weight" : {
"description" : "Общий вес (в граммах). Если значение не передано, то по умолчанию - 100.",
"format" : "int32"
},
"length" : {
"description" : "Габариты упаковки. Длина (в сантиметрах). Если значение не передано, то по умолчанию - 1.",
"format" : "int32"
},
"width" : {
"description" : "Габариты упаковки. Ширина (в сантиметрах). Если значение не передано, то по умолчанию - 1.",
"format" : "int32"
},
"height" : {
"description" : "Габариты упаковки. Высота (в сантиметрах). Если значение не передано, то по умолчанию - 1.",
"format" : "int32"
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к заявке для курьера"
},
"courier_power_of_attorney" : {
"description" : "Курьеру необходима доверенность (по умолчанию - false)"
},
"courier_identity_card" : {
"description" : "Курьеру необходим документ удостоверяющий личность (по умолчанию - false)"
},
"sender" : {
"$ref" : "#/components/schemas/IntakeContactDto"
},
"from_location" : {
"$ref" : "#/components/schemas/IntakeLocationDto"
},
"need_call" : {
"description" : "Необходим прозвон отправителя (по умолчанию - false)"
}
},
"description" : "Заявка на вызов курьера (забор груза)"
},
"IntakeLocationDto" : {
"required" : [ "address" ],
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"maxLength" : 255,
"description" : "Название страны населенного пункта"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid",
"deprecated" : true
},
"kladr_region_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР региона населенного пункта",
"deprecated" : true
},
"sub_region" : {
"maxLength" : 255,
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
}
},
"description" : "Населённый пункт. Необходимо заполнять, если не передан номер заказа. Иначе значение берется из заказа"
},
"IntakeAvailableDaysLocationDto" : {
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"sub_region" : {
"maxLength" : 255,
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса. Обязательна, если не передан code"
}
},
"description" : "Населённый пункт"
},
"IntakeAvailableDaysRequestDto" : {
"required" : [ "from_location" ],
"properties" : {
"from_location" : {
"$ref" : "#/components/schemas/IntakeAvailableDaysLocationDto"
},
"date" : {
"description" : "Дата, до какого числа включительно получить доступные дни.
\nНапример, если будет передана дата \"2026-03-25\", то вернутся все даты, в которые доступен забор груза, начиная с даты запроса и до \"2026-03-25\" включительно.
\nЧасовой пояс пользователя не учитывается.
\nЕсли дата не передана, то даты вернутся по умолчанию с промежутком от сегодня до плюс две недели."
}
},
"description" : "Запрос на получение доступных дат вызова курьера для населенных пунктов"
},
"IntakeAvailableDaysResponseDto" : {
"properties" : {
"date" : {
"description" : "Доступные даты для забора курьером",
"items" : {
"format" : "date"
}
},
"all_days" : {
"description" : "Признак \"Забор доступен по всем дням\", может принимать значения:
\n\"true\" - забор доступен по всем дням;
\n\"false\" - забор доступен не по всем дням.
\nЕсли забор доступен по всем дням из запрошенного диапазона дат, в ответе вернется \"all_days\" = true, список дат в \"date\" при этом возвращен не будет."
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
}
},
"description" : "Ответ на запрос на получение доступных дат вызова курьера для населенных пунктов"
},
"ScheduleDto" : {
"required" : [ "date" ],
"properties" : {
"cdek_number" : {
"maxLength" : 255,
"description" : "Номер заказа СДЭК. Обязателен, если не передан order_uuid"
},
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не передан cdek_number",
"format" : "uuid"
},
"date" : {
"description" : "Дата доставки, согласованная с получателем. (Если заказ \"До склада\", эта дата не влияет на сроки доставки и может быть произвольной)",
"format" : "date"
},
"time_from" : {
"pattern" : "HH:mm",
"description" : "Время доставки \"С\", согласованное с получателем. Обязательно, если заказ \"до двери\""
},
"time_to" : {
"pattern" : "HH:mm",
"description" : "Время доставки \"Пo\", согласованное с получателем. Обязательно, если заказ \"до двери\""
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к договоренности о доставке"
},
"delivery_point" : {
"maxLength" : 255,
"description" : "Буквенно-цифровой код ПВЗ СДЭК, на который будет доставлена посылка, например \"MSK93\". Не может быть заполнен одновременно с to_location. Обязателен, если заказ \"до склада\""
},
"to_location" : {
"$ref" : "#/components/schemas/ScheduleLocationDto"
}
},
"description" : "Договоренность о доставке"
},
"ScheduleLocationDto" : {
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"maxLength" : 255,
"description" : "Название страны населенного пункта"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid",
"deprecated" : true
},
"kladr_region_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР региона населенного пункта",
"deprecated" : true
},
"sub_region" : {
"maxLength" : 255,
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
}
},
"description" : "Населённый пункт"
},
"EstimatedDeliveryIntervalsRequestDto" : {
"required" : [ "date_time", "tariff_code", "to_location" ],
"properties" : {
"date_time" : {
"description" : "Дата и время планируемой отправки",
"format" : "date-time",
"example" : "2021-08-03T13:08:49Z"
},
"from_location" : {
"$ref" : "#/components/schemas/EstimatedDeliveryIntervalsRequestFromLocationDto"
},
"shipment_point" : {
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом. Не может использоваться одновременно с from_location. Обязателен, если тариф с режимом \"от склада\"."
},
"to_location" : {
"$ref" : "#/components/schemas/EstimatedDeliveryIntervalsRequestToLocationDto"
},
"tariff_code" : {
"description" : "Код тарифа",
"format" : "int32"
},
"additional_order_types" : {
"uniqueItems" : true,
"description" : "Дополнительный тип заказа:
2 - для сборного груза (LTL). Совместим с типом заказа \"ИМ\"/\"Доставка\";
4 - для Форвард (Forward). Совместим с типом заказа \"ИМ\";
6 - для \"Фулфилмент. Приход\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
7 - для \"Фулфилмент. Отгрузка\". Совместим с типом заказа \"ИМ\";
9 - для Форвард. Экспресс (Forward. Express). Совместим с типом заказа \"ИМ\";
10 - для доставки шин по тарифу \"Экономичный экспресс\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
11 - для доставки в рамках одного офиса \"Один офис\" (при условии, что офис отправителя и получателя совпадают). Совместим с типом заказа \"ИМ\"/\"Доставка\";
14 - для CDEK.Shopping. Совместим с типом заказа \"ИМ\";
15 - для \"ТО для последней мили\". Совместим с типом заказа \"ИМ\"/\"Доставка\".",
"items" : {
"format" : "int32"
}
}
},
"description" : "Запрос на получение доступных интервалов доставки до создания заказа"
},
"EstimatedDeliveryIntervalsRequestFromLocationDto" : {
"required" : [ "address" ],
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"postal_code" : {
"description" : "Почтовый индекс"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"country_code" : {
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"region" : {
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"sub_region" : {
"description" : "Название района региона"
},
"city" : {
"description" : "Название населенного пункта"
},
"address" : {
"description" : "Строка адреса"
}
},
"description" : "Адрес отправления. Не может использоваться одновременно с shipment_point. Обязателен, если заказ с тарифом \"от двери\"."
},
"EstimatedDeliveryIntervalsRequestToLocationDto" : {
"required" : [ "address" ],
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"postal_code" : {
"description" : "Почтовый индекс"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"country_code" : {
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"region" : {
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"sub_region" : {
"description" : "Название района региона"
},
"city" : {
"description" : "Название населенного пункта"
},
"address" : {
"description" : "Строка адреса"
}
},
"description" : "Адрес доставки"
},
"EstimatedDeliveryIntervalDto" : {
"properties" : {
"start_time" : {
"pattern" : "HH:mm",
"description" : "Время начала интервала доставки"
},
"end_time" : {
"pattern" : "HH:mm",
"description" : "Время окончания интервала доставки"
},
"agreed_count" : {
"description" : "Количество согласованных доставок в интервале",
"format" : "int32"
},
"total_count" : {
"description" : "Всего доставок в интервале",
"format" : "int32"
}
},
"description" : "Доступные интервалы доставки до создания заказа"
},
"EstimatedDeliveryIntervalsInfoDto" : {
"properties" : {
"date" : {
"description" : "Дата доступного интервала для доставки (формат yyyy-MM-dd)",
"format" : "date"
},
"time_intervals" : {
"description" : "Временные интервалы для доставки",
"items" : {
"$ref" : "#/components/schemas/EstimatedDeliveryIntervalDto"
}
}
},
"description" : "Доступные интервалы доставки до создания заказа"
},
"EstimatedDeliveryIntervalsResponseDto" : {
"required" : [ "date_intervals" ],
"properties" : {
"date_intervals" : {
"description" : "Доступные интервалы доставки до создания заказа",
"items" : {
"$ref" : "#/components/schemas/EstimatedDeliveryIntervalsInfoDto"
}
}
},
"description" : "Ответ на получение интервалов доставки до создания заказа"
},
"CalcPackageRequestDto" : {
"required" : [ "weight" ],
"properties" : {
"weight" : {
"description" : "Общий вес (в граммах)",
"format" : "int32"
},
"length" : {
"description" : "Габариты упаковки. Длина (в сантиметрах)",
"format" : "int32"
},
"width" : {
"description" : "Габариты упаковки. Ширина (в сантиметрах)",
"format" : "int32"
},
"height" : {
"description" : "Габариты упаковки. Высота (в сантиметрах)",
"format" : "int32"
}
},
"description" : "Информация об упаковке"
},
"CalculatorLocationDto" : {
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"contragent_type" : {
"maxLength" : 20,
"description" : "Тип контрагента, разрешённые значения:
LEGAL_ENTITY - юридическое лицо;
INDIVIDUAL - физическое лицо."
},
"longitude" : {
"maxLength" : 20,
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"maxLength" : 20,
"description" : "Широта",
"format" : "double"
}
},
"description" : "Населённый пункт для вычислений тарифа"
},
"CalculatorTariffListRequestDto" : {
"required" : [ "from_location", "packages", "to_location" ],
"properties" : {
"date" : {
"pattern" : "yyyy-MM-dd'T'HH:mm:ssZ",
"description" : "Дата и время планируемой передачи заказа. По умолчанию - текущая",
"example" : "2025-03-24T14:15:22+0700"
},
"type" : {
"description" : "Тип заказа.
1 - интернет-магазин,
2 - доставка.
По умолчанию - 1",
"format" : "int32"
},
"additional_order_types" : {
"uniqueItems" : true,
"description" : "Дополнительный тип заказа:
2 - для сборного груза (LTL). Совместим с типом заказа \"ИМ\"/\"Доставка\";
4 - для Форвард (Forward). Совместим с типом заказа \"ИМ\";
6 - для \"Фулфилмент. Приход\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
7 - для \"Фулфилмент. Отгрузка\". Совместим с типом заказа \"ИМ\";
9 - для Форвард. Экспресс (Forward. Express). Совместим с типом заказа \"ИМ\";
10 - для доставки шин по тарифу \"Экономичный экспресс\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
11 - для доставки в рамках одного офиса \"Один офис\" (при условии, что офис отправителя и получателя совпадают). Совместим с типом заказа \"ИМ\"/\"Доставка\";
14 - для CDEK.Shopping. Совместим с типом заказа \"ИМ\";
15 - для \"ТО для последней мили\". Совместим с типом заказа \"ИМ\"/\"Доставка\".",
"items" : {
"format" : "int32"
}
},
"currency" : {
"description" : "Валюта, в которой необходимо произвести расчет (числовой код из \"Приложение 14. Код валюты для методов расчета стоимости\").
По умолчанию - валюта договора",
"format" : "int32"
},
"lang" : {
"maxLength" : 3,
"description" : "Язык вывода информации о тарифах.
Возможные значения: rus, eng, zho.
По умолчанию - rus"
},
"shipment_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом (для заказов с режимом доставки «от склада»). Если офис известен на этапе расчета, передача кода офиса в запросе повысит точность расчета сроков доставки. Если в запросе указывается код офиса, но он не подходит по параметрам, то офис подменяется на ближайший с подходящими характеристиками. Если ближайший офис не удалось подобрать, офис не будет включен в расчет."
},
"delivery_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет доставлена посылка (для заказов с режимом доставки «до склада»). Если офис известен на этапе расчета, передача кода офиса в запросе повысит точность расчета сроков доставки. Если в запросе указывается код офиса, но он не подходит по параметрам, то офис подменяется на ближайший с подходящими характеристиками. Если ближайший офис не удалось подобрать, офис не будет включен в расчет."
},
"from_location" : {
"$ref" : "#/components/schemas/CalculatorLocationDto"
},
"to_location" : {
"$ref" : "#/components/schemas/CalculatorLocationDto"
},
"packages" : {
"description" : "Места (упаковки) в заказе",
"items" : {
"$ref" : "#/components/schemas/CalcPackageRequestDto"
}
}
},
"description" : "Запрос на расчет по доступным тарифам"
},
"CalculatorTariffListResponseDto" : {
"properties" : {
"tariff_codes" : {
"description" : "Доступные тарифы",
"items" : {
"$ref" : "#/components/schemas/TariffCodeDto"
}
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
}
},
"description" : "Ответ на запрос расчета по доступным тарифам"
},
"DeliveryDateRangeDto" : {
"properties" : {
"min" : {
"description" : "Минимальная дата",
"format" : "date",
"example" : "2022-02-02"
},
"max" : {
"description" : "Максимальная дата",
"format" : "date",
"example" : "2022-02-04"
}
},
"description" : "Прогнозируемый диапазон дат доставки. Для расчета дат используется производственный календарь. В зависимости от скорости тарифа учитываются или календарные, или рабочие дни. Если рабочие дни учитываются, то выходные и праздники пропускаются."
},
"TariffCodeDto" : {
"required" : [ "delivery_mode", "delivery_sum", "period_max", "period_min", "tariff_code", "tariff_name" ],
"properties" : {
"tariff_code" : {
"description" : "Код тарифа. Обязателен для расчета по коду тарифа",
"format" : "int32"
},
"tariff_name" : {
"maxLength" : 255,
"description" : "Название тарифа на языке вывода"
},
"tariff_description" : {
"maxLength" : 255,
"description" : "Описание тарифа на языке вывода"
},
"delivery_mode" : {
"description" : "Режим тарифа (Приложение 15)",
"format" : "int32"
},
"delivery_sum" : {
"description" : "Базовая стоимость доставки без НДС и доп. услуг (НДС может быть включен в базовый тариф по условиям договора)",
"format" : "float"
},
"period_min" : {
"description" : "Минимальное время доставки (в рабочих днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"period_max" : {
"description" : "Максимальное время доставки (в рабочих днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"calendar_min" : {
"description" : "Минимальное время доставки (в календарных днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"calendar_max" : {
"description" : "Максимальное время доставки (в календарных днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"delivery_date_range" : {
"$ref" : "#/components/schemas/DeliveryDateRangeDto"
}
},
"description" : "Тарифы"
},
"CalcAdditionalServiceDto" : {
"properties" : {
"code" : {
"maxLength" : 255,
"description" : "Тип дополнительной услуги"
},
"parameter" : {
"maxLength" : 255,
"description" : "Параметр дополнительной услуги
1. Количество для услуг PACKAGE_1, PACKAGE_A_2_LIGHT_EXPRESS, PACKAGE_A_3_LIGHT_EXPRESS, PACKAGE_A_4_LIGHT_EXPRESS, PACKAGE_A_5_LIGHT_EXPRESS, CARTON_BOX_XS, CARTON_BOX_S, CARTON_BOX_M, CARTON_BOX_2KG, CARTON_BOX_3KG, CARTON_BOX_5KG, CARTON_BOX_10KG, CARTON_BOX_XL_18_KILOS, CARTON_BOX_20KG, CARTON_BOX_30KG, CARTON_FILLER, XL_BOX_INNER_CRATE, 20_KG_BOX_INNER_CRATE, 30_KG_BOX_INNER_CRATE (для всех типов заказа)
2. Объявленная стоимость заказа для услуги INSURANCE (для всех типов заказа)
3. Длина для услуг BUBBLE_WRAP, WASTE_PAPER (для всех типов заказа)
4. Номер телефона для услуги SMS"
}
},
"description" : "Доп. услуга"
},
"CalculatorRequestDto" : {
"required" : [ "from_location", "packages", "tariff_code", "to_location" ],
"properties" : {
"date" : {
"pattern" : "yyyy-MM-dd'T'HH:mm:ssZ",
"description" : "Дата и время планируемой передачи заказа. По умолчанию - текущая",
"example" : "2025-03-24T14:15:22+0700"
},
"type" : {
"description" : "Тип заказа.
1 - интернет-магазин,
2 - доставка.
По умолчанию - 1",
"format" : "int32"
},
"currency" : {
"description" : "Валюта, в которой необходимо произвести расчет (числовой код из \"Приложение 14. Код валюты для методов расчета стоимости\").
По умолчанию - валюта договора",
"format" : "int32"
},
"lang" : {
"maxLength" : 3,
"description" : "Язык вывода информации о тарифах.
Возможные значения: rus, eng, zho.
По умолчанию - rus"
},
"tariff_code" : {
"description" : "Код тарифа. Обязателен для расчета по коду тарифа",
"format" : "int32"
},
"from_location" : {
"$ref" : "#/components/schemas/CalculatorLocationDto"
},
"to_location" : {
"$ref" : "#/components/schemas/CalculatorLocationDto"
},
"services" : {
"description" : "Дополнительные услуги",
"items" : {
"$ref" : "#/components/schemas/CalcAdditionalServiceDto"
}
},
"packages" : {
"description" : "Места (упаковки) в заказе",
"items" : {
"$ref" : "#/components/schemas/CalcPackageRequestDto"
}
},
"additional_order_types" : {
"uniqueItems" : true,
"description" : "Дополнительный тип заказа:
2 - для сборного груза (LTL). Совместим с типом заказа \"ИМ\"/\"Доставка\";
4 - для Форвард (Forward). Совместим с типом заказа \"ИМ\";
6 - для \"Фулфилмент. Приход\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
7 - для \"Фулфилмент. Отгрузка\". Совместим с типом заказа \"ИМ\";
9 - для Форвард. Экспресс (Forward. Express). Совместим с типом заказа \"ИМ\";
10 - для доставки шин по тарифу \"Экономичный экспресс\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
11 - для доставки в рамках одного офиса \"Один офис\" (при условии, что офис отправителя и получателя совпадают). Совместим с типом заказа \"ИМ\"/\"Доставка\";
14 - для CDEK.Shopping. Совместим с типом заказа \"ИМ\";
15 - для \"ТО для последней мили\". Совместим с типом заказа \"ИМ\"/\"Доставка\".",
"items" : {
"format" : "int32"
}
},
"shipment_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом (для заказов с режимом доставки «от склада»). Если офис известен на этапе расчета, передача кода офиса в запросе повысит точность расчета сроков доставки. Если в запросе указывается код офиса, но он не подходит по параметрам, то офис подменяется на ближайший с подходящими характеристиками. Если ближайший офис не удалось подобрать, офис не будет включен в расчет."
},
"delivery_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет доставлена посылка (для заказов с режимом доставки «до склада»). Если офис известен на этапе расчета, передача кода офиса в запросе повысит точность расчета сроков доставки. Если в запросе указывается код офиса, но он не подходит по параметрам, то офис подменяется на ближайший с подходящими характеристиками. Если ближайший офис не удалось подобрать, офис не будет включен в расчет."
}
},
"description" : "Запрос на расчет по коду тарифа"
},
"CalcResponseAdditionalServiceDto" : {
"required" : [ "code", "discount_percent", "discount_sum", "sum", "total_sum", "vat_rate", "vat_sum" ],
"properties" : {
"code" : {
"description" : "Тип дополнительной услуги"
},
"sum" : {
"description" : "Стоимость услуги",
"format" : "float",
"readOnly" : true
},
"total_sum" : {
"description" : "Стоимость услуги с НДС и скидкой",
"format" : "float",
"readOnly" : true
},
"discount_percent" : {
"description" : "Процент скидки",
"format" : "float",
"readOnly" : true
},
"discount_sum" : {
"description" : "Сумма скидки",
"format" : "float",
"readOnly" : true
},
"vat_rate" : {
"description" : "Процент НДС",
"format" : "float",
"readOnly" : true
},
"vat_sum" : {
"description" : "Сумма НДС",
"format" : "float",
"readOnly" : true
}
},
"description" : "Дополнительная услуга"
},
"CalculatorResponseDto" : {
"required" : [ "currency", "delivery_sum", "period_max", "period_min", "total_sum", "weight_calc" ],
"properties" : {
"delivery_sum" : {
"description" : "Базовая стоимость доставки без НДС и доп. услуг (НДС может быть включен в базовый тариф по условиям договора)",
"format" : "float"
},
"period_min" : {
"description" : "Минимальное время доставки (в рабочих днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"period_max" : {
"description" : "Максимальное время доставки (в рабочих днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"calendar_min" : {
"description" : "Минимальное время доставки (в календарных днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"calendar_max" : {
"description" : "Максимальное время доставки (в календарных днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"weight_calc" : {
"description" : "Расчетный вес (в граммах)",
"format" : "int32"
},
"services" : {
"description" : "Дополнительные услуги (возвращается, если в запросе были переданы доп. услуги)",
"items" : {
"$ref" : "#/components/schemas/CalcResponseAdditionalServiceDto"
}
},
"total_sum" : {
"description" : "Стоимость доставки с учетом дополнительных услуг и НДС",
"format" : "float"
},
"currency" : {
"maxLength" : 3,
"description" : "Валюта, в которой рассчитана стоимость доставки (код СДЭК)"
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
},
"delivery_date_range" : {
"$ref" : "#/components/schemas/DeliveryDateRangeDto"
}
},
"description" : "Ответ на расчет по коду тарифа"
},
"CalculatorTariffWithServicesRequestDto" : {
"required" : [ "from_location", "packages", "to_location" ],
"properties" : {
"date" : {
"pattern" : "yyyy-MM-dd'T'HH:mm:ssZ",
"description" : "Дата и время планируемой передачи заказа. По умолчанию - текущая",
"example" : "2025-03-24T14:15:22+0700"
},
"type" : {
"description" : "Тип заказа.
1 - интернет-магазин,
2 - доставка.
По умолчанию - 1",
"format" : "int32"
},
"currency" : {
"description" : "Валюта, в которой необходимо произвести расчет (числовой код из \"Приложение 14. Код валюты для методов расчета стоимости\").
По умолчанию - валюта договора",
"format" : "int32"
},
"lang" : {
"maxLength" : 3,
"description" : "Язык вывода информации о тарифах.
Возможные значения: rus, eng, zho.
По умолчанию - rus"
},
"from_location" : {
"$ref" : "#/components/schemas/CalculatorLocationDto"
},
"to_location" : {
"$ref" : "#/components/schemas/CalculatorLocationDto"
},
"services" : {
"description" : "Дополнительные услуги",
"items" : {
"$ref" : "#/components/schemas/CalcAdditionalServiceDto"
}
},
"packages" : {
"description" : "Места (упаковки) в заказе",
"items" : {
"$ref" : "#/components/schemas/CalcPackageRequestDto"
}
},
"additional_order_types" : {
"uniqueItems" : true,
"description" : "Дополнительный тип заказа:
2 - для сборного груза (LTL). Совместим с типом заказа \"ИМ\"/\"Доставка\";
4 - для Форвард (Forward). Совместим с типом заказа \"ИМ\";
6 - для \"Фулфилмент. Приход\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
7 - для \"Фулфилмент. Отгрузка\". Совместим с типом заказа \"ИМ\";
9 - для Форвард. Экспресс (Forward. Express). Совместим с типом заказа \"ИМ\";
10 - для доставки шин по тарифу \"Экономичный экспресс\". Совместим с типом заказа \"ИМ\"/\"Доставка\";
11 - для доставки в рамках одного офиса \"Один офис\" (при условии, что офис отправителя и получателя совпадают). Совместим с типом заказа \"ИМ\"/\"Доставка\";
14 - для CDEK.Shopping. Совместим с типом заказа \"ИМ\";
15 - для \"ТО для последней мили\". Совместим с типом заказа \"ИМ\"/\"Доставка\".",
"items" : {
"format" : "int32"
}
},
"shipment_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом (для заказов с режимом доставки «от склада»). Если офис известен на этапе расчета, передача кода офиса в запросе повысит точность расчета сроков доставки. Если в запросе указывается код офиса, но он не подходит по параметрам, то офис подменяется на ближайший с подходящими характеристиками. Если ближайший офис не удалось подобрать, офис не будет включен в расчет."
},
"delivery_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет доставлена посылка (для заказов с режимом доставки «до склада»). Если офис известен на этапе расчета, передача кода офиса в запросе повысит точность расчета сроков доставки. Если в запросе указывается код офиса, но он не подходит по параметрам, то офис подменяется на ближайший с подходящими характеристиками. Если ближайший офис не удалось подобрать, офис не будет включен в расчет."
}
},
"description" : "Запрос на расчет по доступным тарифам с учетом дополнительных услуг"
},
"CalculatorTariffWithServiceResultErrorResponseDto" : {
"required" : [ "code", "message" ],
"properties" : {
"code" : {
"description" : "Код ошибки"
},
"additional_code" : {
"description" : "Дополнительный код ошибки для службы поддержки"
},
"message" : {
"description" : "Описание ошибки"
}
},
"description" : "Дополнительная услуга"
},
"CalculatorTariffWithServiceResultResponseDto" : {
"required" : [ "currency", "delivery_sum", "period_max", "period_min", "total_sum", "weight_calc" ],
"properties" : {
"delivery_sum" : {
"description" : "Базовая стоимость доставки без НДС и доп. услуг (НДС может быть включен в базовый тариф по условиям договора)",
"format" : "float"
},
"period_min" : {
"description" : "Минимальное время доставки (в рабочих днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"period_max" : {
"description" : "Максимальное время доставки (в рабочих днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"calendar_min" : {
"description" : "Минимальное время доставки (в календарных днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"calendar_max" : {
"description" : "Максимальное время доставки (в календарных днях). Сроки доставки рассчитываются без учета дня принятия груза на складе.",
"format" : "int32"
},
"delivery_date_range" : {
"$ref" : "#/components/schemas/DeliveryDateRangeDto"
},
"weight_calc" : {
"description" : "Расчетный вес (в граммах)",
"format" : "int32"
},
"services" : {
"description" : "Дополнительные услуги (возвращается, если в запросе были переданы доп. услуги)",
"items" : {
"$ref" : "#/components/schemas/CalcResponseAdditionalServiceDto"
}
},
"total_sum" : {
"description" : "Стоимость доставки с учетом дополнительных услуг и НДС",
"format" : "float"
},
"currency" : {
"description" : "Валюта, в которой рассчитана стоимость доставки (код СДЭК)"
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/CalculatorTariffWithServiceResultErrorResponseDto"
}
}
}
},
"CalculatorTariffWithServicesListResponseDto" : {
"required" : [ "tariff_codes" ],
"properties" : {
"tariff_codes" : {
"description" : "Список тарифов с учетом дополнительных услуг",
"items" : {
"$ref" : "#/components/schemas/CalculatorTariffWithServicesResponseDto"
}
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
}
},
"description" : "Ответ на запрос расчета по доступным тарифам с учетом дополнительных услуг"
},
"CalculatorTariffWithServicesResponseDto" : {
"required" : [ "result", "status", "tariff_code" ],
"properties" : {
"tariff_code" : {
"description" : "Код тарифа"
},
"status" : {
"description" : "Статус расчета"
},
"result" : {
"$ref" : "#/components/schemas/CalculatorTariffWithServiceResultResponseDto"
}
}
},
"ContragentsNewTerritoriesRequest" : {
"properties" : {
"contragents" : {
"items" : {
"format" : "uuid"
}
}
}
},
"OrderUpdateRequestDto" : {
"required" : [ "recipient", "type" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор сущности в ИС СДЭК. Необязательное поле, если заполнен cdek_number",
"format" : "uuid"
},
"type" : {
"description" : "Тип заказа.
\n- 1 - \"интернет-магазин\" (только для договора типа \"Договор с ИМ\"),
\n- 2 - \"доставка\" (для любого договора).",
"format" : "int32"
},
"cdek_number" : {
"maxLength" : 40,
"description" : "Номер заказа СДЭК. Необязательное поле, если заполнен uuid"
},
"number" : {
"maxLength" : 40,
"description" : "Номер заказа в ИС клиента (только для заказов типа «интернет-магазин»). Допустимые символы: цифры, латинские буквы, спецсимволы (ASCII). В пределах одного договора среди активных (успешно созданных) неудаленных заказов номер заказа должен быть уникален. Исключение: если заказ с таким же номером находится в финальном статусе (DELIVERED / NOT_DELIVERED), создание нового заказа с повторным номером разрешено."
},
"accompanying_number" : {
"description" : "Номер сопроводительной накладной на товар (СНТ)"
},
"tariff_code" : {
"description" : "Код тарифа",
"format" : "int32"
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к заказу"
},
"shipment_point" : {
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом. Обязательное поле, если заказ с тарифом \"от склада\". Не может использоваться одновременно с from_location"
},
"delivery_point" : {
"description" : "Код ПВЗ СДЭК, на который будет доставлена посылка. Обязательное поле, если заказ с тарифом \"до склада\" или \"до постамата\". Не может использоваться одновременно с to_location"
},
"delivery_recipient_cost" : {
"$ref" : "#/components/schemas/MoneyDto"
},
"delivery_recipient_cost_adv" : {
"description" : "Доп. сбор за доставку (которую ИМ берет с получателя) в зависимости от суммы заказа (ДСД).\n
\nТолько для заказов \"интернет-магазин\". Возможно указать несколько порогов.
\nДСД применима только с доп. услугой «ЧАСТИЧНАЯ ДОСТАВКА» - в случае,
\nесли получатель купил одну или несколько позиций, или получатель полностью отказался от выкупа товара.\n
\nЕсли при полном отказе от товара оплачивать доп. сбор не требуется, тогда при настройке порогов стоимости необходимо передавать дополнительную товарную позицию «Доставка» в количестве 1 шт. стоимостью 0 рублей, дополнительный сбор за доставку - 0 рублей и далее пороги ДСД.
\n
\nЕсли при полном отказе от товара необходимо взять доп. сбор за доставку, то при настройке порогов в интеграции, необходимо указать дополнительную товарную позицию «Доставка» в количестве 1 шт. стоимостью 0 рублей, сумму доп.сбора за доставку с получателя необходимо задать при минимальном пороге стоимости, далее пороги ДСД, комментарии к заказу о необходимости вручения позиции \"Доставка\".",
"items" : {
"$ref" : "#/components/schemas/DeliveryCostThresholdDto"
}
},
"sender" : {
"$ref" : "#/components/schemas/SenderContactDto"
},
"seller" : {
"$ref" : "#/components/schemas/SellerDto"
},
"recipient" : {
"$ref" : "#/components/schemas/RecipientContactDto"
},
"from_location" : {
"$ref" : "#/components/schemas/LocationDto1"
},
"to_location" : {
"$ref" : "#/components/schemas/LocationDto1"
},
"services" : {
"description" : "Дополнительные услуги",
"items" : {
"$ref" : "#/components/schemas/AdditionalServiceRequestDto"
}
},
"packages" : {
"description" : "Список информации по местам (упаковкам). Количество мест в заказе может быть от 1 до 255",
"items" : {
"$ref" : "#/components/schemas/PackageRequestDto"
}
},
"has_reverse_order" : {
"description" : "Признак необходимости создания реверсного заказа"
},
"delivery_types" : {
"items" : { }
}
},
"description" : "Запрос на изменение заказа в рамках протокола"
},
"IntakeChangeStatusDto" : {
"required" : [ "status", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор заявки в ИС СДЭК",
"format" : "uuid"
},
"status" : {
"$ref" : "#/components/schemas/IntakeStatusPatchDto"
}
},
"description" : "DTO для изменения статуса заявки"
},
"IntakeStatusPatchDto" : {
"required" : [ "add_status", "code" ],
"properties" : {
"code" : {
"description" : "Код статуса. Может принимать значения: PROCESSING_REQUIRED - требует обработки"
},
"add_status" : {
"description" : "Дополнительный код статуса. Может принимать значения: CALL_REQUIRED - необходим прозвон; DOC_REQUIRED - необходимы документы от клиента."
}
},
"description" : "Статус заявки"
},
"IntakeChangeStatusResponseDto" : {
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/IntakeChangeStatusResponseEntity"
},
"requests" : {
"description" : "Информация о запросе/запросах над сущностью",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на изменение статуса заявки"
},
"IntakeChangeStatusResponseEntity" : {
"properties" : {
"uuid" : {
"description" : "Идентификатор заявки в ИС СДЭК",
"format" : "uuid"
}
},
"description" : "Информация о заявке"
},
"RegistriesResponseDto" : {
"properties" : {
"registries" : {
"description" : "Список реестров наложенных платежей, которые были оплачены",
"items" : {
"$ref" : "#/components/schemas/RegistryDto"
}
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
}
},
"description" : "Реестры наложенных платежей"
},
"RegistryDto" : {
"required" : [ "orders", "registry_number", "sum" ],
"properties" : {
"registry_number" : {
"description" : "Номер реестра наложенного платежа",
"format" : "int64"
},
"payment_date" : {
"description" : "Фактическая дата оплаты реестра наложенного платежа",
"format" : "date"
},
"sum" : {
"description" : "Сумма по реестру (в валюте взаиморасчетов)",
"format" : "float"
},
"payment_order_number" : {
"description" : "Номер платежного поручения, в рамках которого был осуществлен платеж
\nЕсли атрибут отсутствует в ответе или пустой, то для уточнения причин, пожалуйста, свяжитесь со своим менеджером"
},
"orders" : {
"description" : "Список заказов",
"items" : {
"$ref" : "#/components/schemas/RegistryOrderDto"
}
},
"date_created" : {
"description" : "Дата создания реестра наложенного платежа",
"format" : "date-time"
}
},
"description" : "Реестр наложенного платежа"
},
"RegistryOrderDto" : {
"required" : [ "agent_commission_sum", "cdek_number", "payment_sum", "total_sum_without_agent", "transfer_sum" ],
"properties" : {
"cdek_number" : {
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа"
},
"transfer_sum" : {
"description" : "Сумма к начислению (в валюте взаиморасчетов)",
"format" : "float"
},
"payment_sum" : {
"description" : "Сумма наложенного платежа, которую взяли с получателя (в валюте взаиморасчетов)",
"format" : "float"
},
"total_sum_without_agent" : {
"description" : "Итоговая стоимость заказа без учета агентского вознаграждения (в валюте взаиморасчетов)",
"format" : "float"
},
"agent_commission_sum" : {
"description" : "Агентское вознаграждение по переводу наложенного платежа (в валюте взаиморасчетов)",
"format" : "float"
},
"basis_type" : {
"description" : "Тип поручения. Если в строке реестра указано поручение с типом \"Заказ\" - будет передано значение \"ORDER\". Для продажи услуг фулфилмента будет передано значение \"SAS\"."
}
},
"description" : "Заказ из реестра наложенного платежа"
},
"PrintStatusDto" : {
"required" : [ "code", "date_time", "name" ],
"properties" : {
"code" : {
"description" : "Код статуса",
"enum" : [ "", "" ]
},
"name" : {
"description" : "Название статуса"
},
"date_time" : {
"description" : "Дата и время установки статуса",
"format" : "date-time"
}
},
"description" : "Статус ШК/ПФ"
},
"WaybillDto" : {
"required" : [ "orders", "statuses", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор квитанции к заказу",
"format" : "uuid"
},
"orders" : {
"description" : "Список заказов",
"items" : {
"$ref" : "#/components/schemas/PrintOrderDto"
}
},
"copy_count" : {
"description" : "Число копий одной квитанции на листе",
"format" : "int32"
},
"type" : {
"maxLength" : 255,
"description" : "Форма квитанции",
"enum" : [ "tpl_china", "tpl_armenia", "tpl_russia", "tpl_english", "tpl_italian", "tpl_korean", "tpl_latvian", "tpl_lithuanian", "tpl_german", "tpl_turkish", "tpl_czech", "tpl_thailand", "tpl_invoice" ]
},
"url" : {
"description" : "Ссылка на скачивание файла. Содержится в ответе только в статусе \"Сформирован\"
\nФормат: https://api.cdek.ru/v2/print/orders/{uuid}.pdf
\nДля получения файла с квитанцией к заказу/заказам воспользуйтесь методом \"Скачивание готовой квитанции\""
},
"statuses" : {
"uniqueItems" : true,
"description" : "Статусы квитанции",
"items" : {
"$ref" : "#/components/schemas/PrintStatusDto"
}
}
},
"description" : "Информация о квитанции к заказу"
},
"WaybillGetResponseDto" : {
"required" : [ "related_entities", "requests" ],
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/WaybillDto"
},
"requests" : {
"description" : "Информация о запросах над квитанцией к заказу",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на получение квитанции к заказу"
},
"BarcodeDto" : {
"required" : [ "orders", "statuses", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор файла ШК места к заказу",
"format" : "uuid"
},
"orders" : {
"description" : "Список заказов",
"items" : {
"$ref" : "#/components/schemas/PrintOrderDto"
}
},
"copy_count" : {
"description" : "Число копий на листе",
"format" : "int32"
},
"format" : {
"maxLength" : 2,
"description" : "Формат печати",
"enum" : [ "A4", "A5", "A6", "A7" ]
},
"url" : {
"description" : "Ссылка на скачивание файла. Содержится в ответе только в статусе \"Сформирован\"
\nФормат: https://api.cdek.ru/v2/print/barcodes/{uuid}.pdf
\nДля получения файла с ШК к заказу/заказам воспользуйтесь методом \"Скачивание готового ШК\""
},
"lang" : {
"maxLength" : 3,
"description" : "Язык печатной формы в кодировке ISO - 639-3. По умолчанию - RUS",
"enum" : [ "RUS", "ENG", "DEU", "ITA", "TUR", "CES", "KOR", "LIT", "LAV" ]
},
"statuses" : {
"uniqueItems" : true,
"description" : "Статус файла",
"items" : {
"$ref" : "#/components/schemas/PrintStatusDto"
}
}
},
"description" : "Информация о ШК месте к заказу"
},
"BarcodeGetResponseDto" : {
"required" : [ "related_entities", "requests" ],
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/BarcodeDto"
},
"requests" : {
"description" : "Информация о запросе над ШК местом к заказу",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на получение ШК места к заказу"
},
"GetPrealertResponseDto" : {
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/GetPrealertResponseDtoPrealertDto"
},
"requests" : {
"description" : "Информация о запросе над заявкой",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на получение информации о преалерте"
},
"GetPrealertResponseDtoOrderDto" : {
"required" : [ "cdek_number", "order_uuid" ],
"properties" : {
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не указан номер заказа",
"format" : "uuid"
},
"cdek_number" : {
"maxLength" : 40,
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа",
"format" : "int64"
},
"im_number" : {
"description" : "Номер заказа в ИС Клиента"
},
"packages" : {
"description" : "Упаковки заказа, по которым получена информация о расхождениях (появляется после закрытия преалерта)",
"items" : {
"$ref" : "#/components/schemas/GetPrealertResponseDtoPackageInfoDto"
}
}
},
"description" : "Заказ, который планируется передать в СДЭК"
},
"GetPrealertResponseDtoPackageInfoDto" : {
"required" : [ "number", "package_id", "status" ],
"properties" : {
"package_id" : {
"description" : "Уникальный номер упаковки в ИС СДЭК. Обязательно для уже существующей в заказе упаковки",
"format" : "uuid"
},
"number" : {
"maxLength" : 20,
"description" : "Номер упаковки в ИС клиента"
},
"status" : {
"description" : "Статус упаковки: принята, не принята, удалена",
"example" : "ACCEPTED,NOT_ACCEPTED,DELETED"
}
},
"description" : "Упаковки заказа, по которым получена информация о расхождениях (появляется после закрытия преалерта)"
},
"GetPrealertResponseDtoPrealertDto" : {
"required" : [ "orders", "planned_date", "shipment_point", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор преалерта в ИС СДЭК",
"format" : "uuid"
},
"prealert_number" : {
"description" : "Номер преалерта в ИС СДЭК"
},
"planned_date" : {
"description" : "Планируемая дата передачи заказов в СДЭК",
"format" : "date-time"
},
"shipment_point" : {
"description" : "Код ПВЗ, в который планируется передать заказы"
},
"closed_date" : {
"description" : "Дата закрытия преалерта (появляется после закрытия преалерта)",
"format" : "date-time"
},
"fact_shipment_point" : {
"description" : "Фактический ПВЗ, в который были переданы заказы (появляется после закрытия преалерта)"
},
"orders" : {
"description" : "Список заказов, которые планируется передать в СДЭК",
"items" : {
"$ref" : "#/components/schemas/GetPrealertResponseDtoOrderDto"
}
}
},
"description" : "Информация о преалерте"
},
"PassportDto" : {
"required" : [ "client", "passport_requirements_satisfied" ],
"properties" : {
"client" : {
"description" : "Клиент, по которому выведена информация о наличии паспортных данных",
"enum" : [ "SENDER", "RECEIVER", "ALL" ]
},
"passport_requirements_satisfied" : {
"description" : "Требования по паспортным данным удовлетворены (актуально для международных заказов):
\ntrue - паспортные данные собраны или не требуются
\nfalse - паспортные данные требуются и не собраны"
}
},
"description" : "Информация о паспортных данных"
},
"PassportOrderDto" : {
"required" : [ "cdek_number", "order_uuid", "passport" ],
"properties" : {
"order_uuid" : {
"description" : "UUID заказа",
"format" : "uuid"
},
"cdek_number" : {
"description" : "Номер заказа",
"format" : "int64"
},
"passport" : {
"description" : "Информация о паспортных данных по заказу",
"items" : {
"$ref" : "#/components/schemas/PassportDto"
}
}
},
"description" : "Информация о паспортных данных заказа"
},
"PassportResponseDto" : {
"properties" : {
"orders" : {
"description" : "Список заказов с информацией о паспортных данных",
"items" : {
"$ref" : "#/components/schemas/PassportOrderDto"
}
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
}
},
"description" : "Ответ на запрос получения паспортных данных"
},
"AccompanyingWaybillDto" : {
"required" : [ "client_name" ],
"properties" : {
"client_name" : {
"description" : "Наименование юрлица клиента, создающего СНТ"
},
"flight_number" : {
"description" : "Номер авиарейса"
},
"air_waybill_numbers" : {
"description" : "Накладные перевозчика для авиарейса",
"items" : { }
},
"vehicle_numbers" : {
"description" : "Номера автомобилей",
"items" : { }
},
"vehicle_driver" : {
"description" : "ФИО водителя автомобиля"
},
"planned_departure_date_time" : {
"description" : "Планируемая дата отправления",
"format" : "date-time"
}
},
"description" : "Информация для сопроводительной накладной"
},
"AdditionalServiceResponseDto" : {
"properties" : {
"code" : {
"maxLength" : 16,
"description" : "Тип дополнительной услуги"
},
"parameter" : {
"description" : "Параметр дополнительной услуги
1. Количество для услуг PACKAGE_1, PACKAGE_A_2_LIGHT_EXPRESS, PACKAGE_A_3_LIGHT_EXPRESS, PACKAGE_A_4_LIGHT_EXPRESS, PACKAGE_A_5_LIGHT_EXPRESS, CARTON_BOX_XS, CARTON_BOX_S, CARTON_BOX_M, CARTON_BOX_2KG, CARTON_BOX_3KG, CARTON_BOX_5KG, CARTON_BOX_10KG, CARTON_BOX_XL_18_KILOS, CARTON_BOX_20KG, CARTON_BOX_30KG, CARTON_FILLER, XL_BOX_INNER_CRATE, 20_KG_BOX_INNER_CRATE, 30_KG_BOX_INNER_CRATE (для всех типов заказа)
2. Объявленная стоимость заказа для услуги INSURANCE
3. Длина для услуг BUBBLE_WRAP, WASTE_PAPER (для всех типов заказа)
4. Номер телефона для услуги SMS
5. Код фотопроекта для услуги PHOTO_OF_DOCUMENTS (добавление услуги доступно только при создании заказа)"
},
"sum" : {
"description" : "Стоимость услуги",
"format" : "float",
"readOnly" : true
},
"total_sum" : {
"description" : "Стоимость услуги с НДС и скидкой",
"format" : "float",
"readOnly" : true
},
"discount_percent" : {
"description" : "Процент скидки",
"format" : "float",
"readOnly" : true
},
"discount_sum" : {
"description" : "Сумма скидки",
"format" : "float",
"readOnly" : true
},
"vat_rate" : {
"description" : "Процент НДС",
"format" : "float",
"readOnly" : true
},
"vat_sum" : {
"description" : "Сумма НДС",
"format" : "float",
"readOnly" : true
}
},
"description" : "Дополнительная услуга"
},
"CallsResponseDto" : {
"properties" : {
"failed_calls" : {
"description" : "Информация о неуспешных прозвонах (недозвонах)",
"items" : {
"$ref" : "#/components/schemas/FailedCallResponseDto"
}
},
"rescheduled_calls" : {
"description" : "Информация о переносах прозвонов",
"items" : {
"$ref" : "#/components/schemas/RescheduledCallResponseDto"
}
}
},
"description" : "Информация о прозвонах получателя"
},
"DeliveryProblemResponseDto" : {
"properties" : {
"code" : {
"description" : "Код проблемы"
},
"create_date" : {
"description" : "Дата создания проблемы",
"format" : "date-time"
}
},
"description" : "Проблема доставки, с которой столкнулся курьер при доставке заказа \"до двери\""
},
"DeliveryRecipientCostResponseDto" : {
"required" : [ "value" ],
"properties" : {
"value" : {
"description" : "Сумма платежа, включая НДС. Сумма не может быть больше 50000000 в валюте города получателя. Если передано значение 0, ставка НДС не применяется.",
"format" : "float"
},
"vat_sum" : {
"description" : "Сумма НДС",
"format" : "float"
},
"vat_rate" : {
"description" : "Ставка НДС с 01.01.2026 (значение - 0, 5, 7, 10, 16, 22, null - без НДС)",
"format" : "int32"
}
},
"description" : "Доп. сбор за доставку, которую ИМ берет с получателя. Актуально только для заказов \"интернет-магазин\"."
},
"FailedCallResponseDto" : {
"required" : [ "date_time", "reason_code" ],
"properties" : {
"date_time" : {
"description" : "Дата и время создания недозвона",
"format" : "date-time"
},
"reason_code" : {
"description" : "Причина недозвона",
"format" : "int32"
}
},
"description" : "Информация о неуспешном прозвоне (недозвоне)"
},
"ItemResponseDto" : {
"required" : [ "amount", "cost", "name", "payment", "ware_key", "weight" ],
"properties" : {
"name" : {
"maxLength" : 255,
"description" : "Наименование товара (может также содержать описание товара: размер, цвет)"
},
"ware_key" : {
"maxLength" : 50,
"description" : "Идентификатор/артикул товара.
\n Артикул товара может содержать только символы: [A-z А-я 0-9 ! @ \" # № $ ; % ^ : & ? * () _ - + = ? < > , .{ } [ ] / , пробел].
\n При передаче одинаковых артикулов в рамках одной упаковки, артикул будет заменяться на: {ware_key}_* , где * – это 7 случайных символов."
},
"marking" : {
"maxLength" : 255,
"description" : "Маркировка товара, переданная при регистрации заказа."
},
"payment" : {
"$ref" : "#/components/schemas/ResponseMoneyDto"
},
"weight" : {
"description" : "Вес (за единицу товара, в граммах)",
"format" : "int32"
},
"weight_gross" : {
"description" : "Вес брутто. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\".",
"format" : "int32"
},
"amount" : {
"description" : "Количество единиц товара (в штуках). Количество одного товара в заказе может быть от 1 до 999",
"format" : "int32"
},
"delivery_amount" : {
"description" : "Количество врученных единиц товара (в штуках)",
"format" : "int32"
},
"name_i18n" : {
"maxLength" : 255,
"description" : "Наименование на иностранном языке. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"brand" : {
"maxLength" : 255,
"description" : "Бренд на иностранном языке. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны производителя товара в формате ISO_3166-1_alpha-2
\nОбязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"material" : {
"maxLength" : 255,
"description" : "Код материала (см. Приложение 7). Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"wifi_gsm" : {
"description" : "Содержит wifi/gsm. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"url" : {
"description" : "Ссылка на сайт интернет-магазина с описанием товара. Обязательно для международных заказов и доместиковых заказов с доп.типом \"ТО для последней мили\"."
},
"seller" : {
"$ref" : "#/components/schemas/SellerItemDto"
},
"return_item_detail" : {
"$ref" : "#/components/schemas/ReturnItemDetail"
},
"excise" : {
"description" : "Является ли товар акцизным"
},
"cost" : {
"description" : "Объявленная стоимость товара (за единицу товара в валюте взаиморасчетов, значение >=0).
\nС данного значения рассчитывается страховка.",
"format" : "float"
},
"feacn_code" : {
"maxLength" : 255,
"description" : "Код ТН ВЭД"
},
"jewel_uin" : {
"description" : "УИН ювелирного изделия"
},
"used" : {
"description" : "Признак товара б/у, применим для c2c заказов."
}
},
"description" : "Информация о товаре в упаковке"
},
"OrderDelayReason" : {
"properties" : {
"create_date" : {
"description" : "Дата и время создания причины задержки",
"format" : "date-time",
"readOnly" : true
},
"description" : {
"description" : "Описание причины задержки",
"readOnly" : true
}
},
"description" : "Информация о причинах задержки"
},
"OrderResponseDto" : {
"required" : [ "from_location", "is_client_return", "is_return", "is_reverse", "packages", "recipient", "sender", "statuses", "tariff_code", "to_location", "type", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор сущности в ИС СДЭК",
"format" : "uuid"
},
"type" : {
"description" : "Тип заказа.
\n- 1 - \"интернет-магазин\" (только для договора типа \"Договор с ИМ\"),
\n- 2 - \"доставка\" (для любого договора).",
"format" : "int32"
},
"additional_order_types" : {
"uniqueItems" : true,
"description" : "Дополнительные типы заказа:
\n- 2 - для сборного груза (LTL). Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 4 - для Forward. Совместим с типом заказа \"ИМ\",
\n- 6 - для \"Фулфилмент. Приход\". Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 7 - для \"Фулфилмент. Отгрузка\". Совместим с типом заказа \"ИМ\",
\n- 9 - для Форвард.Экспресс (Forward.Express). Совместим с типом заказа \"ИМ\",
\n- 10 - для доставки шин по тарифу \"Экономичный экспресс\". Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 11 - для доставки в рамках одного офиса \"Один офис (ИМ)\" (при условии, что офис отправителя и получателя совпадают). Совместим с типом заказа \"ИМ\"/\"Доставка\",
\n- 14 - для CDEK.Shopping. Совместим с типом заказа \"ИМ,
\n- 15 - для \"ТО для последней мили\" (отправка доместик (РФ-РФ) заказов по доп.типу \"ТО+посл.миля\" возможна только из МСК и складов: MSK662, 1 Рейсовая MSK1938, ТО, Москва, Москва-Карго, 1, RU и KHME33, ТО, Химки, Шереметьевское шоссе, 9, RU). Совместим с типом заказа \"ИМ\"/\"Доставка\".",
"items" : {
"format" : "int32"
}
},
"is_return" : {
"description" : "Признак возвратного заказа",
"readOnly" : true
},
"is_reverse" : {
"description" : "Признак реверсного заказа",
"readOnly" : true
},
"cdek_number" : {
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа"
},
"number" : {
"maxLength" : 30,
"description" : "Номер заказа в ИС клиента (только для заказов типа «интернет-магазин»). Допустимые символы: цифры, латинские буквы, спецсимволы (ASCII). В пределах одного договора среди активных (успешно созданных) неудаленных заказов номер заказа должен быть уникален. Исключение: если заказ с таким же номером находится в финальном статусе (DELIVERED / NOT_DELIVERED), создание нового заказа с повторным номером разрешено."
},
"accompanying_number" : {
"description" : "Номер сопроводительной накладной на товар (СНТ)"
},
"accompanying_waybill" : {
"$ref" : "#/components/schemas/AccompanyingWaybillDto"
},
"tariff_code" : {
"description" : "Код тарифа",
"format" : "int32"
},
"comment" : {
"description" : "Комментарий к заказу"
},
"shipment_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет производиться самостоятельный привоз клиентом. Обязательное поле, если заказ с тарифом \"от склада\". Не может использоваться одновременно с from_location"
},
"delivery_point" : {
"maxLength" : 255,
"description" : "Код ПВЗ СДЭК, на который будет доставлена посылка. Обязательное поле, если заказ с тарифом \"до склада\" или \"до постамата\". Не может использоваться одновременно с to_location"
},
"date_invoice" : {
"description" : "Дата инвойса. Только для международных заказов с типом \"интернет-магазин\"",
"format" : "date"
},
"keep_free_until" : {
"description" : "Для заказа до ПВЗ: хранить бесплатно до",
"format" : "date-time"
},
"shipper_name" : {
"maxLength" : 255,
"description" : "Грузоотправитель. Только для международных заказов с типом \"интернет-магазин\""
},
"shipper_address" : {
"maxLength" : 255,
"description" : "Адрес грузоотправителя. Только для международных заказов с типом \"интернет-магазин\""
},
"delivery_recipient_cost" : {
"$ref" : "#/components/schemas/DeliveryRecipientCostResponseDto"
},
"delivery_recipient_cost_adv" : {
"description" : "Доп. сбор за доставку (которую ИМ берет с получателя) в зависимости от суммы заказа. Только для заказов \"интернет-магазин\".
\nДля направлений Беларусь-Беларусь и РФ-Беларусь это поле игнорируется.",
"items" : {
"$ref" : "#/components/schemas/DeliveryCostThresholdDto"
}
},
"sender" : {
"$ref" : "#/components/schemas/SenderResponseContactDto"
},
"seller" : {
"$ref" : "#/components/schemas/SellerDto"
},
"recipient" : {
"$ref" : "#/components/schemas/RecipientResponseContactDto"
},
"from_location" : {
"$ref" : "#/components/schemas/ResponseFromLocationDto"
},
"to_location" : {
"$ref" : "#/components/schemas/ResponseToLocationDto"
},
"services" : {
"description" : "Дополнительные услуги",
"items" : {
"$ref" : "#/components/schemas/AdditionalServiceResponseDto"
}
},
"packages" : {
"description" : "Список информации по местам (упаковкам). Количество мест в заказе может быть от 1 до 255",
"items" : {
"$ref" : "#/components/schemas/PackageResponseDto"
}
},
"statuses" : {
"description" : "Список статусов по заказу, отсортированных по дате и времени",
"readOnly" : true,
"items" : {
"$ref" : "#/components/schemas/OrderStatusDto"
}
},
"is_client_return" : {
"description" : "Признак клиентского возврата"
},
"delivery_mode" : {
"description" : "Истинный режим заказа, может принимать значения:
\n 1 - дверь-дверь
\n 2 - дверь-склад
\n 3 - склад-дверь
\n 4 - склад-склад
\n 6 - дверь-постамат
\n 7 - склад-постамат
\n 8 - постамат-дверь
\n 9 - постамат-склад
\n 10 - постамат-постамат",
"readOnly" : true
},
"has_reverse_order" : {
"description" : "Признак необходимости создания реверсного заказа"
},
"delay_reasons" : {
"description" : "Причины задержки",
"readOnly" : true,
"items" : {
"$ref" : "#/components/schemas/OrderDelayReason"
}
},
"delivery_types" : {
"readOnly" : true,
"items" : { }
},
"planned_delivery_date" : {
"description" : "Плановая дата доставки. Передаётся при приёмке груза на склад",
"format" : "date"
},
"delivery_detail" : {
"$ref" : "#/components/schemas/ResponseDeliveryDetailDto"
},
"delivery_problem" : {
"description" : "Проблемы доставки, с которыми столкнулся курьер при доставке заказа \"до двери\"",
"items" : {
"$ref" : "#/components/schemas/DeliveryProblemResponseDto"
}
},
"developer_key" : {
"description" : "Ключ разработчика"
},
"calls" : {
"$ref" : "#/components/schemas/CallsResponseDto"
}
},
"description" : "Информация о заказе в рамках протокола"
},
"OrderStatusDto" : {
"properties" : {
"code" : {
"description" : "Код статуса (Приложение 15. Статусы заказов в методах получения информации)"
},
"name" : {
"description" : "Название статуса"
},
"date_time" : {
"description" : "Дата и время установки статуса",
"format" : "date-time"
},
"reason_code" : {
"description" : "Дополнительный код статуса"
},
"city" : {
"description" : "Наименование места возникновения статуса"
},
"city_uuid" : {
"description" : "Идентификатор места (города) возникновения статуса",
"format" : "uuid"
},
"deleted" : {
"description" : "Признак удаления статуса. Может принимать значения:
\n- true - статус удалён;
\n- false - статус активен.
\n
\nЗначение true может быть только у финальных статусов."
}
},
"description" : "Статус по заказу"
},
"PackageAddServiceResponseDto" : {
"required" : [ "code" ],
"properties" : {
"code" : {
"description" : "Тип дополнительной услуги. Может принимать только значение GRID_TREE - доп. услуга \"Обрешетка\" для упаковки"
}
},
"description" : "Дополнительная услуга для упаковки"
},
"PackageResponseDto" : {
"required" : [ "number", "weight" ],
"properties" : {
"number" : {
"maxLength" : 30,
"description" : "Номер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиента"
},
"barcode" : {
"description" : "Штрихкод упаковки в ИС СДЭК",
"readOnly" : true
},
"weight" : {
"description" : "Общий вес (в граммах)",
"format" : "int32"
},
"length" : {
"description" : "Габариты упаковки. Длина (в сантиметрах)",
"format" : "int32"
},
"width" : {
"description" : "Габариты упаковки. Ширина (в сантиметрах)",
"format" : "int32"
},
"weight_volume" : {
"description" : "Объемный вес (в граммах)",
"format" : "int32"
},
"weight_calc" : {
"description" : "Расчетный вес (в граммах)",
"format" : "int32"
},
"height" : {
"description" : "Габариты упаковки. Высота (в сантиметрах)",
"format" : "int32"
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к упаковке. Обязательно и только для заказа типа \"Доставка\""
},
"items" : {
"description" : "Позиции товаров в упаковке.",
"items" : {
"$ref" : "#/components/schemas/ItemResponseDto"
}
},
"services" : {
"description" : "Дополнительные услуги для упаковки",
"items" : {
"$ref" : "#/components/schemas/PackageAddServiceResponseDto"
}
},
"package_id" : {
"description" : "Уникальный номер упаковки в ИС СДЭК. Обязательно для уже существующей в заказе упаковки"
}
},
"description" : "Информация об упаковке"
},
"RecipientResponseContactDto" : {
"required" : [ "name" ],
"properties" : {
"company" : {
"maxLength" : 255,
"description" : "Название компании"
},
"name" : {
"maxLength" : 255,
"description" : "ФИО контактного лица"
},
"contragent_type" : {
"maxLength" : 255,
"description" : "Тип получателя. Возможные значения: LEGAL_ENTITY - юридическое лицо, INDIVIDUAL - физическое лицо"
},
"passport_series" : {
"maxLength" : 4,
"description" : "Серия паспорта"
},
"passport_number" : {
"maxLength" : 30,
"description" : "Номер паспорта"
},
"passport_date_of_issue" : {
"description" : "Дата выдачи паспорта",
"format" : "date"
},
"passport_organization" : {
"maxLength" : 255,
"description" : "Орган выдачи паспорта"
},
"tin" : {
"maxLength" : 12,
"description" : "ИНН"
},
"passport_date_of_birth" : {
"description" : "Дата рождения",
"format" : "date"
},
"email" : {
"maxLength" : 255,
"description" : "Эл. адрес"
},
"phones" : {
"description" : "Список телефонов",
"items" : {
"$ref" : "#/components/schemas/PhoneDto"
}
},
"passport_requirements_satisfied" : {
"description" : "Требования по паспортным данным удовлетворены",
"readOnly" : true
}
},
"description" : "Получатель"
},
"RescheduledCallResponseDto" : {
"required" : [ "date_next", "date_time", "time_next" ],
"properties" : {
"date_time" : {
"description" : "Дата и время создания переноса прозвона",
"format" : "date-time"
},
"date_next" : {
"description" : "Дата, на которую согласован повторный прозвон",
"format" : "date"
},
"time_next" : {
"pattern" : "",
"description" : "Время, на которое согласован повторный прозвон",
"example" : "09:00"
},
"comment" : {
"description" : "Комментарий к переносу прозвона"
}
},
"description" : "Информация о перенесённом прозвоне получателя"
},
"ResponseDeliveryDetailDto" : {
"required" : [ "delivery_sum", "total_sum" ],
"properties" : {
"date" : {
"description" : "Дата доставки",
"format" : "date"
},
"recipient_name" : {
"description" : "Получатель при доставке"
},
"payment_sum" : {
"description" : "Сумма наложенного платежа, которую взяли с получателя, в валюте страны получателя с учетом частичной доставки",
"format" : "float"
},
"delivery_sum" : {
"description" : "Стоимость услуги доставки",
"format" : "float"
},
"total_sum" : {
"description" : "Итоговая стоимость заказа",
"format" : "float"
},
"payment_info" : {
"items" : {
"$ref" : "#/components/schemas/ResponsePaymentTypeDto"
}
},
"delivery_vat_rate" : {
"description" : "Процент НДС для расчёта доставки",
"format" : "float"
},
"delivery_vat_sum" : {
"description" : "Сумма НДС для доставки",
"format" : "float"
},
"delivery_discount_percent" : {
"description" : "Процент скидки для расчёта доставки",
"format" : "float"
},
"delivery_discount_sum" : {
"description" : "Сумма скидки для доставки",
"format" : "float"
}
},
"description" : "Информация о вручении"
},
"ResponseDtoOrderResponseDto" : {
"required" : [ "requests" ],
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/OrderResponseDto"
},
"requests" : {
"description" : "Информация о запросах, относящихся к сущности.",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на запрос"
},
"ResponseFromLocationDto" : {
"required" : [ "city", "code", "country_code" ],
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"description" : "Название страны населенного пункта"
},
"region" : {
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid"
},
"sub_region" : {
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"time_zone" : {
"description" : "Часовой пояс населенного пункта"
},
"payment_limit" : {
"description" : "Ограничение на сумму наложенного платежа в населенном пункте",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"description" : "Почтовый индекс"
}
},
"description" : "Адрес отправления"
},
"ResponseMoneyDto" : {
"required" : [ "value" ],
"properties" : {
"value" : {
"description" : "Сумма платежа, включая НДС. Сумма не может быть больше 50000000 в валюте города получателя. Если передано значение 0, ставка НДС не применяется.",
"format" : "float"
},
"vat_sum" : {
"description" : "Сумма НДС. Обязательно, если передано payment.vat_rate",
"format" : "float"
},
"vat_rate" : {
"description" : "Ставка НДС с 01.01.2026 (значение - 0, 5, 7, 10, 16, 22, null - без НДС)",
"format" : "int32"
}
},
"description" : "Доп. сбор за доставку, которую ИМ берет с получателя. Только для заказов \"интернет-магазин\".
Для направлений Беларусь-Беларусь и РФ-Беларусь это поле игнорируется."
},
"ResponsePaymentTypeDto" : {
"required" : [ "sum", "type" ],
"properties" : {
"type" : {
"maxLength" : 4,
"description" : "Тип оплаты: CARD - картой, CASH - наличными",
"enum" : [ "CASH", "CARD" ]
},
"sum" : {
"description" : "Сумма в валюте страны получателя",
"format" : "float"
}
},
"description" : "Информация об оплате наложенного платежа получателем"
},
"ResponseToLocationDto" : {
"required" : [ "city", "code", "country_code" ],
"properties" : {
"code" : {
"maxLength" : 16,
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"description" : "Название страны населенного пункта"
},
"region" : {
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid"
},
"sub_region" : {
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"time_zone" : {
"description" : "Часовой пояс населенного пункта"
},
"payment_limit" : {
"description" : "Ограничение на сумму наложенного платежа в населенном пункте",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"description" : "Почтовый индекс"
}
},
"description" : "Адрес получения"
},
"ReturnItemDetail" : {
"required" : [ "direct_order_number", "direct_order_uuid", "direct_package_number" ],
"properties" : {
"direct_order_number" : {
"description" : "Номер прямого заказа, в котором доставлялся данный товар"
},
"direct_order_uuid" : {
"description" : "Уникальный идентификатор прямого заказа, в котором доставлялся данный товар",
"format" : "uuid"
},
"direct_package_number" : {
"description" : "Номер упаковки, в которой доставлялся данный товар"
}
}
},
"SenderResponseContactDto" : {
"required" : [ "name" ],
"properties" : {
"company" : {
"maxLength" : 255,
"description" : "Название компании"
},
"name" : {
"maxLength" : 255,
"description" : "ФИО контактного лица"
},
"contragent_type" : {
"maxLength" : 255,
"description" : "Тип отправителя. Возможные значения: LEGAL_ENTITY - юридическое лицо, INDIVIDUAL - физическое лицо"
},
"passport_series" : {
"maxLength" : 4,
"description" : "Серия паспорта"
},
"passport_number" : {
"maxLength" : 30,
"description" : "Номер паспорта"
},
"passport_date_of_issue" : {
"description" : "Дата выдачи паспорта",
"format" : "date"
},
"passport_organization" : {
"maxLength" : 255,
"description" : "Орган выдачи паспорта"
},
"tin" : {
"maxLength" : 12,
"description" : "ИНН"
},
"passport_date_of_birth" : {
"description" : "Дата рождения",
"format" : "date"
},
"email" : {
"maxLength" : 255,
"description" : "Эл. адрес"
},
"phones" : {
"description" : "Список телефонов",
"items" : {
"$ref" : "#/components/schemas/PhoneDto"
}
},
"passport_requirements_satisfied" : {
"description" : "Требования по паспортным данным удовлетворены",
"readOnly" : true
}
},
"description" : "Отправитель"
},
"ContactDto" : {
"required" : [ "name" ],
"properties" : {
"company" : {
"maxLength" : 255,
"description" : "Название компании"
},
"name" : {
"maxLength" : 255,
"description" : "ФИО контактного лица"
},
"contragent_type" : {
"maxLength" : 255,
"description" : "Тип отправителя. Возможные значения: LEGAL_ENTITY - юридическое лицо, INDIVIDUAL - физическое лицо"
},
"passport_series" : {
"maxLength" : 4,
"description" : "Серия паспорта"
},
"passport_number" : {
"maxLength" : 30,
"description" : "Номер паспорта"
},
"passport_date_of_issue" : {
"description" : "Дата выдачи паспорта",
"format" : "date"
},
"passport_organization" : {
"maxLength" : 255,
"description" : "Орган выдачи паспорта"
},
"tin" : {
"maxLength" : 12,
"description" : "ИНН"
},
"passport_date_of_birth" : {
"description" : "Дата рождения",
"format" : "date"
},
"email" : {
"maxLength" : 255,
"description" : "Эл. адрес"
},
"phones" : {
"description" : "Список телефонов. Не более 10 номеров. Обязательно для заполнения, если при регистрации заказа не был указан номер отправителя",
"items" : {
"$ref" : "#/components/schemas/PhoneDto"
}
},
"passport_requirements_satisfied" : {
"description" : "Требования по паспортным данным удовлетворены",
"readOnly" : true
}
},
"description" : "Данные контрагента"
},
"IntakeInfoResponseEntity" : {
"required" : [ "from_location", "intake_date", "intake_time_from", "intake_time_to", "statuses", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор заявки в ИС СДЭК",
"format" : "uuid"
},
"cdek_number" : {
"maxLength" : 255,
"description" : "Номер заказа СДЭК. Обязателен, если не указан идентификатор заказа"
},
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК. Обязателен, если не указан номер заказа"
},
"intake_date" : {
"description" : "Дата ожидания курьера Дата ожидания курьера не может быть больше текущей более чем на 31 день. Заявка, созданная на текущую дату после 15:00 по времени отправителя, может быть выполнена на следующий день"
},
"intake_number" : {
"maxLength" : 255,
"description" : "Номер заявки в системе СДЭК"
},
"intake_time_from" : {
"pattern" : "HH:mm",
"description" : "Время начала ожидания курьера",
"example" : "09:00"
},
"intake_time_to" : {
"pattern" : "HH:mm",
"description" : "Время окончания ожидания курьера",
"example" : "18:00"
},
"lunch_time_from" : {
"pattern" : "HH:mm",
"description" : "Время начала обеда, должно входить в диапазон [intake_time_from; intake_time_to]",
"example" : "14:00"
},
"lunch_time_to" : {
"pattern" : "HH:mm",
"description" : "Время окончания обеда, должно входить в диапазон [intake_time_from; intake_time_to]",
"example" : "15:00"
},
"name" : {
"maxLength" : 255,
"description" : "Описание груза"
},
"weight" : {
"description" : "Общий вес (в граммах)",
"format" : "int32"
},
"length" : {
"description" : "Габариты упаковки. Длина (в сантиметрах)",
"format" : "int32"
},
"width" : {
"description" : "Габариты упаковки. Ширина (в сантиметрах)",
"format" : "int32"
},
"height" : {
"description" : "Габариты упаковки. Высота (в сантиметрах)",
"format" : "int32"
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к заявке для курьера"
},
"courier_power_of_attorney" : {
"description" : "Курьеру необходима доверенность (по умолчанию - false)"
},
"courier_identity_card" : {
"description" : "Курьеру необходим документ удостоверяющий личность (по умолчанию - false)"
},
"sender" : {
"$ref" : "#/components/schemas/ContactDto"
},
"from_location" : {
"$ref" : "#/components/schemas/LocationInfoDto"
},
"to_location" : {
"$ref" : "#/components/schemas/LocationInfoDto"
},
"need_call" : {
"description" : "Необходим прозвон отправителя (по умолчанию - false)"
},
"statuses" : {
"description" : "Статус по заявке",
"items" : {
"$ref" : "#/components/schemas/IntakeStatusDto"
}
},
"packages" : {
"description" : "Информация об упаковках",
"items" : {
"$ref" : "#/components/schemas/IntakePackageDto"
}
}
},
"description" : "Информация о заявке"
},
"IntakePackageDto" : {
"properties" : {
"package_id" : {
"description" : "Уникальный номер упаковки в ИС СДЭК. Обязательно для уже существующей в заказе упаковки",
"format" : "uuid"
},
"weight" : {
"description" : "Общий вес (в граммах)",
"format" : "int32"
},
"length" : {
"description" : "Габариты упаковки. Длина (в сантиметрах)",
"format" : "int32"
},
"width" : {
"description" : "Габариты упаковки. Ширина (в сантиметрах)",
"format" : "int32"
},
"height" : {
"description" : "Габариты упаковки. Высота (в сантиметрах)",
"format" : "int32"
}
},
"description" : "Информация об упаковке"
},
"IntakeStatusDto" : {
"required" : [ "code", "date_time", "name" ],
"properties" : {
"code" : {
"maxLength" : 255,
"description" : "Код статуса"
},
"name" : {
"maxLength" : 255,
"description" : "Название статуса"
},
"date_time" : {
"description" : "Дата и время установки статуса",
"format" : "date-time"
}
},
"description" : "Информация о состоянии заявки"
},
"LocationInfoDto" : {
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"maxLength" : 255,
"description" : "Название страны населенного пункта"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid",
"deprecated" : true
},
"kladr_region_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР региона населенного пункта",
"deprecated" : true
},
"sub_region" : {
"maxLength" : 255,
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
}
},
"description" : "Населённый пункт"
},
"PostcodeDto" : {
"properties" : {
"code" : {
"description" : "Код города СДЭК",
"format" : "int32"
},
"postal_codes" : {
"description" : "Почтовые индексы города",
"items" : { }
}
},
"description" : "Ответ на запрос получения списка почтовых индексов"
},
"LocationSearchResponseDto" : {
"properties" : {
"result" : {
"description" : "Список населенных пунктов",
"items" : {
"$ref" : "#/components/schemas/LocationDto1"
}
},
"scrollId" : {
"description" : "Идентификатор для получения следующей страницы с населенными пунктами"
}
},
"description" : "Ответ на запрос получения списка населенных пунктов"
},
"IntakeInfoDto" : {
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/IntakeInfoResponseEntity"
},
"requests" : {
"description" : "Информация о запросе/запросах над сущностью",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
}
},
"description" : "Заявка на вызов курьера (забор груза)"
},
"OfficeCellDimensionsDto" : {
"required" : [ "depth", "height", "width" ],
"properties" : {
"width" : {
"description" : "Ширина (см)",
"format" : "int32"
},
"height" : {
"description" : "Высота (см)",
"format" : "int32"
},
"depth" : {
"description" : "Глубина (см)",
"format" : "int32"
}
},
"description" : "Размеры ячеек"
},
"OfficeDto" : {
"required" : [ "allowed_cod", "code", "have_cash", "have_cashless", "have_fast_payment_system", "is_dressing_room", "is_handout", "is_reception", "location", "owner_code", "phones", "status", "take_only", "type", "uuid", "work_time", "work_time_list" ],
"properties" : {
"code" : {
"maxLength" : 255,
"description" : "Код ПВЗ"
},
"uuid" : {
"maxLength" : 255,
"description" : "Идентификатор офиса в ИС СДЭК"
},
"address_comment" : {
"maxLength" : 255,
"description" : "Описание местоположения"
},
"nearest_station" : {
"maxLength" : 255,
"description" : "Ближайшая станция/остановка транспорта"
},
"nearest_metro_station" : {
"maxLength" : 255,
"description" : "Ближайшая станция метро"
},
"work_time" : {
"maxLength" : 255,
"description" : "Режим работы, строка вида «пн-пт 9-18, сб 9-16»"
},
"phones" : {
"description" : "Список телефонов",
"items" : {
"$ref" : "#/components/schemas/PhoneDto"
}
},
"email" : {
"maxLength" : 255,
"description" : "Адрес электронной почты"
},
"note" : {
"maxLength" : 255,
"description" : "Примечание по ПВЗ"
},
"type" : {
"description" : "Тип ПВЗ. PVZ — склад СДЭК, POSTAMAT — постамат СДЭК"
},
"owner_code" : {
"maxLength" : 255,
"description" : "Принадлежность офиса компании: CDEK — офис принадлежит компании СДЭК, Градусы — офис принадлежит компании Градусы, Телепорт — офис принадлежит компании Телепорт, Tastamat — офис принадлежит компании Tastamat, Халва — офис принадлежит компании Халва, PickPoint — офис принадлежит компании PickPoint, OmniCDEK — офис принадлежит компании OmniCDEK, OmniCDEK (franchise) — офис принадлежит компании OmniCDEK (франчайзи), OmniCDEK (self-employed) — офис принадлежит компании OmniCDEK (самозанятые), \"Нет бренда\" — офис принадлежит компании без бренда"
},
"take_only" : {
"description" : "Является ли офис только пунктом выдачи или также осуществляет приём грузов"
},
"is_handout" : {
"description" : "Является пунктом выдачи"
},
"is_reception" : {
"description" : "Является пунктом приёма"
},
"is_dressing_room" : {
"description" : "Есть ли примерочная"
},
"is_marketplace" : {
"description" : "Офис для доставки заказов \"До маркетплейса\""
},
"is_ltl" : {
"description" : "Работает ли офис с LTL (сборный груз)"
},
"have_cashless" : {
"description" : "Есть безналичный расчет"
},
"have_cash" : {
"description" : "Есть приём наличных"
},
"have_fast_payment_system" : {
"description" : "Есть безналичный расчёт по СБП"
},
"allowed_cod" : {
"description" : "Разрешен наложенный платеж в ПВЗ"
},
"site" : {
"maxLength" : 255,
"description" : "Ссылка на данный офис на сайте СДЭК"
},
"office_image_list" : {
"description" : "Все фото офиса (кроме фото как доехать)",
"items" : {
"$ref" : "#/components/schemas/OfficeImageDto"
}
},
"work_time_list" : {
"description" : "График работы на неделю. Вложенный тег с атрибутами day и periods",
"items" : {
"$ref" : "#/components/schemas/OfficeWorkTimeDto"
}
},
"work_time_exception_list" : {
"description" : "Исключения в графике работы офиса",
"items" : {
"$ref" : "#/components/schemas/OfficeWorkTimeExceptionDto"
}
},
"weight_min" : {
"description" : "Минимальный вес (в кг.), принимаемый в ПВЗ (> WeightMin)",
"format" : "float"
},
"weight_max" : {
"description" : "Максимальный вес (в кг.), принимаемый в ПВЗ (<=WeightMax)",
"format" : "float"
},
"dimensions" : {
"description" : "Перечень максимальных размеров ячеек (только для type = POSTAMAT)",
"items" : {
"$ref" : "#/components/schemas/OfficeCellDimensionsDto"
}
},
"status" : {
"description" : "Статус офиса. Допустимые значения (enum):
\n\"ACTIVE\",
\n\"CLOSED\"",
"enum" : [ "ACTIVE", "CLOSED" ]
},
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
},
"location" : {
"$ref" : "#/components/schemas/OfficeLocationDto"
},
"distance" : {
"description" : "Расстояние до точки, от которой производился поиск ближайшего ПВЗ",
"format" : "int32"
},
"ltl_acceptance_partners" : {
"description" : "Принимает заказы LTL, которые будут доставляться партнерами"
},
"ltl_issuance_partners" : {
"description" : "Выдает заказы LTL, которые были доставлены партнерами"
},
"fulfillment" : {
"description" : "Работает ли офис с \"Фулфилмент. Приход\": «1», «true» - да; «0», «false» - нет."
},
"length_max" : {
"description" : "Максимальная длина грузоместа в см, которую может принять офис",
"format" : "int32"
},
"width_max" : {
"description" : "Максимальная ширина грузоместа в см, которую может принять офис",
"format" : "int32"
},
"height_max" : {
"description" : "Максимальная высота грузоместа в см, которую может принять офис",
"format" : "int32"
}
},
"description" : "Ответ на запрос получения списка офисов"
},
"OfficeImageDto" : {
"required" : [ "url" ],
"properties" : {
"number" : {
"format" : "int32"
},
"url" : {
"maxLength" : 255,
"description" : "Ссылка на фото "
}
},
"description" : "Фото офиса"
},
"OfficeLocationDto" : {
"required" : [ "address", "address_full", "city", "city_code", "country_code", "latitude", "longitude", "region", "region_code" ],
"properties" : {
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"city_code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"address_full" : {
"maxLength" : 255,
"description" : "Полный адрес с указанием страны, региона, города, и т.д."
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
}
},
"description" : "Информация об офисе"
},
"OfficeWorkTimeDto" : {
"required" : [ "day", "time" ],
"properties" : {
"day" : {
"description" : "Порядковый номер дня начиная с единицы. Понедельник = 1, воскресенье = 7.",
"format" : "int32"
},
"time" : {
"maxLength" : 255,
"description" : "Период работы в эти дни. Если в этот день не работают, то не отображается."
}
},
"description" : "График работы офиса"
},
"OfficeWorkTimeExcDto" : {
"properties" : {
"date" : { },
"time" : { },
"is_working" : { }
}
},
"OfficeWorkTimeExceptionDto" : {
"required" : [ "date_end", "date_start", "is_working" ],
"properties" : {
"date_start" : {
"description" : "Дата начала исключения в работе офиса",
"format" : "date",
"example" : "2020-01-01"
},
"date_end" : {
"description" : "Дата окончания исключения в работе офиса",
"format" : "date",
"example" : "2020-02-02"
},
"time_start" : {
"description" : "Время начала работы в указанную дату",
"example" : "09:00"
},
"time_end" : {
"description" : "Время окончания работы в указанную дату",
"example" : "18:00"
},
"is_working" : {
"description" : "Признак рабочего/нерабочего дня в указанную дату",
"example" : false
}
},
"description" : "Исключения в графике работы офиса"
},
"ResponseDtoScheduleInfoDto" : {
"required" : [ "requests" ],
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/ScheduleInfoDto"
},
"requests" : {
"description" : "Информация о запросах, относящихся к сущности.",
"items" : {
"$ref" : "#/components/schemas/RequestDto"
}
},
"related_entities" : {
"description" : "Связанные сущности",
"items" : {
"$ref" : "#/components/schemas/RelatedEntityDto"
}
}
},
"description" : "Ответ на запрос"
},
"ScheduleInfoDto" : {
"required" : [ "date", "order_uuid", "statuses", "time_from", "time_to", "uuid" ],
"properties" : {
"cdek_number" : {
"maxLength" : 255,
"description" : "Номер заказа СДЭК"
},
"order_uuid" : {
"description" : "Идентификатор заказа в ИС СДЭК",
"format" : "uuid"
},
"date" : {
"description" : "Дата доставки, согласованная с получателем. (Если заказ \"До склада\", эта дата не влияет на сроки доставки и может быть произвольной). При прозвоне дата доставки до склада устанавливается в автоматическом режиме (дата создания прозвона +19 дней)",
"format" : "date"
},
"time_from" : {
"pattern" : "HH:mm",
"description" : "Время доставки \"С\", согласованное с получателем. Обязательно, если заказ \"до двери\""
},
"time_to" : {
"pattern" : "HH:mm",
"description" : "Время доставки \"Пo\", согласованное с получателем. Обязательно, если заказ \"до двери\""
},
"comment" : {
"maxLength" : 255,
"description" : "Комментарий к договоренности о доставке"
},
"delivery_point" : {
"maxLength" : 255,
"description" : "Новый код ПВЗ СДЭК, на который будет доставлена посылка (если требовалось изменить)"
},
"to_location" : {
"$ref" : "#/components/schemas/ScheduleLocationDto"
},
"uuid" : {
"description" : "Идентификатор сущности в ИС СДЭК",
"format" : "uuid"
},
"statuses" : {
"description" : "Статусы договоренности о доставке",
"items" : {
"$ref" : "#/components/schemas/ScheduleStatusDto"
}
},
"source" : {
"description" : "Источник согласования (модуль, внешняя система, передающая данные о согласовании). Пример: DAILY_CALL_TASK"
}
},
"description" : "Договоренность о доставке"
},
"ScheduleStatusDto" : {
"required" : [ "code", "date_time", "name" ],
"properties" : {
"code" : {
"maxLength" : 255,
"description" : "Код статуса"
},
"name" : {
"maxLength" : 255,
"description" : "Название статуса"
},
"date_time" : {
"description" : "Дата и время установки статуса (формат yyyy-MM-dd'T'HH:mm:ssZ)",
"format" : "date-time"
}
},
"description" : "Информация о состоянии договоренности о доставке"
},
"AvailableDeliveryIntervalDto" : {
"required" : [ "end_time", "start_time" ],
"properties" : {
"start_time" : {
"pattern" : "HH:mm",
"description" : "Время начала интервала доставки"
},
"end_time" : {
"pattern" : "HH:mm",
"description" : "Время окончания интервала доставки"
}
},
"description" : "Доступные интервалы доставки"
},
"AvailableDeliveryIntervalsInfoDto" : {
"required" : [ "date", "time_intervals" ],
"properties" : {
"date" : {
"description" : "Дата доступного интервала для доставки (формат yyyy-MM-dd)",
"format" : "date"
},
"time_intervals" : {
"description" : "Временные интервалы для доставки",
"items" : {
"$ref" : "#/components/schemas/AvailableDeliveryIntervalDto"
}
}
},
"description" : "Доступные интервалы доставки"
},
"AvailableDeliveryIntervalsResponseDto" : {
"required" : [ "date_intervals" ],
"properties" : {
"date_intervals" : {
"description" : "Доступные интервалы доставки",
"items" : {
"$ref" : "#/components/schemas/AvailableDeliveryIntervalsInfoDto"
}
}
},
"description" : "Доступные интервалы доставки"
},
"CheckInfoDto" : {
"required" : [ "cdek_number", "date", "document_number", "fiscal_sign", "fiscal_storage_number", "order_uuid", "payment_info", "type" ],
"properties" : {
"order_uuid" : {
"description" : "Идентификатор заказа, для которого сформирован чек",
"format" : "uuid"
},
"cdek_number" : {
"description" : "Номер заказа, для которого сформирован чек",
"format" : "int64"
},
"date" : {
"description" : "Дата создания чека",
"format" : "date-time"
},
"fiscal_storage_number" : {
"maxLength" : 255,
"description" : "Номер фискального накопителя"
},
"document_number" : {
"maxLength" : 255,
"description" : "Порядковый номер фискального накопителя"
},
"fiscal_sign" : {
"description" : "Фискальный признак документа",
"format" : "int64"
},
"type" : {
"description" : "Тип чека",
"enum" : [ "CASH_RECEIPT_IN", "CASH_RECEIPT_REFUND" ]
},
"payment_info" : {
"description" : "Информация о сумме по чеку",
"items" : {
"$ref" : "#/components/schemas/PaymentInfoDto"
}
},
"shift_no" : {
"description" : "Номер кассовой смены с ККТ",
"format" : "int64"
}
},
"description" : "Информация о чеке"
},
"CheckResponseDto" : {
"properties" : {
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
},
"check_info" : {
"description" : "Список чеков",
"items" : {
"$ref" : "#/components/schemas/CheckInfoDto"
}
}
},
"description" : "Ответ метода получения чеков"
},
"PaymentInfoDto" : {
"required" : [ "sum", "type" ],
"properties" : {
"sum" : {
"description" : "Сумма по чеку",
"format" : "float"
},
"type" : {
"maxLength" : 4,
"description" : "Тип оплаты",
"enum" : [ "CASH", "CARD" ]
}
},
"description" : "Информация о сумме по чеку"
},
"CalculatorAvailableTariffsResponseAdditionalOrderTypesParamDto" : {
"properties" : {
"without_additional_order_type" : {
"description" : "Доступность тарифа для заказа без доп.типа"
},
"additional_order_types" : {
"uniqueItems" : true,
"description" : "Список доступных доп. типов заказа для тарифа",
"items" : { }
}
},
"description" : "Доп. типы заказа, применимые к тарифу"
},
"CalculatorAvailableTariffsResponseDeliveryModeDto" : {
"properties" : {
"delivery_mode" : {
"description" : "Код режима доставки"
},
"delivery_mode_name" : {
"description" : "Имя режима доставки"
},
"tariff_code" : {
"description" : "Код тарифа",
"format" : "int32"
}
},
"description" : "Режим доставки"
},
"CalculatorAvailableTariffsResponseDto" : {
"properties" : {
"tariff_codes" : {
"description" : "Список доступных сервисов",
"items" : {
"$ref" : "#/components/schemas/CalculatorAvailableTariffsResponseTariffCodeDto"
}
}
},
"description" : "Ответ на запрос на получение списка всех доступных тарифов"
},
"CalculatorAvailableTariffsResponseTariffCodeDto" : {
"properties" : {
"tariff_name" : {
"description" : "Имя сервиса"
},
"weight_min" : {
"description" : "Минимальный вес отправления",
"format" : "double"
},
"weight_max" : {
"description" : "Максимальный вес отправления",
"format" : "double"
},
"weight_calc_max" : {
"description" : "Максимальный расчетный вес",
"format" : "double"
},
"length_min" : {
"description" : "Минимальная длина упаковки",
"format" : "int32"
},
"length_max" : {
"description" : "Максимальная длина упаковки",
"format" : "int32"
},
"width_min" : {
"description" : "Минимальная ширина упаковки",
"format" : "int32"
},
"width_max" : {
"description" : "Максимальная ширина упаковки",
"format" : "int32"
},
"height_min" : {
"description" : "Минимальная высота упаковки",
"format" : "int32"
},
"height_max" : {
"description" : "Максимальная высота упаковки",
"format" : "int32"
},
"order_types" : {
"description" : "Список доступных типов заказов для тарифа (пустой список означает, что доступны все)",
"items" : { }
},
"payer_contragent_type" : {
"description" : "Применимо с контрагентами плательщиками, возможные значения:\n\nLEGAL_ENTITY - юридическое лицо\n\nINDIVIDUAL - физическое лицо\n\n(пустой список означает, что доступны все)",
"items" : { }
},
"sender_contragent_type" : {
"description" : "Применимо с контрагентами отправителями, возможные значения:\n\nLEGAL_ENTITY - юридическое лицо\n\nINDIVIDUAL - физическое лицо\n\n(пустой список означает, что доступны все)",
"items" : { }
},
"recipient_contragent_type" : {
"description" : "Применимо с контрагентами получателями, возможные значения:\n\nLEGAL_ENTITY - юридическое лицо\n\nINDIVIDUAL - физическое лицо\n\n(пустой список означает, что доступны все)",
"items" : { }
},
"delivery_modes" : {
"description" : "Режимы доставки (Приложение 15)",
"items" : {
"$ref" : "#/components/schemas/CalculatorAvailableTariffsResponseDeliveryModeDto"
}
},
"additional_order_types_param" : {
"$ref" : "#/components/schemas/CalculatorAvailableTariffsResponseAdditionalOrderTypesParamDto"
}
},
"description" : "Доступный сервис"
},
"ContragentNewTerritoriesResponse" : {
"properties" : {
"uuid" : {
"format" : "uuid"
},
"created" : {
"format" : "date-time"
},
"updated" : {
"format" : "date-time"
},
"version" : {
"format" : "int32"
},
"contragent_uuid" : {
"format" : "uuid"
}
}
},
"AsyncRequestsReportDto" : {
"properties" : {
"ordersRequested" : {
"format" : "int64"
},
"ordersCreated" : {
"format" : "int64"
},
"requestsTotal" : {
"format" : "int64"
},
"requestsOk" : {
"format" : "int64"
},
"requestsNotOk" : {
"format" : "int64"
},
"requestsPerOrderMax" : {
"format" : "int64"
},
"requestsPerOrderMin" : {
"format" : "int64"
},
"requestsPerOrderAvg" : {
"format" : "int64"
},
"requestsOkPerOrderMax" : {
"format" : "int64"
},
"requestsOkPerOrderMin" : {
"format" : "int64"
},
"requestsOkPerOrderAvg" : {
"format" : "int64"
},
"requestsNotOkPerOrderMax" : {
"format" : "int64"
},
"requestsNotOkPerOrderMin" : {
"format" : "int64"
},
"requestsNotOkPerOrderAvg" : {
"format" : "int64"
}
}
},
"SimplifiedResponseDto1" : {
"properties" : {
"errors" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/ErrorDto2"
}
},
"warnings" : {
"description" : "Список предупреждений",
"items" : {
"$ref" : "#/components/schemas/WarningDto"
}
}
},
"description" : "Транспорт с ошибками и предупреждениями"
},
"ErrorDto2" : {
"required" : [ "code", "message" ],
"properties" : {
"code" : {
"description" : "Код ошибки"
},
"additional_code" : {
"description" : "Дополнительный код ошибки для службы поддержки"
},
"message" : {
"description" : "Описание ошибки"
}
},
"description" : "Ошибка, возникшая в ходе выполнения запроса"
},
"LocationDto1" : {
"properties" : {
"code" : {
"description" : "Код населенного пункта СДЭК (метод \"Список населенных пунктов\")",
"format" : "int32"
},
"city_uuid" : {
"description" : "Идентификатор города в ИС СДЭК",
"format" : "uuid"
},
"city" : {
"maxLength" : 255,
"description" : "Название населенного пункта"
},
"fias_guid" : {
"description" : "Идентификатор ФИАС населенного пункта",
"format" : "uuid"
},
"kladr_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР",
"deprecated" : true
},
"country_code" : {
"maxLength" : 2,
"description" : "Код страны в формате ISO_3166-1_alpha-2 (по умолчанию \"RU\")"
},
"country" : {
"maxLength" : 255,
"description" : "Название страны населенного пункта"
},
"region" : {
"maxLength" : 255,
"description" : "Название региона"
},
"region_code" : {
"description" : "Код региона СДЭК (см. метод \"Список регионов\")",
"format" : "int32"
},
"fias_region_guid" : {
"description" : "Уникальный идентификатор ФИАС региона населенного пункта",
"format" : "uuid",
"deprecated" : true
},
"kladr_region_code" : {
"maxLength" : 255,
"description" : "Код КЛАДР региона населенного пункта",
"deprecated" : true
},
"sub_region" : {
"maxLength" : 255,
"description" : "Название района региона"
},
"longitude" : {
"description" : "Долгота",
"format" : "double"
},
"latitude" : {
"description" : "Широта",
"format" : "double"
},
"time_zone" : {
"description" : "Часовой пояс населенного пункта"
},
"payment_limit" : {
"description" : "Ограничение на сумму наложенного платежа в населенном пункте",
"format" : "double"
},
"address" : {
"maxLength" : 255,
"description" : "Строка адреса"
},
"postal_code" : {
"maxLength" : 255,
"description" : "Почтовый индекс"
}
},
"description" : "Населённый пункт"
},
"WebhookDto" : {
"title" : "WebhookDto",
"required" : [ "type", "url", "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор вебхука",
"format" : "uuid",
"readOnly" : true,
"example" : "dd71e526-d850-46db-97db-164391414c5b"
},
"type" : {
"description" : "Тип вебхука.
• ORDER_STATUS - событие по статусам;
• PRINT_FORM - готовность печатной формы;
• PREALERT_CLOSED - получение информации о закрытии преалерта;
• ACCOMPANYING_WAYBILL - получение информации о транспорте для СНТ;
• OFFICE_AVAILABILITY - получение информации об изменении доступности офиса;
• ORDER_MODIFIED - получение информации об изменении заказа;
• DELIV_AGREEMENT - получение информации об изменении договоренности о доставке;
• DELIV_PROBLEM - получение информации о проблемах доставки по заказу;
• COURIER_INFO - получение информации о курьере;
• DOWNLOAD_PHOTO - получение фото документов по заказам.
Если у клиента уже есть подписка с указанным типом, то будет создана еще одна подписка с таким же типом",
"example" : "ORDER_STATUS",
"enum" : [ "ORDER_STATUS", "ORDER_MODIFIED", "PRINT_FORM", "RECEIPT", "DOWNLOAD_PHOTO", "PREALERT_CLOSED", "ACCOMPANYING_WAYBILL", "OFFICE_AVAILABILITY", "DELIV_PROBLEM", "DELIV_AGREEMENT", "COURIER_INFO" ]
},
"url" : {
"description" : "URL, на который отправляется событие",
"example" : "http://yoursite.com/webhookcallback"
}
},
"description" : "Вебхук"
},
"RequestInfoDto" : {
"title" : "RequestInfoDto",
"properties" : {
"request_uuid" : {
"description" : "Идентификатор запроса в ИС СДЭК",
"format" : "uuid",
"example" : "dd71e526-d850-46db-97db-164391414c5b"
},
"type" : {
"description" : "Тип запроса",
"example" : "CREATE",
"enum" : [ "CREATE", "UPDATE", "DELETE", "AUTH", "GET" ]
},
"date_time" : {
"description" : "Дата и время установки текущего статуса запроса",
"format" : "date-time",
"example" : "2026-06-03T17:15Z"
},
"state" : {
"description" : "Текущее состояние запроса",
"example" : "SUCCESSFUL",
"enum" : [ "ACCEPTED", "SUCCESSFUL", "INVALID" ]
},
"errors" : {
"description" : "Ошибки, возникшие в ходе выполнения запроса",
"items" : {
"$ref" : "#/components/schemas/ErrorDto3"
}
}
},
"description" : "Информация о запросе"
},
"ResponseDto" : {
"properties" : {
"entity" : {
"description" : "Информация о сущности, над которой выполняется запрос"
},
"requests" : {
"description" : "Список запросов",
"items" : {
"$ref" : "#/components/schemas/RequestInfoDto"
}
}
},
"description" : "Ответ на запрос"
},
"ResponseDtoWebhookResponseDto" : {
"title" : "ResponseDto",
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/WebhookResponseDto"
},
"requests" : {
"description" : "Список запросов",
"items" : {
"$ref" : "#/components/schemas/RequestInfoDto"
}
}
},
"description" : "Ответ на запрос"
},
"WebhookResponseDto" : {
"title" : "WebhookResponseDto",
"required" : [ "uuid" ],
"properties" : {
"uuid" : {
"description" : "Идентификатор вебхука",
"format" : "uuid",
"readOnly" : true,
"example" : "dd71e526-d850-46db-97db-164391414c5b"
}
},
"description" : "Вебхук"
},
"OtpCreateRequest" : {
"title" : "OtpCreateRequest",
"required" : [ "clientContractorUuid", "length", "ttlSeconds", "url" ],
"properties" : {
"clientContractorUuid" : {
"description" : "Идентификатор клиента",
"format" : "uuid"
},
"url" : {
"minLength" : 1,
"description" : "Ссылка на внешний сервис генерации OTP"
},
"length" : {
"description" : "Длина кода, который будет отправлен клиенту",
"format" : "int32"
},
"ttlSeconds" : {
"description" : "Время жизни кода в секундах",
"format" : "int32"
}
},
"description" : "Запрос на добавление информации об OTP"
},
"AlertDto" : {
"title" : "AlertDto",
"properties" : {
"type" : {
"description" : "Тип, который используется на фронте для выбора цвета фона, на котором отображается текст",
"example" : "danger",
"enum" : [ "success", "info", "warning", "danger" ]
},
"msg" : {
"description" : "Текст ошибки",
"example" : "Внутренняя ошибка сервера."
},
"errorCode" : {
"description" : "Технический код",
"example" : "internal_error"
},
"params" : {
"description" : "Дополнительные параметры",
"items" : {
"$ref" : "#/components/schemas/AlertParamDto"
}
},
"source" : {
"description" : "Имя приложения, которое является источником",
"example" : "example-app"
}
},
"description" : "Ошибка при обработке запроса контроллером"
},
"AlertParamDto" : {
"title" : "AlertParamDto",
"properties" : {
"field" : {
"description" : "Имя параметра",
"example" : "order_number"
},
"value" : {
"description" : "Значение параметра",
"example" : "1234567890"
}
},
"description" : "Дополнительный параметр ошибки"
},
"ErrorResponseDto" : {
"properties" : {
"alerts" : {
"description" : "Список ошибок",
"items" : {
"$ref" : "#/components/schemas/AlertDto"
}
}
},
"description" : "Стандартный формат ответа контроллера в случае ошибки"
},
"OtpEntity" : {
"title" : "OtpEntity",
"required" : [ "length", "ttlSeconds", "url" ],
"properties" : {
"uuid" : {
"format" : "uuid"
},
"createdAt" : {
"format" : "date-time"
},
"url" : { },
"length" : {
"format" : "int32"
},
"ttlSeconds" : {
"format" : "int32"
}
}
},
"ClientEntity" : {
"title" : "ClientEntity",
"required" : [ "contractorUuid", "maxWebhooks" ],
"properties" : {
"uuid" : {
"format" : "uuid"
},
"createdAt" : {
"format" : "date-time"
},
"deleted" : { },
"contractorUuid" : {
"format" : "uuid"
},
"otp" : {
"$ref" : "#/components/schemas/OtpEntity"
},
"maxWebhooks" : {
"format" : "int32"
}
}
},
"OtpRequest" : {
"title" : "OtpRequest",
"properties" : {
"cdek_number" : {
"description" : "Номер заказа ЭК5"
},
"security_code" : {
"description" : "Код OTP"
}
},
"description" : "Запрос на генерацию OTP"
},
"OtpResponse" : {
"title" : "OtpResponse",
"properties" : {
"length" : {
"description" : "Длина отправляемого OTP",
"format" : "int32"
},
"ttlSeconds" : {
"description" : "Время жизни отправляемого OTP",
"format" : "int32"
}
},
"description" : "Ответ на запрос к методам OTP"
},
"DomainAddBlackListRequest" : {
"required" : [ "domain_list" ],
"properties" : {
"domain_list" : {
"items" : { }
}
}
},
"ResponseDtoWebhookDto" : {
"title" : "ResponseDto",
"properties" : {
"entity" : {
"$ref" : "#/components/schemas/WebhookDto"
},
"requests" : {
"description" : "Список запросов",
"items" : {
"$ref" : "#/components/schemas/RequestInfoDto"
}
}
},
"description" : "Ответ на запрос"
},
"DomainBlackListResult" : {
"title" : "DomainBlackListResult",
"properties" : {
"uuid" : {
"format" : "uuid"
},
"createdAt" : {
"format" : "date-time"
},
"updatedAt" : {
"format" : "date-time"
},
"deleted" : { },
"domain" : { },
"ip" : { }
}
},
"DomainDeleteBlackListRequest" : {
"required" : [ "domain_list", "ip_list" ],
"properties" : {
"domain_list" : {
"items" : { }
},
"ip_list" : {
"items" : { }
}
}
},
"ErrorDto3" : {
"title" : "ErrorDto",
"properties" : {
"code" : {
"description" : "Код ошибки",
"example" : "error_code"
},
"message" : {
"description" : "Сообщение об ошибке",
"example" : "Error message"
}
},
"description" : "Информация об ошибке"
}
},
"securitySchemes" : {
"bearerAuth" : {
"type" : "http",
"scheme" : "bearer",
"bearerFormat" : "JWT"
}
}
}
}