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

API
Главная / API - Cost calculation and ordering

Cost calculation and ordering

Обновлено 28.08.2020
293 кб
Содержание:

General information

This service allows getting the data from the directories that are used for cost calculation and ordering.

Directory of special transport requirements

Method request

Request example

Method address: https://api.dellin.ru/v1/references/services.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/references/services.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

{
   "metadata":{
      "status":200,
      "generated_at":"2015-06-18 12:37:28"
   },
   "data":[
      {
         "uid":"0x92fce2284f000b0241dad7c2e88b1655",
         "name":"для погрузки необходим гидроборт",
         "title":"Гидроборт",
         "incompatible":[
            "0x88f93a2c37f106d94ff9f7ada8efe886"
         ]
      }
   ]
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2015-06-18 12:37:28</generated_at>
   </metadata>
   <data>
      <uid>0x92fce2284f000b0241dad7c2e88b1655</uid>
      <name>для погрузки необходим гидроборт</name>
      <title>Гидроборт</title>
      <incompatible>0x88f93a2c37f106d94ff9f7ada8efe886</incompatible>
   </data>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
metadataobjectSystem information
metadata.statusintegerEmulated status http-code. If successful, code 200 is returned
metadata.generated_atstring

Server response date and time.

Format: YYYY-MM-DD HH:MM:SS

dataarray of DataInformation on special transport requirements
data.uidstring

Service UID

data.namestring

Full name of the service.

For parameter values see table below

data.titlestring

Short name of the service.

For parameter values see table below

data.incompatiblearray of stringsUIDs of services types incompatible with the type which UID is passed in data.uid parameter

"response.data.name" and "response.data.title" parameters values
The table below lists "response.data.name" parameter values and corresponding values of "response.data.title" parameter

data.name

data.title

"для погрузки необходим гидроборт" - tail lift is required"Гидроборт" - tail lift
"для погрузки необходим манипулятор" - crane is required"Манипулятор" - crane
"для погрузки необходима открытая машина" - open vehicle is required"Открытая машина" - open vehicle
"растентовка" - removable curtains"Растентовка" - removable curtains

Error handling

The common API errors are used with the method, for errors format description and errors list see Errors of API methods.

Directory of available packages

Method request

Request example

Method address: https://api.dellin.ru/v1/references/packages.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/references/packages.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

{
   "metadata":{
      "status":200,
      "generated_at":"2015-06-18 12:37:28"
   },
   "data":[
      {
         "uid":"0x838FC70BAEB49B564426B45B1D216C15",
         "title":"Деревянная обрешётка",
         "name":"crate",
         "countable":"false",
         "incompatible":[
            "0x8783b183e825d40d4eb5c21ef63fbbfb",
            "0xb9f594d27a2d31b440a647d19547543c"
         ]
      }
   ]
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2015-06-18 12:37:28</generated_at>
   </metadata>
   <data>
      <uid>0x838FC70BAEB49B564426B45B1D216C15</uid>
      <title>Деревянная обрешётка</title>
      <name>crate</name>
      <countable>false</countable>
      <incompatible>0x8783b183e825d40d4eb5c21ef63fbbfb</incompatible>
      <incompatible>0xb9f594d27a2d31b440a647d19547543c</incompatible>
   </data>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
metadataobjectSystem information
metadata.statusintegerEmulated status http-code. If successful, code 200 is returned
metadata.generated_atstring

Server response date and time.

Format: YYYY-MM-DD HH:MM:SS

dataarray of DataInformation on packaging type
data.uidstring

UID

data.titlestring

Packaging type name in Russian.

For parameter values see table below

data.namestring

Packaging type conditional name in English.

For parameter values see table below

data.countablebooleanFlag indicating that several units of packaging can be ordered
data.incompatiblearray of strings

UIDs of packaging types incompatible with the type which UID is passed in data.uid parameter

"response.data.title" and "response.data.name" parameters values
The table below lists "response.data.title" parameter values and corresponding values of "response.data.name" parameter

data.title

data.name

Meaning
Деревянная обрешёткаcrateWooden crate
Жёсткая коробcrate_plusWooden box
Картонные коробкиboxCardboard box
Дополнительная упаковкаtypeAdditional packaging
Деревянная обрешётка + амортизацияcrate_with_bubbleBubble wrap and wooden crate
Спец. упаковка для автостеколprotect_auto_glassSpecial packaging for auto glass
Спец. упаковка для автозапчастейprotect_auto_partSpecial packaging for auto parts
Палетный борт + амортизацияpallet_with_bubbleBubble wrap and pallet
Воздушно-пузырьковая плёнкаbubleBubble wrap
МешокbagBag
Палентный бортpalletPallet

Error handling

The common API errors are used with the method, for errors format description and errors list see Errors of API methods.

Directory of additional services

Method request

Request example

Method address: https://api.dellin.ru/v1/public/request_services.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/public/request_services.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": "1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4",
   "url": "https://api.dellin.ru/catalog/request_services.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434"
}
<response>
   <hash>1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4</hash>
   <url>https://api.dellin.ru/catalog/request_services.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434</url>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
hashstringFile hash code (MD5). By comparing the hash codes of two files received at different times, you can understand whether the data in the directory has changed or not
urlstring

Link to the file with directory data in csv format in utf-8 encoding (the link is valid for 10 minutes).

The line delimiter in the file is the character "\n", the column delimiter is comma (","), and the text delimiter is the quotation mark (" " ").

The file located on the link in the response contains the next columns:

  • id — unique service identifier;
  • uid — unique service identifier for relation with other directories;
  • name — service name.

It is recommended to update the downloaded file once a month

Directory of shipping types

Method request

Request example

Method address: https://api.dellin.ru/v1/public/request_delivery_types.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/public/request_delivery_types.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": "1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4",
   "url": "https://api.dellin.ru/catalog/request_delivery_types.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434"
}
<response>
   <hash>1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4</hash>
   <url>https://api.dellin.ru/catalog/request_delivery_types.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434</url>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
hashstringFile hash code (MD5). By comparing the hash codes of two files received at different times, you can understand whether the data in the directory has changed or not
urlstring

Link to the file with directory data in csv format in utf-8 encoding (the link is valid for 10 minutes).

The line delimiter in the file is the character "\n", the column delimiter is comma (","), and the text delimiter is the quotation mark (" " ").

The file located on the link in the response contains the next columns:

  • id - unique shipping type identifier;
  • uid - shipping type UID that is used to define the shipping type in other methods;
  • description - shipping type name.
    The following values may be present in the "description" column.
    • "автотранспортная перевозка" - road carriage;
    • "экспресс-перевозка" - express transportation;
    • "авиаперевозка" - air transportation;
    • "коммерческая почта" - commercial mail;
    • "доставка малогабаритного груза" - small cargo transportation.

It is recommended to update the downloaded file once a month

Small size cargo is the cargo with parameters that do not exceed the following values:
  • weight is less than or equal to 10 kg;
  • LWH is less than or equal to 0.54*0.39*0.39 m;
  • volume is less than or equal to 0.1 cubic meters.
It is only possible to order Small Cargo Delivery service if there are Delovye Linii company terminals in the city of departure and city of arrival. For more information see company website

Directory of payer types

Method request

Request example

Method address: https://api.dellin.ru/v1/public/payer_types.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/public/payer_types.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": "1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4",
   "url": "https://api.dellin.ru/catalog/payer_types.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434"
}
<response>
   <hash>1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4</hash>
   <url>https://api.dellin.ru/catalog/payer_types.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434</url>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
hashstringFile hash code (MD5). By comparing the hash codes of two files received at different times, you can understand whether the data in the directory has changed or not
urlstring

Link to the file with directory data in csv format in utf-8 encoding (the link is valid for 10 minutes).

The line delimiter in the file is the character "\n", the column delimiter is comma (","), and the text delimiter is the quotation mark (" " ").

The file located on the link in the response contains the next columns:

  • id — unique payer type identifier;
  • name — payer type name.

It is recommended to update the downloaded file once a month

Directory of payment types

Method request

Request example

Method address: https://api.dellin.ru/v1/public/payment_types.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/public/payment_types.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": "1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4",
   "url": "https://api.dellin.ru/catalog/payment_types.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434"
}
<response>
   <hash>1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4</hash>
   <url>https://api.dellin.ru/catalog/payment_types.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434</url>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
hashstringFile hash code (MD5). By comparing the hash codes of two files received at different times, you can understand whether the data in the directory has changed or not
urlstring

Link to the file with directory data in csv format in utf-8 encoding (the link is valid for 10 minutes).

The line delimiter in the file is the character "\n", the column delimiter is comma (","), and the text delimiter is the quotation mark (" " ").

The file located on the link in the response contains the next columns:

  • id — unique payment type identifier;
  • name — payment type name.

It is recommended to update the downloaded file once a month

Directory of vehicle loading types

Method request

Request example

Method address: https://api.dellin.ru/v1/references/load_types.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/references/load_types.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

{
   "metadata":{
      "status":200,
      "generated_at":"2015-06-18 12:37:28"
   },
   "data":[
      {
         "uid":"0xb83b7589658a3851440a853325d1bf69",
         "name":"боковая погрузка",
         "title":"Боковая загрузка",
         "incompatible":[
            "0xabb9c63c596b08f94c3664c930e77778"
         ]
      }
   ]
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2015-06-18 12:37:28</generated_at>
   </metadata>
   <data>
      <uid>0xb83b7589658a3851440a853325d1bf69</uid>
      <name>боковая погрузка</name>
      <title>Боковая загрузка</title>
      <incompatible>0xabb9c63c596b08f94c3664c930e77778</incompatible>
   </data>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
metadataobjectSystem information
metadata.statusinteger

Emulated status http-code. If successful, code 200 is returned

metadata.generated_atstring

Server response date and time.

Format: YYYY-MM-DD HH:MM:SS

dataarray of DataInformation on loading types
data.uidstring

Loading type UID

data.namestring

Loading type name.

Possible values:

  • "верхняя погрузка" - top loading;
  • "боковая погрузка" - side loading
data.titlestring

Loading type short name.

Possible values:

  • "Верхняя загрузка" - top loading;
  • "Боковая загрузка" - side loading
data.incompatiblearray of stringsUIDs of loading types incompatible with the type which UID is passed in data.uid parameter

Error handling

The common API errors are used with the method, for errors format description and errors list see Errors of API methods.

Directory of vehicle loading/unloading services

Method request

Request example

Method address: https://api.dellin.ru/v1/public/load_params.json

{
   "appkey": "00000000-0000-0000-0000-000000000000"
}

Method address: https://api.dellin.ru/v1/public/load_params.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": "1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4",
   "url": "https://api.dellin.ru/catalog/load_params.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434"
}
<response>
   <hash>1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4</hash>
   <url>https://api.dellin.ru/catalog/load_params.csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434</url>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
hashstringFile hash code (MD5). By comparing the hash codes of two files received at different times, you can understand whether the data in the directory has changed or not
urlstring

Link to the file with directory data in csv format in utf-8 encoding (the link is valid for 10 minutes).

The line delimiter in the file is the character "\n", the column delimiter is comma (","), and the text delimiter is the quotation mark (" " ").

The file located on the link in the response contains the next columns:

  • UID — unique identifier of additional parameter of loading/unloading service;
  • valueRequired — parameter determining the need to specify the value for additional parameter of loading/unloading service. Possible values: "1" — the value is required; "0" — the value is not required;
  • name — name of additional parameter of loading/unloading service.

It is recommended to update the downloaded file once a month

Hourly rental information

Method request

Request example

Method address: https://api.dellin.ru/v1/references/hourly_rent_info.json

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "city":"Вла"
}

Method address: https://api.dellin.ru/v1/references/hourly_rent_info.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <city>Вла</city>
</request>

Description of parameters

Request
Request
ParameterRequiredTypeDescription
appkeyYesstringApplication key. To get the key, register
cityNostringCity - full name or fragment. Minimum string length - 2 characters. Search from the beginning of the string

Method response

Response example

{
   "metadata":{
      "status":200,
      "generated_at":"2020-02-19 06:44:04"
   },
   "data":[
      {
         "city":"Ярославль",
         "categoryId":351,
         "category":"Тент",
         "minOrderTime":2.0,
         "vehDeliveryTime":1.0,
         "aroundCity":550.0,
         "kilometerCostOut":15.0,
         "manipulator":false,
         "manipulatorCost":0,
         "tentRemoval":true,
         "tentRemovalCost":1500.0,
         "dropCenter":false,
         "dropCenterCost":0,
         "liftCapacity":2000.0,
         "volume":17.0,
         "lenght":4.0,
         "width":2.1,
         "height":2.1
      },
      {
         "city":"Ярославль",
         "categoryId":352,
         "category":"Тент / Фургон",
         "minOrderTime":3.0,
         "vehDeliveryTime":1.0,
         "aroundCity":950.0,
         "kilometerCostOut":25.0,
         "manipulator":false,
         "manipulatorCost":0,
         "tentRemoval":true,
         "tentRemovalCost":1500.0,
         "dropCenter":false,
         "dropCenterCost":0,
         "liftCapacity":5000.0,
         "volume":37.0,
         "lenght":6.5,
         "width":2.38,
         "height":2.4
      },
      {
         "city":"Ярославль",
         "categoryId":350,
         "category":"Фургон",
         "minOrderTime":2.0,
         "vehDeliveryTime":1.0,
         "aroundCity":550.0,
         "kilometerCostOut":15.0,
         "manipulator":false,
         "manipulatorCost":0,
         "tentRemoval":false,
         "tentRemovalCost":0,
         "dropCenter":false,
         "dropCenterCost":0,
         "liftCapacity":2000.0,
         "volume":17.0,
         "lenght":4.0,
         "width":2.1,
         "height":2.1
      }
   ]
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2020-02-19 06:44:04</generated_at>
   </metadata>
   <data>
      <city>Ярославль</city>
      <categoryId>351</categoryId>
      <category>Тент</category>
      <minOrderTime>2</minOrderTime>
      <vehDeliveryTime>1</vehDeliveryTime>
      <aroundCity>550</aroundCity>
      <kilometerCostOut>15</kilometerCostOut>
      <manipulator>false</manipulator>
      <manipulatorCost>0</manipulatorCost>
      <tentRemoval>true</tentRemoval>
      <tentRemovalCost>1500</tentRemovalCost>
      <dropCenter>false</dropCenter>
      <dropCenterCost>0</dropCenterCost>
      <liftCapacity>2000</liftCapacity>
      <volume>17</volume>
      <lenght>4</lenght>
      <width>2.1</width>
      <height>2.1</height>
   </data>
   <data>
      <city>Ярославль</city>
      <categoryId>352</categoryId>
      <category>Тент / Фургон</category>
      <minOrderTime>3</minOrderTime>
      <vehDeliveryTime>1</vehDeliveryTime>
      <aroundCity>950</aroundCity>
      <kilometerCostOut>25</kilometerCostOut>
      <manipulator>false</manipulator>
      <manipulatorCost>0</manipulatorCost>
      <tentRemoval>true</tentRemoval>
      <tentRemovalCost>1500</tentRemovalCost>
      <dropCenter>false</dropCenter>
      <dropCenterCost>0</dropCenterCost>
      <liftCapacity>5000</liftCapacity>
      <volume>37</volume>
      <lenght>6.5</lenght>
      <width>2.38</width>
      <height>2.4</height>
   </data>
   <data>
      <city>Ярославль</city>
      <categoryId>350</categoryId>
      <category>Фургон</category>
      <minOrderTime>2</minOrderTime>
      <vehDeliveryTime>1</vehDeliveryTime>
      <aroundCity>550</aroundCity>
      <kilometerCostOut>15</kilometerCostOut>
      <manipulator>false</manipulator>
      <manipulatorCost>0</manipulatorCost>
      <tentRemoval>false</tentRemoval>
      <tentRemovalCost>0</tentRemovalCost>
      <dropCenter>false</dropCenter>
      <dropCenterCost>0</dropCenterCost>
      <liftCapacity>2000</liftCapacity>
      <volume>17</volume>
      <lenght>4</lenght>
      <width>2.1</width>
      <height>2.1</height>
   </data>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
metadataobjectSystem information
metadata.statusintegerEmulated status http-code. If successful, code 200 is returned
metadata.generated_atstring

Server response date and time.

Format: YYYY-MM-DD HH:MM:SS

dataarray of DataHourly rental details
data.citystring

City

data.categoryIdintegerVehicle category ID
data.categorystring

Vehicle category name

Possible values:

  • "Борт" - flatbed truck ;
  • "Борт (Манипулятор)" - flatbed truck with crane;
  • "Тент" - tent/van;
  • "Тент/Фургон" - tent/van;
  • "Фургон" - van
data.minOrderTimefloatMinimum order time, h
data.vehDeliveryTimefloatVehicle arrival time, h
data.aroundCityfloatRental price within the city, rubles per hour
data.kilometerCostOutfloatCost per kilometer outside of the city, rubles
data.manipulatorbooleanFlag indicating that crane is available
data.manipulatorCostfloatCrane truck price, rubles
data.tentRemovalbooleanFlag indicating that removable curtains are available
data.tentRemovalCostfloatRemovable curtains price, rubles
data.dropCenterbooleanFlag indicating that it is possible to enter the city center
data.dropCenterCostfloatCost of entering the city center, rubles
data.liftCapacityfloatVehicle carrying capacity, kg
data.volumefloatVehicle volume, m3
data.lengthfloatVehicle length, m
data.widthfloatVehicle width, m
data.heightfloatVehicle height, m

Error handling

The common API errors are used with the method, for errors format description and errors list see Errors of API methods.