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

Модель Курьером WB (Delivery by Wildberries, DBW) — это модель продаж, при которой товары хранятся на складе продавца, а когда поступает заказ, курьер Wildberries забирает товар со склада и доставляет покупателю. 

По модели DBW можно продавать только сверхгабаритные товары (СГТ) в городах, указанных в справочном центре или на портале WB Партнёры при создании склада продавца для модели DBW. 

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

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

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

Получите ID сборочного задания — orderId в списке новых сборочных заданий, в методе GET /api/v3/dbw/orders/new. Метод вернет информацию о сборочных заданиях со статусом new — новое. Сборочные задания в этом статусе ещё не были взяты в работу.

Чтобы получить весь список сборочных заданий, используйте метод POST /api/v3/dbw/orders/status.

Шаг 2. Получить дату и время доставки

Получите информацию дате и времени доставки сборочного задания с помощью метода POST /api/v3/dbw/orders/delivery-date. В одном запросе вы можете передать до 1000 ID сборочных заданий. 

Используйте эти данные, чтобы спланировать сборку и обработку заказа. В течение первых суток после заказа покупатель может изменить желаемое время доставки. Прежнее время доставки также вернется в ответе метода POST /api/v3/dbw/orders/delivery-date в первые сутки после изменения.

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

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

Шаг 4. Добавить метаданные сборочного задания

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

Получите список метаданных, которые можно добавить к сборочному заданию, с помощью метода GET /api/v3/dbw/orders/new. В ответе метода вы получите массив requiredMeta с перечнем метаданных. Например, код маркировки, УИН, IMEI, GTIN.

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

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

Стикер — это уникальный код товара, заказанного по модели DBW. По стикеру можно отследить все действия с проданной единицей товара.

Получите стикеры сборочных заданий с помощью метода POST /api/v3/dbw/orders/stickers. Распечатайте полученные стикеры и наклейте их на соответствующие сборочные задания в поставке.

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

Когда заказ собран, упакован и промаркирован, переведите сборочное задание в статус complete — в доставке — чтобы Wildberries отправил за ним курьера для доставки покупателю. Перевести сборочное задание в доставку необходимо в течение 15 дней после того, как вы перевели заказ в статус confirm — на сборке, иначе оно будет автоматически удалено.

Переведите сборочное задание в доставку с помощью метода PATCH /api/v3/dbw/orders/{orderId}/assemble. В URL запроса передайте ID сборочного задания orderId из шага 1.

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

Шаг 7. Получить завершённые сборочные задания

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

Чтобы получить список завершённых сборочных заданий, используйте метод GET /api/v3/dbw/orders. Метод предоставляет информацию за заданный период до 30 календарных дней.

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

• Как работать с заказами по модели «Курьером WB» (DBW)

---

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

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

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

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

• Получить список новых сборочных заданий — GET /api/v3/dbw/orders/new.
  Метод возвращает список сборочных заданий в статусе new — новое. Сборочные задания в этом статусе ещё не были взяты в работу. Список новых сборочных заданий будет полезен при сборке новых заказов.
• Получить список завершенных сборочных заданий — GET /api/v3/dbw/orders.
  Метод позволяет получить информацию за заданный период до 30 календарных дней одним запросом. Список завершенных сборочных заданий может понадобиться, например для анализа выполненных заданий.

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

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

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

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

• Сборка и доставка заказов

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

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

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

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

• Перевести сборочное задание на сборку — PATCH /api/v3/dbw/orders/{orderId}/confirm.
  Перед тем, как начать сборку заказа, переведите сборочное задание в статус confirm — на сборке.
• Перевести сборочное задание в доставку — PATCH /api/v3/dbw/orders/{orderId}/assemble.
  Когда заказ собран, упакован, промаркирован и готов к передаче курьеру, переведите его в статус complete — в доставке.
• Отменить сборочное задание по инициативе продавца — PATCH /api/v3/dbw/orders/{orderId}/cancel.
  Если произошел форс-мажор и отправить заказ покупателю невозможно, вы можете отменить заказ. Для этого переведите сборочное задание в статус cancel — отменено продавцом.

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

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

• Сборка и доставка заказов

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

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

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

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

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

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

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

Чтобы получить информацию о курьере, используйте метод POST /api/v3/dbw/orders/courier. В одном запросе вы можете передать несколько ID сборочных заданий orderId. В ответе метода вы получите информацию о том, назначен ли на заказ курьер Wildberries, и контактные данные курьера (номер автомобиля, ФИО, телефон, ожидаемое время прибытия на ваш склад).
ID сборочных заданий можно получить с помощью методов получения сборочных заданий. 

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

• confirm — на сборке
• complete — в доставке

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

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

Вы можете отменить сборочное задание DBW по своей инициативе. Например, если произошел форс-мажор и заказанного товара не оказалось на складе.

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

• new — новый
• confirm — на сборке

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

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

• Отмена заказа по инициативе продавца