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

API
Главная / API - Terminals

Terminals

Обновлено 16.07.2020
116 кб

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.

The file is only available in JSON format. The file should be updated monthly

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
ParameterRequiredTypeDescription
appkeyYesstringApplication 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
ParameterTypeDescription
hashstringHash 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
urlstring

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
ParameterTypeDescription

id

stringCity ID
namestringCity name
codestring

City CLADR* code

*CLADR - Classifier of Addresses of Russian Federation 

cityIDintegerCity ID in the "Places" directory
latitudestringCity latitude
longitudestring
City longitude
urlstringCity domain
timeshiftstring
Time difference compared with Moscow
requestEndTimestring

End time for accepting the orders for shipping from the sender's address. Orders submitted after the time will be completed the next day

sfrequestEndTimestring

End time for accepting the orders for shipping to the receiver's address. Orders submitted after the time will be completed the next day

day2dayRequeststring

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
day2daySFRequeststring

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
freeStorageDaysstringFree storage period (days) for the city
terminalsobjectInformation on the terminals in the city
terminals.terminalarray of TerminalThe list of the terminals in the city

Notes:

  1. 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
ParameterTypeDescription

id

stringTerminal ID
namestringTerminal name
addressstringTerminal address
fullAddressstringTerminal full address
latitudestringTerminal latitude
longitudestringTerminal longitude
isPVZbooleanFlag indicating that the terminal is a pick-up point
isOfficebooleanFlag indicating that the terminal performs only office function
receiveCargobooleanFlag indicating that it is possible to dispatch the cargo from the terminal
giveoutCargobooleanFlag indicating that it is possible to receive the cargo at the terminal
storagebooleanFlag indicating that the terminal provides warehousing (3PL) services
mapsMapsTerminal at the map
addressCodeobject

Terminal address CLADR code data (1)

addressCode.street_codestringTerminal street CLADR code (1)
calcScheduleobjectTerminal working hours 
calcSchedule.derivalstringThe cargo acceptance hours
calcSchedule.arrivalstringThe cargo give out hours
defaultbooleanFlag indicating that the terminal is the default city terminal
maxVolumefloatMaximum allowable cargo volume, m3
maxWeightfloatMaximum allowable cargo weight, kg
maxHeightfloatMaximum allowable cargo height, m
maxWidthfloatMaximum allowable cargo width, m
maxLengthfloatMaximum allowable cargo length, m
worktablesobjectTerminal departments office hours
worktables.worktablearray of WorktableThe list of terminal departments

Notes:

  1. CLADR - Classifier of Addresses of Russian Federation 

Maps
Maps
ParameterTypeDescription
widthobjectMap image width data

width.[widthValue]

WidthValue

Instead of [widthValue] parameter name contains the actual map image width (pixels)

WidthValue
WidthValue
ParameterTypeDescription

height

object

Map image height data

height.[heightValue]HeightValue

Instead of [heightValue] parameter name contains the actual map image height (pixels)

HeightValue
HeightValue
ParameterTypeDescription

url

string

Map image link

Worktable
Worktable
ParameterTypeDescription

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
mondaystringMonday business hours (1)
tuesdaystringTuesday business hours (1)
wednesdaystringWednesday business hours (1)
thursdaystringThursday business hours (1)
fridaystringFriday business hours (1)
saturdaystringSaturday  business hours (1)
sundaystringSunday business hours (1)
timetablestringBusiness hours for the whole week - as a string (1)

Notes:

  1. The data has the text format, the wording may vary: "09:00-20:00", "9.00-17.00", "09:00-18-00", "24 ч"