Калькулятор стоимости и сроков перевозки
Общие сведения
Сервис позволяет получить подробную информацию о стоимости и сроках интересующего способа перевозки. Для определения ориентировочной стоимости и сроков перевозки следует использовать "Калькулятор ориентировочной стоимости и сроков заказа".
Ниже представлено описание всех параметров метода, в соответствующем разделе можно найти примеры запросов и ответов.
Калькулятор стоимости и сроков перевозки
Запрос метода
Структура запроса
Адрес метода: https://api.dellin.ru/v2/calculator.json
{ "appkey":"00000000-0000-0000-0000-000000000000", "sessionID":"00000000-0000-0000-0000-000000000000", "delivery":{ "deliveryType":{ "type":"express" }, "arrival":{ "variant":"terminal", "terminalID":"1", "addressID":238577, "address":{ "search":"59.924501, 30.241762", "street":"7800000000008850000000000" }, "city":"7800000000000000000000000", "time":{ "worktimeStart":"9:30", "worktimeEnd":"19:00", "breakStart":"12:00", "breakEnd":"13:00", "exactTime":false }, "handling":{ "freightLift":true, "toFloor":2, "carry":50 }, "requirements":[ "0x9951e0ff97188f6b4b1b153dfde3cfec", "0x88f93a2c37f106d94ff9f7ada8efe886" ] }, "derival":{ "produceDate":"2019-11-08", "variant":"address", "terminalID":"1", "addressID":238577, "address":{ "search":"Москва, Юности, 5", "street":"7700000000004650000000000" }, "time":{ "worktimeEnd":"19:30", "worktimeStart":"9:00", "breakStart":"12:00", "breakEnd":"13:00", "exactTime":false }, "handling":{ "freightLift":true, "toFloor":40, "carry":243 }, "requirements":[ "0x9951e0ff97188f6b4b1b153dfde3cfec", "0x88f93a2c37f106d94ff9f7ada8efe886" ] }, "packages":[ { "uid":"0xa6a7bd2bf950e67f4b2cf7cc3a97c111", "count":1 } ], "accompanyingDocuments":[ { "action":"send" }, { "action":"return" } ] }, "members":{ "requester":{ "role":"sender", "uid":"ae62f076-d602-4341-b691-45bf8dfe4a10" } }, "cargo":{ "quantity":4, "length":1, "width":1, "height":1, "weight":12, "totalVolume":1, "totalWeight":12, "oversizedWeight":0, "oversizedVolume":0, "freightUID":"0x82e6000423b423b711da7d15445d42cb", "hazardClass":7.2, "insurance":{ "statedValue":15477.34, "term":false } }, "payment":{ "type":"cash", "promocode":"promo123", "paymentCity":"7700000000000000000000000", "paymentCitySearch":{ "search":"Москва" } } }
Адрес метода: https://api.dellin.ru/v2/calculator.xml
<request> <appkey>00000000-0000-0000-0000-000000000000</appkey> <sessionID>00000000-0000-0000-0000-000000000000</sessionID> <delivery> <deliveryType> <type>express</type> </deliveryType> <arrival> <variant>terminal</variant> <terminalID>1</terminalID> <addressID>238577</addressID> <address> <search>59.924501, 30.241762</search> <street>7800000000008850000000000</street> </address> <city>7800000000000000000000000</city> <time> <worktimeStart>9:30</worktimeStart> <worktimeEnd>19:00</worktimeEnd> <breakStart>12:00</breakStart> <breakEnd>13:00</breakEnd> <exactTime>false</exactTime> </time> <handling> <freightLift>true</freightLift> <toFloor>2</toFloor> <carry>50</carry> </handling> <requirements>0x9951e0ff97188f6b4b1b153dfde3cfec</requirements> <requirements>0x88f93a2c37f106d94ff9f7ada8efe886</requirements> </arrival> <derival> <produceDate>2019-11-08</produceDate> <variant>address</variant> <terminalID>1</terminalID> <addressID>238577</addressID> <address> <search>Москва, Юности, 5</search> <street>7700000000004650000000000</street> </address> <time> <worktimeEnd>19:30</worktimeEnd> <worktimeStart>9:00</worktimeStart> <breakStart>12:00</breakStart> <breakEnd>13:00</breakEnd> <exactTime>false</exactTime> </time> <handling> <freightLift>true</freightLift> <toFloor>40</toFloor> <carry>243</carry> </handling> <requirements>0x9951e0ff97188f6b4b1b153dfde3cfec</requirements> <requirements>0x88f93a2c37f106d94ff9f7ada8efe886</requirements> </derival> <packages> <uid>0xa6a7bd2bf950e67f4b2cf7cc3a97c111</uid> <count>1</count> </packages> <accompanyingDocuments> <action>send</action> </accompanyingDocuments> <accompanyingDocuments> <action>return</action> </accompanyingDocuments> </delivery> <members> <requester> <role>sender</role> <uid>ae62f076-d602-4341-b691-45bf8dfe4a10</uid> </requester> </members> <cargo> <quantity>4</quantity> <length>1</length> <width>1</width> <height>1</height> <weight>12</weight> <totalVolume>1</totalVolume> <totalWeight>12</totalWeight> <oversizedWeight>0</oversizedWeight> <oversizedVolume>0</oversizedVolume> <freightUID>0x82e6000423b423b711da7d15445d42cb</freightUID> <hazardClass>7.2</hazardClass> <insurance> <statedValue>15477.34</statedValue> <term>false</term> </insurance> </cargo> <payment> <type>cash</type> <promocode>promo123</promocode> <paymentCity>7700000000000000000000000</paymentCity> <paymentCitySearch> <search>Москва</search> </paymentCitySearch> </payment> </request>
Описание параметров
Request
Request | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
appkey | Да | string | Ключ приложения. Для получения ключа необходимо пройти регистрацию |
sessionID | Нет | string | ID сессии, требуется для учета индивидуальных скидок. Для получения сессии необходимо воспользоваться сервисом "Авторизация пользователя" |
delivery | Да | object | Информация по перевозке груза |
delivery.deliveryType | Да | DeliveryType | Вид межтерминальной перевозки груза для которого будет рассчитана стоимость |
delivery.arrival | Да | DerivalArrival | Данные по доставке груза до получателя |
delivery.derival | Да | DerivalArrival | Данные по доставке груза от отправителя |
delivery.packages | Нет | array of Packages | Данные по упаковке. При отсутствии параметра расчёт производится без учёта услуги |
delivery.accompanyingDocuments | Нет | array of AcDoc | Информация по сопроводительным документам |
members | Нет | object | Участники перевозки |
members.requester | Нет | Requester | Заказчик перевозки |
cargo | Да | Cargo | Информация о грузе |
payment | Нет | Payment | Оплата перевозки |
DeliveryType
DeliveryType | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
type | Да | string | Вид межтерминальной перевозки груза, для которого будет рассчитана стоимость. Возможные значения:
Малогабаритный груз - это груз, параметры которого не превышают следующие значения:
|
DerivalArrival
DerivalArrival | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
produceDate | Да | string | Дата выполнения заказа. Формат: "ГГГГ-ММ-ДД" Используется только для параметра "request.delivery.derival" |
variant | Да | string | Способ доставки груза. Возможные значения:
|
terminalID | Нет | string | ID терминала отправки/доставки груза из "Справочника терминалов". Заполняется при расчете стоимости предзаказа Допускается передача только одного из следующих параметров: "terminalID", "addressID", "address", "city" |
addressID | Нет | integer | ID адреса отправителя/получателя из адресной книги Личного кабинета (подробнее см. сервис "Адреса"). Заполняется в случае, если клиенту необходим расчёт для адреса, сохранённого в Личном Кабинете Допускается передача только одного из следующих параметров: "terminalID", "addressID", "address", "city" |
address | Нет | object | Адрес Допускается передача только одного из следующих параметров: "terminalID", "addressID", "address", "city" |
address.search | Нет* | string | Адрес в виде текста или координат. При передаче адреса в виде текста, помимо собственно адреса (улицы и номера дома), в запрос следует включать наименование населённого пункта, элементы необходимо указывать через запятую, например "Омск, Ленина, 5". Координаты также указываются через запятую, первое число - широта, например "59.924501, 30.241762". Помимо собственно адреса, в запрос следует включать наименование населённого пункта. Максимум - 1024 символа. *Передача одного из взаимоисключающих параметров "address.search" или "address.street"является обязательной |
address.street | Нет* | string | Код КЛАДР улицы. Может быть получен с помощью сервисов, представленных на странице "Поиск КЛАДР" *Передача одного из взаимоисключающих параметров "address.search" или "address.street"является обязательной |
city | Нет | string | Код КЛАДР города. Может быть получен с помощью сервисов, представленных на странице "Поиск КЛАДР" Используется только для параметра "request.delivery.arrival".Передача параметра невозможна, только если заказана доставка до адреса (значение параметра "variant" - "address").Допускается передача только одного из следующих параметров: "terminalID", "addressID", "address", "city" |
time | Нет* | object | Время передачи груза отправителем/получателю на адресе. *Параметр является обязательным, если выбрана доставка от адреса/до адреса (значение параметра "variant" - "address") |
time.worktimeStart | Да | string | Начало периода передачи груза. Формат: "ЧЧ:ММ" |
time.worktimeEnd | Да | string | Окончание периода передачи груза. Формат: "ЧЧ:ММ" |
time.breakStart | Нет | string | Начало перерыва. Формат: "ЧЧ:ММ" |
time.breakEnd | Нет | string | Окончание перерыва. Формат: "ЧЧ:ММ" |
time.exactTime | Нет | boolean | Передача груза в точное время. Значение по умолчанию: "false" |
handling | Нет | object | Погрузо-разгрузочные работы на адресе. Необязательный параметр, при его отсутствии расчёт производится без учёта стоимости услуги |
handling.freightLift | Нет | boolean | Есть грузовой лифт. Значение по умолчанию: "false" |
handling.toFloor | Нет | integer | Номер этажа, на который необходимо поднять груз |
handling.carry | Нет | integer | Расстояние, на которое необходимо перенести груз (в метрах) |
requirements | Нет | array of strings | Дополнительные требования к транспорту: доступные виды загрузки машины (боковая, задняя и пр.), а также другие требования - манипулятор, растентовка и пр. Указываются UID'ы из "Справочника специальных требований к транспорту" и "Справочника видов загрузки". Возможна передача нескольких значений |
Packages
Packages | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
uid | Да | string | Вид упаковки груза, UID упаковки из "Справочника дополнительных услуг" |
count | Нет* | integer | Количество упаковок *Если выбрана упаковка "Упаковка мешок" или "Картонная коробка", то параметр является обязательным |
AcDoc
AcDoc | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
action | Да | string | Действие с сопроводительными документами. Возможные значения:
Возможна передача обоих значений с использованием отдельных параметров.Возврат сопроводительных документов недоступен при отправке груза "анонимному" получателю, то есть, если значение "members.receiver.counteragent.isAnonym" - "true". "Анонимный" получатель - получатель, о котором предоставлен минимум информации (см. описание услуги "Упрощённая отправка груза" на сайте компании "Деловые Линии") |
Requester
Requester | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
role | Нет | string | Роль в перевозке. Возможные значения:
|
uid | Нет | string | UID контрагента из "Списка контрагентов". Параметр игнорируется при отсутствии полного доступа к контрагентам |
Cargo
Cargo | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
quantity | Нет | integer | Количество грузовых мест, шт. Значение по умолчанию - "1". Если вид перевозки груза - "письмо" ("request.delivery.deliveryType.type" = "letter"), то переданное значение параметра игнорируется, используется значение "1" |
length | Да* | float | Длина самого длинного грузового места, м. *Если вид перевозки груза - "письмо"("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.3" |
width | Да* | float | Ширина самого широкого грузового места, м. Если вид перевозки груза- "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.21" |
height | Да* | float | Высота самого высокого грузового места, м. *Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.01" |
weight | Нет* | float | Вес самого тяжелого грузового места, кг. *Параметр является обязательным, если количество грузовых мест больше одного ("request.cargo.quantity" > 1). В противном случае значение параметра принимается равным значению параметра "request.cargo.totalWeight". |
totalVolume | Да* | float | Общий объём груза, м3. *Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.001" |
totalWeight | Да* | float | Общий вес груза, кг. *Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.5" |
oversizedWeight | Нет* | float | Вес негабаритных грузовых мест, кг (1). Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр игнорируется. *Если по весогабаритным характеристикам определено, что груз является негабаритным, то параметр является обязательным |
oversizedVolume | Нет* | float | Объём негабаритных грузовых мест, м3 (1). Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр игнорируется. *Если по весогабаритным характеристикам определено, что груз является негабаритным, то параметр является обязательным |
freightUID | Нет | string | UID характера груза из справочника "Характер груза". Для поиска UID по наименованию груза следует использовать сервис "Характер груза по введенной строке". Если значение параметра "request.delivery.deliveryType.type" - "letter", то переданное значение игнорируется, автоматически устанавливается UID груза "Документы" |
hazardClass | Да | float | Класс опасности груза. Значение по умолчанию - "0" |
insurance | Нет | object | Информация о страховке груза |
insurance.statedValue | Да | float | Объявленная стоимость груза, руб. Максимальная длина поля - 12 символов |
insurance.term | Да | boolean | Признак страхования срока доставки груза. Значение по умолчанию - "true" |
Примечания: 1. Негабаритное грузовое место - это:
2. Заказ жесткой упаковки определяется передачей в параметре "request.delivery.packages.uid" идентификатора одного из следующих видов упаковки (см. "Справочник дополнительных услуг"):
|
Payment
Payment | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
type | Да | string | Вид оплаты (1). Возможные значения:
|
promocode | Нет | string | Промокод |
paymentCity | Нет* | string | Код КЛАДР населённого пункта оплаты (1). Может быть получен с помощью сервисов, представленных на странице "Поиск КЛАДР" *Передача одного из взаимоисключающих параметров "paymentCity" или "paymentCitySearch" является обязательной |
paymentCitySearch | Нет* | string | Данные по населённому пункту оплаты в виде произвольной строки (1) *Передача одного из взаимоисключающих параметров "paymentCity" или "paymentCitySearch" является обязательной |
paymentCitySearch.search | Да | string | Населённый пункт в виде произвольной строки. Максимум - 1024 символа. Помимо наименования населённого пункта, в строке может быть передано наименование страны, региона, района - это позволит уточнить поиск и исключить ошибки, которые могут возникнуть из-за одинаковых названий населённых пунктов |
Примечания:
|
Ответ метода
Структура ответа
{ "metadata":{ "status":200, "generated_at":"2019-11-25 08:16:47" }, "data":{ "derival":{ "terminal":"Санкт-Петербург", "price":475, "contractPrice":false, "servicePrice":475, "premiumDetails":[ ], "terminals":[ ], "handling":{ "price":0, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "contractPrice":false }, "intercity":{ "price":null, "contractPrice":true, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "small":{ "price":540, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "air":{ "price":540, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "express":{ "price":540, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "letter":{ "price":540, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "arrival":{ "terminal":"Чита", "price":0, "contractPrice":false, "premiumDetails":[ { "name":"Экспедирование до клиента график доставки", "value":2000, "date":null, "announcement":false, "public":true } ], "terminals":[ { "id":"104", "name":"Чита", "address":"Чита, Сухая Падь ул., 3", "streetCode":"7500000100008350000000000", "price":0, "contractPrice":false, "default":true, "express":false, "isPVZ":false } ], "contractPrice":false }, "price":1680, "priceMinimal":"auto", "packages":{ }, "orderDates":{ "pickup":"2019-11-26", "senderAddressTime":null, "senderTerminalTime":null, "arrivalToOspSender":null, "derrivalFromOspSender":"2019-11-26", "arrivalToOspReceiver":null, "arrivalToAirport":"2019-11-28", "arrivalToAirportMax":"2019-11-29", "giveoutFromOspReceiver":"2019-11-28 00:00:00", "giveoutFromOspReceiverMax":"2019-11-29 00:00:00", "derrivalFromOspReceiver":null, "createTo":null, "derrivalToAddress":null, "derivalToAddressMax":null }, "deliveryTerm":0, "accompanyingDocuments":{ "send":{ "price":200, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "return":{ "price":200, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] } }, "insurance":250, "insuranceComponents":{ "cargoInsurance":200, "termInsurance":50 }, "notify":{ "price":15, "contractPrice":false, "premium":0, "discount":0, "premiumDetails":[ ], "discountDetails":[ ] }, "simpleShippingAvailable":true, "availableDeliveryTypes":{ "auto":480.0, "small":549.0, "avia":4230.0, "express":620.0, "letter":null }, "foundAddresses":[ { "field":"delivery.derival.address", "source":"199106, Россия, Санкт-Петербург, Санкт-Петербург, Кожевенная линия, дом 40", "result":"199106, Россия, г Санкт-Петербург, линия Кожевенная, дом 40" }, { "field":"delivery.arrival.address", "source":"Москва, Юности, 5", "result":"Россия, Московская обл, г Москва, ул Юности, д 5" }, { "field":"payment.paymentCitySearch", "source":"Москва", "result":"Россия, Московская обл, г Москва" } ], "information":[ "После оформления заказа наш специалист свяжется с Вами для утверждения стоимости" ] } }
<response> <metadata> <status>200</status> <generated_at>2019-11-25 08:16:47</generated_at> </metadata> <data> <derival> <terminal>Санкт-Петербург</terminal> <price>475</price> <contractPrice>false</contractPrice> <servicePrice>475</servicePrice> <handling> <price>0</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </handling> </derival> <intercity> <price /> <contractPrice>true</contractPrice> <premium>0</premium> <discount>0</discount> </intercity> <small> <price>540</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </small> <air> <price>540</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </air> <express> <price>540</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </express> <letter> <price>540</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </letter> <arrival> <terminal>Чита</terminal> <price>0</price> <contractPrice>false</contractPrice> <premiumDetails> <name>Экспедирование до клиента график доставки</name> <value>2000</value> <date /> <announcement>false</announcement> <public>true</public> </premiumDetails> <terminals> <id>104</id> <name>Чита</name> <address>Чита, Сухая Падь ул., 3</address> <streetCode>7500000100008350000000000</streetCode> <price>0</price> <contractPrice>false</contractPrice> <default>true</default> <express>false</express> <isPVZ>false</isPVZ> </terminals> </arrival> <price>1680</price> <priceMinimal>auto</priceMinimal> <packages /> <orderDates> <pickup>2019-11-26</pickup> <senderAddressTime /> <senderTerminalTime /> <arrivalToOspSender /> <derrivalFromOspSender>2019-11-26</derrivalFromOspSender> <arrivalToOspReceiver /> <arrivalToAirport>2019-11-28</arrivalToAirport> <arrivalToAirportMax>2019-11-29</arrivalToAirportMax> <giveoutFromOspReceiver>2019-11-28 00:00:00</giveoutFromOspReceiver> <giveoutFromOspReceiverMax>2019-11-29 00:00:00</giveoutFromOspReceiverMax> <derrivalFromOspReceiver /> <createTo /> <derrivalToAddress /> <derivalToAddressMax /> </orderDates> <deliveryTerm>0</deliveryTerm> <accompanyingDocuments> <send> <price>200</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </send> <return> <price>200</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </return> </accompanyingDocuments> <insurance>250</insurance> <insuranceComponents> <cargoInsurance>200</cargoInsurance> <termInsurance>50</termInsurance> </insuranceComponents> <notify> <price>15</price> <contractPrice>false</contractPrice> <premium>0</premium> <discount>0</discount> </notify> <simpleShippingAvailable>true</simpleShippingAvailable> <availableDeliveryTypes> <auto>480</auto> <small>549</small> <avia>4230</avia> <express>620</express> <letter /> </availableDeliveryTypes> <foundAddresses> <field>delivery.derival.address</field> <source>199106, Россия, Санкт-Петербург, Санкт-Петербург, Кожевенная линия, дом 40</source> <result>199106, Россия, г Санкт-Петербург, линия Кожевенная, дом 40</result> </foundAddresses> <foundAddresses> <field>delivery.arrival.address</field> <source>Москва, Юности, 5</source> <result>Россия, Московская обл, г Москва, ул Юности, д 5</result> </foundAddresses> <foundAddresses> <field>payment.paymentCitySearch</field> <source>Москва</source> <result>Россия, Московская обл, г Москва</result> </foundAddresses> <information>После оформления заказа наш специалист свяжется с Вами для утверждения стоимости</information> </data> </response>
Описание параметров
Response
Response | ||
---|---|---|
Параметр | Тип | Описание |
metadata | object | Системная информация |
metadata.status | integer | Эмуляция http-кода состояния. В случае успешного выполнения возвращается код "200" (OK) |
metadata.generated_at | string | Дата и время генерации ответа сервера. Формат: "ГГГГ-ММ-ДД ЧЧ:ММ:СС" |
data | object | Информация по стоимости и срокам перевозки груза |
data.derival | DerivalArrival | Данные по доставке груза от отправителя |
data.intercity | CostsCalculation | Информация о стоимости автоперевозки |
data.small | CostsCalculation | Информация о стоимости доставки малогабаритного груза |
data.air | CostsCalculation | Информация о стоимости авиаперевозки |
data.express | CostsCalculation | Информация о стоимости экспресс-перевозки |
data.letter | CostsCalculation | Информация о стоимости услуги "Письмо" |
data.arrival | DerivalArrival | Данные по доставке груза до получателя |
data.price | string | Итоговая стоимость для выбранного вида перевозки Итоговая стоимость складывается из значений следующих параметров:
|
data.priceMinimal | string | Способ перевозки с минимальной стоимостью. Возможные значения:
|
data.packages | array of CostsCalculation | Информация о стоимости упаковки |
data.orderDates | OrderDates | График движения груза |
data.deliveryTerm | integer | Срок доставки груза от терминала получения до адреса (в днях) |
data.accompanyingDocuments | AcDoc | Информация о стоимости отправки/возврата сопроводительных документов |
data.insurance | string | Общая стоимость страхования груза |
data.insuranceComponents | InsuranceComponents | Общий список услуг по страхованию груза и их стоимость |
data.notify | CostsCalculation | Информация о стоимости услуги "информация о статусе заказа" |
data.simpleShippingAvailable | boolean | Информация о доступности услуги "упрощённая отправка" |
data.availableDeliveryTypes | AvailableDeliveryTypes | Список доступных видов перевозки и их стоимость |
data.foundAddresses | array of FoundAddresses | Данные по найденным адресам/населённым пунктам. Параметр присутствует в ответе, только если в запросе был передан параметр "address.search" класса "DerivalArrival" или параметр "paymetn.paymentCitySearch.search" |
data.information | array of strings | Информационное сообщение. Отображается, например, если стоимость какой-то из услуг является договорной (в ответе есть параметр "contractPrice" со значением "true") или если в запросе был передан промокод, но применить его по какой-то причине невозможно |
DerivalArrival
DerivalArrival | ||
---|---|---|
Параметр | Тип | Описание |
terminal | string | Город подразделения-отправителя/подразделения-получателя |
price | string | Итоговая стоимость доставки от отправителя/до получателя Если заказана доставка от терминала/до терминала, то есть в запросе для параметра "request.delivery.derival.variant"/"request.delivery.arrival.variant" было передано значение "terminal", то итоговая стоимость отправки/получения равна стоимости въезда на терминал (см. параметры "response.derival.teminals.pirce"/response.arrival.teminals.pirce").Если заказана доставка от адреса отправителя/до адреса получателя, то есть в запросе для параметра "request.delivery.derival.variant"/"request.delivery.arrival.variant" было передано значение "address", то итоговая стоимость складывается из значений следующих параметров:
|
contractPrice | boolean | Флаг, обозначающий, что стоимость доставки является договорной. Если стоимость договорная (значение параметра - "true"), то значение параметров "price" и "servicePrice" - "null", информация о наценках и скидках отсутствует (массивы "premiumDetails" и "discountDetails" - пустые) |
servicePrice | string | Стоимость услуги доставки груза от адреса отправителя/до адреса получателя (без учёта скидок и наценок) Параметр выводится только в том случае, если производится расчёт стоимости доставки непосредственно от/до адреса, то есть в запросе для параметра"request.delivery.derival.variant"/"request.delivery.arrival.variant" было передано значение "address"(в случае, если рассчитывается стоимость доставки от/до терминала, то есть было передано значение "terminal", параметр не выводится) |
premiumDetails | array of PricingDetails | Подробная информация о наценках по услуге |
discountDetails | array of PricingDetails | Подробная информация о скидках по услуге |
terminals | array of Terminals | Информация о терминалах, где может быть выдан/сдан груз |
handling | CostsCalculation | Информация о стоимости погрузо-разгрузочных работ |
CostsCalculation
CostsCalculation | ||
---|---|---|
Параметр | Тип | Описание |
price | string | Стоимость услуги |
contractPrice | boolean | Признак договорной цены. Если стоимость договорная (значение параметра - "true"), то значение параметра "price" - "null", информация о наценках и скидках отсутствует (значения параметров "premium" и "discount" - "0", массивы "premiumDetails" и "discountDetails" - пустые) |
premium | string | Размер наценки по услуге |
discount | string | Размер скидки по услуге |
premiumDetails | array of PricingDetails | Подробная информация о наценках по услуге |
discountDetails | array of PricingDetails | Подробная информация о скидках по услуге |
AvailableDeliveryTypes
AvailableDeliveryType | ||
---|---|---|
Параметр | Тип | Описание |
auto | float | Стоимость автодоставки |
small | float | Стоимость доставки малогабаритного груза |
avia | float | Стоимость авиадоставки |
express | float | Стоимость экспресс-доставки |
letter | float | Стоимость доставки письма Информация о стоимости услуги доступна, только если значение параметра запроса "delivery.deliveryType.type" - "letter". В остальных случаях информация недоступна, значение параметра - "null" |
OrderDates
OrderDates | ||
---|---|---|
Параметр | Тип | Описание |
pickup | string | Дата передачи груза на адресе отправителя |
senderAddressTime | string | Время, до которого необходимо забрать груз на адресе отправителя |
senderTerminalTime | string | Время, до которого необходимо передать груз на терминал отправителя |
arrivalToOspSender | string | Дата прибытия на терминал-отправитель |
derivalFromOspSender | string | Дата отправки с терминала-отправителя |
arrivalToOspReceiver | string | Дата прибытия на терминал-получатель |
arrivalToAirport | string | Дата прибытия на терминал получателя/в аэропорт |
arrivalToAirportMax | string | Максимальная дата прибытия на терминал получателя/в аэропорт (в случае, если возможно увеличение срока прибытия) |
giveoutFromOspReceiver | string | Дата и время, с которого груз готов к выдаче на терминале |
giveoutFromOspReceiverMax | string | Максимальная дата и время, с которого груз готов к выдаче на терминале (в случае, если возможно увеличение срока готовности) |
derivalFromOspReceiver | string | Дата отправки с терминала-получателя |
createTo | string | Время, до которого необходимо подать заявку на доставку от адреса |
derrivalToAddress | string | Дата и время, с которого возможна доставка до клиента Параметр присутствует в ответе только при расчёте стоимости авиа или экспресс-перевозки (значение параметра запроса "delivery.deliveryType.type"- "avia" или "express") |
derivalToAddressMax | string | Максимальная дата и время, до которого возможна доставка до клиента Параметр присутствует в ответе только при расчёте стоимости авиа или экспресс-перевозки (значение параметра запроса "delivery.deliveryType.type"- "avia" или "express") |
AcDoc
AcDoc | ||
---|---|---|
Параметр | Тип | Описание |
send | CostsCalculation | Информация о стоимости отправки сопроводительных документов |
return | CostsCalculation | Информация о стоимости возврата сопроводительных документов |
InsuranceComponents
InsuranceComponents | ||
---|---|---|
Параметр | Тип | Описание |
cargoInsurance | string | Общая стоимость услуги "Страхование груза" |
termInsurance | string | Общая стоимость услуги "Страхование срока доставки груза". Если стоимость не указана, значит, услуга недоступна для этого направления или груза |
contractPrice | boolean | Признак договорной цены. Если стоимость договорная (значение параметра - "true"), то информация о стоимости отсутствует (значения параметров "cargoInsurance" и "termInsurance" - "0") |
PricingDetails
PricingDetails | ||
---|---|---|
Параметр | Тип | Описание |
name | string | Наименование типа скидки/наценки. Например, "Наценка на негабарит" или "Открытая акция" |
value | string | Размер скидки/наценки в рублях |
date | string | Срок действия. Формат: "ГГГГ-ММ-ДД" |
announcement | boolean | Признак отношения к акциям. Возможные значения:
|
public | boolean | Признак публичной скидки/наценки. Для авторизованного пользователя наценки могут быть как публичными, так и индивидуальными. Для неавторизованного - только публичными. Возможные значения:
|
triggers | array of Triggers | Массив характеристик заказа, которые инициировали применение скидки. Параметр выводится в блоке "discountDetails", если такие характеристики есть и скидка была применена |
Triggers
Triggers | ||
---|---|---|
Параметр | Тип | Описание |
key | string | Характеристика заказа, которая инициировала применение скидки. Например, если скидка была применена по промокоду, то параметр содержит значение "promocode" |
Terminals
Terminals | ||
---|---|---|
Параметр | Тип | Описание |
id | string | ID терминала из "Справочника терминалов" |
name | string | Наименование подразделения |
address | string | Адрес терминала |
streetCode | string | Код КЛАДР улицы, см. метод "Поиск улиц" |
price | string | Стоимость въезда на территорию терминала |
contractPrice | boolean | Признак договорной цены. Если стоимость договорная (значение параметра - "true"), то значение параметра "price" - "null" |
default | boolean | Признак того, что терминал является терминалом по умолчанию для выбранного города |
express | boolean | Признак того, что на терминале может быть оказана услуга "Экспресс-перевозка" |
isPVZ | boolean | В настоящий момент параметр присутствует в ответе, но не используется |
FoundAddresses
FoundAddresses | ||
---|---|---|
Параметр | Тип | Описание |
field | string | Объект, в котором был передан параметр "search" |
source | string | Введённое значение |
result | string | Найденный адрес/населённый пункт |
Обработка ошибок
В методе используются общие ошибки API, описание формата и перечень ошибок см. в документе "Ошибки методов API".