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

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

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

Обновлено 23.10.2017
160 кб

Общая информация 

Сервис позволяет осуществить следующие операции: 

  1. Рассчитать стоимость и сроки перевозки; 
  2. Рассчитать стоимость альтернативных вариантов перевозки груза и индивидуальных скидок клиента.

Расчет стоимости и сроков перевозки

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

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

Адрес метода: https://api.dellin.ru/v1/public/calculator.json 

{  
   "appkey":"00000000-0000-0000-000000000000",
   "derivalPoint":"7800000000000000000000000",
   "derivalDoor":true,
   "arrivalPoint":"5200000100000000000000000",
   "arrivalDoor":false,
   "sizedVolume":0.5,
   "sizedWeight":15.5,
   "oversizedVolume":0.8,
   "oversizedWeight":23.1,
   "length":0.5,
   "width":1.1,
   "height":0.9,
   "freight_uid":"0x9c2acaea110d75ba48fdc7a83c976269",
   "statedValue":1000.5,
   "packages": [
      "0x8783b183e825d40d4eb5c21ef63fbbfb",
      "0x951783203a254a05473c43733c20fe72"
   ],
   "derivalServices": [
      "0xb83b7589658a3851440a853325d1bf69",
      "0x92fce2284f000b0241dad7c2e88b1655"
   ],
   "arrivalServices": [
      "0xb83b7589658a3851440a853325d1bf69",
      "0x92fce2284f000b0241dad7c2e88b1655"
   ],
   "documentServices":[  
      "0xA11455A5C9BE0000477AB88A272A295B",
      "0xAD28BADA70021EBC41765FC1EC28AFE8"
   ],
   "derivalLoading":[  
      {  
         "uid":"0xa77fcf6a449164ed490133777a68bd51"
      },
      {  
         "uid":"0xadf1fc002cb8a9954298677b22dbde12",
         "value":"4"
      },
      {  
         "uid":"0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74",
         "value":"58"
      }
   ],
   "arrivalUnLoading":[  
      {  
         "uid":"0xa77fcf6a449164ed490133777a68bd51"
      },
      {  
         "uid":"0xadf1fc002cb8a9954298677b22dbde12",
         "value":"4"
      },
      {  
         "uid":"0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74",
         "value":"58"
      }
   ],
   "derivalfixedtimevisit":true,
   "derivalperiodvisit":{  
      "start":"10:00",
      "end":"20:30"
   },
   "arrivalfixedtimevisit":true,
   "arrivalperiodvisit":{  
      "start":"09:00",
      "end":"18:00"
   },
   "calculatedate":"2017-03-21",
   "sessionID": "00000000-0000-0000-000000000000",
   "cauid": "00000000-0000-0000-000000000000",
   "requester":2,
   "packages_count":3,
   "bags_count":3
}

Адрес метода: https://api.dellin.ru/v1/public/calculator.xml

