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

API
Главная / API - Ограничения по параметрам заказа

Ограничения по параметрам заказа

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

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

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

Ниже представлено описание всех параметров метода, в соответствующем разделе можно найти примеры запросов и ответов. 

Ограничения по параметрам заказа

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

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

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

{  
   "appkey":"00000000-0000-0000-0000-000000000000",
   "blocks":[  
      "day_to_day",
      "packages",
      "loadings",
      "insurance"
   ],
   "derivalPoint":"1000000100000000000000000",
   "arrivalPoint":"7700000000000000000000000",
   "volume":"3",
   "weight":"1",
   "derivalTerminalID":122,
   "arrivalTerminalID":325,
   "deliveryType":1,
   "derivalDoor":true,
   "arrivalDoor":true
}

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

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <blocks>day_to_day</blocks>
   <blocks>packages</blocks>
   <blocks>loadings</blocks>
   <blocks>insurance</blocks>
   <derivalpoint>1000000100000000000000000</derivalpoint>
   <arrivalpoint>7700000000000000000000000</arrivalpoint>
   <volume>3</volume>
   <weight>1</weight>
   <derivalTerminalID>122</derivalTerminalID>
   <arrivalTerminalID>325</arrivalTerminalID>
   <deliveryType>1</deliveryType>
   <derivalDoor>true</derivalDoor>
   <arrivalDoor>true</arrivalDoor>
</request>

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

Request
ПараметрОбязательныйТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию

blocks

Даarray of strings

Список дополнительных услуг (предоставление которых может быть ограничено из-за условий заказа) по которым необходима информация.

Доступные значения:

  • "day_to_day" - возможность передать груз водителю-экспедитору на адресе отправителя в день заказа;
  • "packages" - доступные упаковки (аналогично методу "Список доступных упаковок при заданных параметрах");
  • "loadings" - доступные виды погрузки/дополнительные опции при погрузке;
  • "insurance" - услуга "Страхование срока доставки"
Если параметр отсутствует или передан пустой массив, то в ответе будет присутствовать информация по всем услугам
derivalPointДаstring

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

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

arrivalPointДаstring

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

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

volumeДаstringОбъем груза, куб. м.
weightДаstringВес груза, кг
derivalTerminalIDНетintegerID терминала отправки груза из "Справочника терминалов"
arrivalTerminalIDНетintegerID терминала выдачи груза из "Справочника терминалов"

deliveryType

Да

integer

ID вида доставки из "Справочника видов доставки"

derivalDoor

Нет

boolean

Признак заказа доставки от адреса.

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

arrivalDoor

Нет

boolean

Признак заказа доставки до адреса.

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

Ответ метода

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

