Page tree
Skip to end of metadata
Go to start of metadata

Метод используется для расчета стоимости и сроков доставки по коду тарифа.

Запрос на расчет по коду тарифа

Для использования необходимо отправить POST-запрос на URL:

Тело запроса

Необходимо передавать в формате JSON (Content-Type: application/json).

Поддерживаются следующие поля:

Название поля

Описание

Тип поля

Обяз. для заполн.

1dateДата и время планируемой передачи заказа
По умолчанию - текущая
dateTime нет
2typeТип заказа (для проверки доступности тарифа и дополнительных услуг по типу заказа):
1 - "интернет-магазин"
2 - "доставка" 
По умолчанию - 1
integerнет
3currencyВалюта, в которой необходимо произвести расчет (подробнее см. приложение 1)
По умолчанию - валюта договора
integerнет
4tariff_codeКод тарифа (подробнее см. приложение 2)integerда
5from_location1Адрес отправленияlocationда
5.1codeКод локации (справочник СДЭК)integer

нет

5.2postal_codeПочтовый индексstring(255)нет
5.3country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)нет
5.4cityНазвание городаstring(255)нет
5.5addressПолная строка адресаstring(255)нет
6to_location1Адрес полученияlocationда
6.1codeКод локации (справочник СДЭК)integer

нет

6.2postal_codeПочтовый индексstring(255)нет
6.3country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)нет
6.4cityНазвание городаstring(255)нет
6.5addressПолная строка адресаstring(255)нет
7servicesДополнительные услугиservice[ ]нет
7.1codeТип дополнительной услуги, код из справочника доп. услуг (подробнее см. приложение 3)string()да
7.2parameterПараметр дополнительной услуги:
  • количество упаковок для услуги "Упаковка 1" и "Упаковка 2" (для всех типов заказа)
  • объявленная стоимость заказа для услуги "Страхование" (только для заказов с типом "доставка")
  • этаж для "Подъем на этаж ручной"
integerнет
8packagesСписок информации по местам (упаковкам)package[ ]да
8.1weightОбщий вес (в граммах)integerда
8.2lengthГабариты упаковки. Длина (в сантиметрах)integerнет
8.3widthГабариты упаковки. Ширина (в сантиметрах)integerнет
8.4heightГабариты упаковки. Высота (в сантиметрах)integerнет

1Идентификация города производится по следующему алгоритму в порядке приоритетности:

  1. По уникальному коду города СДЭК. Значения передаются в атрибутах from_location.code и to_location.code.
  2. По почтовому индексу города. Значения передаются в атрибутах from_location.postal_code и to_location.postal_code. В качестве уточняющих параметров могут быть переданы код страны и наименование города.
  3. По строке адреса. Значения передаются в атрибутах from_location.address и to_location.address.

Ответ на расчет по коду тарифа

Ответ возвращается в формате JSON:

Название поля

Описание

Тип поля

Обяз. для заполн.

1delivery_sumСтоимость доставкиfloatда
2period_minМинимальное время доставки (в рабочих днях)integerда
3period_maxМаксимальное время доставки (в рабочих днях)integerда
4weight_calcРасчетный вес (в граммах)integerда
5servicesДополнительные услуги (возвращается, если в запросе были переданы доп. услуги)service[ ]нет
5.1codeТип дополнительной услуги, код из справочника доп. услугstring()да
5.2sumСтоимость услугиfloatда
6total_sumСтоимость доставки с учетом дополнительных услугfloatда
7currencyВалюта, в которой рассчитана стоимость доставки (код СДЭК)string(3)да
8errorsСписок ошибокerror[]нет
8.1codeКод ошибкиstring()да
8.2messageОписание ошибкиstring()да


Пример запроса
{
    "type": "2",
    "date": "2020-11-03T11:49:32+0700",
    "currency": "1",
    "tariff_code": "11",
    "from_location": {
        "code": 270
    },
    "to_location": {
        "code": 44
    },
    "services": [
        {
            "code": "PACKAGE_1",
            "parameter": "2"
        }
    ],
    "packages": [
        {
            "height": 10,
            "length": 10,
            "weight": 4000,
            "width": 10
        }
    ]
}


Пример ответа
{
    "period_min": 2,
    "currency": "RUB",
    "delivery_sum": 1040.0,
    "weight_calc": 4000,
    "services": [
        {
            "code": "PACKAGE_1",
            "sum": 100.0
        }
    ],
    "period_max": 2,
    "total_sum": 1140.0
}