<request>
   <appkey>Ваш ключ приложения</appkey>
   <sessionid>0000000-0000000-000000-00000-00000</sessionid>
   <derivalpoint>7800000000000000000000000</derivalpoint> 
   <derivaldoor>true</derivaldoor>
   <arrivalpoint>5200000100000000000000000</arrivalpoint> 
   <arrivaldoor>false</arrivaldoor>
   <sizedvolume>1</sizedvolume>
   <sizedweight>1</sizedweight>
   <oversizedvolume>1</oversizedvolume>
   <oversizedweight>1</oversizedweight>
   <length>1</length>
   <width>1</width>
   <height>1</height>
   <freight_uid>0x9c2acaea110d75ba48fdc7a83c976269</freight_uid>
   <statedvalue>1000</statedvalue>
   <packages>0xAD22189D098FB9B84EEC0043196370D6</packages>
   <derivalservices>0xb83b7589658a3851440a853325d1bf69</derivalservices>
   <derivalservices>0x92fce2284f000b0241dad7c2e88b1655</derivalservices>
   <arrivalservices>0xb83b7589658a3851440a853325d1bf69</arrivalservices>
   <arrivalservices>0x92fce2284f000b0241dad7c2e88b1655</arrivalservices>
   <documentServices>0xA11455A5C9BE0000477AB88A272A295B</documentServices>
   <documentServices>0xAD28BADA70021EBC41765FC1EC28AFE8</documentServices>
   <derivalloading> 
      <uid>0xa77fcf6a449164ed490133777a68bd51</uid>
   </derivalloading>
   <derivalloading>
      <uid>0xadf1fc002cb8a9954298677b22dbde12</uid>
      <value>4</value>
   </derivalloading>
   <derivalloading>
      <uid>0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74</uid>
      <value>58</value>
   </derivalloading>
     <arrivalunloading> 
      <uid>0xa77fcf6a449164ed490133777a68bd51</uid> 
   </arrivalunloading>
   <arrivalunloading>
      <uid>0xadf1fc002cb8a9954298677b22dbde12</uid> 
      <value>4</value>
   </arrivalunloading>
   <arrivalunloading>
      <uid>0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74</uid>
      <value>58</value>
   </arrivalunloading>
   <derivalfixedtimevisit>true</derivalfixedtimevisit>
   <derivalperiodvisit>
      <start>10:00</start>
      <end>20:30</end>
   </derivalperiodvisit>
   <arrivalfixedtimevisit>true</arrivalfixedtimevisit>
   <arrivalperiodvisit>
      <start>09:00</start>
      <end>18:00</end>
   </arrivalperiodvisit>
   <calculatedate>2017-03-21</calculatedate>
 <requester>2</requester>  
   <packages_count>3</packages_count>
   <bags_count>3</bags_count>
</request>

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

Request
ПараметрR*ТипОписание
Основные параметры
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
derivalPointДаstring

Код КЛАДР пункта отправки груза/пункта прибытия груза. Заполняется на основании данных справочника "КЛАДР". Формат кода - беззнаковое целое число длиной 25 символов. Если код региона начинается с нуля, тогда длина кода будет равна 24 символам (в API не используется ведущий ноль). Если код региона меньше 25 символов, необходимо справа дополнить его нужным количеством нулей.

Определить код КЛАДР нужного населенного пункта можно с помощью нашего сервиса. Также можно получить таблицу с кодами КЛАДР в формате, полностью совместимом с API Деловых линий, обратившись к "Справочнику населенных пунктов"

arrivalPointДаstring
derivalDoorНетbooleanНеобходима доставка груза от адреса. Если значение параметра равно "false", тогда доп. услуги доставки от/до адреса ("derivalServices"/"arrivalServices") не будут включены в расчет, даже если они указаны в запросе
arrivalDoorНетbooleanНеобходима доставка груза до адреса. Если значение параметра равно "false", тогда доп. услуги доставки от/до адреса ("derivalServices"/"arrivalServices") не будут включены в расчет, даже если они указаны в запросе   
Данные по грузу
sizedVolumeДаfloatОбщий объём груза, м3
sizedWeightДаfloatОбщий вес груза, кг
oversizedVolumeНетfloatОбъём негабаритной части груза, м3 
oversizedWeightНетfloatВес негабаритной части груза, кг
lengthНетfloatДлина самого длинного из мест
widthНетfloatШирина самого широкого из мест
heightНетfloatВысота самого высокого из мест
freight_uidНетstringUID характера груза из справочника "Характер груза" 1С:ГП
statedValueНетfloat

Заявленная стоимость груза в рублях.

Доступные значения:

  • 0 - груз страхуется без объявленной стоимости
  • больше 0 - груз страхуется на указанную сумму
    При отсутствии этого параметра в запросе, груз также страхуется без объявленной стоимости
packages
Нетarray of string

ID вида упаковки, в которую нужно упаковать груз. Заполняется на основании "Справочника доступных упаковок". Пользователь может одновременно заказать несколько видов упаковок

Дополнительные услуги
derivalServicesНетarray of string

