Создание запроса производится в два действия.
Получение данных для формирования нового запроса
GET /api/v1/tender/create
Детальную информацию по получаемым данным, можно получить в документации метода:
/api/docs/ui/index#!/Tender/Tender_Create
Из полученных списков юр.лиц, контрагентов и их сотрудников, можно выбрать необходимых и использовать их идентификаторы при заполнении запроса на создание.
Отправка заполненного запроса в систему
POST /api/v1/tender/create
Детальную информацию по передаваемым параметрам можно получить в документации метода:
/api/docs/ui/index#!/Tender/Tender_Create_0
Например:
В результате работы метода возвращается уникальный идентификатор созданного запроса (по которому, в дальнейшем, можно получать детальную информацию и статус запроса) или ошибку.
Внимание!
Для корректного создания запроса, необходимо указать, как минимум, две точки маршрута (Loading - погрузка и Unloading - разгрузка) и примерное расстояние между ними.
Если расстояние неизвестно заранее, то можно указать 0 или пропустить параметр Distance, тогда система осуществит попытку автоматически найти заданные адреса и рассчитать маршрут.
В случае неудачи, запрос вернет код 400 с комментарием "невозможно проложить маршрут" и предложением "уточнить точки маршрута".
Это можно сделать, обратившись к методам раздела Взаимодействие с геосервисами:
- Прямое геокодирование - поможет узнать, возможно ли, распознавание конкретного адреса
- Поиск и уточнение адреса - поможет найти более точные альтернативы для введенного адреса
- Расчет параметров маршрута - может построить и рассчитать маршрут между точками, а так же укажет на каком этапе возникает проблема