Terminals directory

Обновлено 04.10.2023

153 кб

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.

The file is only available in JSON format. The file should be updated regularly. To understand whether the data in the directory has changed or not - compare the hash codes (see the response parameters description)

Terminals directory

Method request

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

JSON
XML

{
   "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

JSON
XML

{  
   "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>

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: "1" - possible; "0" - impossible
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: "1" - possible; "0" - impossible
preorderRequest	string	Flag indicating that in the city it is possible to place a pre-order (1) Possible values: "1" - possible; "0" - impossible
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: If a client wants to bring the cargo to the company terminal, they may place an order online, print the paper and bring it to the terminal. Thus they will be able to save time since the clients who placed a pre-order are served out of turn. For more information see Delovye Linii company website.

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
phones	array of Phones	List of phone numbers
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
mail	string	E-mail address
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: "Доставка груза" (delivery) "Прием и выдача груза" (accepting and giving out the cargo) "Приём груза" (accepting the cargo) "Выдача груза" (giving out the cargo) "Обработка заявок на доставку груза от/до адреса" (processing the orders for delivery from/to the address)
Notes: CLADR - Classifier of Addresses of Russian Federation

Phones

Phones
Parameter	Type	Description
number	string	Phone number
type	string	Type of phone number. Possible values: "городской" (landline); "мобильный" (mobile)
comment	string	Сomment
primary	boolean	Indicator of main phone number

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: "Доставка груза" - delivery; "Прием и выдача груза" - accepting and giving out the cargo; "Приём груза" - accepting the cargo; "Выдача груза" - giving out the cargo; "Приём груза к экспресс-перевозке" - accepting express cargoes; "Выдача грузов экспресс-перевозки" - giving out express cargoes; "Обработка заявок на доставку груза от/до адреса" - processing the orders for delivery from/to the address; "Офис" - office
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: The data has the text format, the wording may vary: "09:00-20:00", "9.00-17.00", "09:00-18-00", "24 ч"

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: The data has the text format, the wording may vary

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

Terminals directory

General information

Terminals directory

Method request

Request structure

Description of parameters

Request

Method response

Response structure

Description of parameters

File content

Content example

Description of parameters

City

Terminal

Phones

Maps

WidthValue

HeightValue

Worktable

SpecialWorktable