Калькулятор. Расчет по доступным тарифам
Метод используется клиентами для расчета стоимости и сроков доставки по всем доступным тарифам.
Запрос на расчет по доступным тарифам
Для использования необходимо отправить 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 | additional_order_types | Дополнительный тип заказа: 2 - для сборного груза (LTL) 4 - для Forward 6 - для "Фулфилмент. Приход" 7 - для "Фулфилмент. Отгрузка" 10 - для доставки шин по тарифу "Экономичный экспресс" | [ ] | нет |
| 4 | currency | Валюта, в которой необходимо произвести расчет (подробнее см. приложение 1) По умолчанию - валюта договора | integer | нет |
| 5 | lang | Язык вывода информации о тарифах Возможные значения: rus, eng, zho По умолчанию - rus | string(3) | нет |
| 6 | from_location1 | Адрес отправления | location | да |
| 6.1 | code | Код населенного пункта СДЭК (метод "Список населенных пунктов") | integer | да2 |
| 6.2 | postal_code | Почтовый индекс | string(255) | да2 |
| 6.3 | country_code | Код страны в формате ISO_3166-1_alpha-2 (по умолчанию RU) | string(2) | нет |
| 6.4 | city | Название города | string(255) | нет |
| 6.5 | address | Полная строка адреса | string(255) | да2 |
| 7 | to_location1 | Адрес получения | location | да |
| 7.1 | code | Код населенного пункта СДЭК (метод "Список населенных пунктов") | integer | нет |
| 7.2 | postal_code | Почтовый индекс | string(255) | нет |
| 7.3 | country_code | Код страны в формате ISO_3166-1_alpha-2 (по умолчанию RU) | string(2) | нет |
| 7.4 | city | Название города | string(255) | нет |
| 7.5 | address | Полная строка адреса | string(255) | нет |
| 8 | packages | Список информации по местам (упаковкам) | package[ ] | да |
| 8.1 | weight | Общий вес (в граммах) | integer | да |
| 8.2 | length | Габариты упаковки. Длина (в сантиметрах) | integer | нет |
| 8.3 | width | Габариты упаковки. Ширина (в сантиметрах) | integer | нет |
| 8.4 | height | Габариты упаковки. Высота (в сантиметрах) | integer | нет |
1 Идентификация города производится по следующему алгоритму в порядке приоритетности:
- По уникальному коду города СДЭК. Значения передаются в атрибутах from_location.code и to_location.code.
- По почтовому индексу города. Значения передаются в атрибутах from_location.postal_code и to_location.postal_code. В качестве уточняющих параметров могут быть переданы код страны и наименование города.
- По строке адреса. Значения передаются в атрибутах from_location.address и to_location.address.
2 Достаточно указать одно из полей code, postal_code или 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 | Российский рубль | RUB |
| 2 | Тенге | KZT |
| 3 | Доллар США | USD |
| 4 | Евро | EUR |
| 5 | Фунт Стерлингов | GBP |
| 6 | Китайский юань | CNY |
| 7 | Беларусский рубль | BYR |
| 8 | Гривна | UAH |
| 9 | Киргизский сом | KGS |
| 10 | Армянский драм | AMD |
| 11 | Турецкая лира | TRY |
| 12 | Тайский бат | THB |
| 13 | Вон | KRW |
| 14 | Дирхам | AED |
| 15 | Узбекский сум | UZS |
| 16 | Тугрик | MNT |
| 17 | Злотый | PLN |
| 18 | Манат | AZN |
| 19 | Лари | GEL |
| 55 | Йена | JPY |
Приложение 2. Тарифы СДЭК
Тарифы для ИМ
Код | Название тарифа | Режим доставки | Ограничение по весу | Услуга | Описание |
|---|---|---|---|---|---|
| 7 | Международный экспресс документы дверь-дверь | дверь-дверь (Д-Д) | до 5 кг | Международный экспресс | Экспресс-доставка за/из-за границы документов и писем. |
| 8 | Международный экспресс грузы дверь-дверь | дверь-дверь (Д-Д) | до 30 кг | Международный экспресс | Экспресс-доставка за/из-за границы грузов и посылок до 30 кг. |
136 | Посылка склад-склад | склад-склад | до 30 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |
137 | Посылка склад-дверь | склад-дверь | |||
138 | Посылка дверь-склад | дверь-склад | |||
139 | Посылка дверь-дверь | дверь-дверь (Д-Д) | |||
| 231 | Экономичная посылка дверь-дверь | дверь-дверь (Д-Д) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров для компаний, осуществляющих дистанционную торговлю. |
| 232 | Экономичная посылка дверь-склад | дверь-склад (Д-С) | |||
| 233 | Экономичная посылка склад-дверь | склад-дверь (С-Д) | |||
234 | Экономичная посылка склад-склад | склад-склад | |||
291 | E-com Express склад-склад | Склад-склад | до 500 кг | E-com Express | Самая быстрая экспресс-доставка в режиме авиа. Тариф доступен только для клиентов с типом Юридическое лицо. |
293 | E-com Express дверь-дверь | Дверь-дверь (Д-Д) | |||
294 | E-com Express склад-дверь | Склад-дверь (С-Д) | |||
295 | E-com Express дверь-склад | Дверь-склад (Д-С) | |||
509 | E-com Express дверь-постамат | Дверь-постамат (Д-П) | |||
510 | E-com Express склад-постамат | Склад-постамат (С-П) | |||
| 366 | Посылка дверь-постамат | дверь-постамат (Д-П) | до 30 кг | Посылка | Услуга экономичной доставки товаров для компаний, осуществляющих дистанционную торговлю. |
| 368 | Посылка склад-постамат | склад-постамат (С-П) | |||
| 378 | Экономичная посылка склад-постамат | склад-постамат (С-П) | до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров для компаний, осуществляющих дистанционную торговлю. |
| 184 | E-com Standard дверь-дверь | Дверь-дверь (Д-Д) | E-com Standard | Стандартная экспресс-доставка. Сервис по доставке товаров из-за рубежа с услугами по таможенному оформлению (услуги для компаний дистанционной торговли). Тариф доступен только для клиентов с типом Юридическое лицо. Доступно для заказов с типом "ИМ" и "Доставка". | |
| 185 | E-com Standard склад-склад | Склад-склад (С-С) | |||
| 186 | E-com Standard склад-дверь | Склад-дверь (С-Д) | |||
| 187 | E-com Standard дверь-склад | Дверь-склад (Д-С) | |||
| 497 | E-com Standard дверь-постамат | Дверь-постамат (Д-П) | |||
| 498 | E-com Standard склад-постамат | Склад-постамат (С-П) | |||
| 19 | Экономичный экспресс дверь-дверь | Дверь-дверь (Д-Д) | Индивидуальные ограничения в зависимости от направления. Максимальные габариты одной стороны - 300 см | Экономичный экспресс | Экономичная доставка шин. Необходимо передавать дополнительный тип заказа "10" в поле additional_order_types. |
| 2321 | Экономичный экспресс дверь-склад | Дверь-склад (Д-С) | |||
| 2322 | Экономичный экспресс склад-дверь | Склад-дверь (С-Д) | |||
| 2323 | Экономичный экспресс склад-склад | Склад-склад (С-С) |
Тарифы для обычной доставки
Код | Название тарифа | Режим доставки | Ограничение по весу | Услуга | Описание |
|---|---|---|---|---|---|
|
|
|
|
|
|
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 | Магистральный экспресс склад-склад | склад-склад (С-С) | Экономичная доставка | Быстрая экономичная доставка грузов. | |
121 | Магистральный экспресс дверь-дверь | дверь-дверь (Д-Д) | |||
122 | Магистральный экспресс склад-дверь | склад-дверь (С-Д) | |||
123 | Магистральный экспресс дверь-склад | дверь-склад (Д-С) | |||
63 | Магистральный супер-экспресс склад-склад | склад-склад (С-С) | Экономичная доставка | Быстрая экономичная доставка грузов к определенному часу | |
124 | Магистральный супер-экспресс дверь-дверь | дверь-дверь (Д-Д) | |||
125 | Магистральный супер-экспресс склад-дверь | склад-дверь (С-Д) | |||
126 | Магистральный супер-экспресс дверь-склад | дверь-склад (Д-С) | |||
|
| ||||
| |||||
| 480* | Экспресс дверь-дверь | дверь-дверь (Д-Д) | Экспресс | Классическая экспресс-доставка документов и грузов по стандартным срокам доставки. Без ограничений по весу | |
| 481* | Экспресс дверь-склад | дверь-склад (Д-С) | |||
| 482* | Экспресс склад-дверь | склад-дверь (С-Д) | |||
| 483* | Экспресс склад-склад | склад-склад (С-С) | |||
| 485* | Экспресс дверь-постамат | дверь-постамат (Д-П) | |||
| 486* | Экспресс склад-постамат | склад-постамат (С-П) | |||
| 748 | Сборный груз дверь-дверь | дверь-дверь (Д-Д) | Сборный груз | Экономичная наземная доставка сборных грузов | |
| 749 | Сборный груз дверь-склад | дверь-склад (Д-С) | |||
| 750 | Сборный груз склад-дверь | склад-дверь (С-Д) | |||
| 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 | склад-склад | |||
| 533 | СДЭК документы дверь-дверь | Дверь-дверь (Д-Д) | 0.5 кг | СДЭК документы | Экспресс доставка документов со спец. условием от 90 документов за 90 дней. Доступно только для заказов с типом "доставка". |
| 534 | СДЭК документы дверь-склад | Дверь-склад (Д-С) | 0.5 кг | СДЭК документы | |
| 535 | СДЭК документы склад-дверь | Склад-дверь (С-Д) | 0.5 кг | СДЭК документы | |
| 536 | СДЭК документы склад-склад | Склад-склад (С-С) | 0.5 кг | СДЭК документы |
*- системно "Экспресс лайт" = "Экспресс" (т.е. 1=480, 361=485 и т.д.).
Для разных направлений тарифы могут называться по-разному. Тарифы идентичны, по расчету одинаковы. В ответе возвращается ИЛИ "Экспресс лайт" ИЛИ "Экспресс"
Приложение 3. Режимы доставки
| Код | Режим доставки |
|---|---|
| 1 | дверь-дверь |
| 2 | дверь-склад |
| 3 | склад-дверь |
| 4 | склад-склад |
| 6 | дверь-постамат |
| 7 | склад-постамат |
| 8 | постамат-дверь |
| 9 | постамат-склад |
| 10 | постамат-постамат |
© 2000—2024, Курьерская компания СДЭК