Процесс создания заказа (Технический)
Проверка необходимости выбора типа курьера
Перед созданием заказа система проверяет, известен ли тип курьера.
- Тип неизвестен: Выполняется запрос:
/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.
Если при создании заказа был передано значение Даты - времени в поле deferred_till и переданная дата - время позже времени создания заказа, то заказ перейдет в статус pending, что означает “ожидание” даты времени указанном в поле.