Калькулятор услуги Доставка до адреса
Общие сведения
Сервис позволяет рассчитать стоимость услуги "Доставка до адреса" для активной перевозки.
Калькулятор услуги доставка до адреса
Запрос метода
Структура запроса
Адрес метода: https://api.dellin.ru/v1/public/calculator_sf.json
{ "appkey":"00000000-0000-0000-0000-000000000000", "sessionID":"00000000-0000-0000-0000-000000000000", "arrivalHouse":4, "arrivalPoint":"7700000000000000000000000", "docSQLUid":"0xb4960050569468bb11e7aa87cebf3d88", "calculateDate":"2017-10-15", "arrivalPeriodVisit":{ "start":"09:00", "end":"18:00" }, "arrivalServices":[ "0xb83b7589658a3851440a853325d1bf69" ], "arrivalFixedTimeVisit":true, "arrivalUnLoading":[ { "uid":"0xa77fcf6a449164ed490133777a68bd51" }, { "uid":"0xadf1fc002cb8a9954298677b22dbde12", "value":"4" }, { "uid":"0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74", "value":"58" } ], "promocode":"promo123", "requester":1 }
Адрес метода: https://api.dellin.ru/v1/public/calculator_sf.xml
<request> <appkey>00000000-0000-0000-0000-000000000000</appkey> <sessionid>00000000-0000-0000-0000-000000000000</sessionid> <arrivalHouse>4</arrivalHouse> <arrivalPoint>7700000000000000000000000</arrivalPoint> <docSQLUid>0xb4960050569468bb11e7aa87cebf3d88</docSQLUid> <calculateDate>2017-10-15</calculateDate> <arrivalPeriodVisit> <start>09:00</start> <end>18:00</end> </arrivalPeriodVisit> <arrivalServices>0xb83b7589658a3851440a853325d1bf69</arrivalServices> <arrivalFixedTimeVisit>true</arrivalFixedTimeVisit> <arrivalUnLoading> <uid>0xa77fcf6a449164ed490133777a68bd51</uid> </arrivalUnLoading> <arrivalUnLoading> <uid>0xadf1fc002cb8a9954298677b22dbde12</uid> <value>4</value> </arrivalUnLoading> <arrivalUnLoading> <uid>0x9a0d647ddb11ebbd4ddaaf3b1d9f7b74</uid> <value>58</value> </arrivalUnLoading> <promocode>promo123</promocode> <requester>1</requester> </request>
Описание параметров
Request | |||
---|---|---|---|
Параметр | R* | Тип | Описание |
appkey | Да | string | Ключ приложения. Для получения ключа необходимо пройти регистрацию |
sessionID | Нет | string | ID сессии, требуется для учета индивидуальных скидок. Для получения сессии необходимо воспользоваться методом "Авторизация пользователя" |
arrivalHouse | Нет | integer | Номер дома |
arrivalPoint | Да | string | Код КЛАДР пункта прибытия груза. Может быть указан код КЛАДР города или улицы. Код КЛАДР может быть получен с помощью сервисов, представленных на странице "Поиск КЛАДР" |
docSQLUid | Да | string | UID накладной. Для получения идентификатора накладной необходимо воспользоваться методом "Журнал заказов" |
calculateDate | Нет | string | Дата прибытия груза. Если параметр не передан, то используется текущая дата |
arrivalPeriodVisit | Нет | object | Период времени доставки груза |
arrivalPeriodVisit.start | Да | string | Начало периода доставки груза |
arrivalPeriodVisit.end | Да | string | Окончание периода доставки груза |
arrivalServices | Нет | array of string | UID дополнительных услуг для доставки груза до адреса. Заполняется на основании "Справочника услуг ПРР". Пользователь может одновременно заказать несколько дополнительных услуг, но не все имеющиеся доп. услуги. Стоимость доп. услуг включается в стоимости доставки от/до адреса |
arrivalFixedTimeVisit | Нет | boolean | Фиксированное время доставки груза. Если передано значение "true", то значение параметра "arrivalPeriodVisit.end" игнорируется, вместо него используется значение ("arrivalPeriodVisit.start" + 30 минут). Значение по умолчанию: "false". Параметр требует передачи в запросе arrivalPeriodVisit, иначе возникает ошибка: "Требуется передать параметр 'arrivalperiodvisit'". |
arrivalUnLoading | Нет | array of Request.ArrivalUnLoading | Заказ разгрузки ТС. Содержит дополнительные параметры, необходимые для расчета погрузо-разгрузочных работ |
promocode | Нет | string | Промокод |
Request.ArrivalUnLoading | |||
Параметр | R* | Тип | Описание |
uid | Нет | string | Уникальные идентификаторы дополнительных параметров, необходимых для расчета погрузо-разгрузочных работ. Список параметров заполняется на основании "Справочника услуг ПРР". Если дополнительные параметры не будут переданы в запросе, погрузо-разгрузочные работы будут заказаны, но их стоимость будет рассчитана неточно |
value | Нет | string | Значение доп. параметра, если оно необходимо. К примеру, доп. параметр = "этаж", значение = "4" |
Ответ метода
Структура ответа
{ "redirect":false, "derival":{ "terminal":"Москва" }, "arrival":{ "premium":"0.00", "premiumDetails":[ { "date":null, "announcement":false, "name":"Боковая загрузка (получатель)", "value":"1650.00", "public":true }, { "date":null, "announcement":false, "name":"Экспедирование до клиента (фиксированное время)", "value":"490.00", "public":true } ], "discountDetails":[ { "name":"Боковая загрузка (получатель)", "value":"50", "date":"2016-01-01", "announcement":"true", "public":"true", "triggers":[ { "key":"promocode" } ] }, { "name":"Экспедирование до клиента (фиксированное время)", "value":"100", "date":"2016-01-01", "announcement":"true", "public":"false" } ], "price":"2410.00", "terminal":"Москва", "discount":"150.00" }, "loadunload":{ "arrival":"1200.00", "discount":"0.00", "premium":"0.00", "premiumDetails":[], "discountDetails":[] }, "information":[ "Срок действия промокода истек" ] }
<response> <redirect>false</redirect> <derival> <terminal>Москва</terminal> </derival> <arrival> <premium>0.00</premium> <premiumDetails> <date /> <announcement>false</announcement> <name>Боковая загрузка (получатель)</name> <value>1650.00</value> <public>true</public> </premiumDetails> <premiumDetails> <date /> <announcement>false</announcement> <name>Экспедирование до клиента (фиксированное время)</name> <value>490.00</value> <public>true</public> </premiumDetails> <discountDetails> <name>Скидка 1</name> <value>50</value> <date>2016-01-01</date> <announcement>true</announcement> <public>true</public> <triggers> <key>promocode</key> </triggers> </discountDetails> <discountDetails> <name>Скидка 2</name> <value>100</value> <date>2016-01-01</date> <announcement>true</announcement> <public>false</public> </discountDetails> <price>2410.00</price> <terminal>Москва</terminal> <discount>0.00</discount> </arrival> <loadunload> <arrival>1200.00</arrival> <discount>0.00</discount> <premium>0.00</premium> </loadunload> <information>Срок действия промокода истек</information> </response>
Описание параметров
Response | ||
---|---|---|
Параметр | Тип | Описание |
redirect | boolean | Признак перенаправления груза |
derival | object | Данные о терминале отправления |
derival.terminal | string | Город, в котором расположен терминал, до которого изначально была заказана доставка, и с которого рассчитывается доставка до адреса |
arrival | object | Информация о стоимости доставки груза до адреса получателя с учетом стоимости услуг, наценок и скидок на услуги, но без учета ПРР |
arrival.premium | string | Суммарный размер наценок на услуги (при наличии) |
arrival.premiumDetails | array of PremiumDetails | Детализация стоимости услуг с учетом наценок и скидок |
arrival.discountDetails | array of DiscountDetails | Детализация скидок на услуги (при наличии) |
arrival.price | string | Итоговая стоимость доставки до адреса без учета ПРР |
arrival.terminal | string | Ближайший населённый пункт к адресу получателя, в котором имеется терминал (может совпадать со значением параметра "derival.terminal", если нет другого терминала, расположенного ближе к получателю) |
arrival.discount | string | Суммарный размер скидок на услуги (при наличии) |
loadunload | object | Информация о стоимости ПРР |
loadunload.arrival | string | Стоимость ПРР. Если ПРР выполняются бесплатно, то параметр содержит значение "0" |
loadunload.discount | string | Суммарный размер скидок на ПРР (при наличии) |
loadunload.premium | string | Суммарный размер наценок на ПРР (при наличии) |
loadunload.premiumDetails | array of PremiumDetails | Детализация стоимости услуг ПРР с учетом наценок и скидок |
loadunload.discountDetails | array of DiscountDetails | Детализация скидок на ПРР (при наличии) |
information | array of strings | Информационное сообщение. Отображается, например, если в запросе был передан промокод, но применить его по какой-то причине невозможно |
PremiumDetails | ||
---|---|---|
Параметр | Тип | Описание |
name | string | Наименование типа наценки |
value | string | Размер наценки (в рублях) |
date | date | Срок действия наценки. Формат: ГГГГ-ММ-ДД |
announcement | boolean | Признак отношения наценки к акциям Возможные значения:
|
public | boolean | Признак публичной наценки Возможные значения:
|
DiscountDetails | ||
---|---|---|
Параметр | Тип | Описание |
name | string | Наименование типа скидки |
value | string | Размер скидки (в рублях) |
date | date | Срок действия скидки. Формат: ГГГГ-ММ-ДД |
announcement | boolean | Признак отношения скидки к акциям Возможные значения:
|
public | boolean | Признак публичной скидки Возможные значения:
|
triggers | array of Triggers | Массив характеристик заказа, которые инициировали применение скидки. Параметр выводится, если такие характеристики есть и скидка была применена |
Triggers | ||
---|---|---|
Параметр | Тип | Описание |
key | string | Характеристика заказа, которая инициировала применение скидки. Например, если скидка была применена по промокоду, то параметр содержит значение "promocode" |