Possible order completion dates

Обновлено 12.11.2020

185 кб

General information

The service allows getting the list of possible completion dates for orders for shipping from the sender's address/delivery to the receiver's address. Unauthorized users can check possible dates of shipping from the senders's address, meanwhile checking the dates of delivery to the receiver's address is available only to authorized users.

Possible completion dates for orders for shipping from the sender's address

Method request

Method address: https://api.dellin.ru/v2/request/address/dates.json

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "delivery":{
      "deliveryType":{
         "type":"auto"
      },
      "derival":{
         "addressID":3357,
         "address":{
            "search":"Омск, Ленина, 5",
            "street":"5500000100005970000000000",
            "house":"5",
            "building":"1",
            "structure":"4",
            "flat":"1"
         },
         "city":"5500000100000000000000000",
         "time":{
            "exactTime":true
         },
         "handling":{
            "freightLift":true,
            "toFloor":10,
            "carry":100
         },
         "requirements":[
            "0xabb9c63c596b08f94c3664c930e77778",
            "0x88f93a2c37f106d94ff9f7ada8efe886",
            "0x818e8ff1eda1abc349318a478659af08",
            "0xb83b7589658a3851440a853325d1bf69",
            "0x92fce2284f000b0241dad7c2e88b1655",
            "0x9951e0ff97188f6b4b1b153dfde3cfec"
         ]
      }
   },
   "cargo":{
      "quantity":4,
      "weight":12,
      "height":1,
      "width":1,
      "length":1,
      "totalVolume":1,
      "totalWeight":12
   }
}

Method address: https://api.dellin.ru/v2/request/address/dates.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sessionID>00000000-0000-0000-0000-000000000000</sessionID>
   <delivery>
      <deliveryType>
         <type>auto</type>
      </deliveryType>
      <derival>
         <addressID>3357</addressID>
         <address>
            <search>Омск, Ленина, 5</search>
            <street>5500000100005970000000000</street>
            <house>5</house>
            <building>1</building>
            <structure>4</structure>
            <flat>1</flat>
         </address>
         <city>5500000100000000000000000</city>
         <time>
            <exactTime>true</exactTime>
         </time>
         <handling>
            <freightLift>true</freightLift>
            <toFloor>10</toFloor>
            <carry>100</carry>
         </handling>
         <requirements>0xabb9c63c596b08f94c3664c930e77778</requirements>
         <requirements>0x88f93a2c37f106d94ff9f7ada8efe886</requirements>
         <requirements>0x818e8ff1eda1abc349318a478659af08</requirements>
         <requirements>0xb83b7589658a3851440a853325d1bf69</requirements>
         <requirements>0x92fce2284f000b0241dad7c2e88b1655</requirements>
         <requirements>0x9951e0ff97188f6b4b1b153dfde3cfec</requirements>
      </derival>
   </delivery>
   <cargo>
      <quantity>4</quantity>
      <weight>12</weight>
      <height>1</height>
      <width>1</width>
      <length>1</length>
      <totalVolume>1</totalVolume>
      <totalWeight>12</totalWeight>
   </cargo>
</request>

Description of parameters

Request

Request
Parameter	Required	Type	Description
appkey	Yes	string	Application key. To get the key, register
sessionID	No	string	To get the session ID, use the User Authorization method
delivery	Yes	object	Information on delivery
delivery.deliveryType	Yes	DeliveryType	Information on type of terminal-to-terminal shipping
delivery.derival	Yes	Derival	Information on shipping from sender's the address
cargo	Yes	object	Cargo details
cargo.quantity	No	integer	Quantity of cargo places, pcs. Default value: 1 *If the shipping type is "letter" ("request.delivery.deliveryType.type" = "letter"), then the parameter is not required, passed value is ignored, the parameter takes the value "1"
cargo.weight	No*	float	Weight of the heaviest cargo place, kg *If quantity of the cargo places ("cargo.quantity" parameter value) is more than 1, then the parameter is required. Otherwise, the parameter takes the value of "cargo.totalWeight" parameter. If the shipping type is "letter" ("request.delivery.deliveryType.type" = "letter"), then the parameter is not required, passed value is ignored, the parameter takes the value "0.5"
cargo.height	Yes*	float	Height of the highest cargo place, m *If the shipping type is "letter" ("request.delivery.deliveryType.type" = "letter"), then the parameter is not required, passed value is ignored, the parameter takes the value "0.01"
cargo.width	Yes*	float	Width of the widest cargo place, m *If the shipping type is "letter" ("request.delivery.deliveryType.type" = "letter"), then the parameter is not required, passed value is ignored, the parameter takes the value "0.21"
cargo.length	Yes*	float	Length of the longest cargo place, m *If the shipping type is "letter" ("request.delivery.deliveryType.type" = "letter"), then the parameter is not required, passed value is ignored, the parameter takes the value "0.3"
cargo.totalVolume	Yes*	float	Total cargo volume, m3 If the shipping type is "letter" ("request.delivery.deliveryType.type" = "letter"), then the parameter is not required, passed value is ignored, the parameter takes the value "0.001"
cargo.totalWeight	Yes*	float	Total cargo weight, kg *If the shipping type is "letter" ("request.delivery.deliveryType.type" = "letter"), then the parameter is not required, passed value is ignored, the parameter takes the value "0.5"

