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

API
Главная / API - Справочник терминалов

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

Обновлено 04.10.2023
Скачать в PDF
152 кб
Содержание:

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

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

Файл с данными справочника доступен только в формате JSON. Необходимо поддерживать актуальность файла, для сравнения версий следует использовать хеш-код (см. описание параметров ответа)

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

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

Структура запроса 

Адрес метода: 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
ПараметрТипОписание
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",
                  "phones":[
                     {
                        "number":"7 (812) 448-88-88",
                        "type":"городской",
                        "comment":"",
                        "primary":false
                     }
                  ],
                  "isPVZ":false,
                  "isOffice":true,
                  "receiveCargo":false,
                  "giveoutCargo":false,
                  "storage":false,
                  "mail":"pismo@dellin.ru",
                  "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

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

preorderRequest

string

Признак возможности оформить предзаказ в данном подразделении ("1" - да, "0" - нет)

freeStorageDaysstringКоличество дней бесплатного хранения в данном подразделении
terminalsobjectИнформация о терминалах в городе
terminals.terminalarray of TerminalСписок терминалов в городе

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

id

stringID терминала в системе
namestringНаименование терминала
addressstringАдрес терминала
fullAddressstringПолный адрес терминала
latitudestringШирота терминала
longitudestringДолгота терминала
phonesarray of PhonesСписок телефонных номеров
isPVZbooleanВ настоящий момент параметр присутствует в ответе, но не используется
isOfficebooleanПризнак работы терминала только в режиме офиса
receiveCargobooleanПризнак работы терминала на приём груза
giveoutCargobooleanПризнак работы терминала на выдачу груза
storagebooleanПризнак работы терминала в режиме 3PL-склада
mailstringЭлектронная почта
cashOnDeliverybooleanПризнак доступности оплаты наложенным платежом на терминале
mapsMapsТерминал на карте
addressCodeobjectИнформация о коде КЛАДР адреса терминала
addressCode.street_codestringКод КЛАДР улицы терминала
calcScheduleobjectРасписание работы терминала
calcSchedule.derivalstringГрафик работы терминала по приему груза для отправки
calcSchedule.arrivalstringГрафик работы терминала по выдаче поступившего груза 
defaultbooleanПризнак терминала по умолчанию для города
maxVolumefloatМаксимально допустимый объем груза
maxWeightfloatМаксимально допустимый вес груза
maxHeightfloatМаксимально допустимая высота груза
maxWidthfloatМаксимально допустимая ширина груза
maxLengthfloatМаксимально допустимая длина груза
worktablesobjectРасписание работы отделов терминала
worktables.worktablearray of WorktableСписок отделов терминала
worktables.specialWorktableSpecialWorktable

График работы терминала в праздничные дни.

Параметр присутствует в ответе, если значение параметра "worktables.worktable.department" - одно из:

  • "Доставка груза"
  • "Прием и выдача груза"
  • "Приём груза"
  • "Выдача груза"
  • "Обработка заявок на доставку груза от/до адреса"

Phones
Phones
ПараметрТипОписание
numberstringНомер телефона

type

string

Тип телефонного номера.

Возможные значения:

  • "городской";
  • "мобильный"
commentstringКомментарий
primarybooleanПризнак основного номера

Maps
Maps
ПараметрТипОписание
widthobjectШирина изображения с картой

width.widthValue

WidthValue

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

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

height

object

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

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

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

url

string

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

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

department

string

Наименование отдела.

Возможные значения:

  • "Доставка груза";
  • "Прием и выдача груза";
  • "Приём груза";
  • "Выдача груза";
  • "Приём груза к экспресс-перевозке";
  • "Выдача грузов экспресс-перевозки";
  • "Обработка заявок на доставку груза от/до адреса";
  • "Офис"
mondaystringВремя работы в понедельник (1)
tuesdaystringВремя работы во вторник (1)
wednesdaystringВремя работы в среду (1)
thursdaystringВремя работы в четверг (1)
fridaystringВремя работы в пятницу (1)
saturdaystringВремя работы в субботу (1)
sundaystringВремя работы в воскресенье (1)
timetablestringВремя работы на всю неделю короткой строкой (1)

Примечания:

  1. Данные имеют текстовый формат и могут быть представлены по-разному, например: "09:00-20:00", "9.00-17.00", "09:00-18-00", "24 ч"

SpecialWorktable
SpecialWorktable
ПараметрТипОписание
receivearray of stringsГрафик работы терминала на прием груза (в праздничные дни) (1)
giveoutarray of stringsГрафик работы терминала на выдачу груза (в праздничные дни) (1)

Примечания:

  1. Данные имеют текстовый формат и могут быть представлены по-разному