Перейти к основному содержимому

Автоматический поиск слотов поставки

Модуль: 5.8 · Бронировщик поставок

Что это​

Задание на бронирование описывает поставку, которую вы хотите оформить: склад, желаемую дату (с допуском в днях), тип поставки и объём. По такому заданию Optima сама следит за появлением свободных слотов приёмки на складах Wildberries — вам не нужно постоянно обновлять страницу планирования вручную. Вы управляете жизненным циклом задания и видите всю историю его изменений.

Как пользоваться​

  1. Создайте задание — укажите кабинет, склад, желаемую дату и допустимое отклонение (± дней), тип (короб или монопаллета) и количество. Задание появляется в статусе «черновик».

  2. Запустите поиск — задание переходит «в поиск», и Optima начинает отслеживать доступные слоты по вашим условиям:

    POST /booking/tasks/<id>/start

  3. Остановите или измените задание в любой момент, пока оно активно:

    POST /booking/tasks/<id>/stop      # с необязательной причиной
    PATCH /booking/tasks/<id>          # изменить склад, дату, объём и т.п.

  4. Смотрите историю и список. История хранит все переходы статусов задания; список заданий можно фильтровать по статусу:

    GET /booking/tasks/<id>/history
    GET /booking/tasks?status=searching

Как это работает​

Optima опрашивает публичный тарифный API приёмки Wildberries в рамках безопасных лимитов и отмечает слоты, подходящие вашему заданию по складу, типу поставки и дате (± допуск). При появлении подходящего слота происходит два действия:

  1. Вы получаете уведомление со ссылкой на экран планирования поставки в личном кабинете Wildberries — остаётся подтвердить бронирование. Уведомления доступны в общей ленте; на одно задание приходит одно уведомление (без спама).
  2. Задание автоматически переходит в статус «забронировано» и снимается с поиска — Optima больше не тратит проверки на это задание, а факт находки фиксируется в истории задания (когда и на каком складе нашёлся слот).

Так задание не «зависает» в поиске после того, как слот уже найден, а повторные проверки и уведомления по нему не дублируются.

Ограничения​

  • Само бронирование слота выполняется в личном кабинете Wildberries. Optima находит подходящий слот и ведёт задание, но финальное подтверждение делает продавец. Статус «забронировано» означает, что слот найден и передан вам для подтверждения, — а не что бронь уже оформлена на стороне Wildberries. Полностью автоматическое бронирование в текущей версии не поставляется.
  • Частота проверки ограничена правилами Wildberries — примерно раз в 10–15 секунд на кабинет, а не «каждую секунду».
  • Доступность слота определяется правилами WB: бесплатная или платная приёмка при разрешённой выгрузке.
  • Менять и останавливать можно только активное задание (черновик или в поиске); забронированные и остановленные задания неизменяемы.