Поиск по сайту

API
Главная / API - Калькулятор стоимости и сроков

Калькулятор стоимости и сроков перевозки

Обновлено 03.07.2020
224 кб

Общие сведения

Сервис позволяет получить подробную информацию о стоимости и сроках интересующего способа перевозки. Для определения ориентировочной стоимости и сроков перевозки следует использовать "Калькулятор ориентировочной стоимости и сроков заказа".

 Ниже представлено описание всех параметров метода, в соответствующем разделе можно найти примеры запросов и ответов. 

Калькулятор стоимости и сроков перевозки

Запрос метода

Пример запроса 

Адрес метода: 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":{
            "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":{
            "street":"7700000000003690000000000",
         },
         "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,
      "weight":12,
      "height":1,
      "totalVolume":1,
      "totalWeight":12,
      "oversizedWeight":0,
      "oversizedVolume":0,
      "freightUID":"0x82e6000423b423b711da7d15445d42cb",
      "freightName":"Автомобильные диски",
      "hazardClass":7.2,
      "insurance":{
         "statedValue":15477.34,
         "term":false
      }
   },
   "payment":{
      "paymentCity":"7700000000000000000000000",
      "type":"cash"
   }
}

Адрес метода: 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>
            <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>
            <street>7700000000003690000000000</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>
      <weight>12</weight>
      <height>1</height>
      <totalVolume>1</totalVolume>
      <totalWeight>12</totalWeight>
      <oversizedWeight>0</oversizedWeight>
      <oversizedVolume>0</oversizedVolume>
      <freightUID>0x82e6000423b423b711da7d15445d42cb</freightUID>
      <freightName>Автомобильные диски</freightName>
      <hazardClass>7.2</hazardClass>
      <insurance>
         <statedValue>15477.34</statedValue>
         <term>false</term>
      </insurance>
   </cargo>
   <payment>
      <paymentCity>7700000000000000000000000</paymentCity>
      <type>cash</type>
   </payment>
</request>

Описание параметров

Request
Request
ПараметрОбязательныйТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
sessionIDНетstringID сессии, требуется для учета индивидуальных скидок. Для получения сессии необходимо воспользоваться сервисом "Авторизация пользователя"
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ДаobjectИнформация о грузе
cargo.quantityНетinteger

Количество грузовых мест, шт. Значение по умолчанию - "1".

Если вид перевозки груза - "письмо" ("request.delivery.deliveryType.type" = "letter"), то переданное значение параметра игнорируется, используется значение "1"

cargo.lengthДа*float

Длина самого длинного грузового места, м.

*Если вид перевозки груза - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.3"

cargo.widthДа*float

Ширина самого широкого грузового места, м.

Если вид перевозки груза - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.21"

cargo.weightНет*float

Вес самого тяжелого грузового места, кг.

*Параметр является обязательным, если количество грузовых мест больше одного ("request.cargo.quantity" > 1). В противном случае значение параметра принимается равным значению параметра "request.cargo.totalWeight".
*Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.5"

cargo.heightДа*float

Высота самого высокого грузового места, м.

*Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.01"

cargo.totalVolumeДа*float

Общий объём груза, м3.

*Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.001"

cargo.totalWeightДа*float

Общий вес груза, кг.

*Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.5"

cargo.oversizedWeightНет*float

Вес негабаритных грузовых мест, кг (1).

Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр игнорируется.

*Если по весогабаритным характеристикам определено, что груз является негабаритным, то параметр является обязательным

cargo.oversizedVolumeНет*float

Объём негабаритных грузовых мест, м3  (1).

Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр игнорируется.

*Если по весогабаритным характеристикам определено, что груз является негабаритным, то параметр является обязательным

cargo.freightUIDНетstring

UID характера груза из справочника "Характер груза". Для поиска UID по наименованию груза следует использовать сервис "Характер груза по введенной строке"

Допускается передача только одного из параметров: "request.cargo.freightName" или "request.cargo.freightUID"
cargo.freightNameНетstring

Характер груза

Допускается передача только одного из параметров: "request.cargo.freightName" или "request.cargo.freightUID"
cargo.hazardClassДаfloat

Класс опасности груза.

Значение по умолчанию - "0"

cargo.insuranceНетInsuaranceИнформация о страховке груза
paymentДаobjectОплата перевозки
payment.paymentCityДаstringКод КЛАДР города оплаты. Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР"
payment.typeДаstring

