Заказы FBS

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

Модель FBS (Fulfillment by Seller) — это модель продаж, когда продавец самостоятельно организует хранение товаров и их доставку на склад, сортировочный центр (СЦ) или в пункт выдачи заказов (ПВЗ) Wildberries. Сайт Wildberries в этом случае используется как витрина для товаров продавца.

При работе по модели FBS c помощью API вы можете:

---

Поставка на склад или СЦ

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

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

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

Шаг 2. Создать новую поставку

Создайте поставку с помощью метода POST /api/v3/supplies. В теле запроса передайте наименование новой поставки, по которому вам будет удобно находить ее в списке поставок.

В ответе метода вернется ID поставки supplyId в формате WB-GI-1234567. Это означает, что поставка успешно создана. Используйте supplyId в следующих шагах.

Шаг 3. Добавить в поставку сборочные задания

Добавьте сборочное задание к поставке с помощью метода PATCH /api/v3/supplies/{supplyId}/orders/{orderId}. В URL запроса укажите:

• orderId — ID сборочного задания, полученный в шаге 1;
• supplyId — ID поставки, полученный в шаге 2.

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

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

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

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

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

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

Шаг 6. Передать поставку в доставку

Передайте поставку в доставку с помощью метода PATCH /api/v3/supplies/{supplyId}/deliver. В URL запроса передайте supplyId — ID поставки, полученный в шаге 2. 

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

Шаг 7. Получить QR-код поставки

QR-код поставки — это уникальный идентификационный код, который присваивается каждой поставке товаров на склад или в СЦ Wildberries.

Получите QR-код поставки с помощью метода GET /api/v3/supplies/{supplyId}/barcode. В URL запроса передайте supplyId — ID поставки, полученный в шаге 2. Вы можете получить QR-код поставки в форматах:

• SVG, ZPLV, PNG — вертикальный;
• ZPLH, PNG — горизонтальный.

QR-код поставки потребуется приемщику на складе, чтобы принять поставку. Передайте код в электронном виде или распечатайте его и разместите на транспортировочном коробе так, чтобы сотрудник склада мог легко заметить и отсканировать код при приемке.

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

• Обработка заказов по модели FBS
• Отгрузка поставок по модели Маркетплейс (FBS) на склад или в СЦ

---

Поставка в ПВЗ 

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

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

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

Шаг 2. Создать поставку

Создайте поставку с помощью метода POST /api/v3/supplies. В теле запроса передайте наименование новой поставки, по которому вам будет удобно находить ее в списке поставок.

В ответе метода вернется ID поставки supplyId в формате WB-GI-1234567. Это означает, что поставка успешно создана. Используйте supplyId в следующих шагах.

Шаг 3. Добавить в поставку сборочные задания

Добавьте сборочное задание к поставке с помощью метода PATCH /api/v3/supplies/{supplyId}/orders/{orderId}. В URL запроса укажите:

• orderId — ID сборочного задания, полученный в шаге 1;
• supplyId — ID поставки, полученный в шаге 2.

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

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

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

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

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

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

Шаг 6. Создать короба в поставке

Транспортировочный короб — это упаковка для перевозки поставки. Отгрузить поставку в ПВЗ можно только в транспортировочном коробе.

Добавьте короба в поставку с помощью метода POST /api/v3/supplies/{supplyId}/trbx. В URL запроса передайте supplyId — ID поставки, полученный в шаге 3. В теле запроса передайте количество коробов, которое необходимо добавить. В успешном ответе метода вы получите trbxIds — список ID коробов, которые были созданы и добавлены в поставку.

Подробнее об операциях с коробами через API вы можете узнать в разделе Операции с коробами при поставках FBS.

Шаг 7. Распределить сборочные задания по коробам

Чтобы добавить одно или несколько сборочных заданий в короб, используйте метод PATCH /api/v3/supplies/{supplyId}/trbx/{trbxId}.

В URL запроса укажите:

• supplyId — ID поставки, полученный в шаге 2;
• trbxId — ID короба, полученный в шаге 6.

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

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

Проверьте сформированную поставку с помощью метода GET /api/v3/supplies/{supplyId}/trbx. В URL метода укажите ID поставки supplyId из шага 2. В ответе метода вы получите список коробов в составе поставки и перечень сборочных заданий в каждом из коробов.

Шаг 9. Получить QR-коды коробов

QR-код короба (стикер короба) — это уникальный идентификационный код, который наносится на каждый короб с товарами и используется для автоматизации приемки, хранения и отслеживания поставки.

Получите QR-коды коробов с помощью метода POST /api/v3/supplies/{supplyId}/trbx/stickers. В URL запроса передайте supplyId — ID поставки, полученный в шаге 2. Вы можете получить QR-код поставки в форматах:

• SVG, ZPLV, PNG — вертикальный;
• ZPLH, PNG — горизонтальный.

Распечатайте полученные стикеры и наклейте на соответствующие короба.

Шаг 10. Передать поставку в доставку

Передайте поставку в доставку с помощью метода PATCH /api/v3/supplies/{supplyId}/deliver. В URL запроса укажите supplyId — ID поставки, полученный в шаге 2. 

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

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

