Процесс создания заказа (Технический)
Проверка необходимости выбора типа курьера
Перед созданием заказа система проверяет, известен ли тип курьера.
- Тип неизвестен: Выполняется запрос:
/v2/client/{clientId}/delivery_order/courier_types— Получение списка типов курьераМетод возвращает список доступных типов курьеров на основе габаритов и веса груза.
Для создания заказа обязательно необхимо передать тип курьера в "requirements":
- Тип известен: Переход к формированию параметров заказа.
Формирование параметров заказа
Для создания заказа передаются следующие параметры:
- Центр затрат (ЦЗ): Это сущность для раздельного учёта затрат и разграничения видимости заказов по точкам.
- Точки маршрута (
RoutePoints):- Тип точки: отгрузка, доставка, возврат.
- Координаты и текстовый адрес или идентификатор адреса.
- Комментарий к точке.
- Контакты на адресе (имя и номер телефона).
- Флаг необходимости SMS-кода подтверждения на точке.
- Данные о грузах (
Items): Внешний идентификатор заказа (номер заказа покупателя), индексы точек изRoutePoints, наименование, объявленная ценность, вес, габариты, количество. - Автоматическое подтверждение: Флаг
auto_confirm:true/false.
Отправка заявки на создание
Выполняется POST-запрос с собранными параметрами:
POST/v2/client/{clientId}/delivery_order— Создание заказа на доставкуЗаказ успешно создан. API возвращает id заказа и все переданные данные.
Заказу присваивается статус: new.