Приложение 1. Валюты калькулятора

КодВалюта
1Рубль
2Тенге
3Доллар
4Евро
5Фунт стерлингов
6Юань
7Белорусские рубли
8Гривна
9Киргизский сом
10Армянский драм
11Турецкая лира
12Тайский бат
13Вона
14Дирхам
15Сум
16Тугрик
17Злотый
18Манат
19Лари

Приложение 2.Тарифы СДЭК

Тарифы для ИМ

Код

Название тарифа

Режим доставки

Ограничение по весу

Услуга

Описание

7Международный экспресс документы дверь-дверьдверь-дверь (Д-Д)до 5 кгМеждународный экспрессЭкспресс-доставка за/из-за границы документов и писем.
8Международный экспресс грузы дверь-дверьдверь-дверь (Д-Д)до 30 кгМеждународный экспресс

Экспресс-доставка за/из-за границы грузов и посылок до 30 кг.

136

Посылка склад-склад

склад-склад (С-С)

до 30 кг







Посылка

Услуга экономичной доставки товаров по России для компаний, осуществляющих дистанционную торговлю.

137

Посылка склад-дверь

склад-дверь (С-Д)

138

Посылка дверь-склад

дверь-склад (Д-С)

139

Посылка дверь-дверь

дверь-дверь (Д-Д)

233

Экономичная посылка склад-дверь

склад-дверь (С-Д)

до 50 кг


Экономичная посылка

Услуга экономичной наземной доставки товаров по России для компаний, осуществляющих дистанционную торговлю.

Услуга действует по направлениям из Москвы в подразделения СДЭК, находящиеся за Уралом и в Крым.

234

Экономичная посылка склад-склад

склад-склад (С-С)

291

CDEK Express склад-склад

склад-склад (С-С)





CDEK Express




Сервис по доставке товаров из-за рубежа в Россию, Украину, Казахстан, Киргизию, Узбекистан с услугами по таможенному оформлению.

Предлагается 2 схемы работы:

1) клиент доставляет заказ на таможенный пост в России. Мы встречаем, помогаем с таможней и доставляем адресату;

2) клиент привозит посылки на один из наших складов за рубежом. Мы перевозим их на таможенный пост в Россию, проводим очистку и доставляем получателю.

293

CDEK Express дверь-дверь

дверь-дверь (Д-Д)

294

CDEK Express склад-дверь

склад-дверь (С-Д)

295

CDEK Express дверь-склад

дверь-склад (Д-С)

366

Посылка дверь-постамат

дверь-постамат (Д-П)до 30 кгПосылкаУслуга экономичной доставки товаров по России для компаний, осуществляющих дистанционную торговлю.
368Посылка склад-постаматсклад-постамат (С-П)
378Экономичная посылка склад-постаматсклад-постамат (С-П)

до 50 кг

Экономичная посылка

Услуга экономичной наземной доставки товаров по России для компаний, осуществляющих дистанционную торговлю.

Услуга действует по направлениям из Москвы в подразделения СДЭК, находящиеся за Уралом и в Крым

Тарифы Китайский экспресс

Доступны для заказов с типом "интернет-магазин" и для заказов с типом "доставка".

Код

Название тарифа

Режим доставки

Ограничение по весу

Услуга

Описание

243

Китайский экспресс

склад-склад (С-С)


Китайский Экспресс

Услуга по доставке из Китая в Россию, Белоруссию и Казахстан. Стоимость разбита по интервалам:
- до 200 гр;
- каждые последующие 100 гр до 1 кг;
- каждый последующий 1кг свыше 1 кг.

245

Китайский экспресс

дверь-дверь (Д-Д)


246

Китайский экспресс

склад-дверь (С-Д)


247

Китайский экспресс

дверь-склад (Д-С)

Тарифы для обычной доставки

Код

Название тарифа

Режим доставки

Ограничение по весу

Услуга

Описание

1

Экспресс лайт дверь-дверь

дверь-дверь (Д-Д)

до 30 кг

Экспресс

Классическая экспресс-доставка по России документов и грузов до 30 кг.

3

Супер-экспресс до 18

дверь-дверь (Д-Д)

до 30 кг

Срочная доставка

Срочная доставка документов и грузов «из рук в руки» по России к определенному часу.

5

Экономичный экспресс склад-склад

склад-склад (С-С)


Экономичная доставка

Недорогая доставка грузов по России ЖД и автотранспортом (доставка грузов с увеличением сроков).

10

