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