UID дополнительных услуг для доставки груза от адреса. Заполняется на основании "Справочника доп. услуг для заявки". Пользователь может одновременно заказать несколько дополнительных услуг, но не все имеющиеся доп. услуги одновременно. Стоимость доп. услуг включается в стоимости доставки от/до адреса

arrivalServicesНетarray of stringUID дополнительных услуг для доставки груза до адреса. Заполняется на основании "Справочника доп. услуг для заявки ". Пользователь может одновременно заказать несколько дополнительных услуг, но не все имеющиеся доп. услуги одновременно. Стоимость доп. услуг включается в стоимости доставки от/до адреса
documentServicesНетarray of stringПередача сопроводительных документов. В параметре могут быть переданы 2 стандартных значения - UID документов на отправку и документов на возврат
derivalLoadingНетarray of Request.DerivalLoadingЗаказ погрузки ТС. Содержит дополнительные параметры, необходимые для расчета погрузочно-разгрузочных работ.
arrivalUnLoadingНетarray of Request.ArrivalUnLoadingЗаказ разгрузки ТС. Содержит дополнительные параметры, необходимые для расчета погрузочно-разгрузочных работ.
quantityНетintegerКоличество грузовых мест. По умолчанию = 1
derivalFixedTimeVisitНетbooleanФиксированное время забора груза. Игнорируется, если период времени забора (параметр "derivalPeriodVisit") больше 30 минут
derivalPeriodVisitНетobjectПериод времени забора груза
derivalPeriodVisit.startНетstringНачало периода забора груза
derivalPeriodVisit.endНетstringОкончание периода забора груза
arrivalFixedTimeVisitНетbooleanФиксированное время доставки груза. Игнорируется, если период времени забора (параметр "arrivalPeriodVisit") больше 30 минут
arrivalPeriodVisitНетobjectПериод времени доставки груза
arrivalPeriodVisit.startНетstringНачало периода доставки груза
arrivalPeriodVisit.endНетstringОкончание периода доставки груза
calculateDateНетstringДата, для которой будет осуществлен расчет
sessionIDНетstringID сессии. Если требуется произвести расчет с учетом индивидуальных скидок контрагента (при их наличии), требуется передать этот параметр. Для получения сессии необходимо воспользоваться методом "Авторизация пользователя".
cauidНетstringUID контрагента, скидки которого требуется применить к расчетам. Если не передан, то расчет идёт для контрагента по умолчанию (подробнее в методе "Получение списка контрагентов")
requesterНетinteger

Роль контрагента-заказчика перевозки.

Доступные значения:

  • "1" = отправитель
  • "2" = получатель
  • "3" = плательщик или третье лицо, если в учетной записи ЛК нет контрагентов с полным доступом

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

packages_countНетintegerКоличество необходимых коробок. По умолчанию = 1. Параметр необходимо передавать только в том случае, если в параметре "packages" указан ID вида упаковки "коробка"
bag_countНетintegerКоличество необходимых мешков. По умолчанию = 1. Параметр необходимо передавать только в том случае, если в параметре "packages" указан ID этого вида упаковки "мешок"

Request.DerivalLoading
ПараметрR*ТипОписание
uidНетstringУникальные идентификаторы дополнительных параметров, необходимых для расчета погрузочно-разгрузочных работ. Список параметров заполняется на основании "Справочника услуг ПРР". Если дополнительные параметры не будут переданы в запросе, погрузочно-разгрузочные работы будут заказаны, но их стоимость будет рассчитана неточно
valueНетstringЗначение доп. параметра, если оно необходимо. К примеру, доп. параметр = "этаж", значение = "4"
Параметр "ArrivalUnLoading" содержит те же дополнительные параметры, что и "DerivalLoading". 

Ответ метода

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

