Terminals
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.
Terminals directory
Method request
Request example
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 example
{ "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). The file should be updated monthly |
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, "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>
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 in the "Places" directory |
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 | Flag indicating that the terminal is a pick-up point that means it is not possible to dispatch cargo from the terminal and the size of the cargoes that are given out at the terminal is limited:
|
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 |
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 |
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:
|