Заказы FBS
Инструкция по работе с разделом
Дата обновления: 02.04.2026
Чтобы протестировать методы заказов FBS, вы можете воспользоваться песочницей.
Модель продаж FBS
Модель FBS (Fulfillment by Seller) — это модель продаж, когда продавец самостоятельно организует хранение товаров и их доставку на склад, сортировочный центр (СЦ) или в пункт выдачи заказов (ПВЗ) Wildberries. Сайт Wildberries в этом случае используется как витрина для товаров продавца.
Методы WB АРІ для работы с заказами созданы для синхронизации данных между Wildberries и системами продавцов. Продавцы должны сохранять данные, полученные по WB API, на своих хранилищах и обрабатывать эти данные самостоятельно. Обмениваться данными с Wildberries можно только по мере необходимости.
Не допускается использовать АРІ Wildberries в качестве внешней базы данных. При превышении лимитов на запросы доступ к API ограничивается.
При работе по модели FBS c помощью API вы можете:
Управлять сборочными заданиями
Автоматизируйте получение сборочных заданий и проверку их статусов.
Управлять поставками
Заранее планируйте и формируйте поставки, получайте QR-коды и настраивайте количество грузомест.
Получать пропуска на склады
Оперативно оформляйте пропуска и вносите изменения в них.
Поставка на склад или СЦ
Шаг 1. Получить ID сборочного задания, которое нужно добавить в поставку
Когда покупатель оформил заказ на товар, продавцу приходит сборочное задание, на основе которого формируется поставка. Чтобы сформировать поставку, вам потребуются ID всех сборочных заданий, которые будут обработаны в рамках этой поставки.
Получите ID сборочного задания с помощью одного из методов получения сборочных заданий. В ответах методов вы получите orderId — используйте значение этого поля в следующих шагах.
Шаг 2. Создать новую поставку
Создайте поставку с помощью метода POST /api/v3/supplies. В теле запроса передайте наименование новой поставки, по которому вам будет удобно находить ее в списке поставок.
В ответе метода вернется ID поставки supplyId в формате WB-GI-1234567. Это означает, что поставка успешно создана. Используйте supplyId в следующих шагах.
Используйте метод GET /api/v3/supplies, чтобы получить supplyId для уже созданной поставки. Этот метод вернет список поставок и основную информацию по каждой из них.
Шаг 3. Добавить в поставку сборочные задания
Добавьте сборочные задания к поставке с помощью метода PATCH /api/marketplace/v3/supplies/{supplyId}/orders. В URL запроса укажите:
orderId— ID сборочных заданий, полученные в шаге 1;supplyId— ID поставки, полученный в шаге 2.
В одну поставку вы можете добавить только сборочные задания, поступившие на один склад warehouseId.
В пустую поставку вы можете добавить сборочное задание:
- с товаром любого габаритного типа (МГТ, КГТ+, СГТ). После этого поставка приобретает габаритный тип добавленного сборочного задания. Далее в неё можно добавить только сборочные задания такого же типа.
- с любым значением в поле
crossBorderType: кроссбордер или не кроссбордер. После этого поставка приобретает признакcrossBorderTypeдобавленного сборочного задания. Далее в неё можно добавить только сборочные задания такого же типа. Чтобы узнатьcrossBorderTypeпоставки, используйте методы получения списка поставок и информации о поставке.
Шаг 4. Проверить заполнение метаданных сборочных заданий
Метаданные сборочных заданий — это дополнительная информация о товарах, которая используется для идентификации и отслеживания продукции на каждом этапе ее жизненного цикла. Например, код маркировки, УИН, IMEI, GTIN, срок годности, номер ГТД.
Проверьте и при необходимости добавьте метаданные сборочных заданий с помощью методов, описанных в разделе Метаданные сборочных заданий.
Список метаданных сборочного задания, без которых поставку с ним невозможно перевести в доставку, указан в ответе метода GET /api/v3/orders/new в поле requiredMeta.
Список метаданных сборочного задания, без которых поставку с ним можно перевести в доставку, указан в ответе метода GET /api/v3/orders/new в поле optionalMeta.Эти метаданные могут потребоваться, например, при возврате товара покупателем.
Шаг 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-код поставки потребуется приемщику на складе, чтобы принять поставку. Передайте код в электронном виде или распечатайте его и разместите на транспортировочном коробе так, чтобы сотрудник склада мог легко заметить и отсканировать код при приемке.
Получить QR-код поставки можно только после того, как она передана в доставку.
Полезные ссылки в справочном центре:
Поставка в ПВЗ
Шаг 1. Получить ID сборочного задания, которое нужно передать в поставку
Когда покупатель оформил заказ на товар, продавцу приходит сборочное задание, на основе которого формируется поставка. Чтобы сформировать поставку, вам потребуются ID всех сборочных заданий, которые будут обработаны в рамках этой поставки.
Получите ID сборочного задания с помощью одного из методов получения сборочных заданий. В ответах методов вы получите orderId — используйте значение этого поля в следующих шагах.
Шаг 2. Создать поставку
Создайте поставку с помощью метода POST /api/v3/supplies. В теле запроса передайте наименование новой поставки, по которому вам будет удобно находить ее в списке поставок.
В ответе метода вернется ID поставки supplyId в формате WB-GI-1234567. Это означает, что поставка успешно создана. Используйте supplyId в следующих шагах.
Используйте метод GET /api/v3/supplies, чтобы получить supplyId для уже созданной поставки. Этот метод вернет список поставок и основную информацию по каждой из них.
Шаг 3. Добавить в поставку сборочные задания
Добавьте сборочные задания к поставке с помощью метода PATCH /api/marketplace/v3/supplies/{supplyId}/orders. В URL запроса укажите:
orderId— ID сборочных заданий, полученные в шаге 1;supplyId— ID поставки, полученный в шаге 2.
В одну поставку вы можете добавить только сборочные задания, поступившие на один склад warehouseId.
В пустую поставку вы можете добавить сборочное задание:
- с товаром любого габаритного типа (МГТ, КГТ+, СГТ). После этого поставка приобретает габаритный тип добавленного сборочного задания. Далее в неё можно добавить только сборочные задания такого же типа.
- с любым значением в поле
crossBorderType: кроссбордер или не кроссбордер. После этого поставка приобретает признакcrossBorderTypeдобавленного сборочного задания. Далее в неё можно добавить только сборочные задания такого же типа. Чтобы узнатьcrossBorderTypeпоставки, используйте методы получения списка поставок и информации о поставке.
Шаг 4. Проверить заполнение метаданных сборочных заданий
Метаданные сборочных заданий — это дополнительная информация о товарах, которая используется для идентификации и отслеживания продукции на каждом этапе ее жизненного цикла. Например, код маркировки, УИН, IMEI, GTIN, срок годности, номер ГТД.
Проверьте и при необходимости добавьте метаданные сборочных заданий с помощью методов, описанных в разделе Метаданные сборочных заданий.
Список метаданных сборочного задания, без которых поставку с ним невозможно перевести в доставку, указан в ответе метода GET /api/v3/orders/new в поле requiredMeta.
Список метаданных сборочного задания, без которых поставку с ним можно перевести в доставку, указан в ответе метода GET /api/v3/orders/new в поле optionalMeta.Эти метаданные могут потребоваться, например, при возврате товара покупателем.
Шаг 5. Получить стикеры сборочных заданий
Стикер — это уникальный код товара, заказанного по модели FBS. По стикеру можно отследить все действия с проданной единицей товара.
Получите стикеры сборочных заданий с помощью одного из методов получения стикеров сборочных заданий. Распечатайте полученные стикеры и наклейте их на соответствующие сборочные задания в поставке.
Шаг 6. Создать короба в поставке
Транспортировочный короб — это упаковка для перевозки поставки. Отгрузить поставку в ПВЗ можно только в транспортировочном коробе.
Если вы переведёте в доставку поставку без короба, сотрудники ПВЗ не смогут ее принять — товары придется отгрузить на склад.
Добавьте короба в поставку с помощью метода POST /api/v3/supplies/{supplyId}/trbx. В URL запроса передайте supplyId — ID поставки, полученный в шаге 3. В теле запроса передайте количество коробов, которое необходимо добавить. В успешном ответе метода вы получите trbxIds — список ID коробов, которые были созданы и добавлены в поставку.
Подробнее об операциях с коробами через API вы можете узнать в разделе Операции с коробами при поставках FBS.
Шаг 7. Получить QR-коды коробов
QR-код короба (стикер короба) — это уникальный идентификационный код, который наносится на каждый короб с товарами и используется для автоматизации приемки, хранения и отслеживания поставки.
Получите QR-коды коробов с помощью метода POST /api/v3/supplies/{supplyId}/trbx/stickers. В URL запроса передайте supplyId — ID поставки, полученный в шаге 2. Вы можете получить QR-код поставки в форматах:
- SVG, ZPLV, PNG — вертикальный;
- ZPLH, PNG — горизонтальный.
Распечатайте полученные стикеры и наклейте на соответствующие короба.
Шаг 8. Передать поставку в доставку
Если вы не переведёте поставку в доставку, она будет автоматически закрыта при сканировании QR-кода или приёмке первого товара на ПВЗ.
Передайте поставку в доставку с помощью метода PATCH /api/v3/supplies/{supplyId}/deliver. В URL запроса укажите supplyId — ID поставки, полученный в шаге 2.
После вызова метода поставка будет закрыта, все сборочные задания в ней перейдут в статус complete — в доставке. Добавить сборочные задания в закрытую поставку невозможно.
Если вы переведёте в доставку поставку без короба, сотрудники ПВЗ не смогут ее принять — товары придется отгрузить на склад.
Полезные ссылки в справочном центре:
Управление сборочными заданиями
Сборочное задание — это единица заказанного товара, которую необходимо подготовить для выдачи покупателю. Сборочное задание содержит информацию о заказе. Например, какой товар нужно упаковать и отгрузить, сколько времени прошло с момента поступления заказа, куда нужно доставить товар.
После того, как покупатель оформил заказ на товар, продавец получает сборочное задание и выполняет по нему заказ. Сборочное задание всегда содержит одну единицу товара. Если покупатель заказал несколько товаров одновременно, продавец получит несколько сборочных заданий.
С помощью WB API вы можете получить списки сборочных заданий и информацию по каждому из них. Например, тип доставки, товар в задании, адрес доставки заказа, цена.
Получение сборочных заданий
Используйте методы WB API, чтобы:
- Получить список новых сборочных заданий
Список новых сборочных заданий будет полезен при сборке новых заказов и подготовке товаров к отправке. Чтобы получить список сборочных заданий в статусеnew— новое, используйте метод GET /api/v3/orders/new. Сборочные задания в этом статусе еще не были взяты в работу.
В поле sellerDate в ответе метода GET /api/v3/orders/new указана рекомендованная дата доставки сверхгабаритных товаров на склад или в сортировочный центр.
Если товары СГТ доставлены на склад раньше, продавец оплачивает хранение до рекомендованной даты. Если товары доставлены позже рекомендованной даты, действует повышенный коэффициент.
- Получить список всех сборочных заданий
Список всех сборочных заданий пригодится для мониторинга, анализа и управления заказами. Чтобы получить список всех заданий во всех статусах, используйте метод GET /api/v3/orders. - Получить список сборочных заданий для повторной отгрузки
Повторная отгрузка — это дополнительная отгрузка продавцом товаров, которые не были обнаружены или не были отсканированы при приемке на складе. Такие товары продавец повторно отправляет на склад, чтобы завершить поставку. Чтобы получить сборочные задания на повторную отгрузку, используйте метод GET /api/v3/supplies/orders/reshipment.
Товары из одного заказа (корзины) покупателя можно определить по полю orderUid: все товары, заказанные одним покупателем за один раз, будут иметь одинаковый orderUid.
Чтобы получить текущий статус сборочного задания, используйте метод POST /api/v3/orders/status. В запросе метода укажите ID сборочных заданий orderId, для которых нужно получить статус, – до 1000 ID в одном запросе. Чтобы получить ID сборочных заданий, используйте методы получения списков сборочных заданий, описанные выше.
Стикеры сборочных заданий
Стикер — это уникальный код товара, заказанного по модели FBS. По стикеру можно отследить все действия с каждой проданной единицей товара.
Получите стикеры сборочных заданий:
- Если вы отправляете заказы по России, используйте метод POST /api/v3/orders/stickers.
- Если вы отправляете заказы с зарубежного склада покупателю в Россию или другие страны присутствия Wildberries по модели кроссбордер (cross-border), используйте метод POST /api/v3/orders/stickers/cross-border.
В запросе методов в атрибуте orders укажите ID сборочных заданий orderId, до 100 ID в одном запросе. Чтобы получить ID сборочных заданий, используйте методы получения сборочных заданий .
Полезные ссылки в справочном центре:
Информация о сборочных заданиях кроссбордера
Используйте методы WB API, чтобы получить:
- Историю статусов для сборочных заданий кроссбордера — POST /api/v3/orders/status/history.
- Заказы с информацией по клиенту — POST /api/v3/orders/client.
Метод доступен только для кроссбордера из Турции. - Стикеры сборочных заданий кроссбордера — POST /api/v3/orders/stickers/cross-border.
В запросе методов в атрибуте orders укажите ID сборочных заданий orderId, до 100 ID в одном запросе. Чтобы получить ID сборочных заданий, используйте методы получения сборочных заданий.
Метаданные сборочных заданий
Метаданные сборочных заданий — это дополнительная информация о товарах, которая используется для идентификации и отслеживания продукции на каждом этапе ее жизненного цикла.
Для работы с метаданными сборочных заданий вам нужно указать ID сборочного задания orderId в URL запросов. Получите ID сборочного задания с помощью методов получения сборочных заданий.
Ответ метода получения списка новых сборочных заданий GET /api/v3/orders/new содержит массивы метаданных:
- r
equiredMeta— список метаданных, которые необходимо добавить в сборочное задание, чтобы поставку с этим сборочным заданием можно было перевести в доставку optionalMeta— список метаданных, которые можно добавить в сборочное задание. Поставку со сборочным заданием без этих метаданных можно перевести в доставку, но метаданные могут потребоваться, например, при возврате товара покупателем
Рекомендуем добавлять в сборочные задания все метаданные, полученные в полях requiredMeta и optionalMeta.
- Получить метаданные сборочных заданий — POST /api/marketplace/v3/orders/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. - Закрепить за сборочным заданием срок годности товара — PUT /api/v3/orders/{orderId}/meta/expiration.
Срок годности — дата, до которой годен товар. Минимальный допустимый срок годности — 30 дней от текущей даты. Указание срока годности необязательно и остаётся на усмотрение продавца. Указать срок годности можно только для сборочных заданий в статусеconfirm— на сборке. - Закреплять за сборочным заданием номер ГТД — PUT /api/marketplace/v3/orders/{orderId}/meta/customs-declaration.
ГТД (Грузовая таможенная декларация) — документ, который позволяет легально перевозить импортные товары через границу. В ГТД содержится информация о грузе, транспорте, таможенной стоимости товара, отправителе и получателе. При импорте ГТД оформляют на таможне. При экспорте — проверяют, чтобы убедиться в правильности оформления вывоза. - Удалить метаданные сборочного задания — DELETE /api/v3/orders/{orderId}/meta.
Одним запросом вы можете удалить значение только одного идентификатора метаданных (код маркировки, УИН, IMEI или 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/marketplace/v3/supplies/{supplyId}/orders.
В URL запроса укажите
supplyId— ID поставки, иorderId— ID сборочных заданий. Метод добавляет сборочные задания в поставку и переводит их в статусconfirm— на сборке. В пустую поставку вы можете добавить любые сборочные задания. Если в поставке уже есть сборочные задания, то добавить в нее можно только сборочные задания:- поступившие на один склад
warehouseId; - одного и того же габаритного типа (МГТ, КГТ+, СГТ);
- с одним и тем же значением
crossBorderType: кроссбордер или не кроссбордер.
- поступившие на один склад
- Переместить сборочные задания в другую поставку — PATCH /api/marketplace/v3/supplies/{supplyId}/orders.
В URL запроса укажите
supplyId— ID поставки, в которую нужно переместить сборочное задание, иorderId— ID сборочных заданий. Перемещать сборочные задания можно:- между поставками с одного склада;
- между поставками одного габаритного типа (МГТ, КГТ+, СГТ);
- между поставками с одним и тем же значением
crossBorderType: кроссбордер или не кроссбордер; - между активными поставками;
- из закрытой поставки в активную, если сборочное задание требует повторной отгрузки.
- Получить ID сборочных заданий в поставке — GET /api/marketplace/v3/supplies/{supplyId}/order-ids.
В 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
Большинство операций с коробами можно проводить только пока поставка находится в статусе confirm — на сборке.
C помощью WB API вы можете:
- Создать короб в поставке — POST /api/v3/supplies/{supplyId}/trbx.
В URL запроса укажите ID поставкиsupplyId. В ответе метода вы получите список ID созданных коробовtrbxIds. За один запрос можно создать до 1000 коробов. - Получить список коробов поставки — 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/marketplace/v3/supplies/{supplyId}/orders, чтобы переместить сборочные задания в другую поставку. В URL метода укажите
supplyId— ID поставки, в которую нужно переместить сборочное задание, иorderId— ID сборочных заданий. В одну поставку вы можете добавить только сборочные задания:- поступившие на один склад
warehouseId; - одного и того же габаритного типа (МГТ, КГТ+, СГТ);
- с одним и тем же значением
crossBorderType: кроссбордер или не кроссбордер.
- поступившие на один склад
- 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 созданного пропуска.
Получение списка пропусков
Обновление пропуска

ПредпросмотрШаг 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.