DeliveryType

DeliveryType
Parameter	Required	Type	Description
type	Yes	string	Shipping type. Possible values: auto- by truck; express; letter; avia; small - shipping of small-size cargo. 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.540.390.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

Derival

Derival
Parameter	Required	Type	Description
addressID	No*	integer	Address ID from "Address book" *One of the excluding parameters is required: "addressID", "address" or "city"
address	No*	Address	Address data *One of the excluding parameters is required: "addressID", "address" or "city"
city	No*	string	City CLADR code. To get CLADR code use the services listed on Using CLADR codes page *One of the excluding parameters is required: "addressID", "address" or "city"
time	No	object	Information on pickup time
time.exactTime	No	boolean	Flag indicating that picked up at precise time is required. Default value: false
handling	No	object	Information on loading and unloading works
handling.freightLift	No	boolean	Flag indicating that there is a service lift. Default value: false
handling.toFloor	No	integer	Number of the floor from which the cargo is to be carried downstairs
handling.carry	No	integer	Distance to which the cargo is to be carried, m
requirements	No	array of strings	UIDs of loading types/additional requirements to the truck. Possible values: 0xb83b7589658a3851440a853325d1bf69 - side loading; 0xabb9c63c596b08f94c3664c930e77778 - top loading; 0x92fce2284f000b0241dad7c2e88b1655 - tail lift; 0x88f93a2c37f106d94ff9f7ada8efe886 - crane; 0x9951e0ff97188f6b4b1b153dfde3cfec - open vehicle; 0x818e8ff1eda1abc349318a478659af08 - removable curtains

Address

Address
Parameter	Required	Type	Description
search	No (1)	string	Address as a string. Minimum 2 symbols, maximum 1024 (2)
street	No (1)	string	CLADR* code of the street (see. "Streets directory") (2). *CLADR - Classifier of Addresses of Russian Federation
house	No (1)	string	House number, including the letter. For example, "13/A" (2). Maximum 7 characters
building	No	string	Building (2). Maximum 5 characters
structure	No	string	Structure (2). Maximum 7 characters
flat	No	string	Apartment/office, including the letter. For example, "222 A" (2). Maximum 5 characters
Notes: Address information must be passed in the request therefore either "search" parameter is required or "street" and "house" parameters are required. If "search" parameter is passed in the request, then "street", "house", "building", "structure" or "flat" parameters must not be passed in the request

Method response

Response example

JSON
XML

{
   "metadata":{
      "status":200,
      "generated_at":"2020-06-03 09:06:54"
   },
   "data":{
      "dates":[
         "2020-06-04",
         "2020-06-05",
         "2020-06-06",
         "2020-06-07",
         "2020-06-08",
         "2020-06-09",
         "2020-06-10",
         "2020-06-11",
         "2020-06-12",
         "2020-06-13",
         "2020-06-14",
         "2020-06-15",
         "2020-06-16",
         "2020-06-17",
         "2020-06-18",
         "2020-06-19",
         "2020-06-20",
         "2020-06-21",
         "2020-06-22",
         "2020-06-23",
         "2020-06-24",
         "2020-06-25",
         "2020-06-26",
         "2020-06-27",
         "2020-06-28",
         "2020-06-29",
         "2020-06-30",
         "2020-07-01",
         "2020-07-02",
         "2020-07-03",
         "2020-07-04",
         "2020-07-05",
         "2020-07-06",
         "2020-07-07",
         "2020-07-08",
         "2020-07-09",
         "2020-07-10",
         "2020-07-11",
         "2020-07-12",
         "2020-07-13",
         "2020-07-14",
         "2020-07-15",
         "2020-07-16",
         "2020-07-17",
         "2020-07-18",
         "2020-07-19",
         "2020-07-20",
         "2020-07-21",
         "2020-07-22",
         "2020-07-23",
         "2020-07-24",
         "2020-07-25",
         "2020-07-26",
         "2020-07-27",
         "2020-07-28",
         "2020-07-29",
         "2020-07-30",
         "2020-07-31",
         "2020-08-01",
         "2020-08-02"
      ],
      "foundAddresses": [
         {
            "field": "delivery.derival.address",
            "source": "Омск, Ленина, 5",
            "result": "Россия, Омская обл, г Омск, ул Ленина, д 5"
         }
      ]
   }
}