• Обработка заказов по модели FBS
• Отгрузка поставок по модели Маркетплейс (FBS) в ПВЗ

---

Управление сборочными заданиями

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

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

С помощью WB API вы можете получить списки сборочных заданий и информацию по каждому из них. Например, тип доставки, товар в задании, адрес доставки заказа, цена.

---

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

Используйте методы WB API, чтобы:

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

Чтобы получить текущий статус сборочного задания, используйте метод POST /api/v3/orders/status. В запросе метода укажите ID сборочных заданий orderId, для которых нужно получить статус, – до 1000 ID в одном запросе. Чтобы получить ID сборочных заданий, используйте методы получения списков сборочных заданий, описанные выше.

---

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

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

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

• Если вы отправляете заказы по России, используйте метод POST /api/v3/orders/stickers.
• Если вы отправляете заказы с зарубежного склада покупателю в Россию или другие страны присутствия Wildberries по модели кроссбордер (cross-border), используйте метод POST /api/v3/files/orders/external-stickers.

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

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

• Стикер заказа

---

Информация о сборочных заданиях кроссбордера

Кроссбордер (cross-border) — это модель работы, при которой товары для продажи на Wildberries хранятся на складе не в России или странах ЕАЭС. Продавец отправляет заказы напрямую с зарубежного склада покупателю в Россию или другие страны присутствия Wildberries.

Используйте методы WB API, чтобы:

• Получить историю статусов для сборочных заданий кроссбордера — POST /api/v3/orders/status/history.
• Получить заказы с информацией по клиенту — POST /api/v3/orders/client.
  Метод доступен только для кроссбордера из Турции.
• Стикеры сборочных заданий кроссбордера — POST /api/v3/files/orders/external-stickers.

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

---

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

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

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

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

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

• Маркировка товаров для модели Маркетплейс (FBS)
• Указание GTIN и КИЗ при сборке поставки 

---

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

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

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

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

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

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

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

---

Управление поставками на склады Wildberries

Поставка — это одно или несколько сборочных заданий, которые продавец объединяет в одну доставку на склад, сортировочный центр (СЦ) или в пункт выдачи заказов (ПВЗ) Wildberries.

---

Операции с поставками FBS

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

• Создать новую поставку — POST /api/v3/supplies.
  В теле запроса передайте наименование новой поставки, чтобы быстрее находить ее в списке. В ответе метода вернется ID поставки supplyId в формате WB-GI-1234567. Это означает, что поставка успешно создана.
• Получить список всех поставок — GET /api/v3/supplies.
  В ответе метода вы получите список поставок и основную информацию по каждой из них.
• Получить информацию о конкретной поставке — GET /api/v3/supplies/{supplyId}.
  В ответе метода вы получите подробную информацию о поставке. Например, название, тип, даты создания и закрытия поставки. В URL запроса укажите supplyId — ID поставки.
• Получить QR-код поставки — GET /api/v3/supplies/{supplyId}/barcode.
  QR-код поставки — это уникальный идентификационный код, который присваивается каждой поставке товаров на склад или в СЦ Wildberries. QR-код поставки потребуется приемщику на складе, чтобы принять поставку. В URL запроса укажите supplyId — ID поставки.
• Удалить поставку — DELETE /api/v3/supplies/{supplyId}.
  В URL запроса укажите supplyId — ID поставки. Подробнее о методе вы можете узнать в разделе Удаление поставки.

Чтобы получить supplyId для URL запросов, используйте методы:

• Создание новой поставки — POST /api/v3/supplies.
• Получение списка поставок — GET /api/v3/supplies.

---

Операции со сборочными заданиями в поставках FBS

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

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

• Добавить сборочное задание в поставку — PATCH /api/v3/supplies/{supplyId}/orders/{orderId}.
  В URL запроса укажите supplyId — ID поставки, и orderId — ID сборочного задания.
  Метод добавляет сборочное задание в поставку и переводит его в статус confirm — на сборке. После того, как в поставку добавлено хотя бы одно сборочное задание, она приобретает габаритный тип этого сборочного задания. Добавить в нее сборочное задание с другим габаритным типом невозможно.
• Переместить сборочное задание в другую поставку — PATCH /api/v3/supplies/{supplyId}/orders/{orderId}.
  В URL запроса укажите supplyId — ID поставки, в которую нужно переместить сборочное задание, и orderId — ID сборочного задания. Перемещать сборочные задания можно:
  • между активными поставками;
  • из закрытой поставки в активную, если сборочное задание требует повторной отгрузки.
• Получить сборочные задания в составе поставки — GET /api/v3/supplies/{supplyId}/orders.
  В URL запроса укажите supplyId — ID поставки. В ответе метода вы получите список сборочных заданий и основную информацию по каждому из них.
• Отменить сборочное задание — PATCH /api/v3/orders/{orderId}/cancel.
  В URL запроса укажите orderId — ID сборочного задания. Подробнее о методе вы можете узнать в разделе Отмена сборочного задания.
  

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

• Создание новой поставки — POST /api/v3/supplies.
• Получение списка поставок — GET /api/v3/supplies.

---