{  
   "derival":{  
      "terminal":"Санкт-Петербург",
      "price":"2150.00",
      "terminals":[  
         {  
            "id":"36",
            "address":"193231, Санкт-Петербург г, Латышских Стрелков ул, дом № 31",
            "price":"100",
            "name":"Санкт-Петербург-Восток"
         },
         {  
            "id":"38",
            "address":"194292, Санкт-Петербург г, 2-й Верхний пер, дом № 13 А",
            "price":"100",
            "name":"Санкт-Петербург-Парнас"
         }
      ],
      "terminals_express":[  
         {  
            "price":100,
            "address":"117403, Москва г, Лобненская ул, дом № 18",
            "id":36,
            "name":"Москва Север"
         }
      ]
   },
   "intercity":{  
      "price":"3062.5",
      "premium":"50.00",
      "discount":"10.00",
      "premiumDetails":[  
         {  
            "name":"Наценка 1",
            "value":"50.00",
            "date":"2016-01-01",
            "announcement":"true",
            "public":"true"
         }
      ],
      "discountDetails":[  
         {  
            "name":"Скидка 1",
            "value":"50.00",
            "date":"2016-01-01",
            "announcement":"true",
            "public":"true"
         }
      ],
      "insurance":"350.00",
      "insurance_components":{  
         "cargo_insurance":"50.00",
         "term_insurance":"35.00"
      },
      "notify":{  
         "price":"10.00"
      }
   },
   "small":{  
      "price":"1750.00",
      "premium":"50.00",
      "discount":"10.00",
      "premiumDetails":[  
         {  
            "name":"Наценка 1",
            "value":"50.00",
            "date":"2016-01-01",
            "announcement":"true",
            "public":"true"
         }
      ],
      "discountDetails":[  
         {  
            "name":"Скидка 1",
            "value":"50.00",
            "date":"2016-01-01",
            "announcement":"true",
            "public":"true"
         }
      ],
      "insurance":"350.00",
      "insurance_components":{  
         "cargo_insurance":"50.00",
         "term_insurance":"35.00"
      },
      "notify":{  
         "price":"10.00"
      }
   },
   "air":{  
      "premium":"0.00",
      "premiumDetails":[  

      ],
      "discountDetails":[  

      ],
      "price":"2680.00",
      "discount":"0.00",
      "insurance_components":{  
         "cargo_insurance":"8500.00"
      },
      "notify":{  
         "price":"10.00"
      },
      "insurance":"8500.00"
   },
   "express":{  
      "premium":"0.00",
      "premiumDetails":[  
       {  
         "name":"Наценка 1",
         "value":"50.00",
         "date":"2016-01-01",
         "announcement":"true",
         "public":"true"
       }
      ],
      "discountDetails":[  

      ],
      "price":"670.00",
      "discount":"0.00",
      "insurance_components":{  
         "cargo_insurance":"8500.00"
      },
      "notify":{  
         "price":"10.00"
      },
      "time":{  
         "genitive":"1 дня",
         "nominative":"1 день",
         "value":"1"
      },
      "insurance":"8500.00"
   },
   "arrival":{  
      "terminal":"Москва",
      "price":"15.00",
      "terminals":[  
         {  
            "id":"36",
            "price":"100"
         }
      ],
      "terminals_express":[  
         {  
            "price":100,
            "address":"117403, Москва г, Лобненская ул, дом № 18",
            "id":36,
            "name":"Москва Север"
         }
      ]
   },
   "letter":{  
      "price":"300.00"
   },
   "price":"13657.5",
   "time":{  
      "genitive":"3 дней",
      "nominative":"3 дня",
      "value":"3"
   },
   "loadUnload":{  
      "derival":"3510.00",
      "arrival":"4500.00"
   },
   "packages":{  
      "bag":"70.00",
      "premium":"50.00",
      "discount":"10.00",
      "premiumDetails":[  
         {  
            "name":"Наценка 1",
            "value":"50.00",
            "date":"2016-01-01",
            "announcement":"true",
            "public":"true"
         }
      ],
      "discountDetails":[  
         {  
            "name":"Скидка 1",
            "value":"50.00",
            "date":"2016-01-01",
            "announcement":"true",
            "public":"true"
         }
      ],
   },
   "order_dates":{  
      "pickup":"2016-05-01",
      "arrival_to_osp_receiver":"2016-05-01",
      "derrival_from_osp_receiver":"2016-05-01",
      "arrival_to_osp_sender":"2016-05-01",
      "derrival_from_osp_sender":"2016-05-01"
   },
   "delivery_term":1,
   "shipping_documents":{  
      "send":"150",
      "return":"150"
   },
   "insurance":"350.0",
   "insurance_components":{  
      "cargo_insurance":"50.00",
      "term_insurance":"300.00"
   }
}
<response>
   <derival>
      <terminal>Санкт-Петербург</terminal>
      <price>2150.0</price>
      <terminals>
         <id>36</id>
         <address>193231, Санкт-Петербург г, Латышских Стрелков ул, дом № 31</address>
         <price>100</price>
         <name>Санкт-Петербург-Восток</name>
      </terminals>
      <terminals>
         <id>38</id>
         <address>194292, Санкт-Петербург г, 2-й Верхний пер, дом № 13 А</address>
         <price>100</price>
         <name>Санкт-Петербург-Парнас</name>
      </terminals>
      <terminals_express>
         <price>100</price>
         <address>117403, Москва г, Лобненская ул, дом № 18</address>
         <id>36</id>
         <name>Москва Север</name>
      </terminals_express>
   </derival>
   <intercity>
      <price>3062.5</price>
      <premium>50.00</premium>
      <discount>10.00</discount>
      <premiumDetails>
         <name>Наценка 1</name>
         <value>50.00</value>
         <date>2016-01-01</date>
         <announcement>true</announcement>
         <public>true</public>
      </premiumDetails>
      <discountDetails>
         <name>Скидка 1</name>
         <value>50.00</value>
         <date>2016-01-01</date>
         <announcement>true</announcement>
         <public>true</public>
      </discountDetails>
      <insurance>350.00</insurance>
      <insurance_components>
         <cargo_insurance>50.00</cargo_insurance>
         <term_insurance>35.00</term_insurance>
      </insurance_components>
      <notify>
         <price>10.00</price>
      </notify>
   </intercity>
     <small>
      <price>1750.00</price>
      <premium>50.00</premium>
      <discount>10.00</discount>
      <premiumDetails>
         <name>Наценка 1</name>
         <value>50.00</value>
         <date>2016-01-01</date>
         <announcement>true</announcement>
         <public>true</public>
      </premiumDetails>
      <discountDetails>
         <name>Скидка 1</name>
         <value>50.00</value>
         <date>2016-01-01</date>
         <announcement>true</announcement>
         <public>true</public>
      </discountDetails>
      <insurance>350.00</insurance>
      <insurance_components>
         <cargo_insurance>50.00</cargo_insurance>
         <term_insurance>35.00</term_insurance>
      </insurance_components>
      <notify>
         <price>10.00</price>
      </notify>
   </small>      
   <arrival>
      <terminal>Москва</terminal>
      <price>15.0</price>
      <terminals>
         <id>36</id>
         <price>100</price>
      </terminals>
      <terminals_express>
         <price>100</price>
         <address>117403, Москва г, Лобненская ул, дом № 18</address>
         <id>36</id>
         <name>Москва Север</name>
      </terminals_express>
   </arrival>
   <letter>
      <price>300.00</price>
   </letter>
   <price>13657.5</price>
   <insurance>350.0</insurance>
   <time>
      <genitive>3 дней</genitive>
      <nominative>3 дня</nominative>
      <value>3</value>
   </time>
   <loadunload>
      <derival>3510.00</derival>
      <arrival>4500.00</arrival>
   </loadunload>
   <packages>
      <bag>70.00</bag>
      <premium>50.00</premium>
      <discount>10.00</discount>
      <premiumDetails>
         <name>Наценка 1</name>
         <value>50.00</value>
         <date>2016-01-01</date>
         <announcement>true</announcement>
         <public>true</public>
      </premiumDetails>
      <discountDetails>
         <name>Скидка 1</name>
         <value>50.00</value>
         <date>2016-01-01</date>
         <announcement>true</announcement>
         <public>true</public>
      </discountDetails>
      <insurance>350.00</insurance>
      <insurance_components>
         <cargo_insurance>50.00</cargo_insurance>
         <term_insurance>35.00</term_insurance>
      </insurance_components>
      <notify>
         <price>10.00</price>
      </notify>
   </packages>
   <order_dates>
      <pickup>2016-05-01</pickup>
      <arrival_to_osp_receiver>2016-05-01</arrival_to_osp_receiver>
      <derrival_from_osp_receiver>2016-05-01</derrival_from_osp_receiver>
      <arrival_to_osp_sender>2016-05-01</arrival_to_osp_sender>
      <derrival_from_osp_sender>2016-05-01</derrival_from_osp_sender>
   </order_dates>
   <delivery_term>1</delivery_term>
   <shipping_documents>
      <send>150</send>
      <return>150</return>
   </shipping_documents>
   <insurance_components>
      <cargo_insurance>50.00</cargo_insurance>
      <term_insurance>300.00</term_insurance>
   </insurance_components> 