<response>
   <metadata>
      <status>200</status>
      <generated_at>2020-06-03 09:06:54</generated_at>
   </metadata>
   <data>
      <dates>2020-06-04</dates>
      <dates>2020-06-05</dates>
      <dates>2020-06-06</dates>
      <dates>2020-06-07</dates>
      <dates>2020-06-08</dates>
      <dates>2020-06-09</dates>
      <dates>2020-06-10</dates>
      <dates>2020-06-11</dates>
      <dates>2020-06-12</dates>
      <dates>2020-06-13</dates>
      <dates>2020-06-14</dates>
      <dates>2020-06-15</dates>
      <dates>2020-06-16</dates>
      <dates>2020-06-17</dates>
      <dates>2020-06-18</dates>
      <dates>2020-06-19</dates>
      <dates>2020-06-20</dates>
      <dates>2020-06-21</dates>
      <dates>2020-06-22</dates>
      <dates>2020-06-23</dates>
      <dates>2020-06-24</dates>
      <dates>2020-06-25</dates>
      <dates>2020-06-26</dates>
      <dates>2020-06-27</dates>
      <dates>2020-06-28</dates>
      <dates>2020-06-29</dates>
      <dates>2020-06-30</dates>
      <dates>2020-07-01</dates>
      <dates>2020-07-02</dates>
      <dates>2020-07-03</dates>
      <dates>2020-07-04</dates>
      <dates>2020-07-05</dates>
      <dates>2020-07-06</dates>
      <dates>2020-07-07</dates>
      <dates>2020-07-08</dates>
      <dates>2020-07-09</dates>
      <dates>2020-07-10</dates>
      <dates>2020-07-11</dates>
      <dates>2020-07-12</dates>
      <dates>2020-07-13</dates>
      <dates>2020-07-14</dates>
      <dates>2020-07-15</dates>
      <dates>2020-07-16</dates>
      <dates>2020-07-17</dates>
      <dates>2020-07-18</dates>
      <dates>2020-07-19</dates>
      <dates>2020-07-20</dates>
      <dates>2020-07-21</dates>
      <dates>2020-07-22</dates>
      <dates>2020-07-23</dates>
      <dates>2020-07-24</dates>
      <dates>2020-07-25</dates>
      <dates>2020-07-26</dates>
      <dates>2020-07-27</dates>
      <dates>2020-07-28</dates>
      <dates>2020-07-29</dates>
      <dates>2020-07-30</dates>
      <dates>2020-07-31</dates>
      <dates>2020-08-01</dates>
      <dates>2020-08-02</dates>
      <foundAddresses>
         <field>delivery.derival.address</field>
         <source>Омск, Ленина, 5</source>
         <result>Россия, Омская обл, г Омск, ул Ленина, д 5</result>
      </foundAddresses>
   </data>
</response>

Description of parameters

Response

Response
Parameter	Type	Description
metadata	object	System information
metadata.status	integer	Emulated status http-code. If successful, code 200 is returned
metadata.generated_at	string	Server response date and time. Format: YYYY-MM-DD HH:MM:SS
data	object	Information on possible dates of order completion
data.dates	array of strings	A list of possible dates of order completion Format: YYYY-MM-DD
data.foundAddresses	array of FoundAddresses	Data on found addresses. The parameter is present in the response if "search" parameter of the "Address" class was passed in the request

FoundAddresses

FoundAddresses
Parameter	Type	Description
field	string	The parent object that was used to pass the "search" parameter
source	string	Entered value
result	string	Address found

Error handling

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

Possible completion dates for orders for delivery to the receiver's address

Method request

Request example

JSON
XML

Method address: https://api.dellin.ru/v2/request_delivery/address/dates.json

{   
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "docID":"2000085063763",
   "delivery":{
      "arrival":{
         "addressID":3357,
         "address":{
            "search":"Омск, Ленина, 5",
            "street":"5500000100005970000000000",
            "house":"5",
            "building":"1",
            "structure":"4",
            "flat":"1
         },
         "city":"5500000100000000000000000",
         "time":{
            "exactTime":true
         },
         "handling":{
            "freightLift":true,
            "toFloor":10,
            "carry":100
         },
         "requirements":[
            "0xabb9c63c596b08f94c3664c930e77778",
            "0x88f93a2c37f106d94ff9f7ada8efe886",
            "0x818e8ff1eda1abc349318a478659af08",
            "0xb83b7589658a3851440a853325d1bf69",
            "0x92fce2284f000b0241dad7c2e88b1655",
            "0x9951e0ff97188f6b4b1b153dfde3cfec"
         ]
      }
   }
}