{  
   "day_to_day":{  
      "same_day_pickup_ends_at":"16:00:00",
      "minimal_pickup_period":4,
      "same_day_pickup_allowed":true,
      "terminal_id":58,
      "minimal_same_day_pickup_period":4
   },
   "packages":[  
      {  
         "incompatible_uids":[  
            "0x8783b183e825d40d4eb5c21ef63fbbfb",
            "0xb9f594d27a2d31b440a647d19547543c"
         ],
         "uid":"0x838fc70baeb49b564426b45b1d216c15"
      },
      {  
         "incompatible_uids":[  

         ],
         "uid":"0x951783203a254a05473c43733c20fe72"
      },
      {  
         "incompatible_uids":[  
            "0x84f7578779ae4a444e3dfc8b96d80e08"
         ],
         "uid":"0x9a7f11408f4957d7494570820fcf4549"
      },
      {  
         "incompatible_uids":[  

         ],
         "uid":"0xa8b42ac5ec921a4d43c0b702c3f1c109"
      },
      {  
         "incompatible_uids":[  

         ],
         "uid":"0xad22189d098fb9b84eec0043196370d6"
      },
      {  
         "incompatible_uids":[  
            "0x9195b45e731fd4bd44c3157f2e23b33f"
         ],
         "uid":"0xbaa65b894f477a964d70a4d97ec280be"
      }
   ],
   "loadings":{  
      "recipient":[  
         "0xb83b7589658a3851440a853325d1bf69",
         "0xabb9c63c596b08f94c3664c930e77778",
         "0x92fce2284f000b0241dad7c2e88b1655",
         "0x88f93a2c37f106d94ff9f7ada8efe886",
         "0x9951e0ff97188f6b4b1b153dfde3cfec",
         "0x818e8ff1eda1abc349318a478659af08"
      ],
      "sender":[  
         "0xb83b7589658a3851440a853325d1bf69",
         "0xabb9c63c596b08f94c3664c930e77778",
         "0x92fce2284f000b0241dad7c2e88b1655",
         "0x88f93a2c37f106d94ff9f7ada8efe886",
         "0x9951e0ff97188f6b4b1b153dfde3cfec",
         "0x818e8ff1eda1abc349318a478659af08"
      ]
   },
   "insurance":{
      "term_insurance_available":1
   }
}
<response>
   <day_to_day>
      <same_day_pickup_ends_at>16:00:00</same_day_pickup_ends_at>
      <minimal_pickup_period>4</minimal_pickup_period>
      <same_day_pickup_allowed>true</same_day_pickup_allowed>
      <terminal_id>58</terminal_id>
      <minimal_same_day_pickup_period>4</minimal_same_day_pickup_period>
   </day_to_day>
   <packages>
      <incompatible_uids>0x8783b183e825d40d4eb5c21ef63fbbfb</incompatible_uids>
      <incompatible_uids>0xb9f594d27a2d31b440a647d19547543c</incompatible_uids>
      <uid>0x838fc70baeb49b564426b45b1d216c15</uid>
   </packages>
   <packages>
      <uid>0x951783203a254a05473c43733c20fe72</uid>
   </packages>
   <packages>
      <incompatible_uids>0x84f7578779ae4a444e3dfc8b96d80e08</incompatible_uids>
      <uid>0x9a7f11408f4957d7494570820fcf4549</uid>
   </packages>
   <packages>
      <uid>0xa8b42ac5ec921a4d43c0b702c3f1c109</uid>
   </packages>
   <packages>
      <uid>0xad22189d098fb9b84eec0043196370d6</uid>
   </packages>
   <packages>
      <incompatible_uids>0x9195b45e731fd4bd44c3157f2e23b33f</incompatible_uids>
      <uid>0xbaa65b894f477a964d70a4d97ec280be</uid>
   </packages>
   <loadings>
      <recipient>0xb83b7589658a3851440a853325d1bf69</recipient>
      <recipient>0xabb9c63c596b08f94c3664c930e77778</recipient>
      <recipient>0x92fce2284f000b0241dad7c2e88b1655</recipient>
      <recipient>0x88f93a2c37f106d94ff9f7ada8efe886</recipient>
      <recipient>0x9951e0ff97188f6b4b1b153dfde3cfec</recipient>
      <recipient>0x818e8ff1eda1abc349318a478659af08</recipient>
      <sender>0xb83b7589658a3851440a853325d1bf69</sender>
      <sender>0xabb9c63c596b08f94c3664c930e77778</sender>
      <sender>0x92fce2284f000b0241dad7c2e88b1655</sender>
      <sender>0x88f93a2c37f106d94ff9f7ada8efe886</sender>
      <sender>0x9951e0ff97188f6b4b1b153dfde3cfec</sender>
      <sender>0x818e8ff1eda1abc349318a478659af08</sender>
   </loadings>
   <insurance>
      <term_insurance_available>1</term_insurance_available>
   </insurance>
</response>

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

Response
ПараметрТипОписание
day_to_dayobjectИнформация об ограничениях передачи груза водителю-экспедитору на адресе отправителя в день заказа
day_to_day.same_day_pickup_ends_atstringВремя, до которого можно заказать услугу передачи груза водителю-экспедитору в день заказа, ЧЧ:ММ:СС
day_to_day.minimal_pickup_periodinteger

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

(У клиента есть возможность указать, с какого по какое время должен приехать водитель, данный интервал не должен быть меньше значения параметра)

day_to_day.same_day_pickup_allowedbooleanПризнак возможности передачи груза водителю-экспедитору в день заказа
day_to_day.terminal_idintegerID терминала отправки груза (см. "Справочника терминалов")
day_to_day.minimal_same_day_pickup_periodinteger

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

(У клиента есть возможность указать, с какого по какое время должен приехать водитель, при передаче груза водителю-экспедитору в день заказа данный интервал не должен быть меньше значения параметра)

packagesarray of Response.PackagesИнформация об упаковках, доступных с учётом указанных условий перевозки
loadingsobjectДоступные виды погрузки/дополнительные опции при погрузке
loadings.recipientarray of strings

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

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

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

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

Возможные значения, см. в описании параметра "response.loadings.recipient".

insurance

object

Информация об услуге "Страхование срока доставки"

insurance.term_insurance_available

integer

Информация о доступности услуги страхования срока доставки.

Возможные варианты:

  • "1" - Услуга доступна для заказа/Доступен отказ от услуги;
  • "2" - Услуга недоступна для заказа/Отказ от услуги недоступен;
  • "3" - Отказ от услуги недоступен

Response.Packages
ПараметрТипОписание
incompatible_uidsarray of strings

Массив UID упаковок, несовместимых с видом, UID которого передан в параметре "response.packages.uid" (см. "Справочник доступных упаковок")

uidstringUID упаковки (см. "Справочник доступных упаковок")