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

API
Главная / API - Возможные даты выполнения заявки

Возможные даты выполнения заявки

Обновлено 23.10.2020
184 кб

Общие сведения

Сервис позволяет получить список возможных дат выполнения заявки на доставку от адреса отправителя/до адреса получателя. Проверка возможных дат выполнения заявки на доставку от адреса доступна неавторизованным пользователям, в то время как для проверки возможных дат выполнения заявки на доставку до адреса необходима авторизация.

Возможные даты выполнения заявки на доставку от адреса

Запрос метода

Пример запроса

Адрес метода: 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":{
            "street":"7500000100005430000000000",
            "house":"3",
            "building":"2",
            "structure":"4",
            "flat":"1"
         },
         "city":"8900000700000000000000000",
         "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
   }
}

Адрес метода: 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>
            <street>7500000100005430000000000</street>
            <house>3</house>
            <building>2</building>
            <structure>4</structure>
            <flat>1</flat>
         </address>
         <city>8900000700000000000000000</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>

Описание параметров

Request
Request
ПараметрОбязательныйТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
sessionIDНетstringID сессии. Для получения сессии необходимо воспользоваться методом "Авторизация пользователя"
deliveryДаobjectИнформация о доставке
delivery.deliveryTypeДаDeliveryTypeИнформация о виде межтерминальной перевозки груза
delivery.derivalДаDerival

Информация о доставке от адреса отправителя

cargoДаobjectИнформация о грузе
cargo.quantityНетinteger

Количество грузовых мест, шт. Значение по умолчанию - "1"

*Если вид перевозки груза - "письмо" ("request.delivery.deliveryType.type" = "letter"), то переданное значение параметра игнорируется, используется значение "1"
cargo.weightНет*float

Вес самого тяжелого грузового места, кг

*Параметр является обязательным, если количество грузовых мест больше одного ("cargo.quantity" > 1). В противном случае значение параметра принимается равным значению параметра "cargo.totalWeight".
Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.5"
cargo.heightДа*float

Высота самого высокого грузового места, м

*Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.01"
cargo.widthДа*float

Ширина самого широкого грузового места, м

*Если вид перевозки груза - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.21"
cargo.lengthДа*float

Длина самого длинного грузового места, м

*Если вид перевозки груза - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.3"
cargo.totalVolumeДа*float

Общий объём груза, м3

*Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.001"
cargo.totalWeightДа*float

Общий вес груза, кг

*Если вид доставки - "письмо" ("request.delivery.deliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, используется значение "0.5"

DeliveryType
DeliveryType
ПараметрОбязательныйТипОписание

type

Даstring

Вид межтерминальной перевозки.

Возможные значения:

  • "auto"- автодоставка;
  • "express" - экспресс-доставка;
  • "letter" - письмо;
  • "avia" - авиадоставка;
  • "small" - доставка малогабаритного груза
Малогабаритный груз - это груз, параметры которого не превышают следующие значения:
  • масса меньше либо равна 10 кг;
  • Д*Ш*В меньше либо равны 0,54*0,39*0,39 м;
  • объём меньше либо равен 0,1 куб. м.
Заказ услуги "Доставка малогабаритного груза" возможен только в случае, если в городах отправки и получения есть подразделения компании "Деловые Линии", более подробную информацию см. на сайте компании

Derival
Derival
ПараметрОбязательныйТипОписание
addressIDНет*integer

ID адреса из "Адресной книги"

*В запросе обязательно должен присутствовать один из взаимоисключающих параметров: "addressID", "address" или "city"
addressНет*object

Адрес

*В запросе обязательно должен присутствовать один из взаимоисключающих параметров: "addressID", "address" или "city"
address.streetДаstringКод КЛАДР улицы (см. "Справочник улиц")
address.houseНет

string

Номер дома, включая литеру. Например, "13/А".

Максимум 7 символов

address.buildingНетstring

Корпус.

Максимум 5 символов

address.structureНетstring

Строение.

Максимум 7 символов

address.flatНетstring

Номер квартиры/офиса. Допускается написание с буквой, например "222 А".

Максимум 5 символов

cityНет*string

Код КЛАДР населенного пункта. Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР"

*В запросе обязательно должен присутствовать один из взаимоисключающих параметров: "addressID", "address" или "city"
timeНетobjectИнформация о времени прибытия водителя-экспедитора
time.exactTimeНетboolean

Флаг, обозначающий, что необходимо забрать груз у отправителя точно в указанное время.

Значение по умолчанию: "false"

handlingНетobjectИнформация о погрузо-разгрузочных работах
handling.freightLiftНетboolean

Флаг, обозначающий, что есть грузовой лифт.

Значение по умолчанию: "false"

handling.toFloorНетinteger

Номер этажа, c которого необходимо спустить груз

handling.carryНетintegerРасстояние, на которое необходимо перенести груз (в метрах)
requirementsНетarray of strings

Массив UID видов погрузки/дополнительных требований к транспорту.

Возможные значения:

  • 0xb83b7589658a3851440a853325d1bf69 - боковая погрузка;
  • 0xabb9c63c596b08f94c3664c930e77778 - верхняя погрузка;
  • 0x92fce2284f000b0241dad7c2e88b1655 - гидроборт (грузоподъёмная платформа);
  • 0x88f93a2c37f106d94ff9f7ada8efe886 - манипулятор (подъёмное устройство);
  • 0x9951e0ff97188f6b4b1b153dfde3cfec - открытая машина;
  • 0x818e8ff1eda1abc349318a478659af08 - растентовка (снятие тента с автомобиля)

Ответ метода

Пример ответа

{
   "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"
      ]
   }
}
<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>
   </data>
