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

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

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

Обновлено 22.01.2018
74 кб

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

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

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

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

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

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

{  
   "appkey":"00000000-0000-0000-000000000000",
   "blocks":[  
      "dayinday",
      "packages",
      "loadings"
   ],
   "derivalPoint":"1000000100000000000000000",
   "arrivalPoint":"7700000000000000000000000",
   "volume":"3",
   "weight":"1",
   "derivalTerminalID": 122,
   "arrivalTerminalID": 325
}

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

<request>
   <appkey>00000000-0000-0000-000000000000</appkey>
   <blocks>dayinday</blocks>
   <blocks>packages</blocks>
   <blocks>loadings</blocks>
   <derivalpoint>1000000100000000000000000</derivalpoint>
   <arrivalpoint>7700000000000000000000000</arrivalpoint>
   <volume>3</volume>
   <weight>1</weight>
   <derivalTerminalID>122</derivalTerminalID>
   <arrivalTerminalID>325</arrivalTerminalID>
</request>

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

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

blocks

Даarray of strings

Список информационных блоков по ограничениям.

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

Если параметр отсутствует или список пустой, то подразумевается, что запрошены все блоки

derivalPointДаstring

Код КЛАДР пункта отправки груза/пункта прибытия груза. Заполняется на основании данных справочника "КЛАДР". Формат кода - беззнаковое целое число длиной 25 символов. Если код региона начинается с нуля, тогда длина кода будет равна 24 символам (в API не используется ведущий ноль). Если код региона меньше 25 символов, необходимо справа дополнить его нужным количеством нулей.

Определить код КЛАДР нужного населенного пункта можно с помощью нашего сервиса. Также можно получить таблицу с кодами КЛАДР в формате, полностью совместимом с API Деловых линий, обратившись к "Справочнику населенных пунктов"

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

Ответ метода

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

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

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

Response
ПараметрТипОписание
dayindayobjectИнформация по ограничениям по выдаче груза день в день
dayinday.same_day_pickup_ends_atstringМаксимальное время возможности заказа выдачи груза день в день, ЧЧ:ММ:СС
dayinday.minimal_pickup_periodintegerМинимальный интервал забора, ч - ограничение для формы выбора фиксированного времени забора для общих случаев формирования заявки, если дата НЕ сегодняшняя
dayinday.same_day_pickup_allowedbooleanПризнак возможности заказа выдачи груза день в день
dayinday.terminal_idintegerИдентификатор терминала, относящегося к данному КЛАДР (актуально для нетерминальных городов)
dayinday.minimal_same_day_pickup_periodintegerМинимальный интервал забора день в день, ч - ограничение для формы выбора фиксированного времени забора для случая, когда возможен забор день в день и выбрана сегодняшняя дата
packagesarray of Response.PackagesИнформация по ограничениям по упаковке
loadingsobjectИнформация о доступных услугах по спец. требованиям (по погрузке)
loadings.recipientarray of stringsМассив UID способов загрузки машины, доступных получателю
loadings.senderarray of stringsМассив UID способов загрузки машины, доступных отправителю

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

Массив UID несовместимых упаковок

uidstringUID упаковок, доступных на указанных терминалах/адресах отправки и доставки