Проверка ограничений
Общие сведения
Метод позволяет получить информацию об ограничениях и возможных значениях параметров в зависимости от условий заказа.
Ниже представлено описание всех параметров метода, в соответствующем разделе можно найти примеры запросов и ответов.
Ограничения по параметрам заказа
Запрос метода
Структура запроса
Адрес метода: 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 | Список дополнительных услуг (предоставление которых может быть ограничено из-за условий заказа) по которым необходима информация. Доступные значения:
Если параметр отсутствует или передан пустой массив, то в ответе будет присутствовать информация по всем услугам |
| derivalPoint | Да | string | Код КЛАДР пункта отправки груза. Может быть указан код КЛАДР города или улицы. Код КЛАДР может быть получен с помощью сервисов, представленных на странице "Поиск КЛАДР" |
| arrivalPoint | Да | string | Код КЛАДР пункта прибытия груза. Может быть указан код КЛАДР города или улицы. Код КЛАДР может быть получен с помощью сервисов, представленных на странице "Поиск КЛАДР" |
| volume | Да | float | Объем груза, куб. м. |
| weight | Да | float | Вес груза, кг |
| derivalTerminalID | Нет | integer | ID терминала отправки груза из "Справочника терминалов" |
| arrivalTerminalID | Нет | integer | ID терминала выдачи груза из "Справочника терминалов" |
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_day | object | Информация об ограничениях передачи груза водителю-экспедитору на адресе отправителя в день заказа |
| day_to_day.same_day_pickup_ends_at | string | Время, до которого можно заказать услугу передачи груза водителю-экспедитору в день заказа, ЧЧ:ММ:СС |
| day_to_day.minimal_pickup_period | integer | Минимальная продолжительность интервала приезда водителя-экспедитора, ч (У клиента есть возможность указать, с какого по какое время должен приехать водитель, данный интервал не должен быть меньше значения параметра) |
| day_to_day.same_day_pickup_allowed | boolean | Признак возможности передачи груза водителю-экспедитору в день заказа |
| day_to_day.terminal_id | integer | ID терминала отправки груза (см. "Справочника терминалов") |
| day_to_day.minimal_same_day_pickup_period | integer | Минимальная продолжительность интервала приезда водителя-экспедитора при передаче груза в день заказа, ч (У клиента есть возможность указать, с какого по какое время должен приехать водитель, при передаче груза водителю-экспедитору в день заказа данный интервал не должен быть меньше значения параметра) |
| packages | array of Response.Packages | Информация об упаковках, доступных с учётом указанных условий перевозки |
| loadings | object | Доступные виды погрузки/дополнительные опции при погрузке |
| loadings.recipient | array of strings | Массив UID видов погрузки/дополнительных опций, доступные получателю. Возможные значения:
|
| loadings.sender | array of strings | Массив UID видов погрузки/дополнительных опций, доступных отправителю Возможные значения, см. в описании параметра "response.loadings.recipient". |
insurance | object | Информация об услуге "Страхование срока доставки" |
insurance.term_insurance_available | integer | Информация о доступности услуги страхования срока доставки. Возможные значения:
|
| Response.Packages | ||
|---|---|---|
| Параметр | Тип | Описание |
| incompatible_uids | array of strings | Массив UID упаковок, несовместимых с видом, UID которого передан в параметре "response.packages.uid" (см. "Справочник видов упаковки") |
| uid | string | UID упаковки (см. "Справочник видов упаковки") |
