Заказы DBS

Модель продаж DBS

Витрина (DBS) и Витрина Экспресс (EDBS) — модели продаж в Wildberries, когда продавец хранит товары на собственном складе и своими силами доставляет товары покупателям. Сайт Wildberries в этом случае используется как витрина для товаров продавца.

Витрину ещё называют Доставка силами продавца (DBS — Delivery by Seller), а Витрину экспресс — Доставка силами продавца — экспресс (EDBS — Express Delivery by Seller). Витрина экспресс (EDBS) подразумевает более быструю доставку: заказы покупателям нужно доставлять в пределах 4 часов. По модели Витрина (DBS) доставка может занимать от 5 часов до 35 дней.

Модели DBS и EDBS дают больше гибкости, но требуют строгого соблюдения сроков и качества доставки. Через WB API вы можете автоматизировать обновление статусов заказов. Таким образом вы сократите риск ошибок и повысите скорость доставки. Это критично для удержания карточки товара на высоких позициях в поиске и улучшения опыта покупателей.

---

Выполнение заказа по модели DBS

Чтобы выполнить заказ по модели DBS, соблюдайте порядок действий:

Шаг 1. Получить ID нового сборочного задания

После того как покупатель оформил заказ на товар, продавец получает сборочное задание и выполняет по нему заказ. Если покупатель заказал несколько товаров одновременно, продавец получит несколько сборочных заданий.

Сборочное задание — это единица заказанного товара, которую необходимо подготовить для отправки покупателю. Сборочное задание содержит информацию о заказе. Например, товар нужно упаковать и отгрузить, сколько времени прошло с момента поступления заказа, куда нужно доставить товар.

Для обработки заказа DBS получите ID сборочного задания — orderId в списке новых сборочных заданий, в методе GET /api/v3/dbs/orders/new. 

Метод вернет информацию о сборочных заданиях со статусом new — новое. Сборочные задания в этом статусе еще не были взяты в работу.

Шаг 2. Перевести сборочное задание на сборку

Переведите сборочное задание в статус confirm — на сборке. Для этого используйте метод PATCH /api/v3/dbs/orders/{orderId}/confirm. В URL запроса передайте ID сборочного задания orderId из шага 1.

Шаг 3. Получить информацию о покупателе

После сборки и упаковки товара вам нужно связаться с покупателем для доставки заказа. Чтобы получить контакты покупателя: имя, фамилию и номер телефона — используйте метод POST /api/v3/dbs/orders/client.

Шаг 4. Передать сборочное задание в доставку

Когда вы соберете заказ, упакуете товар и получите контактные данные покупателя, вы можете передать сборочное задание в доставку. Для этого переведите сборочное задание в статус deliver — в доставке — с помощью метода PATCH /api/v3/dbs/orders/{orderId}/deliver.

Шаг 5. Выполнить и закрыть сборочное задание

Когда вы доставите заказ покупателю, покупатель может принять заказ или отказаться от него.

1. Если покупатель оставил заказ себе, переведите заказ в статус receive — получено покупателем. Для этого используйте метод PATCH /api/v3/dbs/orders/{orderId}/receive. Для работы метода нужен код подтверждения, который покупатель сообщит курьеру в момент получения заказа.
2. Если покупатель отказался от получения заказа, переведите заказ в статус reject — отказ при получении. Для этого используйте метод PATCH /api/v3/dbs/orders/{orderId}/reject. Для работы метода нужен код подтверждения, который покупатель сообщит курьеру в момент получения заказа.

Полезные ссылки в справочном центре:

• Как работать с заказами

---

Получение сборочных заданий DBS

Сборочное задание — это единица заказанного товара, которую необходимо подготовить для отправки покупателю. Сборочное задание содержит информацию о заказе: какой товар нужно упаковать и отгрузить, сколько времени прошло с момента поступления заказа, куда нужно доставить товар и так далее.

Вы можете автоматизировать обработку сборочных заданий с помощью WB API и получать списки:

1. Новых сборочных заданий.
   Если вам нужно получить список сборочных заданий, которые еще не были взяты в работу, используйте метод GET /api/v3/dbs/orders/new. На момент выполнения API-запроса у этих сборочных заданий будет статус new — новое. Метод будет полезен при сборке новых заказов и подготовке товаров к отправке.
2. Завершенных сборочных заданий.
   Если вам нужно получить список сборочных заданий, завершенных после получения или отмены заказа, используйте метод GET /api/v3/dbs/orders. Метод позволяет получить данные за заданный период, максимум 30 календарных дней. Он может пригодиться, например, для анализа выполненных заказов.

Методы списков сборочных заданий не возвращают статусы сборочных заданий в явном виде. Используйте метод POST /api/v3/dbs/orders/status, чтобы получать:

• supplierStatus — статусы, которые меняет сам продавец.
• wbStatus — статусы в системе Wildberries.

В запросе данного метода укажите ID сборочных заданий orderId, для которых нужно получить статус — до 1000 ID в одном запросе. ID сборочных заданий можно получить с помощью методов списков новых и завершенных сборочных заданий. 

Полезные ссылки в справочном центре:

• Сборочные задания

---

Управление статусами сборочных заданий DBS

