Калькулятор. Расчет по доступным тарифам
Метод используется клиентами для расчета стоимости и сроков доставки по всем доступным тарифам.
Запрос на расчет по доступным тарифам
Для использования необходимо отправить POST-запрос на URL:
Среда | URL |
---|---|
тестовая | https://api.edu.cdek.ru/v2/calculator/tarifflist |
боевая | https://api.cdek.ru/v2/calculator/tarifflist |
Тело запроса
Необходимо передавать в формате JSON (Content-Type: application/json).
Поддерживаются следующие поля:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | date | Дата и время планируемой передачи заказа По умолчанию - текущая | dateTime | нет |
2 | type | Тип заказа: 1 - "интернет-магазин" 2 - "доставка" По умолчанию - 1 | integer | нет |
3 | currency | Валюта, в которой необходимо произвести расчет (подробнее см. приложение 1) По умолчанию - валюта договора | integer | нет |
4 | lang | Язык вывода информации о тарифах Возможные значения: rus, eng, zho По умолчанию - rus | string(3) | нет |
5 | from_location1 | Адрес отправления | location | да |
5.1 | code | Код населенного пункта СДЭК (метод "Список населенных пунктов") | integer | нет |
5.2 | postal_code | Почтовый индекс | string(255) | нет |
5.3 | country_code | Код страны в формате ISO_3166-1_alpha-2 (по умолчанию RU) | string(2) | нет |
5.4 | city | Название города | string(255) | нет |
5.5 | address | Полная строка адреса | string(255) | нет |
6 | to_location1 | Адрес получения | location | да |
6.1 | code | Код населенного пункта СДЭК (метод "Список населенных пунктов") | integer | нет |
6.2 | postal_code | Почтовый индекс | string(255) | нет |
6.3 | country_code | Код страны в формате ISO_3166-1_alpha-2 (по умолчанию RU) | string(2) | нет |
6.4 | city | Название города | string(255) | нет |
6.5 | address | Полная строка адреса | string(255) | нет |
7 | packages | Список информации по местам (упаковкам) | package[ ] | да |
7.1 | weight | Общий вес (в граммах) | integer | да |
7.2 | length | Габариты упаковки. Длина (в сантиметрах) | integer | нет |
7.3 | width | Габариты упаковки. Ширина (в сантиметрах) | integer | нет |
7.4 | height | Габариты упаковки. Высота (в сантиметрах) | integer | нет |
1Идентификация города производится по следующему алгоритму в порядке приоритетности:
- По уникальному коду города СДЭК. Значения передаются в атрибутах from_location.code и to_location.code.
- По почтовому индексу города. Значения передаются в атрибутах from_location.postal_code и to_location.postal_code. В качестве уточняющих параметров могут быть переданы код страны и наименование города.
- По строке адреса. Значения передаются в атрибутах from_location.address и to_location.address.
Ответ на расчет по доступным тарифам
Ответ возвращается в формате JSON:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | tariff_codes | Доступные тарифы | [ ] | нет |
1.1 | tariff_code | Код тарифа (подробнее см. приложение 2) | integer | да |
1.2 | tariff_name | Название тарифа на языке вывода | string() | да |
1.3 | tariff_description | Описание тарифа на языке вывода | string() | да |
1.4 | delivery_mode | Режим тарифа (подробнее см. приложение 3) | integer | да |
1.5 | delivery_sum | Стоимость доставки | float | да |
1.6 | period_min | Минимальное время доставки (в рабочих днях) | integer | да |
1.7 | period_max | Максимальное время доставки (в рабочих днях) | integer | да |
1.8 | calendar_min | Минимальное время доставки (в календарных днях) | integer | нет |
1.9 | calendar_max | Максимальное время доставки (в календарных днях) | integer | нет |
2 | errors | Список ошибок | error[] | нет |
2.1 | code | Код ошибки | string() | да |
2.2 | message | Описание ошибки | string() | да |
{ "type": 1, "date": "2020-11-03T11:49:32+0700", "currency": 1, "lang": "rus", "from_location": { "code": 270 }, "to_location": { "code": 44 }, "packages": [ { "height": 10, "length": 10, "weight": 4000, "width": 10 } ] } |
{ "tariff_codes": [ { "tariff_code": 1, "tariff_name": "Экспресс лайт дверь-дверь", "tariff_description": "Классическая экспресс-доставка документов и грузов по всей территории России по принципу «от двери до двери» со стандартными сроками доставки", "delivery_mode": 1, "delivery_sum": 1135.0, "period_min": 2, "period_max": 2 }, { "tariff_code": 10, "tariff_name": "Экспресс лайт склад-склад", "tariff_description": "Отправитель самостоятельно доставляет груз/документы в офис СД «Экспресс-курьер», получатель самостоятельно забирает груз/документы в офисе СД «Экспресс-курьер»", "delivery_mode": 4, "delivery_sum": 960.0, "period_min": 2, "period_max": 2 }] } |
Приложение 1. Валюты калькулятора
Код | Валюта |
---|---|
1 | Рубль |
2 | Тенге |
3 | Доллар |
4 | Евро |
5 | Фунт стерлингов |
6 | Юань |
7 | Белорусские рубли |
8 | Гривна |
9 | Киргизский сом |
10 | Армянский драм |
11 | Турецкая лира |
12 | Тайский бат |
13 | Вона |
14 | Дирхам |
15 | Сум |
16 | Тугрик |
17 | Злотый |
18 | Манат |
19 | Лари |
55 | Японская иена |
Приложение 2. Тарифы СДЭК
Тарифы для ИМ
Код | Название тарифа | Режим доставки | Ограничение по весу | Услуга | Описание |
---|---|---|---|---|---|
7 | Международный экспресс документы дверь-дверь | дверь-дверь (Д-Д) | до 5 кг | Международный экспресс | Экспресс-доставка за/из-за границы документов и писем. |
8 | Международный экспресс грузы дверь-дверь | дверь-дверь (Д-Д) | до 30 кг | Международный экспресс | Экспресс-доставка за/из-за границы грузов и посылок до 30 кг. |
136 | Посылка склад-склад | склад-склад (С-С) | до 30 кг | Посылка | Услуга экономичной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. |
137 | Посылка склад-дверь | склад-дверь (С-Д) | |||
138 | Посылка дверь-склад | дверь-склад (Д-С) | |||
139 | Посылка дверь-дверь | дверь-дверь (Д-Д) | |||
231 | Экономичная посылка дверь-дверь | дверь-дверь (Д-Д) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. Услуга действует по направлениям из Москвы в подразделения СДЭК, находящиеся за Уралом и в Крым. |
232 | Экономичная посылка дверь-склад | дверь-склад (Д-С) | |||
233 | Экономичная посылка склад-дверь | склад-дверь (С-Д) | |||
234 | Экономичная посылка склад-склад | склад-склад (С-С) | |||
291 | CDEK Express склад-склад | склад-склад (С-С) | CDEK Express | Сервис по доставке товаров из-за рубежа в Россию, Украину, Казахстан, Киргизию, Узбекистан с услугами по таможенному оформлению. Предлагается 2 схемы работы: 1) клиент доставляет заказ на таможенный пост в России. Мы встречаем, помогаем с таможней и доставляем адресату; 2) клиент привозит посылки на один из наших складов за рубежом. Мы перевозим их на таможенный пост в Россию, проводим очистку и доставляем получателю. | |
293 | CDEK Express дверь-дверь | дверь-дверь (Д-Д) | |||
294 | CDEK Express склад-дверь | склад-дверь (С-Д) | |||
295 | CDEK Express дверь-склад | дверь-склад (Д-С) | |||
366 | Посылка дверь-постамат | дверь-постамат (Д-П) | до 30 кг | Посылка | Услуга экономичной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. |
368 | Посылка склад-постамат | склад-постамат (С-П) | |||
378 | Экономичная посылка склад-постамат | склад-постамат (С-П) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. Услуга действует по направлениям из Москвы в подразделения СДЭК, находящиеся за Уралом и в Крым |
184 | Международный экономичный экспресс | дверь-дверь (Д-Д) | Международный экономичный экспресс | Сервис по доставке товаров из-за рубежа в Россию, Беларусь, Казахстан, Киргизию, Узбекистан с услугами по таможенному оформлению. | |
185 | Международный экономичный экспресс | склад-склад (С-С) | |||
186 | Международный экономичный экспресс | склад-дверь (С-Д) | |||
187 | Международный экономичный экспресс | дверь-склад (Д-С) | |||
533 | СДЭК документы дверь-дверь | Дверь-дверь (Д-Д) | 0.3 кг | СДЭК документы | Экспресс доставка документов по всей РФ и ЕАЭС, со спец. условием от 90 документов за 90 дней |
534 | СДЭК документы дверь - склад | Дверь-склад (Д-С) | 0.3 кг | СДЭК документы | |
535 | СДЭК документы склад - дверь | Склад-дверь (С-Д) | 0.3 кг | СДЭК документы | |
536 | СДЭК документы склад - склад | Склад-склад (С-С) | 0.3 кг | СДЭК документы |
Тарифы Китайский экспресс
Доступны для заказов с типом "интернет-магазин" и для заказов с типом "доставка".
Код | Название тарифа | Режим доставки | Ограничение по весу | Услуга | Описание | |
---|---|---|---|---|---|---|
243 | Китайский экспресс | склад-склад (С-С) | Китайский Экспресс | Услуга по доставке из Китая в Россию, Белоруссию и Казахстан. Стоимость разбита по интервалам: | ||
245 | Китайский экспресс | дверь-дверь (Д-Д) | ||||
246 | Китайский экспресс | склад-дверь (С-Д) | ||||
247 | Китайский экспресс | дверь-склад (Д-С) |
Тарифы для обычной доставки
Код | Название тарифа | Режим доставки | Ограничение по весу | Услуга | Описание |
---|---|---|---|---|---|
|
|
|
|
|
|
3 | Супер-экспресс до 18 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» по России к определенному часу. |
|
|
|
|
| |
|
|
|
|
|
|
|
|
| |||
|
|
| |||
|
|
|
|
|
|
|
|
| |||
|
|
| |||
|
|
| |||
57 | Супер-экспресс до 9 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» по России к определенному часу (доставка за сутки). |
58 | Супер-экспресс до 10 | дверь-дверь (Д-Д) | |||
59 | Супер-экспресс до 12 | дверь-дверь (Д-Д) | |||
60 | Супер-экспресс до 14 | дверь-дверь (Д-Д) | |||
61 | Супер-экспресс до 16 | дверь-дверь (Д-Д) | |||
777 | Супер-экспресс до 12 | дверь-склад (Д-С) | |||
786 | Супер-экспресс до 14 | дверь-склад (Д-С) | |||
795 | Супер-экспресс до 16 | дверь-склад (Д-С) | |||
804 | Супер-экспресс до 18 | дверь-склад (Д-С) | |||
778 | Супер-экспресс до 12 | склад-дверь (С-Д) | |||
787 | Супер-экспресс до 14 | склад-дверь (С-Д) | |||
796 | Супер-экспресс до 16 | склад-дверь (С-Д) | |||
805 | Супер-экспресс до 18 | склад-дверь (С-Д) | |||
779 | Супер-экспресс до 12 | склад-склад (С-С) | |||
788 | Супер-экспресс до 14 | склад-склад (С-С) | |||
797 | Супер-экспресс до 16 | склад-склад (С-С) | |||
806 | Супер-экспресс до 18 | склад-склад (С-С) | |||
62 | Магистральный экспресс склад-склад | склад-склад (С-С) | Экономичная доставка | Быстрая экономичная доставка грузов по России | |
63 | Магистральный супер-экспресс склад-склад | склад-склад (С-С) | Экономичная доставка | Быстрая экономичная доставка грузов к определенному часу | |
| |||||
124 | Магистральный супер-экспресс дверь-дверь | дверь-дверь (Д-Д) | Экономичная доставка | Быстрая экономичная доставка грузов к определенному часу | |
125 | Магистральный супер-экспресс склад-дверь | склад-дверь (С-Д) | |||
126 | Магистральный супер-экспресс дверь-склад | дверь-склад (Д-С) | |||
|
| ||||
| |||||
480* | Экспресс дверь-дверь | дверь-дверь (Д-Д) | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки внутри страны (Россия, Белоруссия, Армения, Киргизия, Казахстан). Также действует по направлениям между странами таможенного союза (Россия, Белоруссия, Армения, Киргизия, Казахстан). Без ограничений по весу | |
481* | Экспресс дверь-склад | дверь-склад (Д-С) | |||
482* | Экспресс склад-дверь | склад-дверь (С-Д) | |||
483* | Экспресс склад-склад | склад-склад (С-С) | |||
485* | Экспресс дверь-постамат | дверь-постамат (Д-П) | |||
486* | Экспресс склад-постамат | склад-постамат (С-П) | |||
751 | Сборный груз склад-склад | склад-склад (С-С) | до 20000 кг | Сборный груз | Экономичная наземная доставка сборных грузов |
66 | Доставка за 4 часа внутри города пешие | дверь-дверь (Д-Д) | до 15 кг | Блиц-экспресс | Доставка заказов от 0 до 15 кг пешими курьерами день в день по Москве и Санкт-Петербургу |
67 | Доставка за 4 часа МСК-МО МО-МСК пешие | дверь-дверь (Д-Д) | до 15 кг | Доставка заказов от 0 до 15 кг пешими курьерами день в день по Москве и Московской области (до 10 км от МКАД) | |
68 | Доставка за 4 часа внутри города авто | дверь-дверь (Д-Д) | от 15 кг до 30 кг | Доставка заказов от 15 кг до 30 кг пешими курьерами день в день по Москве и Санкт-Петербургу | |
69 | Доставка за 4 часа МСК-МО МО-МСК авто | дверь-дверь (Д-Д) | от 15 кг до 30 кг | Доставка заказов от 15 кг до 30 кг пешими курьерами день в день по Москве и Московской области (до 10 км от МКАД | |
676 | Супер-экспресс до 10.00 | дверь-дверь | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» по России к определенному часу (доставка за 1-2 суток). |
677 | Супер-экспресс до 10.00 | дверь-склад | |||
678 | Супер-экспресс до 10.00 | склад-дверь | |||
679 | Супер-экспресс до 10.00 | склад-склад | |||
686 | Супер-экспресс до 12.00 | дверь-дверь | |||
687 | Супер-экспресс до 12.00 | дверь-склад | |||
688 | Супер-экспресс до 12.00 | склад-дверь | |||
689 | Супер-экспресс до 12.00 | склад-склад | |||
696 | Супер-экспресс до 14.00 | дверь-дверь | |||
697 | Супер-экспресс до 14.00 | дверь-склад | |||
698 | Супер-экспресс до 14.00 | склад-дверь | |||
699 | Супер-экспресс до 14.00 | склад-склад | |||
706 | Супер-экспресс до 16.00 | дверь-дверь | |||
707 | Супер-экспресс до 16.00 | дверь-склад | |||
708 | Супер-экспресс до 16.00 | склад-дверь | |||
709 | Супер-экспресс до 16.00 | склад-склад | |||
716 | Супер-экспресс до 18.00 | дверь-дверь | |||
717 | Супер-экспресс до 18.00 | дверь-склад | |||
718 | Супер-экспресс до 18.00 | склад-дверь | |||
719 | Супер-экспресс до 18.00 | склад-склад |
*- системно "Экспресс лайт" = "Экспресс" (т.е. 1=480, 361=485 и т.д.).
Для разных направлений тарифы могут называться по-разному. Тарифы идентичны, по расчету одинаковы. В ответе возвращается ИЛИ "Экспресс лайт" ИЛИ "Экспресс"
Приложение 3. Режимы доставки
Код | Режим доставки |
---|---|
1 | дверь-дверь |
2 | дверь-склад |
3 | склад-дверь |
4 | склад-склад |
6 | дверь-постамат |
7 | склад-постамат |
© 2000—2022, Курьерская компания СДЭК