</response>

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

Response
ПараметрТипОписание
derivalResponse.DerivalДанные по доставке груза от адреса отправителя
intercityResponse.IntercityДанные межтерминальной перевозки
smallResponse.SmallДанные по доставке груза с помощью доп. услуги "Доставка малогабаритного груза"
airResponse.AirДанные по авиадоставке груза
expressResponse.ExpressДанные по экспресс-доставке груза
arrivalResponse.ArrivalДанные по доставке груза до адреса получателя
letterobject

Данные по услуге "Письмо". Параметр присутствует в ответе, если одновременно соблюдены следующие условия:

  • "volume" <= 0.01
  • "weight" <= 0.5
  • "length" <= 0.3
  • "width" <= 0.21
  • "height" <= 0.01
  • "quantity" = 1
letter.pricestringСтоимость услуги "Письмо"
pricestringОбщая стоимость перевозки с учетом всех услуг для межтерминальной перевозки. Если межтерминальная перевозка недоступна на данном направлении, расчет производится для авиаперевозки.
timeobjectМинимально возможный срок доставки в днях (срок доставки возвращается для доставки между терминалами услугой автотранспортной перевозки, для всех остальных вариантов перевозки, этот срок может отличаться)
time.genitivestringСрок доставки груза в родительном падеже
time.nominativestringСрок доставки груза в именительном падеже
time.valuestringСрок доставки груза. Числовое значение
loadUnloadobjectСтоимость дополнительных услуг, если они были заказаны
loadUnload.derivalstringСтоимость дополнительных услуг при доставке груза от адреса
loadUnload.arrivalstringСтоимость дополнительных услуг при доставке груза до адреса
packagesResponse.PackagesДанные по стоимости упаковки груза
order_datesobjectГрафик движения груза
order_dates.pickupstringДата забора груза
order_dates.arrival_to_osp_receiverstringДата прибытия в ОСП-получатель
order_dates.derrival_from_osp_receiverstringДата отправки из ОСП-получателя
order_dates.arrival_to_osp_senderstringДата прибытия в ОСП-отправитель
order_dates.derrival_from_osp_senderstringДата отправки из ОСП-отправителя
delivery_termintegerСрок доставки груза
shipping_documentsobjectДоставка сопроводительных документов
shipping_documents.sendstringКоличество сопроводительных документов на отправку
shipping_documents.returnstringКоличество сопроводительных документов на возврат
insurancestringОбщая стоимость страхования груза
insurance_componentsobjectОбщий список услуг по страхованию груза и их стоимость
insurance_components.cargo_insurancestringОбщая стоимость услуги "Страхование груза"
insurance_components.term_insurancestringОбщая стоимость услуги "Страхование срока доставки груза". Если стоимость не указана, значит, услуга недоступна для этого направления или груза