Method address: https://api.dellin.ru/v2/request_delivery/address/dates.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sessionID>00000000-0000-0000-0000-000000000000</sessionID>
   <docID>2000085063763</docID>
   <delivery>
      <arrival>
         <addressID>3357</addressID>
         <address>
            <search>Омск, Ленина, 5</search>
            <street>5500000100005970000000000</street>
            <house>5</house>
            <building>1</building>
            <structure>4</structure>
            <flat>1</flat>
         </address>
         <city>5500000100000000000000000</city>
         <time>
            <exactTime>true</exactTime>
         </time>
         <handling>
            <freightLift>true</freightLift>
            <toFloor>10</toFloor>
            <carry>100</carry>
         </handling>
         <requirements>0xabb9c63c596b08f94c3664c930e77778</requirements>
         <requirements>0x88f93a2c37f106d94ff9f7ada8efe886</requirements>
         <requirements>0x818e8ff1eda1abc349318a478659af08</requirements>
         <requirements>0xb83b7589658a3851440a853325d1bf69</requirements>
         <requirements>0x92fce2284f000b0241dad7c2e88b1655</requirements>
         <requirements>0x9951e0ff97188f6b4b1b153dfde3cfec</requirements>
      </arrival>
   </delivery>
</request>

Description of parameters

Request

Request
Parameter	Required	Type	Description
appkey	Yes	string	Application key. To get the key, register
sessionID	Yes	string	To get the session ID, use the User Authorization method
docID	Yes	string	Number of order, waybill or order for shipping for which it is necessary to receive the list of possible dates of delivery to the receiver's address
delivery	Yes	object	Information on delivery
delivery.arrival	Yes	Arrival	Information on delivery to the receiver's address. An empty object can be passed

Arrival

Arrival
Parameter	Required	Type	Description
addressID	No	integer	Address ID from "Address book" Allows getting the list of possible completion dates in case of delivery to the address different from the one indicated in the waybill. Only one of the following parameters can be passed: "addressID", "address" or "city"
address	No	Address	Address data Allows getting the list of possible completion dates in case of delivery to the address different from the one indicated in the waybill. Only one of the following parameters can be passed: "addressID", "address" or "city"
city	No	string	City CLADR code. To get CLADR code use the services listed on Using CLADR codes page Allows getting the list of possible completion dates in case of delivery to the city different from the one indicated in the waybill. Only one of the following parameters can be passed: "addressID", "address" or "city"
time	No	object	Information on delivery time
time.exactTime	No	boolean	Flag indicating that delivery at precise time is required. Default value: false
handling	No	object	Information on loading and unloading works
handling.freightLift	No	boolean	Flag indicating that there is a service lift. Default value: false
handling.toFloor	No	integer	Number of the floor to which the cargo is to be carried
handling.carry	No	integer	Distance to which the cargo is to be carried, m
requirements	No	array of strings	UIDs of loading types/additional requirements to the truck. Possible values: 0xb83b7589658a3851440a853325d1bf69 - side loading; 0xabb9c63c596b08f94c3664c930e77778 - top loading; 0x92fce2284f000b0241dad7c2e88b1655 - tail lift; 0x88f93a2c37f106d94ff9f7ada8efe886 - crane; 0x9951e0ff97188f6b4b1b153dfde3cfec - open vehicle; 0x818e8ff1eda1abc349318a478659af08 - removable curtains

Address

Address
Parameter	Required	Type	Description
search	No (1)	string	Address as a string. Minimum 2 symbols, maximum 1024 (2)
street	No (1)	string	CLADR* code of the street (see. "Streets directory") (2). *CLADR - Classifier of Addresses of Russian Federation
house	No (1)	string	House number, including the letter. For example, "13/A" (2). Maximum 7 characters
building	No	string	Building (2). Maximum 5 characters
structure	No	string	Structure (2). Maximum 7 characters
flat	No	string	Apartment/office, including the letter. For example, "222 A" (2). Maximum 5 characters
Notes: Address information must be passed in the request therefore either "search" parameter is required or "street" and "house" parameters are required. If "search" parameter is passed in the request, then "street", "house", "building", "structure" or "flat" parameters must not be passed in the request

Method response

Response of the method "Possible completion dates for orders for delivery to the receiver's address" is similar to the response of the method "Possible completion dates for orders for shipping from sender's address".

Error handling

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

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

Possible order completion dates

General information

Possible completion dates for orders for shipping from the sender's address

Method request

Request example

Description of parameters

Request

DeliveryType

Derival

Address

Method response

Response example

Description of parameters

Response

FoundAddresses

Error handling

Possible completion dates for orders for delivery to the receiver's address

Method request

Request example

Description of parameters

Request

Arrival

Address

Method response

Error handling