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

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

Калькулятор услуги Доставка до адреса

Обновлено 08.08.2017
81 кб

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

Сервис позволяет рассчитать стоимость услуги "Доставка до адреса".

Калькулятор услуги Доставка до адреса

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

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

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

{  
   "arrivalHouse":4,
   "arrivalPoint":"6300000100007620000000000",
   "docSQLUid":"0xadad7d3e781543b540617f833c4f8737",
   "calculateDate":"2016-07-15",
   "arrivalPeriodVisit":{  
      "start":"09:00",
      "end":"18:00"
   },
   "arrivalFixedTimeVisit":true,
   "arrivalServices":[  
      "0xb83b7589658a3851440a853325d1bf69",
      "0x92fce2284f000b0241dad7c2e88b1655"
   ],
   "derivalLoading":[  
      {  
         "uid":"0xa77fcf6a449164ed490133777a68bd51"
      },
      {  
         "uid":"0xadf1fc002cb8a9954298677b22dbde12",
         "value":"4"
      },
      {  
         "uid":"0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74",
         "value":"58"
      }
   ],
   "arrivalUnLoading":[  
      {  
         "uid":"0xa77fcf6a449164ed490133777a68bd51"
      },
      {  
         "uid":"0xadf1fc002cb8a9954298677b22dbde12",
         "value":"4"
      },
      {  
         "uid":"0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74",
         "value":"58"
      }
   ],
   "sessionID":"00000000-0000-0000-000000000000",
   "requester":2
}

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

<request>
   <arrivalhouse>4</arrivalhouse>
   <arrivalpoint>6300000100007620000000000</arrivalpoint>
   <docsqluid>0xadad7d3e781543b540617f833c4f8737</docsqluid>
   <calculatedate>2016-07-15</calculatedate>
   <arrivalperiodvisit>
      <start>09:00</start>
      <end>18:00</end>
   </arrivalperiodvisit>
   <arrivalfixedtimevisit>true</arrivalfixedtimevisit>
   <arrivalservices>0xb83b7589658a3851440a853325d1bf69</arrivalservices>
   <arrivalservices>0x92fce2284f000b0241dad7c2e88b1655</arrivalservices>
   <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>
   <sessionid>00000000-0000-0000-000000000000</sessionid>
   <requester>2</requester>
</request>

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

Request
ПараметрR*ТипОписание
arrivalHouseНетintegerНомер дома
arrivalPointДаstring

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

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

docSQLUidДаstringUID накладной. Для получения идентификатора накладной необходимо воспользоваться методом "Журнал заказов"
calculateDateДаstringДата прибытия груза
arrivalPeriodVisitНетobjectПериод времени доставки груза
arrivalPeriodVisit.startДаstringНачало периода доставки груза
arrivalPeriodVisit.endДаstringОкончание периода доставки груза

arrivalFixedTimeVisit

Нетboolean

Фиксированное время доставки груза. Игнорируется, если период времени забора (параметр "arrivalPeriodVisit") больше 30 минут.

Значение по умолчанию: false. Параметр требует передачи в запросе arrivalPeriodVisit, иначе возникает ошибка: "Требуется передать параметр 'arrivalperiodvisit'".

arrivalServicesНетarray of stringUID дополнительных услуг для доставки груза до адреса. Заполняется на основании "Справочника услуг ПРР ". Пользователь может одновременно заказать несколько дополнительных услуг, но не все имеющиеся доп. услуги. Стоимость доп. услуг включается в стоимости доставки от/до адреса
derivalLoadingНетarray of Request.DerivalLoadingЗаказ погрузки ТС. Содержит дополнительные параметры, необходимые для расчета погрузо-разгрузочных работ
arrivalUnLoadingНетarray of Request.ArrivalUnLoadingЗаказ разгрузки ТС. Содержит дополнительные параметры, необходимые для расчета погрузо-разгрузочных работ
sessionIDНетstringID сессии, требуется для учета индивидуальных скидок. Для получения сессии необходимо воспользоваться методом "Авторизация пользователя"
requesterНетinteger

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

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

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

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

Ответ метода

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

{
   "derival": {
      "terminal": "Омск"
    },
   "arrival": {
      "terminal": "Санкт-Петербург",
      "price": "760.00"
    },
   "intercity": {
      "price": "1530.00"
    }
}
<response>
   <derival>
      <terminal>Омск</terminal>
   </derival>
   <arrival>
      <terminal>Санкт-Петербург</terminal>
      <price>760.00</price>
   </arrival>
   <intercity>
      <price>1530.00</price>
   </intercity>
</response>

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

Response
ПараметрТипОписание
derivalobjectДанные по доставке груза от адреса отправителя
derival.terminalstringГород подразделения-отправителя
arrivalobjectДанные по доставке груза до адреса получателя
arrival.terminalstringГород подразделения-получателя
arrival.pricestringСтоимость въезда на терминал
intercityobjectДанные межтерминальной перевозки
intercity.pricestringСтоимость межтерминальной перевозки