Response.Derival
ПараметрТипОписание
terminalstringГород подразделения-отправителя
pricestringСтоимость доставки груза с учетом заказанных дополнительных услуг
terminalsarray of Response.Derival.Terminals

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

Если в запросе "derivalDoor" = "false" и "arrivalDoor" = "false", то список будет содержать информацию только о тех складах, которые имеют возможность принять груз указанного веса, объема и габаритов (условие не применяется для коммерческой почты).

terminals_expressarray of Response.Derival.Terminals_expressСписок складов, принимающих грузы к экспресс-перевозке. Содержится в ответе, если услуга "Экспресс-перевозка" может быть оказана

Response.Derival.Terminals
ПараметрТипОписание
idstringID терминала из "Справочника терминалов"
addressstringАдрес терминала
pricestringСтоимость въезда на территорию терминала
namestringНаименование склада

Response.Derival.Terminals_express
ПараметрТипОписание
pricefloatСтоимость въезда на территорию терминала
addressstringАдрес терминала
idintegerID терминала из "Справочника терминалов"
namestringНаименование склада

Response.Intercity
ПараметрТипОписание
pricestringСтоимость межтерминальной перевозки
premiumstringРазмер наценки по услуге
discountstringРазмер скидки по услуге
premiumDetailsarray of Response.PremiumDetailsПодробная информация о наценках по услуге
discountDetailsarray of Response.DiscountDetailsПодробная информация о скидках по услуге
insurancestringСтоимость страхования груза в межтерминальной перевозке (сумма стоимостей всех услуг)
insurance_componentsobject

