Справочник терминалов
Общие сведения
Сервис позволяет получить данные справочника терминалов. Справочник содержит информацию о терминалах (а также пунктах выдачи заказов) в городах, графиках их работы. Получить список терминалов для конкретного населённого пункта можно при помощи сервиса "Поиск терминалов".
Справочник терминалов
Запрос метода
Структура запроса
Адрес метода: https://api.dellin.ru/v3/public/terminals.json
{ "appkey": "00000000-0000-0000-0000-000000000000" }
Адрес метода: https://api.dellin.ru/v3/public/terminals.xml
<request> <appkey>00000000-0000-0000-0000-000000000000</appkey> </request>
Описание параметров
Request | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
appkey | Да | string | Ключ приложения. Для получения ключа необходимо пройти регистрацию |
Ответ метода
Структура ответа
{ "hash":"afb376bcefe05f204e6d456785e859813228537677ec3092bb4668b0f8ca7dd1", "url":"http://api.dellin.ru/catalog/terminals_v3.json?sk=YxKEbTqWQ1CBIyfLo8Q3lg&e=1521185588" }
<response> <hash>afb376bcefe05f204e6d456785e859813228537677ec3092bb4668b0f8ca7dd1</hash> <url>http://api.dellin.ru/catalog/terminals_v3.json?sk=YxKEbTqWQ1CBIyfLo8Q3lg&e=1521185588</url> </response>
Описание параметров
Response | ||
---|---|---|
Параметр | Тип | Описание |
hash | string | Хеш-код файла (MD5). Путём сравнения хеш-кодов двух файлов, полученных в разное время, можно понять, изменились данные в справочнике или нет |
url | string | Ссылка на файл с данными справочника в формате json |
Содержимое файла
Файл с данными справочника доступен только в формате JSON.
Пример содержимого
{ "city":[ { "id":"1", "name":"Санкт-Петербург", "code":"7800000000000000000000000", "cityID":200601, "latitude":"59.936600", "longitude":"30.412800", "url":"spb.dellin.ru", "timeshift":"0", "requestEndTime":"18:00", "sfrequestEndTime":"18:00", "day2dayRequest":"1", "day2daySFRequest":"0", "preorderRequest":"1", "freeStorageDays":"2", "terminals":{ "terminal":[ { "id":"39", "name":"Санкт-Петербург офис", "address":"Внуковская ул., 2а", "fullAddress":"196210, Санкт-Петербург г, Внуковская ул, дом № 2, Литера А", "latitude":"59.806300", "longitude":"30.310900", "isPVZ":false, "isOffice":true, "receiveCargo":false, "giveoutCargo":false, "storage":false, "cashOnDelivery":false, "maps":{ "width":{ "640":{ "height":{ "640":{ "url":"http://assets.dellin.ru/assets/yamaps_public/2015/7/22/843814/original/39.png#275f1dc620536e570afe3147b1dd84ce7993fdbbec7ed5b42ed3e74b709e3820" } } }, "944":{ "height":{ "352":{ "url":"http://assets.dellin.ru/assets/yamaps_public/2015/7/22/843815/original/39.png#5930944fe2e95fdc99cb4e3617a69a2f3ddbf273b45853f31bc1a9f3b518734b" } } }, "960":{ "height":{ "960":{ "url":"http://assets.dellin.ru/assets/yamaps_public/2015/7/22/843816/original/39.png#6d42291da28e1033c3de38f9ba67cb7cc5497e5a32c6ee2f9f7d0417a73ea939" } } } } }, "addressCode":{ "street_code":"7800000000018790000000000" }, "calcSchedule":{ "derival":null, "arrival":null }, "default":false, "maxVolume":0.0, "maxWeight":3000.0, "maxHeight":2.3999999999999999, "maxWidth":2.3999999999999999, "maxLength":13.0, "worktables":{ "worktable":[ { "department":"Офис", "monday":"09:00-19:00", "tuesday":"09:00-19:00", "wednesday":"09:00-19:00", "thursday":"09:00-19:00", "friday":"09:00-19:00", "saturday":"-", "sunday":"-", "timetable":"пн-пт 09:00-19:00; сб,вс выходной" }, { "department":"Обработка заявок на доставку груза от/до адреса", "monday":"08:00-18:00 ", "tuesday":"08:00-18:00 ", "wednesday":"08:00-18:00 ", "thursday":"08:00-18:00 ", "friday":"08:00-18:00 ", "saturday":"08:00-18:00", "sunday":"08:00-14:00", "timetable":"пн-сб 08:00-18:00; вс 08:00-14:00" } ], "specialWorktable":{ "receive":[ "27 ноября — выходной", "28 ноября — с 10:00 до 15:00", "29–30 ноября — выходные" ], "giveout":[ "27 ноября — выходной", "28 ноября — с 10:00 до 15:00", "29–30 ноября — выходные" ] } } } ] } } ] }
<response> </response>
Описание параметров
City
City | ||
---|---|---|
Параметр | Тип | Описание |
id | string | ID города в системе |
name | string | Наименование города |
code | string | Код КЛАДР города |
cityID | integer | ID города, см. "Поиск населённых пунктов" |
latitude | string | Широта города |
longitude | string | Долгота города |
url | string | Домен для города |
timeshift | string | Смещение времени в часах относительно Москвы |
requestEndTime | string | Время окончания приёма заявок на забор груза от адреса. Позже этого времени заявка переносится на следующий день |
sfrequestEndTime | string | Время окончания приёма заявок на доставку до адреса. Позже этого времени заявка переносится на следующий день |
day2dayRequest | string | Признак возможности оформить заявку на забор груза от адреса день-в-день в данном подразделении ("1" - да, "0" - нет) |
day2daySFRequest | string | Признак возможности оформить заявку на доставку груза до адреса день-в-день в данном подразделении ("1" - да, "0" - нет) |
preorderRequest | string | Признак возможности оформить предзаказ в данном подразделении ("1" - да, "0" - нет) |
freeStorageDays | string | Количество дней бесплатного хранения в данном подразделении |
terminals | object | Информация о терминалах в городе |
terminals.terminal | array of Terminal | Список терминалов в городе |
Terminal
Terminal | ||
---|---|---|
Параметр | Тип | Описание |
id | string | ID терминала в системе |
name | string | Наименование терминала |
address | string | Адрес терминала |
fullAddress | string | Полный адрес терминала |
latitude | string | Широта терминала |
longitude | string | Долгота терминала |
isPVZ | boolean | В настоящий момент параметр присутствует в ответе, но не используется |
isOffice | boolean | Признак работы терминала только в режиме офиса |
receiveCargo | boolean | Признак работы терминала на приём груза |
giveoutCargo | boolean | Признак работы терминала на выдачу груза |
storage | boolean | Признак работы терминала в режиме 3PL-склада |
cashOnDelivery | boolean | Признак доступности оплаты наложенным платежом на терминале |
maps | Maps | Терминал на карте |
addressCode | object | Информация о коде КЛАДР адреса терминала |
addressCode.street_code | string | Код КЛАДР улицы терминала |
calcSchedule | object | Расписание работы терминала |
calcSchedule.derival | string | График работы терминала по приему груза для отправки |
calcSchedule.arrival | string | График работы терминала по выдаче поступившего груза |
default | boolean | Признак терминала по умолчанию для города |
maxVolume | float | Максимально допустимый объем груза |
maxWeight | float | Максимально допустимый вес груза |
maxHeight | float | Максимально допустимая высота груза |
maxWidth | float | Максимально допустимая ширина груза |
maxLength | float | Максимально допустимая длина груза |
worktables | object | Расписание работы отделов терминала |
worktables.worktable | array of Worktable | Список отделов терминала |
worktables.specialWorktable | SpecialWorktable | График работы терминала в праздничные дни. Параметр присутствует в ответе, если значение параметра "worktables.worktable.department" - одно из:
|
Maps
Maps | ||
---|---|---|
Параметр | Тип | Описание |
width | object | Ширина изображения с картой |
width.widthValue | WidthValue | Вместо [widthValue] указано значение ширины изображения с картой (в пикселях) |
WidthValue
WidthValue | ||
---|---|---|
Параметр | Тип | Описание |
height | object | Высота изображения с картой |
height.heightValue | HeightValue | Вместо [heightValue] указано значение высоты изображения с картой (в пикселях) |
HeightValue
HeightValue | ||
---|---|---|
Параметр | Тип | Описание |
url | string | Ссылка на изображение с картой |
Worktable
Worktable | ||
---|---|---|
Параметр | Тип | Описание |
department | string | Наименование отдела. Возможные значения:
|
monday | string | Время работы в понедельник (1) |
tuesday | string | Время работы во вторник (1) |
wednesday | string | Время работы в среду (1) |
thursday | string | Время работы в четверг (1) |
friday | string | Время работы в пятницу (1) |
saturday | string | Время работы в субботу (1) |
sunday | string | Время работы в воскресенье (1) |
timetable | string | Время работы на всю неделю короткой строкой (1) |
Примечания:
|
SpecialWorktable
SpecialWorktable | ||
---|---|---|
Параметр | Тип | Описание |
receive | array of strings | График работы терминала на прием груза (в праздничные дни) (1) |
giveout | array of strings | График работы терминала на выдачу груза (в праздничные дни) (1) |
Примечания:
|