Экспресс лайт склад-склад

склад-склад (С-С)

до 30 кг


Экспресс

Классическая экспресс-доставка по России документов и грузов.

11

Экспресс лайт склад-дверь

склад-дверь (С-Д)

12

Экспресс лайт дверь-склад

дверь-склад (Д-С)

15

Экспресс тяжеловесы склад-склад

склад-склад (С-С)

от 30 кг

Экспресс

Классическая экспресс-доставка по России грузов.

16

Экспресс тяжеловесы склад-дверь

склад-дверь (С-Д)

17

Экспресс тяжеловесы дверь-склад

дверь-склад (Д-С)

18

Экспресс тяжеловесы дверь-дверь

дверь-дверь (Д-Д)

57

Супер-экспресс до 9

дверь-дверь (Д-Д)

до 30 кг

Срочная доставка

Срочная доставка документов и грузов «из рук в руки» по России к определенному часу (доставка за 1-2 суток).

58

Супер-экспресс до 10

дверь-дверь (Д-Д)

59

Супер-экспресс до 12

дверь-дверь (Д-Д)

60

Супер-экспресс до 14

дверь-дверь (Д-Д)

61

Супер-экспресс до 16

дверь-дверь (Д-Д)

62

Магистральный экспресс склад-склад

склад-склад (С-С)


Экономичная доставка

Быстрая экономичная доставка грузов по России

63

Магистральный супер-экспресс склад-склад

склад-склад (С-С)


Экономичная доставка

Быстрая экономичная доставка грузов к определенному часу

118Экономичный экспресс дверь-дверьдверь-дверь (Д-Д)
Экономичная доставкаНедорогая доставка грузов по России ЖД и автотранспортом (доставка грузов с увеличением сроков).
119Экономичный экспресс склад-дверьсклад-дверь (С-Д)
120Экономичный экспресс дверь-складдверь-склад (Д-С)
121Магистральный экспресс дверь-дверьдверь-дверь (Д-Д)
Экономичная доставкаБыстрая экономичная доставка грузов по России
122Магистральный экспресс склад-дверьсклад-дверь (С-Д)
123Магистральный экспресс дверь-складдверь-склад (Д-С)
124Магистральный супер-экспресс дверь-дверьдверь-дверь (Д-Д)
Экономичная доставкаБыстрая экономичная доставка грузов к определенному часу
125Магистральный супер-экспресс склад-дверьсклад-дверь (С-Д)
126Магистральный супер-экспресс дверь-складдверь-склад (Д-С)
361Экспресс лайт дверь-постаматдверь-постамат (Д-П)до 30 кг

Экспресс

Классическая экспресс-доставка по России документов и грузов до 30 кг.

363

Экспресс лайт склад-постамат

склад-постамат (С-П)
480Экспресс дверь-дверьдверь-дверь (Д-Д)
ЭкспрессКлассическая экспресс-доставка документов и грузов по стандартным срокам доставки внутри страны (Россия, Белоруссия, Армения, Киргизия, Казахстан). Также действует по направлениям между странами таможенного союза (Россия, Белоруссия, Армения, Киргизия, Казахстан).
Без ограничений по весу
481Экспресс дверь-складдверь-склад (Д-С)
482Экспресс склад-дверьсклад-дверь (С-Д)
483Экспресс склад-складсклад-склад (С-С)
485Экспресс дверь-постаматдверь-постамат (Д-П)
486Экспресс склад-постаматсклад-постамат (С-П)

Приложение 3. Дополнительные услуги

Код услугиНазвание

INSURANCE

Страхование

DELIV_WEEKEND

Доставка в выходной день

TAKE_SENDER

Забор в городе отправителе

DELIV_RECEIVER

Доставка в городе получателе

TRYING_ON

Примерка на дому

PART_DELIV

Частичная доставка

INSPECTION_CARGO

Осмотр вложения

REVERSE

Реверс

DANGER_CARGOОпасный груз
PACKAGE_1Упаковка 1
PACKAGE_2Упаковка 2
WAIT_FOR_RECEIVERОжидание более 15 мин. у получателя
WAIT_FOR_SENDERОжидание более 15 мин. у отправителя
REPEATED_DELIVERYПовторная поездка
SMSСмс уведомление
GET_UP_FLOOR_BY_HANDПодъем на этаж ручной
GET_UP_FLOOR_BY_ELEVATORПодъем на этаж лифтом
CALLПрозвон
THERMAL_MODEТепловой режим
  • No labels