Перечень услуг страхования и их стоимость

insurance_components.Cargo_insurancestringСтоимость услуги "Страхование груза" в межтерминальной перевозке
insurance_components.Term_insurancestringСтоимость услуги "Страхование срока доставки груза" в межтерминальной перевозке. Если стоимость не указана, значит, услуга недоступна для этого направления или груза
notifyobjectДанные об услуге SMS-уведомление
notify.pricestringСтоимость услуги SMS-уведомление

Response.PremiumDetails
ПараметрТипОписание
namestringНаименование типа наценки. Например, "Наценка на негабарит", "Наценка на упаковку"
valuestringРазмер наценки
datestringДата действия наценки
announcementstring

Признак наценки, осуществленной по акции:

  • "true" = наценка осуществлена по акции;
  • "false" = наценка осуществлена не по акции
publicstring

Признак публичной наценки для всех пользователей:

  • "true" = наценка является публичной
  • "false" = наценка является индивидуальной

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

Response.DiscountDetails
ПараметрТипОписание
namestringНаименование типа скидки. Например, "Открытая акция"
valuestringРазмер скидки
datestringДата действия скидки
announcementstring

Признак скидки, предоставленной по акции:

  • "true" = скидка предоставлена по акции;
  • "false" = скидка предоставлена не по акции
publicstring

Признак публичной скидки для всех пользователей:

  • "true" = скидка является публичной
  • "false" =скидка является индивидуальной

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

Объекты "Response.Small", "Response.Air" и "Response.Express" имеют такую же структуру и те же вложенные параметры, что и параметр "intercity".

Response.Arrival
ПараметрТипОписание
terminalstringГород подразделения-получателя
pricestringСтоимость въезда на терминал. Если в запросе был передан параметр "arrivaldoor" = "false", тогда рассчитывается стоимость въезда на терминал. Если параметр = "true", тогда рассчитывается доставка груза от/до дверей
terminalsarray of Response.Arrival.Terminals

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

Если в запросе "derivalDoor" = "false" и "arrivalDoor" = "false", то список будет содержать информацию только о тех складах, которые имеют возможность принимать грузы указанного веса, объема и габаритов

terminals_expressarray of Response.Arrival.Terminals_expressСписок складов, осуществляющих выдачу грузов по экспресс-перевозке. Содержится в ответе, если услуга "Экспресс-перевозка" может быть оказана

Response.Arrival.Terminals
ПараметрТипОписание
idstringID терминала из "Справочника терминалов"
pricestringСтоимость въезда на территорию терминала

Response.Arrival.Terminals_express
ПараметрТипОписание
pricefloatСтоимость въезда на территорию терминала
addressstringАдрес терминала
idintegerID терминала из "Справочника терминалов"
namestringНаименование склада

