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

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

Cost calculation and ordering

Обновлено 16.07.2018
89 кб

General information

This service allows you to get the data from the directiories that are used for cost calculation and ordering.

All methods from this section have the same structure of requests and responses:

Method request

Request example

{
   "appkey": "00000000-0000-0000-000000000000"
}
<request>
   <appkey>00000000-0000-0000-000000000000</appkey>
</request>

Description of parameters

Request
ParameterR*TypeDescription
appkeyYesstringApplication key. To get the key, register

Method response

Response example

{
   "hash": "1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4",
   "url": "https://api.dellin.ru/catalog/[filename].csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434"
}
<response>
   <hash>1707aea20f301fd0a8787b5a68608dd6cf270347ea04c266f1b4c6aa540088a4</hash>
   <url>https://api.dellin.ru/catalog/[filename].csv?sk=Kn0OtWJcumDYUqRjtCEvhg&e=1401285434</url>
</response>

Description of parameters

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).

Instead of "[filename]" the value of this parameter contains the file name that matches the keyword in the name of the corresponding method.

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

Directory of Special Requirements for Transport

NOTICE. This directory is used to calculate the cost (method: v1/public/calculator, parameters: "derivalServices" and "arrivalServices") and to order delivery to the address (method: v1/customers/sfrequest, parameter: "additionalOptions").

Method address for the request in JSON format: https://api.dellin.ru/v1/public/services.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/services.xml

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

  • UID — unique service identifier;
  • name — service name.

Directory of available packages

NOTICE. This directory is used to calculate the cost (method: v1/public/calculator, parameter: "packages").

Method address for the request in JSON format: https://api.dellin.ru/v1/public/packages.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/packages.xml

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

  • id — unique package identifier;
  • description — package name.

Directory of Additional Services

NOTICE. This directory is used to process an order (method: v1/customers/request, parameter: "additionalServices").

Method address for the request in JSON format: https://api.dellin.ru/v1/public/request_services.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/request_services.xml

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.

Directory of Shipping Types

NOTICE. This directory is used to process an order (method: v1/customers/request, parameter: "deliveryType").

Method address for the request in JSON format: https://api.dellin.ru/v1/public/request_delivery_types.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/request_delivery_types.xml

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

  • id — unique shipping type identifier;
  • description — shipping type name.

Directory of Payer Types

NOTICE. This directory is used to process an order (method: v1/customers/request, parameter: "whoIsPayer").

Method address for the request in JSON format: https://api.dellin.ru/v1/public/payer_types.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/payer_types.xml

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

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

Directory of Payment Types

Method address for the request in JSON format: https://api.dellin.ru/v1/public/payment_types.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/payment_types.xml

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

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

Directory of Vehicle Loading Types

Method address for the request in JSON format: https://api.dellin.ru/v1/public/load_types.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/load_types.xml

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

  • id — unique identifier of vehicle loading type;
  • name — name of loading type.

Directory of Vehicle Loading/Unloading Services

Method address for the request in JSON format: https://api.dellin.ru/v1/public/load_params.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/load_params.xml

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.

Information for ordering an hourly rent

Method address for the request in JSON format: https://api.dellin.ru/v1/public/hourly_rent_info.json

Method address for the request in XML format: https://api.dellin.ru/v1/public/hourly_rent_info.xml

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

  • City;
  • Category;
  • Minimum order time;
  • Vehicle delivery time;
  • Around the city, rub/h;
  • Cost of one kilometer outside the city;
  • Manipulator;
  • Manipulator, cost;
  • Tent removal;
  • Tent removal, cost;
  • Going to the center;
  • Going to the center, cost;
  • Lifting capacity, kg;
  • Volume;
  • Length;
  • Width;
  • Height.