Калькулятор услуги Доставка до адреса
Общие сведения
Сервис позволяет рассчитать стоимость услуги "Доставка до адреса" для активной перевозки.
Калькулятор услуги доставка до адреса
Запрос метода
Структура запроса
Адрес метода: http://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" } ], "requester":1 }
Адрес метода: http://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> <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 | Фиксированное время доставки груза. Игнорируется, если период времени забора (параметр "arrivalPeriodVisit") больше 30 минут. Значение по умолчанию: false. Параметр требует передачи в запросе arrivalPeriodVisit, иначе возникает ошибка: "Требуется передать параметр 'arrivalperiodvisit'". |
arrivalUnLoading | Нет | array of Request.ArrivalUnLoading | Заказ разгрузки ТС. Содержит дополнительные параметры, необходимые для расчета погрузо-разгрузочных работ |
Request.ArrivalUnLoading | |||
Параметр | R* | Тип | Описание |
uid | Нет | string | Уникальные идентификаторы дополнительных параметров, необходимых для расчета погрузо-разгрузочных работ. Список параметров заполняется на основании "Справочника услуг ПРР". Если дополнительные параметры не будут переданы в запросе, погрузо-разгрузочные работы будут заказаны, но их стоимость будет рассчитана неточно |
value | Нет | string | Значение доп. параметра, если оно необходимо. К примеру, доп. параметр = "этаж", значение = "4" |
Ответ метода
Структура ответа
{ "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" }, { "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":[] } }
<response> <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> </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> </response>
Описание параметров
Response | ||
---|---|---|
Параметр | Тип | Описание |
derival | object | Данные о терминале отправления |
derival.terminal | string | Город, в котором расположен терминал, до которого изначально была заказана доставка, и с которого рассчитывается доставка до адреса |
arrival | object | Информация о стоимости доставки груза до адреса получателя с учетом стоимости услуг, наценок и скидок на услуги, но без учета ПРР |
arrival.premium | string | Суммарный размер наценок на услуги (при наличии) |
arrival.premiumDetails | array of Response.Arrival.PremiumDetails | Детализация стоимости услуг с учетом наценок и скидок |
arrival.discountDetails | array of Response.Arrival.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 Response.Loadunload.PremiumDetails | Детализация стоимости услуг ПРР с учетом наценок и скидок |
loadunload.discountDetails | array of Response.Loadunload.DiscountDetails | Детализация скидок на ПРР (при наличии) |
Response.Arrival.PremiumDetails | ||
---|---|---|
Параметр | Тип | Описание |
name | string | Наименование типа наценки |
value | string | Размер наценки (в рублях) |
date | date | Срок действия наценки. Формат: ГГГГ-ММ-ДД |
announcement | boolean | Признак отношения наценки к акциям Доступные значения:
|
public | boolean | Признак публичной наценки Доступные значения:
|
Response.Arrival.DiscountDetails | ||
---|---|---|
Параметр | Тип | Описание |
name | string | Наименование типа скидки |
value | string | Размер скидки (в рублях) |
date | date | Срок действия скидки. Формат: ГГГГ-ММ-ДД |
announcement | boolean | Признак отношения скидки к акциям Доступные значения:
|
public | boolean | Признак публичной скидки Доступные значения:
|