Terminals directory
General information
The service allows receiving the terminals directory data. The directory contains information on the city terminals (as well as pick-up points) and their schedules. To get the information on the terminals for the selected city use "Terminals search" method.
Terminals directory
Method request
Request structure
Method address: https://api.dellin.ru/v3/public/terminals.json
{ "appkey": "00000000-0000-0000-0000-000000000000" }
Method address: https://api.dellin.ru/v3/public/terminals.xml
<request> <appkey>00000000-0000-0000-0000-000000000000</appkey> </request>
Description of parameters
Request
Request | |||
---|---|---|---|
Parameter | Required | Type | Description |
appkey | Yes | string | Application key. To get the key, register |
Method response
Response structure
{ "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>
Description of parameters
Response | ||
---|---|---|
Parameter | Type | Description |
hash | string | Hash code (MD5). By comparing the hash codes of two files received at different times, it is possible to understand whether the data in the directory has changed or not |
url | string | Link to the file with the directory data (JSON format) |
File content
The file is only available in JSON format.
Content example
{ "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>
Description of parameters
City
City | ||
---|---|---|
Parameter | Type | Description |
id | string | City ID |
name | string | City name |
code | string | City CLADR* code *CLADR - Classifier of Addresses of Russian Federation |
cityID | integer | City ID, "Places search" |
latitude | string | City latitude |
longitude | string | City longitude |
url | string | City domain |
timeshift | string | Time difference compared with Moscow |
requestEndTime | string | End time for accepting the orders for shipping from the sender's address. Orders submitted after the time will be completed the next day |
sfrequestEndTime | string | End time for accepting the orders for shipping to the receiver's address. Orders submitted after the time will be completed the next day |
day2dayRequest | string | Flag indicating that in the city in case of shipping from the sender's address it is possible to schedule the forwarding driver arrival on the day of placing the order. Possible values:
|
day2daySFRequest | string | Flag indicating that in the city in case of shipping to the receiver's address it is possible to schedule the forwarding driver arrival on the day of placing the order. Possible values:
|
preorderRequest | string | Flag indicating that in the city it is possible to place a pre-order (1) Possible values:
|
freeStorageDays | string | Free storage period (days) for the city |
terminals | object | Information on the terminals in the city |
terminals.terminal | array of Terminal | The list of the terminals in the city |
Notes:
|
Terminal
Terminal | ||
---|---|---|
Parameter | Type | Description |
id | string | Terminal ID |
name | string | Terminal name |
address | string | Terminal address |
fullAddress | string | Terminal full address |
latitude | string | Terminal latitude |
longitude | string | Terminal longitude |
isPVZ | boolean | The parameter is present in the response, but is not currently used |
isOffice | boolean | Flag indicating that the terminal performs only office function |
receiveCargo | boolean | Flag indicating that it is possible to dispatch the cargo from the terminal |
giveoutCargo | boolean | Flag indicating that it is possible to receive the cargo at the terminal |
storage | boolean | Flag indicating that the terminal provides warehousing (3PL) services |
cashOnDelivery | boolean | Flag indicating that cash on delivery service is available at the terminal |
maps | Maps | Terminal at the map |
addressCode | object | Terminal address CLADR code data (1) |
addressCode.street_code | string | Terminal street CLADR code (1) |
calcSchedule | object | Terminal working hours |
calcSchedule.derival | string | The cargo acceptance hours |
calcSchedule.arrival | string | The cargo give out hours |
default | boolean | Flag indicating that the terminal is the default city terminal |
maxVolume | float | Maximum allowable cargo volume, m3 |
maxWeight | float | Maximum allowable cargo weight, kg |
maxHeight | float | Maximum allowable cargo height, m |
maxWidth | float | Maximum allowable cargo width, m |
maxLength | float | Maximum allowable cargo length, m |
worktables | object | Terminal departments office hours |
worktables.worktable | array of Worktable | The list of terminal departments |
worktables.specialWorktable | SpecialWorktable | Terminal workhours on holydays. The parameter is present in the response if "worktables.worktable.department" parameter has one of the next values:
|
Notes:
|
Maps
Maps | ||
---|---|---|
Parameter | Type | Description |
width | object | Map image width data |
width.[widthValue] | WidthValue | Instead of [widthValue] parameter name contains the actual map image width (pixels) |
WidthValue
WidthValue | ||
---|---|---|
Parameter | Type | Description |
height | object | Map image height data |
height.[heightValue] | HeightValue | Instead of [heightValue] parameter name contains the actual map image height (pixels) |
HeightValue
HeightValue | ||
---|---|---|
Parameter | Type | Description |
url | string | Map image link |
Worktable
Worktable | ||
---|---|---|
Parameter | Type | Description |
department | string | Department. Possible values:
|
monday | string | Monday business hours (1) |
tuesday | string | Tuesday business hours (1) |
wednesday | string | Wednesday business hours (1) |
thursday | string | Thursday business hours (1) |
friday | string | Friday business hours (1) |
saturday | string | Saturday business hours (1) |
sunday | string | Sunday business hours (1) |
timetable | string | Business hours for the whole week - as a string (1) |
Notes:
|
SpecialWorktable
SpecialWorktable | ||
---|---|---|
Parameter | Type | Description |
receive | array of strings | Terminal workhours for accepting the cargo (on holydays) (1) |
giveout | array of strings | Terminal workhours for giving out the cargo (on holydays) (1) |
Notes:
|