Подготовить справочники, адреса и узловые точки для заказа

Статья обновлена November 12, 2026

Стенд по умолчанию — test. Только чтение. Порядок работы для агента.

Получите значения для сценария Создать заказ на перевозку. Для запросов нужны действующий доступ к API и доступ к соответствующим справочникам и геосервисам.

Получить коды справочников

Запрашивайте справочники, нужные для полей заказа. Передавайте полученные коды в исходном виде.

Уточнить место

  1. Для подсказок по адресу вызовите GET /api/geocoder/yaProxy/v1. Передайте текст адреса в параметре строки запроса geocode. Смотрите варианты в data.response.GeoObjectCollection.featureMember. Если подходит несколько вариантов, уточните адрес у пользователя.
  2. Чтобы найти заведённую узловую точку, проверьте право can_exp_create_nodal_point в выбранной организации и вызовите POST /api/nodalPoint/suggestWithGeoDataByAddress/v0 с адресом в data.address и идентификатором организации в data.forwarderId. Без forwarderId метод не ищет заведённые точки. Выберите вариант в data.foundAddresses с заполненным nodalPoint. Если такого варианта нет, сообщите, что заведённая точка не найдена.