Заказы 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 сборочного задания — id в списке новых сборочных заданий, в методе GET /api/v3/dbs/orders/new. 

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

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

Переведите сборочное задание в статус confirm — на сборке. Для этого используйте метод POST /api/marketplace/v3/dbs/orders/status/confirm. В параметре запроса ordersIds передайте ID сборочного задания из шага 1. Вы можете передать до 1000 ID сборочных заданий в одном запросе.

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

После сборки и упаковки товара вам нужно связаться с покупателем для доставки заказа.

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

Чтобы получить данные B2B-покупателя: наименование организации, ИНН и КПП — используйте метод POST /api/marketplace/v3/dbs/orders/b2b/info.

Шаг 4. Проверить заполнение метаданных сборочных заданий

Проверьте и при необходимости добавьте метаданные сборочных заданий с помощью методов раздела Метаданные сборочных заданий.

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

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

Если за сборочным заданием не закреплён обязательный IMEI, в ответе метода вы получите ошибку со статус-кодом 409 и "detail":"ImeiIsNotFilled".

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

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

Если покупатель оставил заказ себе, переведите заказ в статус receive — получено покупателем. Для этого используйте метод POST /api/marketplace/v3/dbs/orders/status/receive. Для работы метода нужен код подтверждения, который покупатель сообщит курьеру в момент получения заказа. Вы можете передать до 1000 кодов и ID сборочных заданий в одном запросе.

Если покупатель отказался от получения заказа, переведите заказ в статус reject — отказ при получении. Для этого используйте метод POST /api/marketplace/v3/dbs/orders/status/reject. Для работы метода нужен код подтверждения, который покупатель сообщит курьеру в момент получения заказа. Вы можете передать до 1000 кодов и ID сборочных заданий в одном запросе.

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

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

---

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

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

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

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

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

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

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

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

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

---

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

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

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

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

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

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

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

---

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

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

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

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

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

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

 

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

С помощью WB API вы можете получить информацию о B2C и B2B-покупателях. Контакты B2C-покупателя могут потребоваться, чтобы связаться с ним во время и после выполнения заказа, а данные B2B-покупателя — для оформления документов.

Информация о покупателе

Чтобы получить контактную информацию B2C-покупателя, используйте метод POST /api/v3/dbs/orders/client. В запросе передайте ID сборочных заданий. В ответе метода вы получите имя, фамилию, номера телефонов для связи и добавочные коды.

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

Информация о покупателе B2B

Чтобы получить данные покупателя B2B, используйте метод POST /api/marketplace/v3/dbs/orders/b2b/info. В запросе передайте ID сборочных заданий. В ответе метода вы получите наименование организации, ИНН и КПП.

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

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

---

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

Продавец может установить стоимость доставки на этапе создания или редактирования зоны доставки со склада DBS. Покупатель видит стоимость доставки в корзине на Wildberries и оплачивает доставку при оформлении заказа.

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

Шаг 1. Получить ID группы сборочных заданий

Сборочным заданиям, поступившим на один склад, при заказе будет присвоен ID группы сборочных заданий groupId.

Получите ID группы сборочных заданий через методы:

• GET /api/v3/dbs/orders/new — для новых сборочных заданий
• GET /api/v3/dbs/orders — для завершённых сборочных заданий

Шаг 2. Получить информацию о платной доставке

Чтобы получить информацию о стоимости доставки товаров, используйте метод POST /api/v3/dbs/groups/info. В запросе укажите ID группы сборочных заданий groupId из шага 1.

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

• Платная доставка товаров по моделям «Витрина» (DBS) и «Витрина экспресс» (EDBS)

Отмена сборочного задания

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

Вы можете отменить заказы со статусами:

• new — новый;
• confirm — на сборке;
• deliver — в доставке.

Чтобы отменить заказ по инициативе продавца, переведите сборочное задание в статус cancel — отменено продавцом — с помощью метода POST /api/marketplace/v3/dbs/orders/status/cancel. В URL запросе передайте ID сборочных заданий, которое нужно отменить. Чтобы получить ID сборочного задания, используйте метод получения новых сборочных заданий.

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

• Отмена заказа