Вид оплаты.

Возможные значения:

  • "cash" - оплата наличными;
  • "noncash" - безналичный расчёт.

Используется для проверки возможности безналичной оплаты

Примечания:

  1. Негабаритное грузовое место - это грузовое место, вес которого больше либо равен 100 кг (80 кг в случае перевозки авиатранспортом) или одно из измерений (Д*Ш*В) которого больше либо равно 3 м (80 см в случае перевозки авиатранспортом)

DeliveryType
DeliveryType
ПараметрОбязательныйТипОписание

type

Даstring

Вид межтерминальной перевозки груза, для которого будет рассчитана стоимость.

Возможные значения:

  • "auto"- автодоставка;
  • "express" - экспресс-доставка;
  • "letter" - письмо;
  • "avia" - авиадоставка;
  • "small" - доставка малогабаритного груза.

Малогабаритный груз - это груз, параметры которого не превышают следующие значения:
  • масса меньше либо равна 10 кг;
  • Д*Ш*В меньше либо равны 0,54*0,39*0,39 м;
  • объём меньше либо равен 0,1 куб. м.
Заказ услуги "Доставка малогабаритного груза" возможен только в случае, если в городах отправки и получения есть подразделения компании "Деловые Линии", более подробную информацию см. на сайте компании

DerivalArrival
DerivalArrival
ПараметрОбязательныйТипОписание
produceDateДаstring

Дата выполнения заказа.

Формат: "ГГГГ-ММ-ДД"

Используется только для параметра "request.derival"
variantДаstring

Способ доставки груза.

Возможные значения:

  • "address" - доставка груза непосредственно от адреса отправителя/до адреса получателя;
  • "terminal" - доставка груза от/до терминала.

*При заказе перевозки малогабаритного груза (значение параметра запроса "delivery.deliverуType.type" - "small") доставка от/до терминала невозможна

terminalIDНетstring

ID терминала отправки/доставки груза из "Справочника терминалов").

Заполняется при расчете стоимости предзаказа

Допускается передача только одного из следующих параметров: "terminalID", "addressID", "address", "city"
addressIDНетinteger

ID адреса отправителя/получателя из адресной книги Личного кабинета (подробнее см. сервис "Адреса").

Заполняется в случае, если клиенту необходим расчёт для адреса, сохранённого в Личном Кабинете

Допускается передача только одного из следующих параметров: "terminalID", "addressID", "address", "city"
addressНетobject

Адрес

Допускается передача только одного из следующих параметров: "terminalID", "addressID", "address", "city"
address.streetДаstringКод КЛАДР улицы. Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР"
cityНетstring

Код КЛАДР города. Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР".

Используется только для параметра "request.arrival". Передача параметра возможна, только если заказана доставка до терминала (значение параметра "variant" - "terminal").Допускается передача только одного из следующих параметров: "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

Действие с сопроводительными документами.

Возможные значения:

  • "send" - отправка;
  • "return" - возврат
Возможна передача обоих значений с использованием отдельных параметров

Requester
Requester
ПараметрОбязательныйТипОписание
roleНетstring

Роль в перевозке.

Возможные значения:

  • "sender" - отправитель;
  • "receiver" - получатель;
  • "payer" - плательщик;
  • "third" - третье лицо
uidНетstring

UID контрагента из "Списка контрагентов".

Параметр игнорируется при отсутствии полного доступа к контрагентам

Insuarance
Insuarance
ПараметрОбязательныйТипОписание
statedValueДаfloat

Объявленная стоимость груза, руб.

Максимальная длина поля - 12 символов

termДаboolean

Признак страхования срока доставки груза.

Значение по умолчанию - "true"

Ответ метода

Пример ответа

