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

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

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

Обновлено 21.10.2019
98 кб

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

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

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

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

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

Адрес метода: https://api.dellin.ru/v1/public/produce_date.json

{  
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sizedVolume":"1",
   "sizedWeight":"1",
   "derivalPoint":"7800000000000000000000000",
   "deliveryType":"1",
   "produceDate":"2016-04-20",
   "derivalDoor":true,
   "derivalPeriodVisit":{  
      "workStart":"10:00",
      "workEnd":"15:00"
   },
   "oversizedWeight":"100",
   "oversizedVolume":"100",
   "length":"1",
   "width":"1",
   "height":"1"
}

Адрес метода: https://api.dellin.ru/v1/public/produce_date.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sizedvolume>1</sizedvolume>
   <sizedweight>1</sizedweight>
   <derivalpoint>7800000000000000000000000</derivalpoint>
   <deliverytype>1</deliverytype>
   <producedate>2016-04-20</producedate>
   <derivaldoor>true</derivaldoor>
   <derivalperiodvisit>
      <workstart>10:00</workstart>
      <workend>15:00</workend>
   </derivalperiodvisit>
   <oversizedweight>100</oversizedweight>
   <oversizedvolume>100</oversizedvolume>
   <length>1</length>
   <width>1</width>
   <height>1</height>
</request>

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

Request
ПараметрR*ТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
sizedVolumeНетstringГабаритный объем, кг
sizedWeightНет
stringГабаритный вес, кг
derivalPointДаstring

Код КЛАДР пункта отправления груза. Может быть указан код КЛАДР города или улицы.

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

deliveryTypeДаstringID вида доставки. Указывается на основании "Справочника видов доставки"
produceDateДаstringЖелаемая дата доставки, ГГГГ-ММ-ЧЧ
derivalDoorНетbooleanПризнак доставки от адреса
derivalPeriodVisitНетobjectПериод передачи груза на адресе отправления
derivalPeriodVisit.workStartНет*string

Время начала передачи груза, ЧЧ:ММ

*Параметр обязателен, если передан параметр "derivalPeriodVisit.workEnd"

derivalPeriodVisit.workEndНет*string

Время окончания передачи груза, ЧЧ:ММ

*Параметр обязателен, если передан параметр "derivalPeriodVisit.workStart"

oversizedWeightНетstringНегабаритный вес, кг
oversizedVolumeНетstringНегабаритный объем, кг
lengthНетstringДлина груза, м
widthНетstringШирина груза, м
heightНетstringВысота груза, м

Ответ метода

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

{  
   "available":[  
      {  
         "date":"2016-04-23"
      },
      {  
         "date":"2016-04-24"
      },
      {  
         "date":"2016-04-25"
      },
      {  
         "date":"2016-04-26"
      },
      {  
         "date":"2016-04-27"
      },
      {  
         "date":"2016-04-28"
      }
   ],
   "default_date":"2016-04-25",
   "produce_available":false
}
<response>
   <available>
      <date>2016-04-23</date>
   </available>
   <available>
      <date>2016-04-24</date>
   </available>
   <available>
      <date>2016-04-25</date>
   </available>
   <available>
      <date>2016-04-26</date>
   </available>
   <available>
      <date>2016-04-27</date>
   </available>
   <available>
      <date>2016-04-28</date>
   </available>
   <default_date>2016-04-25</default_date>
   <produce_available>false</produce_available>
</response>

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

Response
ПараметрТипОписание
availablearray of Response.AvailableМассив возможных дат выполнения заявки
default_datestringДата по умолчанию для пользователя
produce_availablebooleanДоступность выбранной даты выполнения заявки

Response.Available
ПараметрТипОписание
datestring

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

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

Если в запросе передан параметр "derivalPeriodVisit.workStart", но не передан параметр "derivalPeriodVisit.workEnd", или наоборот, тогда будет выведено сообщение об ошибке следующего вида с указанием недостающего параметра:

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

{
   "errors": {
      "derivalPeriodVisit": {
         "workEnd": "Требуется"
      }
   }
}
<response>
   <errors>
      <derivalPeriodVisit>
         <workEnd>Требуется</workEnd>
      </derivalPeriodVisit>
   </errors>
</response>

Если одновременно выполняются следующие условия:

  • значение "derivalPeriodVisit.workStart" превышает или равно значению "derivalPeriodVisit.workEnd",
  • значение "derivalPeriodVisit.workStart" не превышает 20:00 или значение "derivalPeriodVisit.workEnd" равно или превышает 20:00,

тогда будет выведено следующее сообщение:

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

{
   "errors":{
      "derivalPeriodVisit":"Период указан неверно"
   }
}
<response>
   <errors>
      <derivalPeriodVisit>Период указан неверно</derivalPeriodVisit>
   </errors>
</response>

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

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

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

Адрес метода: https://api.dellin.ru/v1/public/produce_date_sf.json

{  
   "appkey":"00000000-0000-0000-0000-000000000000",
   "orderID":45345345,
   "arrivalPoint":"7800000000000000000000000",
   "produceDate":"2016-04-20",
   "arrivalPeriodVisit":{  
      "workStart":"10:00",
      "workEnd":"15:00",
      "breakStart":"11:00",
      "breakEnd":"12:00"
   }
}

Адрес метода: https://api.dellin.ru/v1/public/produce_date_sf.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <orderid>45345345</orderid>
   <arrivalpoint>7800000000000000000000000</arrivalpoint>
   <producedate>2016-04-20</producedate>
   <arrivalperiodvisit>
      <workstart>10:00</workstart>
      <workend>15:00</workend>
      <breakstart>11:00</breakstart>
      <breakend>12:00</breakend>
   </arrivalperiodvisit>
</request>

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

Request
ПараметрR*ТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
orderIDДаintegerНомер заказа (заявки, накладной) из "Журнала заказов"
arrivalPointНет
string

Код КЛАДР пункта прибытия груза. Может быть указан код КЛАДР города или улицы.

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

produceDateДаstringЖелаемая дата доставки, ГГГГ-ММ-ЧЧ
arrivalPeriodVisitНетobjectПериод доставки до адреса
arrivalPeriodVisit.workStartНетstringВремя начала доставки, ЧЧ:ММ
arrivalPeriodVisit.workEndНетstringВремя окончания доставки, ЧЧ:ММ
arrivalPeriodVisit.breakStartНет*string

Время начала перерыва, ЧЧ:ММ

*Параметр обязателен, если передан параметр "arrivalPeriodVisit.breakEnd"

arrivalPeriodVisit.breakEndНет*string

Время окончания перерыва, ЧЧ:ММ

*Параметр обязателен, если передан параметр "arrivalPeriodVisit.breakStart"

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