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

API
Главная / API - Подбор даты отправки

Подбор даты отправки

Обновлено 03.02.2023
Скачать в PDF
180 кб
Содержание:

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

Сервис позволяет получить список возможных дат передачи груза водителю-экспедитору на адресе отправителя или же дат сдачи груза на терминал при оформлении заявки при помощи метода "Перевозка сборных грузов". Сервис доступен как авторизованным, так и неавторизованным пользователям.

Даты отправки от адреса

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

Структура запроса

Адрес метода: 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
   }
}

Адрес метода: 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>

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

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" - доставка малогабаритного груза
Малогабаритный груз - это груз, параметры которого не превышают следующие значения:
  • масса меньше либо равна 30 кг;
  • Д*Ш*В меньше либо равны 0,54*0,39*0,39 м;
  • объём меньше либо равен 0,1 куб. м.
Заказ услуги "Доставка малогабаритного груза" возможен только в случае, если в городах отправки и получения есть подразделения компании "Деловые Линии", более подробную информацию см. на сайте компании

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

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

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

Адрес

*В запросе обязательно должен присутствовать один из взаимоисключающих параметров: "addressID", "address" или "city"
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 - растентовка (снятие тента с автомобиля)

Address

Address

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

search

Нет (1)string

Адрес в виде произвольной строки.

Адрес может быть передан в виде текста или координат.

При передаче адреса в виде текста, помимо собственно адреса, в запрос следует включать наименование населённого пункта, элементы необходимо указывать через запятую, например, "Омск, Ленина, 5".

Координаты также указываются через запятую, первое число - широта, например, "59.924501, 30.241762".

Минимум 2 символа, максимум - 1024 (2)

streetНет (1)stringКод КЛАДР улицы (см. "Поиск КЛАДР") (2)
houseНет (1)string

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

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

buildingНетstring

Корпус (2).

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

structureНетstring

Строение (2).

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

flatНетstring

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

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

Примечания:

  1. Обязательно должен быть передан адрес - в виде произвольное строки ("search") или набора параметров (в этом случае обязательными являются параметры "street" и "house"). 
  2. Передача параметра "search" исключает передачу параметров "street", "house", "building" и "structure", но допускает передачу параметра "flat" (в этом случае в качестве номера квартиры/офиса будет использоваться значение параметра "flat")

Ответ метода

Структура ответа

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

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

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

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

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

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

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

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

data.foundAddressesarray of FoundAddressesДанные по найденным адресам. Параметр присутствует в ответе, только если в запросе был передан параметр "search" класса "Address"

FoundAddresses
FoundAddresses
ПараметрТипОписание
fieldstringОбъект, в котором был передан параметр "search"
sourcestring

Введённое значение

resultstring

Найденный адрес

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

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

Даты отправки от терминала

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

Структура запроса

Адрес метода: https://api.dellin.ru/v2/request/terminal/dates.json

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "delivery":{
      "derival":{
         "terminalID":310
      }
   }
}

Адрес метода: https://api.dellin.ru/v2/request/terminal/dates.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sessionID>00000000-0000-0000-0000-000000000000</sessionID>
   <delivery>
      <derival>
         <terminalID>310</terminalID>
      </derival>
   </delivery>
</request>

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

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

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

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

ID терминала из "Справочника терминалов"

Ответ метода

Структура ответа

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

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

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

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

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

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

Список дат, в которые возможна сдача груза на терминал.

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

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

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