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

API
Главная / API - Терминалы и ПВЗ

Терминалы и ПВЗ

Обновлено 22.03.2018
98 кб

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

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

Файл с данными справочника доступен только в формате JSON.

Справочник терминалов

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

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

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

{
   "appkey": "00000000-0000-0000-000000000000"
}

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

<request>
   <appkey>00000000-0000-0000-000000000000</appkey>
</request>

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

Request
ПараметрR*ТипОписание
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
ПараметрТипОписание
hashstringХеш-код файла (MD5). Путём сравнения хеш-кодов двух файлов, полученных в разное время, можно понять, изменились данные в справочнике или нет
urlstring

Ссылка на файл с данными справочника в формате 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,
                  "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"
                        }
                     ]
                  }
               }
            ]
         }
      }
   ]
}
<response>
</response>

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

City
ПараметрТипОписание

id

stringID города в системе
namestringНаименование города
codestringКод КЛАДР города
cityIDintegerID города в "Справочнике населенных пунктов"
latitudestringШирота города
longitudestring
Долгота города
urlstringДомен для города
timeshiftstring
Смещение времени в часах относительно Москвы
requestEndTimestringВремя окончания приёма заявок на забор груза от адреса. Позже этого времени заявка переносится на следующий день
sfrequestEndTimestringВремя окончания приёма заявок на доставку до адреса. Позже этого времени заявка переносится на следующий день
day2dayRequeststringПризнак возможности оформить заявку на забор груза от адреса день-в-день в данном подразделении ("1" - да, "0" - нет)
day2daySFRequeststringПризнак возможности оформить заявку на доставку груза до адреса день-в-день в данном подразделении ("1" - да, "0" - нет)

preorderRequest

stringПризнак возможности оформить предзаказ в данном подразделении ("1" - да, "0" - нет)
freeStorageDaysstringКоличество дней бесплатного хранения в данном подразделении
terminalsCity.TerminalsИнформация о терминалах в городе

City.Terminals
ПараметрТипОписание

terminal

array of City.Terminals.TerminalСписок терминалов в городе

City.Terminals.Terminal
ПараметрТипОписание

id

stringID терминала в системе
namestringНаименование терминала
addressstringАдрес терминала
fullAddressstringПолный адрес терминала
latitudestringШирота терминала
longitudestringДолгота терминала
isPVZbooleanПризнак того, что терминал является пунктом выдачи заказов контрагента "220 Вольт"
isOfficebooleanПризнак работы терминала только в режиме офиса
receiveCargobooleanПризнак работы терминала только на получение груза
giveoutCargobooleanПризнак работы терминала только на отправку груза
mapsCity.Terminals.Terminal.MapsТерминал на карте
addressCodeobjectИнформация о коде КЛАДР адреса терминала
addressCode. street_codestringКод КЛАДР улицы терминала
calcScheduleobjectРасписание работы терминала
calcSchedule.derivalstringГрафик работы терминала по приему груза для отправки
calcSchedule.arrivalstringГрафик работы терминала по выдаче поступившего груза 
defaultbooleanПризнак терминала по умолчанию для города
maxVolumefloatМаксимально допустимый объем груза
maxWeightfloatМаксимально допустимый вес груза
maxHeightfloatМаксимально допустимая высота груза
maxWidthfloatМаксимально допустимая ширина груза
maxLengthfloatМаксимально допустимая длина груза
worktablesCity.Terminals.Terminal.WorktablesРасписание работы отделов терминала

City.Terminals.Terminal.Maps
ПараметрТипОписание

width

City.Terminals.Terminal.Maps.Width

Ширина изображения с картой

City.Terminals.Terminal.Maps.Width
ПараметрТипОписание

[widthValue]

City.Terminals.Terminal.Maps.Width.[WidthValue]

Вместо [widthValue] указано значение ширины изображения с картой (в пикселях)

City.Terminals.Terminal.Maps.Width.[WidthValue]
ПараметрТипОписание

height

City.Terminals.Terminal.Maps.Width.[WidthValue].Heigth

Высота изображения с картой

City.Terminals.Terminal.Maps.Width.[WidthValue].Height
ПараметрТипОписание

[heightValue]

City.Terminals.Terminal.Maps.Width.[WidthValue].Heigth.[HeightValue]

Вместо [heightValue] указано значение высоты изображения с картой (в пикселях)

City.Terminals.Terminal.Maps.Width.[WidthValue].Heigth.[HeightValue]
ПараметрТипОписание

url

string

Ссылка на изображение с картой

City.Terminals.Terminal.Worktables
ПараметрТипОписание

worktable

array of City.Terminals.Terminal.Worktables.WorktableСписок отделов терминала

City.Terminals.Terminal.Worktables.Worktable
ПараметрТипОписание

department

stringНаименование отдела
mondaystringВремя работы в понедельник
tuesdaystringВремя работы во вторник
wednesdaystringВремя работы в среду
thursdaystringВремя работы в четверг
fridaystringВремя работы в пятницу
saturdaystringВремя работы в субботу
sundaystringВремя работы в воскресенье
timetablestringВремя работы на всю неделю короткой строкой
Обратите внимание, что данные о режиме работы по дням недели приходят в текстовом формате и могут быть представлены по-разному, например: "09:00-20:00", "9.00-17.00", "09:00-18-00", "24 ч".