Операции с коробами при поставках FBS

Транспортировочный короб — это упаковка для перевозки поставки. Отгрузить поставку в ПВЗ можно только в транспортировочном коробе.

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

• Создать короб в поставке — POST /api/v3/supplies/{supplyId}/trbx.
  В URL запроса укажите ID поставки supplyId. В ответе метода вы получите список ID созданных коробов trbxIds. За один запрос можно создать до 1000 коробов.
• Добавить сборочные задания в короб — PATCH /api/v3/supplies/{supplyId}/trbx/{trbxId}.
  В URL запроса укажите ID поставки supplyId, в которой находится короб, и ID короба trbxId, в который нужно добавить сборочные задания. В теле запроса передайте orderId — список ID сборочных заданий, которые нужно добавить.
• Удалить сборочные задания из короба — DELETE /api/v3/supplies/{supplyId}/trbx/{trbxId}/orders/{orderId}.
  В URL запроса укажите ID поставки supplyId, ID короба trbxId, из которого нужно удалить сборочные задания, и orderId — ID сборочного задания, которое нужно удалить.
• Получить список коробов поставки — GET /api/v3/supplies/{supplyId}/trbx.
  В URL запроса укажите ID поставки supplyId. В ответе метода вы получите список коробов в поставке и перечень сборочных заданий в каждом из коробов.
• Удалить короба из поставки — DELETE /api/v3/supplies/{supplyId}/trbx.
  В URL запроса укажите ID поставки supplyId, из которой нужно удалить короба. В теле запроса передайте ID коробов trbxId, которые нужно удалить. Метод удалит сборочные задания из указанных коробов, затем удалит эти короба из системы. Сборочные задания из удаленного короба перестанут относиться к какому-либо коробу.
• Получить стикеры коробов поставки — POST /api/v3/supplies/{supplyId}/trbx/stickers.
  QR-код короба (стикер короба) — это уникальный идентификационный код, который наносится на каждый короб с товарами и используется для автоматизации приемки, хранения и отслеживания поставки. В URL запроса передайте supplyId — ID поставки. Вы можете получить QR-код поставки в форматах:
  • SVG, ZPLV, PNG — вертикальный;
  • ZPLH, PNG — горизонтальный.

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

• Создание новой поставки — POST /api/v3/supplies.
• Получение списка поставок — GET /api/v3/supplies.

Получить trbxId для URL запросов вы можете с помощью методов:

• Создание нового короба — POST /api/v3/supplies/{supplyId}/trbx.
• Получение списка коробов — GET /api/v3/supplies/{supplyId}/trbx.

---

Удаление поставки 

Шаг 1. Получить ID поставки, которую нужно удалить

Используйте метод GET /api/v3/supplies. В ответе метода вы получите список всех существующих поставок и ID поставок supplyId, а также основную информацию по каждой поставке. Используйте значение supplyId на следующем шаге.

Шаг 2. Убедиться, что в поставке нет сборочных заданий

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

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

Шаг 3. Удалить поставку

Используйте метод DELETE /api/v3/supplies/{supplyId}. В URL запроса метода укажите supplyId — ID поставки, которую нужно удалить.

---

Пропуска на склады и СЦ Wildberries

По модели FBS продавец может доставлять заказы на склад или сортировочный центр (СЦ) Wildberries. Чтобы попасть на эти объекты, потребуется пропуск. Оформлять пропуска и управлять ими вы можете с помощью WB API.

---

Создание пропуска

Шаг 1. Определить ID склада, на который нужен пропуск

Получите officeId — ID складов , на которые нужен пропуск, с помощью метода GET /api/v3/passes/offices. Используйте officeId в следующем шаге.

Шаг 2. Создать пропуск на склад

Используйте метод POST /api/v3/passes. В теле запроса передайте имя и фамилию водителя, марку и номер машины, а также ID склада officeId. В успешном ответе метода вы получите ID созданного пропуска.

---

Получение списка пропусков

Используйте метод GET /api/v3/passes, чтобы получить список всех созданных пропусков продавца и основную информацию по каждому из них: ID пропуска, дату окончания его действия, информацию о водителе, машине и складе.

---

Обновление пропуска

Шаг 1. Получить ID пропуска, который нужно изменить

Получите список всех созданных пропусков продавца с помощью метода GET /api/v3/passes. В ответе метода вы получите список пропусков и основную информации по каждому из них, в том числе passId — ID пропуска. Используйте значение passId в следующем шаге.

Шаг 2. Внести изменения в пропуск

Используйте метод PUT /api/v3/passes/{passId}. В URL запроса укажите ID пропуска passId. В теле запроса передайте новые данные о водителе, машине и складе, которые нужно внести в пропуск.

---

Удаление пропуска

Шаг 1. Получить ID пропуска, который нужно удалить

Получите список всех созданных пропусков продавца с помощью метода GET /api/v3/passes. В ответе метода вы получите список пропусков и основную информации по каждому из них, в том числе passId — ID пропуска. Используйте значение passId в следующем шаге.

Шаг 2. Удалить пропуск

Используйте метод DELETE /api/v3/passes/{passId}. В URL запроса укажите ID пропуска passId.