{
   "metadata":{
      "status":200,
      "generated_at":"2019-11-25 08:16:47"
   },
   "data":{
      "derival":{
         "terminal":"Санкт-Петербург",
         "price":475,
         "servicePrice":475,
         "premiumDetails":[

         ],
         "terminals":[

         ],
         "handling":{
            "price":0,
            "premium":0,
            "discount":0,
            "premiumDetails":[

            ],
            "discountDetails":[

            ]
         }
      },
      "intercity":{
         "price":540,
         "premium":0,
         "discount":0,
         "premiumDetails":[

         ],
         "discountDetails":[

         ]
      },
      "small":{
         "price":540,
         "premium":0,
         "discount":0,
         "premiumDetails":[

         ],
         "discountDetails":[

         ]
      },
      "air":{
         "price":540,
         "premium":0,
         "discount":0,
         "premiumDetails":[

         ],
         "discountDetails":[

         ]
      },
      "express":{
         "price":540,
         "premium":0,
         "discount":0,
         "premiumDetails":[

         ],
         "discountDetails":[

         ]
      },
      "letter":{
         "price":540,
         "premium":0,
         "discount":0,
         "premiumDetails":[

         ],
         "discountDetails":[

         ]
      },
      "arrival":{
         "terminal":"Чита",
         "price":0,
         "premiumDetails":[
            {
               "name":"Экспедирование до клиента график доставки",
               "value":2000,
               "date":null,
               "announcement":false,
               "public":true
            }
         ],
         "terminals":[
            {
               "id":"104",
               "name":"Чита",
               "address":"Чита, Сухая Падь ул., 3",
               "streetCode":"7500000100008350000000000",
               "price":0,
               "default":true,
               "express":false,
               "isPVZ":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-28T00:00:00+03:00",
         "giveoutFromOspReceiverMax":"2019-11-29T00:00:00+03:00",
         "derrivalFromOspReceiver":null,
         "createTo":null,
         "derrivalToAddress":null,
         "derivalToAddressMax":null
      },
      "deliveryTerm":0,
      "accompanyingDocuments":{
         "send":{
            "price":200,
            "premium":0,
            "discount":0,
            "premiumDetails":[

            ],
            "discountDetails":[

            ]
         },
         "return":{
            "price":200,
            "premium":0,
            "discount":0,
            "premiumDetails":[

            ],
            "discountDetails":[

            ]
         }
      },
      "insurance":250,
      "insuranceComponents":{
         "cargoInsurance":200,
         "termInsurance":50
      },
      "notify":{
         "price":15,
         "premium":0,
         "discount":0,
         "premiumDetails":[

         ],
         "discountDetails":[

         ]
      },
      "simpleShippingAvailable":true,
      "availableDeliveryTypes": {
         "auto": 480.0,
         "small": 549.0,
         "avia": 4230.0,
         "express": 620.0,
         "letter": null
      }
   }
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2019-11-25 08:16:47</generated_at>
   </metadata>
   <data>
      <derival>
         <terminal>Санкт-Петербург</terminal>
         <price>475</price>
         <servicePrice>475</servicePrice>
         <handling>
            <price>0</price>
            <premium>0</premium>
            <discount>0</discount>
         </handling>
      </derival>
      <intercity>
         <price>540</price>
         <premium>0</premium>
         <discount>0</discount>
      </intercity>
      <small>
         <price>540</price>
         <premium>0</premium>
         <discount>0</discount>
      </small>
      <air>
         <price>540</price>
         <premium>0</premium>
         <discount>0</discount>
      </air>
      <express>
         <price>540</price>
         <premium>0</premium>
         <discount>0</discount>
      </express>
      <letter>
         <price>540</price>
         <premium>0</premium>
         <discount>0</discount>
      </letter>
      <arrival>
         <terminal>Чита</terminal>
         <price>0</price>
         <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>
            <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-28T00:00:00+03:00</giveoutFromOspReceiver>
         <giveoutFromOspReceiverMax>2019-11-29T00:00:00+03:00</giveoutFromOspReceiverMax>
         <derrivalFromOspReceiver />
         <createTo />
         <derrivalToAddress />
         <derivalToAddressMax />
      </orderDates>
      <deliveryTerm>0</deliveryTerm>
      <accompanyingDocuments>
         <send>
            <price>200</price>
            <premium>0</premium>
            <discount>0</discount>
         </send>
         <return>
            <price>200</price>
            <premium>0</premium>
            <discount>0</discount>
         </return>
      </accompanyingDocuments>
      <insurance>250</insurance>
      <insuranceComponents>
         <cargoInsurance>200</cargoInsurance>
         <termInsurance>50</termInsurance>
      </insuranceComponents>
      <notify>
         <price>15</price>
         <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>
   </data>
</response>

Описание параметров  

Response
Response
ПараметрТипОписание
metadataobjectСистемная информация
metadata.statusintegerЭмуляция http-кода состояния. В случае успешного выполнения возвращается код "200" (OK)
metadata.generated_atstring

Дата и время генерации ответа сервера.

Формат: "ГГГГ-ММ-ДД ЧЧ:ММ:СС"

dataobjectИнформация по стоимости и срокам перевозки груза
data.derivalDerivalArrivalДанные по доставке груза от отправителя
data.intercityCostsCalculation

Информация о стоимости автоперевозки

data.smallCostsCalculation

Информация о стоимости доставки малогабаритного груза

data.airCostsCalculationИнформация о стоимости авиаперевозки
data.expressCostsCalculationИнформация о стоимости экспресс-перевозки
data.letterCostsCalculationИнформация о стоимости услуги "Письмо"
data.arrivalDerivalArrivalДанные по доставке груза до получателя
data.pricestring

Итоговая стоимость для выбранного вида перевозки

Итоговая стоимость складывается из значений следующих параметров:
  1. Cтоимость выбранного вида межтерминальной перевозки ("data.intercity.price"/"data.small.price"/"data.air.price"/"data.express.price"/"data.letter.price").
  2. "data.derival.price" - стоимость доставки от отправителя.
  3. "data.arrival.price" - стоимость доставки до получателя.
  4. "data.insurance" - стоимость страхования груза.
  5. "data.packages.price" - стоимость упаковки, в ответе может присутствовать несколько таких параметров.
  6. "data.insurance.accompanyingDocuments.send.price" - стоимость отправки сопроводительных документов.
  7. "data.insurance.accompanyingDocuments.receive.price" - стоимость возврата сопроводительных документов.
  8. "data.notify.price" - стоимость услуги "Информация о статусе заказа"
data.priceMininalstring

Способ перевозки с минимальной стоимостью. Возможные значения:

  • "auto"- автоперевозка;
  • "express" - экспресс-доставка;
  • "small" - доставка малогабаритного груза;
  • "letter" - письмо;
  • "avia" - авиадоставка
data.packagesarray of CostsCalculation
Информация о стоимости упаковки
data.orderDatesOrderDatesГрафик движения груза
data.deliveryTermintegerСрок перевозки в днях
data.accompanyingDocumentsAcDocИнформация о стоимости отправки/возврата сопроводительных документов
data.insurancestringОбщая стоимость страхования груза
data.insuranceComponentsInsuranceComponentsОбщий список услуг по страхованию груза и их стоимость
data.notifyCostsCalculationИнформация о стоимости услуги "Информация о статусе заказа"
data.simpleShippingAvailableboolean

Информация о доступности услуги "упрощённая отправка"

data.availableDeliveryTypes

AvailableDeliveryTypesСписок доступных видов перевозки и их стоимость

DerivalArrival
DerivalArrival
ПараметрТипОписание
terminalstringГород подразделения-отправителя/подразделения-получателя
pricestring

Итоговая стоимость доставки от отправителя/до получателя

Если заказана доставка от терминала/до терминала, то есть в запросе для параметра "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", то итоговая стоимость складывается из значений следующих параметров:
  1. "response.derival.servicePrice"/"response.arrival.servicePrice" - стоимость услуги без учёта скидок и наценок.
  2. "response.derival.handling.price"/"response.arrival.handling.price" - стоимость погрузо-разгрузочных работ.
  3. Если заказана доставка от/до адреса, то также учитывается значение параметра "response.derival.premiumDetails.value"/"response.arrival.premiumDetails.value" - размер наценки (в ответе может присутствовать несколько таких параметров)
servicePricestring

Стоимость услуги доставки груза от адреса отправителя/до адреса получателя (без учёта скидок и наценок)

Параметр выводится только в том случае, если производится расчёт стоимости доставки непосредственно от/до адреса, то есть в запросе для параметра "request.delivery.derival.variant"/"request.delivery.arrival.variant" было передано значение "address" (в случае, если рассчитывается стоимость доставки от/до терминала, то есть было передано значение "terminal", параметр не выводится)
premiumDetailsarray of PricingDetailsПодробная информация о наценках по услуге
terminalsarray of TerminalsИнформация о терминалах, где может быть выдан/сдан груз
handlingCostsCalculationИнформация о стоимости погрузо-разгрузочных работ

CostsCalculation
CostsCalculation
ПараметрТипОписание
pricestringСтоимость услуги
premiumstringРазмер наценки по услуге
discountstring

Размер скидки по услуге

premiumDetailsarray of PricingDetailsПодробная информация о наценках по услуге
discountDetailsarray of PricingDetailsПодробная информация о скидках по услуге

AvailableDeliveryTypes
AvailableDeliveryType
ПараметрТипОписание

auto

float

Стоимость автодоставки

small

float

Стоимость доставки малогабаритного груза

avia

float

Стоимость авиадоставки 

express

float

Стоимость экспресс-доставки

letter

float

Стоимость доставки письма

Информация о стоимости услуги доступна, только если значение параметра запроса "delivery.deliveryType.type" - "letter". В остальных случаях информация недоступна, значение параметра - "null"

OrderDates
OrderDates
ПараметрТипОписание
pickupstringДата передачи груза на адресе отправителя
senderAddressTimestringВремя, до которого необходимо забрать груз на адресе отправителя
senderTerminalTimestringВремя, до которого необходимо передать груз на терминал отправителя
arivalToOspSenderstringДата прибытия на терминал-отправитель
derivalFromOspSenderstringДата отправки с терминала-отправителя
arivalToOspReceiverstringДата прибытия на терминал-получатель
arivalToAirportstringДата прибытия на терминал получателя/в аэропорт
arrivalToAirportMaxstringМаксимальная дата прибытия на терминал получателя/в аэропорт (в случае, если возможно увеличение срока прибытия)
giveoutFromOspReceiverstringДата и время, с которого груз готов к выдаче на терминале
giveoutFromOspReceiverMaxstringМаксимальная дата и время, с которого груз готов к выдаче на терминале (в случае, если возможно увеличение срока готовности)
derivalFromOspReceiverstringДата отправки с терминала-получателя
createTostringВремя, до которого необходимо подать заявку на доставку от адреса
derrivalToAddressstring

Дата и время, с которого возможна доставка до клиента

Параметр присутствует в ответе только при расчёте стоимости авиа или экспресс-перевозки (значение параметра запроса "delivery.deliveryType" - "avia" или "express")
derivalToAddressMaxstring

Максимальная дата и время, до которого возможна доставка до клиента

Параметр присутствует в ответе только при расчёте стоимости авиа или экспресс-перевозки (значение параметра запроса "delivery.deliveryType" - "avia" или "express")

AcDoc
AcDoc
ПараметрТипОписание
sendCostsCalculationИнформация о стоимости отправки сопроводительных документов
returnCostsCalculationИнформация о стоимости возврата сопроводительных документов

InsuranceComponents
InsuranceComponents
ПараметрТипОписание
cargoInsurancestringОбщая стоимость услуги "Страхование груза"
termInsurancestringОбщая стоимость услуги "Страхование срока доставки груза". Если стоимость не указана, значит, услуга недоступна для этого направления или груза

PricingDetails

PricingDetails

ПараметрТипОписание
namestringНаименование типа скидки/наценки. Например, "Наценка на негабарит" или "Открытая акция"
valuestring

Размер скидки/наценки в рублях

datestring

Срок действия.

Формат: "ГГГГ-ММ-ДД"

announcementboolean

Признак отношения к акциям.

Возможные значения:

  • "true" - скидка/наценка в рамках акции;
  • "false" (или отсутствие параметра в пакете) - скидка/наценка вне акции
publicboolean

Признак публичной скидки/наценки. Для авторизованного пользователя наценки могут быть как публичными, так и индивидуальными. Для неавторизованного - только публичными.

Возможные значения:

  • "true" - публичная скидка/наценка;
  • "false" (или отсутствие параметра в пакете) - индивидуальная скидка/наценка (доступно только для авторизованных пользователей)

Terminals

Terminals

ПараметрТипОписание
idstringID терминала из "Справочника терминалов"
namestringНаименование подразделения
addressstringАдрес терминала
streetCodestringКод КЛАДР улицы, см. "Cправочник улиц"
pricestringСтоимость въезда на территорию терминала
defaultbooleanПризнак того, что терминал является терминалом по умолчанию для выбранного города
expressbooleanПризнак того, что на терминале может быть оказана услуга "Экспресс-перевозка"
isPVZboolean

Информация о том, является ли терминал пунктом выдачи заказов (ПВЗ).

Возможные значения:

  • "true" - терминал является ПВЗ (то есть невозможна отправка грузов с терминала, а также выдача грузов массой более 10 кг и грузов, превышающих следующие размеры: ДШВ: 50x50x30 см);
  • "false" - терминал не является ПВЗ

Обработка ошибок

В методе используются общие ошибки API, описание формата и перечень ошибок см. в документе "Ошибки методов API".