</response>

Описание параметров

Response
Response
ПараметрТипОписание
metadataobjectСистемная информация
metadata.statusintegerЭмуляция http-кода состояния. В случае успешного выполнения возвращается код "200" (OK)
metadata.generated_atstring

Дата и время генерации ответа сервера.

Формат: "ГГГГ-ММ-ДД ЧЧ:ММ:СС"

dataobjectИнформация о возможных датах выполнения заявки
data.datesarray of strings

Список возможных дат выполнения заявки.

Формат: "ГГГГ-ММ-ДД"

Обработка ошибок

В методе используются общие ошибки API, описание формата и перечень ошибок см. в документе "Ошибки методов API".

Возможные даты выполнения заявки на доставку до адреса

Запрос метода

Пример запроса

Адрес метода: 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":{
            "street":"7500000100005430000000000",
            "house":"3",
            "building":"2",
            "structure":"4",
            "flat":"1"
         },
         "city":"8900000700000000000000000",
         "time":{
            "exactTime":true
         },
         "handling":{
            "freightLift":true,
            "toFloor":10,
            "carry":100
         },
         "requirements":[
            "0xabb9c63c596b08f94c3664c930e77778",
            "0x88f93a2c37f106d94ff9f7ada8efe886",
            "0x818e8ff1eda1abc349318a478659af08",
            "0xb83b7589658a3851440a853325d1bf69",
            "0x92fce2284f000b0241dad7c2e88b1655",
            "0x9951e0ff97188f6b4b1b153dfde3cfec"
         ]
      }
   }
}

Адрес метода: 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>
            <street>7500000100005430000000000</street>
            <house>3</house>
            <building>2</building>
            <structure>4</structure>
            <flat>1</flat>
         </address>
         <city>8900000700000000000000000</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>

Описание параметров

Request
Request
ПараметрОбязательныйТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
sessionIDДаstringID сессии. Для получения сессии необходимо воспользоваться методом "Авторизация пользователя"
docIDДаstringНомер заказа, накладной или заявки, по которой необходимо получить список возможных дат доставки до адреса получателя
deliveryДаobjectИнформация о доставке
delivery.arrivalДаArrival

Информация о доставке до адреса получателя. Допускается передача пустого объекта

Arrival
Arrival
ПараметрОбязательныйТипОписание
addressIDНетinteger

ID адреса из "Адресной книги"

Позволяет получить возможные даты доставки до адреса, отличного от указанного в накладной. Допускается передача только одного из следующих параметров: "addressID", "address" или "city"
addressНетobject

Адрес

Позволяет получить возможные даты доставки до адреса, отличного от указанного в накладной. Допускается передача только одного из следующих параметров: "addressID", "address" или "city"
address.streetДаstringКод КЛАДР улицы (см. "Справочник улиц")
address.houseДа

string

Номер дома, включая литеру. Например, "13/А".

Максимум 7 символов

address.buildingНетstring

Корпус.

Максимум 5 символов

address.structureНетstring

Строение.

Максимум 7 символов

address.flatНетstring

Номер квартиры/офиса. Допускается написание с буквой, например "222 А".

Максимум 5 символов

cityНетstring

Код КЛАДР населенного пункта. Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР"

Позволяет получить возможные даты доставки до населённого пункта, отличного от указанного в накладной. Допускается передача только одного из следующих параметров: "addressID", "address" или "city"
timeНетobjectИнформация о времени доставки
time.exactTimeНетboolean

Флаг, обозначающий, что необходима доставка точно в указанное время.

Значение по умолчанию: "false"

handlingНетobjectИнформация о погрузо-разгрузочных работах
handling.freightLiftНетboolean

Флаг, обозначающий, что есть грузовой лифт.

Значение по умолчанию: "false"

handling.toFloorНетinteger

Номер этажа, на который необходимо поднять груз

handling.carryНетintegerРасстояние, на которое необходимо перенести груз (в метрах)
requirementsНетarray of strings

Массив UID видов погрузки/дополнительных требований к транспорту.

Возможные значения:

  • 0xb83b7589658a3851440a853325d1bf69 - боковая погрузка;
  • 0xabb9c63c596b08f94c3664c930e77778 - верхняя погрузка;
  • 0x92fce2284f000b0241dad7c2e88b1655 - гидроборт (грузоподъёмная платформа);
  • 0x88f93a2c37f106d94ff9f7ada8efe886 - манипулятор (подъёмное устройство);
  • 0x9951e0ff97188f6b4b1b153dfde3cfec - открытая машина;
  • 0x818e8ff1eda1abc349318a478659af08 - растентовка (снятие тента с автомобиля)

Ответ метода

Ответ метода "Возможные даты выполнения заявки на доставку до адреса" аналогичен ответу метода "Возможные даты выполнения заявки на доставку от адреса".

Обработка ошибок

В методе используются общие ошибки API, описание формата и перечень ошибок см. в документе "Ошибки методов API".