Response.Packages
ПараметрТипОписание
bagstringСтоимость выбранного вида упаковки груза
premiumstringРазмер наценки по услуге
discountstringРазмер скидки по услуге
premiumDetailsarray of Response.PremiumDetailsПодробная информация о наценках по услуге
discountDetailsarray of Response.DiscountDetailsПодробная информация о скидках по услуге

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

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

{  
   "errors":{  
      "messages":[  
         "Доставка от адреса отправителя невозможна. Проверьте адрес отправителя.",
         "Доставка до адреса получателя невозможна. Проверьте адрес получателя.",
         "Параметры груза превышают допустимые для забора груза в подразделении-отправителе. Проверьте параметры груза.",
         "Параметры груза превышают допустимые для доставки груза в подразделении-получателе. Проверьте параметры груза.",
         "Для расчета стоимости перевозки груза объемом более 80 кубических метров или весом более 20 тонн необходимо обратиться к нашему специалисту."
      ]
   }
}
<errors>
   <messages>Доставка от адреса отправителя невозможна. Проверьте адрес отправителя.</messages>
   <messages>Доставка до адреса получателя невозможна. Проверьте адрес получателя.</messages>
   <messages>Параметры груза превышают допустимые для забора груза в подразделении-отправителе. Проверьте параметры груза.</messages>
   <messages>Параметры груза превышают допустимые для доставки груза в подразделении-получателе. Проверьте параметры груза.</messages>
   <messages>Для расчета стоимости перевозки груза объемом более 80 кубических метров или весом более 20 тонн необходимо обратиться к нашему специалисту.</messages>
</errors>

Если в запросе есть ошибка, в ответе вернутся те поля, в которых была допущена ошибка и которые не прошли валидацию. 

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

{  
   "errors":{  
      "derivalDoor":"Доступные значения: true или false",
      "sizedWeight":"\"пять\" не является числом",
      "arrivalPoint":"Код КЛАДР/Почтовый индекс не найден",
      "arrivalDoor":"Доступные значения: true или false",
      "statedValue":"\"два\" не является числом",
      "sizedVolume":"\"три\" не является числом",
      "oversizedVolume":"\"четыре\" не является числом",
      "packages":{  
         "error":"Неверный uid упаковки 111222333"
      },
      "oversizedWeight":"\"восемь\" не является числом",
      "derivalPoint":"Код КЛАДР/Почтовый индекс не найден",
      "derivalServices":"Неверный uid дополнительной услуги 333222111",
      "arrivalServices":"Неверный uid дополнительной услуги 333222111"
   }
}
<errors>
   <derivaldoor>Доступные значения: true или false</derivaldoor>
   <sizedweight>"пять" не является числом</sizedweight>
   <arrivalpoint>Код КЛАДР/Почтовый индекс не найден</arrivalpoint>
   <arrivaldoor>Доступные значения: true или false</arrivaldoor>
   <statedvalue>"два" не является числом</statedvalue>
   <sizedvolume>"три" не является числом</sizedvolume>
   <oversizedvolume>"четыре" не является числом</oversizedvolume>
   <packages>
      <error>Неверный uid упаковки "111222333"</error>
   </packages>
   <oversizedweight>"восемь" не является числом</oversizedweight>
   <derivalpoint>Код КЛАДР/Почтовый индекс не найден</derivalpoint>
   <derivalservices>Неверный uid дополнительной услуги "333222111"</derivalservices>
   <arrivalservices>Неверный uid дополнительной услуги "333222111"</arrivalservices>
</errors>

Если в запросе "derivalDoor" = "false" и "arrivalDoor" = "false", и ни один склад выбранного города не имеет возможности принимать грузы указанного веса, объема и габаритов, то будет выведена следующая ошибка:

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

{  
   "errors":{  
      "messages":[  
         "Весогабаритные характеристики груза превышают допустимые для приёма на терминалах города <название города>."
      ]
   }
}
<errors>
   <messages>Весогабаритные характеристики груза превышают допустимые для приёма на терминалах города <название города>.</messages>
</errors>