После того, как покупатель оформил заказ на товар, продавец получает сборочное задание и выполняет по нему заказ. На любом этапе заказа у сборочного задания будет в какой-либо статус. При модели DBS некоторые статусы сборочных заданий может менять сам продавец.

С помощью WB API вы можете автоматизировать изменение статуса сборочного задания для:

• Перевода сборочного задания на сборку.
  Для сборки и обработки заказа сборочное задание нужно перевести в статус confirm — на сборке. Сделать это можно с помощью метода PATCH /api/v3/dbs/orders/{orderId}/confirm.
• Перевода сборочного задания в доставку.
  После того, как товар собран и упакован, его можно передавать в доставку. Для этого сборочное задание необходимо перевести в статус deliver — в доставке. Чтобы это сделать, воспользуйтесь методом PATCH /api/v3/dbs/orders/{orderId}/deliver
• Отмены сборочного задания продавцом.
  Чтобы отменить сборочное задание по инициативе продавца и перевести сборочное задание в статус cancel — отменено продавцом, воспользуйтесь методом PATCH /api/v3/dbs/orders/{orderId}/cancel
• Завершения заказов, когда:
  • Покупатель принял заказ.
    Если покупатель оставил заказ себе, заказ нужно перевести в статус receive — получено покупателем. Для этого используйте метод PATCH /api/v3/dbs/orders/{orderId}/receive. Для работы метода нужен код подтверждения, который покупатель сообщит курьеру в момент получения заказа.
  • Покупатель отказался от заказа.
    Если покупатель отказался от получения заказа, заказ нужно перевести в статус reject — отказ при получении. Для этого используйте метод PATCH /api/v3/dbs/orders/{orderId}/reject. Для работы метода нужен код подтверждения, который покупатель сообщит курьеру в момент получения заказа.

Для каждого метода из этого подраздела вам нужно указать ID сборочного задания orderId в URL запроса. ID сборочных заданий можно получить с помощью методов из кейса по получению сборочных заданий DBS.

Полезные ссылки в справочном центре:

• Как работать с заказами

---

Метаданные сборочных заданий DBS

Метаданные сборочных заданий — это дополнительная информация о товарах, которая используется для идентификации и отслеживания продукции на каждом этапе её жизненного цикла. При работе с Wildberries метаданные играют ключевую роль в обеспечении прозрачности и соблюдения законодательных требований, особенно в отношении маркировки товаров.

С помощью методов API вы можете:

• Получать метаданные сборочного задания — GET /api/v3/dbs/orders/{orderId}/meta.
  В ответе метода вы получите метаданные, доступные для сборочного задания: код маркировки, УИН, IMEI, GTIN. Если ответ вернулся пустым, значит у сборочного задания нет метаданных и добавить их нельзя.
• Закреплять за сборочным заданием код маркировки товара — PUT /api/v3/dbs/orders/{orderId}/meta/sgtin.
  Код маркировки товара — уникальный код, которым маркируется каждая единица товара. Код маркировки получают в национальной системе цифровой маркировки РФ Честный знак. На сайте Честного знака можно проверить актуальный список товаров, которые нужно маркировать, а также узнать, как получить код маркировки на свои товары. У одного сборочного задания может быть несколько кодов маркировки.
• Закреплять за сборочным заданием УИН — PUT /api/v3/dbs/orders/{orderId}/meta/uin.
  УИН (Уникальный Идентификационный Номер) — уникальный код ювелирного изделия. Его используют для учёта ювелирных изделий и их маркировки. УИН получают в системе ГИИС ДМДК. Одно сборочное задание может иметь только один УИН.
• Закреплять за сборочным заданием IMEI — PUT /api/v3/dbs/orders/{orderId}/meta/imei.
  IMEI (International Mobile Equipment Identity) — международный идентификатор мобильного оборудования, например, смартфона или планшета, который присваивает производитель. У некоторых устройств IMEI может отсутствовать. Одно сборочное задание может иметь только один IMEI.
• Закреплять за сборочным заданием GTIN — PUT /api/v3/dbs/orders/{orderId}/meta/gtin.
  GTIN (Global Trade Item Number) — глобальный идентификационный номер товара в международной торговле. Обычно GTIN наносится на упаковку товара в виде штрихкода. Также его можно найти в документации от производителя или в базах данных GS1 — международной организации, которая регулирует стандарты идентификации товаров. Одно сборочное задание может иметь только один GTIN.
• Удалять метаданные сборочного задания — DELETE /api/v3/dbs/orders/{orderId}/meta.
  Одним запросом вы можете удалить значение только одного вида метаданных: код маркировки, УИН, IMEI или GTIN.

Полезные ссылки в справочном центре:

• Маркировка товаров и поставок. Баркод, ШК, КИЗ, УИН

 

Получение информации о покупателе

При модели DBS продавцу могут потребоваться контакты покупателя, чтобы связаться с ним во время и после выполнения заказа. Контактную информацию покупателя — имя, фамилию, номер телефона и так далее — можно получить с помощью метода POST /api/v3/dbs/orders/client.

Информация о покупателе становится доступной только после перевода заказа на сборку — статус confirm. Поэтому по новым заказам — статус new — получить информацию о покупателе не получится.

Полезные ссылки в справочном центре:

• Подготовка к доставке