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

API
Главная / API - Интервалы передачи груза

Интервалы передачи груза

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

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

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

Интервалы передачи груза на адресе отправителя

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

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

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

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "delivery":{
      "deliveryType":{
         "type":"auto"
      },
      "derival":{
         "produceDate":"2020-06-03",
         "addressID":3357,
         "address":{
            "street":"7500000100005430000000000",
            "house":"3",
            "building":"2",
            "structure":"4",
            "flat":"1"
         },
         "city":"8900000700000000000000000"
      }
   }
}

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

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

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

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

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

type

Даstring

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

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

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

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

Дата передачи груза водителю-экспедитору на адресе отправителя

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

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"

Ответ метода

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

{
   "metadata":{
      "status":200,
      "generated_at":"2020-06-30 06:33:53"
   },
   "data":{
      "interval_from":"00:00:00",
      "interval_to":"23:59:00",
      "default_min_same_day_period":6,
      "min_same_day_period":2,
      "min_period":0,
      "same_day":false
   }
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2020-06-03 09:06:54</generated_at>
   </metadata>
   <data>
		<interval_from>00:00:00</interval_from>
		<interval_to>23:59:00</interval_to>
		<default_min_same_day_period>6</default_min_same_day_period>
		<min_same_day_period>2</min_same_day_period>
		<min_period>0</min_period>
		<same_day>false</same_day>
   </data>
</response>

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

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

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

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

dataobjectДанные интервала передачи груза на адресе отправителя/получателя (у клиента есть возможность указать, с какого по какое время должен приехать водитель-экспедитор, данный объект содержит информацию по допустимым параметрам интервала)

data.interval_from

string

Допустимое начало интервала

Формат: "ЧЧ:ММ:СС"

data.interval_to

string

Допустимый конец интервала

Формат: "ЧЧ:ММ:СС"

data.default_min_same_day_periodinteger

Стандартная продолжительность интервала в случае приезда экспедитора в день оформления заказа, ч 

data.min_same_day_periodinteger

Минимальная продолжительность интервала в случае приезда экспедитора в день оформления заказа, ч

data.min_periodinteger

Минимальная продолжительность интервала, ч

data.same_daybooleanФлаг, обозначающий, что можно назначить приезд экспедитора на день оформления заказа

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

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

Интервалы передачи груза на адресе получателя

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

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

Адрес метода: https://api.dellin.ru/v2/request_delivery/address/time_interval.json

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "docID":"2000085063763",
   "delivery":{
      "arrival":{
         "produceDate":"2020-06-03",
         "addressID":3357,
         "address":{
            "street":"7500000100005430000000000",
            "house":"3",
            "building":"2",
            "structure":"4",
            "flat":"1"
         },
         "city":"8900000700000000000000000"
      }
   }
}

Адрес метода: https://api.dellin.ru/v2/request_delivery/address/time_interval.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sessionID>00000000-0000-0000-0000-000000000000</sessionID>
   <docID>2000085063763</docID>
   <delivery>
      <arrival>
         <produceDate>2020-06-03</produceDate>
         <addressID>3357</addressID>
         <address>
            <street>7500000100005430000000000</street>
            <house>3</house>
            <building>2</building>
            <structure>4</structure>
            <flat>1</flat>
         </address>
         <city>8900000700000000000000000</city>
      </arrival>
   </delivery>
</request>

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

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

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

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

Дата доставки груза до адреса получателя

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

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"

Ответ метода

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

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

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