### GET /api/v3/supplies Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод возвращает список [поставок](/openapi/orders-fbs#tag/Postavki-FBS/paths/~1api~1v3~1supplies~1%7BsupplyId%7D/get).
Лимит запросов на один аккаунт продавца для методов сборочных заданий, поставок и пропусков FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 300 запросов | 200 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Parameters - **limit** (integer, query, required): Параметр пагинации. Устанавливает предельное количество возвращаемых данных. - **next** (integer (int64), query, required): Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен `0` в первом запросе. Для следующих запросов необходимо брать значения из одноимённого поля в ответе. ### Responses #### 200 - Успешно - **next** (integer (int64)): Параметр пагинации. Содержит значение, которое необходимо указать в запросе для получения следующего пакета данных (example: 13833711) - **supplies** (array (Supply)): Список поставок Array items: - **id** (string): ID поставки (example: "WB-GI-1234567") - **isB2b** (boolean): Признак B2B-продажи: - `true` — B2B-продажа - `false` — не B2B-продажа - `null` — признак отсутствует, сборочные задания не добавлены к поставке - **done** (boolean): Флаг закрытия поставки: - `true` — закрыта - `false` — открыта - **createdAt** (string (date-time)): Дата создания поставки (RFC3339) (example: "2022-05-04T07:56:29Z") - **closedAt** (string (date-time)): Дата закрытия поставки (RFC3339) (example: "2022-05-04T07:56:29Z") - **scanDt** (string (date-time)): Дата скана поставки (RFC3339) (example: "2022-05-04T07:56:29Z") - **name** (string): Наименование поставки (example: "Тестовая поставка") - **cargoType** (integer): Тип товара: - `1` — малогабаритный товар (МГТ) - `2` — сверхгабаритный товар (СГТ) - `3` — крупногабаритный товар (КГТ+) ("0"|"1"|"2"|"3") - **crossBorderType** (integer (int32)): Тип поставки: - `0` — не кроссбордер - `1` — кроссбордер - `null` — значение отсутствует (example: 1) ("0"|"1") - **destinationOfficeId** (integer (int64)): ID склада назначения поставки. Если `null`, склад назначения не указан (example: 123) #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v3/supplies?limit=0&next=0" ``` ``` -------------------------------- ### GET /api/v3/supplies/{supplyId} Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод возвращает подробную информацию о поставке.
Лимит запросов на один аккаунт продавца для методов сборочных заданий, поставок и пропусков FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 300 запросов | 200 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Parameters - **supplyId** (string, path, required): ID поставки (example: "WB-GI-1234567") ### Responses #### 200 - Успешно **Supply** - **id** (string): ID поставки (example: "WB-GI-1234567") - **isB2b** (boolean): Признак B2B-продажи: - `true` — B2B-продажа - `false` — не B2B-продажа - `null` — признак отсутствует, сборочные задания не добавлены к поставке - **done** (boolean): Флаг закрытия поставки: - `true` — закрыта - `false` — открыта - **createdAt** (string (date-time)): Дата создания поставки (RFC3339) (example: "2022-05-04T07:56:29Z") - **closedAt** (string (date-time)): Дата закрытия поставки (RFC3339) (example: "2022-05-04T07:56:29Z") - **scanDt** (string (date-time)): Дата скана поставки (RFC3339) (example: "2022-05-04T07:56:29Z") - **name** (string): Наименование поставки (example: "Тестовая поставка") - **cargoType** (integer): Тип товара: - `1` — малогабаритный товар (МГТ) - `2` — сверхгабаритный товар (СГТ) - `3` — крупногабаритный товар (КГТ+) ("0"|"1"|"2"|"3") - **crossBorderType** (integer (int32)): Тип поставки: - `0` — не кроссбордер - `1` — кроссбордер - `null` — значение отсутствует (example: 1) ("0"|"1") - **destinationOfficeId** (integer (int64)): ID склада назначения поставки. Если `null`, склад назначения не указан (example: 123) #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 404 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v3/supplies/{supplyId}" ``` ``` -------------------------------- ### GET /api/v3/supplies/{supplyId}/barcode Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод возвращает QR-код [поставки](/openapi/orders-fbs#tag/Postavki-FBS/paths/~1api~1v3~1supplies~1%7BsupplyId%7D/get) в форматах: - SVG - ZPLV (вертикальный) - ZPLH (горизонтальный) - PNG QR-код поставки можно получить только если поставка [передана в доставку](/openapi/orders-fbs#tag/Postavki-FBS/paths/~1api~1v3~1supplies~1%7BsupplyId%7D~1deliver/patch).

Размер — 580x400 px.
Лимит запросов на один аккаунт продавца для методов сборочных заданий, поставок и пропусков FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 300 запросов | 200 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Parameters - **supplyId** (string, path, required): ID поставки (example: "WB-GI-1234567") - **type** (string (svg|zplv|zplh|png), query, required): Тип стикера ### Responses #### 200 - Успешно - **barcode** (string): Закодированное значение стикера (ID поставки) (example: "WB-GI-12345678") - **file** (string (byte)): Полное представление стикера в заданном формате (кодировка base64) (example: "U3dhZ2dlciByb2Nrcw==") #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 404 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 409 - Ошибка запроса данных **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v3/supplies/{supplyId}/barcode?type=svg" ``` ``` -------------------------------- ### GET /api/v3/supplies/orders/reshipment Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод возвращает все [сборочные задания](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/~1api~1v3~1orders/get), требующие повторной отгрузки.

Повторная отгрузка требуется, если поставка была отсканирована в пункте приёмки, но при этом в ней всё ещё есть неотсканированные товары. Спустя определённое время необходимо доставить эти товары заново. Данные сборочные задания можно перевести в [другую активную поставку](/openapi/orders-fbs#tag/Postavki-FBS/paths/~1api~1marketplace~1v3~1supplies~1%7BsupplyId%7D~1orders/patch).
Лимит запросов на один аккаунт продавца для методов сборочных заданий, поставок и пропусков FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 300 запросов | 200 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Responses #### 200 - Успешно - **orders** (array (object)): Список сборочных заданий Array items: - **supplyID** (unknown): ID поставки - **orderID** (unknown): ID сборочного задания #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v3/supplies/orders/reshipment" ``` ``` -------------------------------- ### POST /api/v3/supplies Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод создаёт новую [поставку](/openapi/orders-fbs#tag/Postavki-FBS/paths/~1api~1v3~1supplies~1%7BsupplyId%7D/get). Ограничения: - Только для [сборочных заданий](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/~1api~1v3~1orders/get) по модели FBS. - При добавлении в поставку все передаваемые сборочные задания в [статусе](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/~1api~1v3~1orders~1status/post) `new` будут автоматически переведены в статус `confirm` — на сборке. - Если вы переведёте сборочное задание в статус `cancel` — отмена продавцом, прикрепленное сборочное задание автоматически удалится из поставки. - Поставку можно собрать только из сборочных заданий (заказов) одного габаритного типа `cargoType`. Новая поставка не обладает габаритным признаком, она приобретает габаритный признак первого заказа, добавленного в поставку.
Лимит запросов на один аккаунт продавца для методов сборочных заданий, поставок и пропусков FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 300 запросов | 200 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Request Body **Content-Type:** application/json - **name** (string): Наименование поставки (example: "Тестовая поставка") ### Responses #### 201 - Создано - **id** (string): ID поставки (example: "WB-GI-1234567") #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X POST "https://api.example.com/api/v3/supplies" \ -H "Content-Type: application/json" \ -d '{ "name": "Тестовая поставка" }' ``` ``` -------------------------------- ### GET /api/v3/supplies/{supplyId}/trbx Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Возвращает список коробов поставки.
Лимит запросов на один аккаунт продавца для методов сборочных заданий, поставок и пропусков FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 300 запросов | 200 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Parameters - **supplyId** (string, path, required): ID поставки (example: "WB-GI-1234567") ### Responses #### 200 - Успешно - **trbxes** (array (SupplyTrbx)) Array items: - **id** (string): ID короба (example: "WB-TRBX-1234567") #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 404 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v3/supplies/{supplyId}/trbx" ``` ``` -------------------------------- ### PUT /api/v3/orders/{orderId}/meta/imei Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод обновляет IMEI в [метаданных сборочного задания](/openapi/orders-fbs#tag/Metadannye-FBS/paths/~1api~1marketplace~1v3~1orders~1meta/post).

У одного сборочного задания может быть только один IMEI. Если у устройства два IMEI — **IMEI** и **IMEI2** или **IMEI1** и **IMEI2** — укажите только **IMEI** или **IMEI1**. **IMEI2** указывать не нужно.

Добавлять маркировку можно только для заказов, которые находятся в [статусе](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/~1api~1v3~1orders~1status/post) `confirm`.
Лимит запросов на один аккаунт продавца для всех методов закрепления метаданных FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 1000 запросов | 60 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Parameters - **orderId** (integer (int64), path, required): ID сборочного задания (example: 5632423) ### Request Body **Content-Type:** application/json - **imei** (string) (required): IMEI (example: "123456789012345") ### Responses #### 204 - Обновлено Empty response body #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 409 - Ошибка обновления метаданных **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X PUT "https://api.example.com/api/v3/orders/{orderId}/meta/imei" \ -H "Content-Type: application/json" \ -d '{ "imei": "123456789012345" }' ``` ``` -------------------------------- ### PUT /api/v3/orders/{orderId}/meta/sgtin Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод позволяет закрепить за [сборочным заданием](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/~1api~1v3~1orders/get) код маркировки [Честный знак](https://честныйзнак.рф).

Закрепить код маркировки можно только если в [метаданных сборочного задания](/openapi/orders-fbs#tag/Metadannye-FBS/paths/~1api~1marketplace~1v3~1orders~1meta/post) есть поле `sgtin`, а сборочное задание находится в [статусе](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/~1api~1v3~1orders~1status/post) `confirm`.

Получить загруженные маркировки можно в [метаданных сборочного задания](/openapi/orders-fbs#tag/Metadannye-FBS/paths/~1api~1marketplace~1v3~1orders~1meta/post).
Лимит запросов на один аккаунт продавца для всех методов закрепления метаданных FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 1000 запросов | 60 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Parameters - **orderId** (integer (int64), path, required): ID сборочного задания (example: 5632423) ### Request Body **Content-Type:** application/json - **sgtins** (array (string)): Массив кодов маркировки. Допускается от 16 до 135 символов для кода одной маркировки. ### Responses #### 204 - Отправлено Empty response body #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 404 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 409 - Ошибка добавления маркировки **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X PUT "https://api.example.com/api/v3/orders/{orderId}/meta/sgtin" \ -H "Content-Type: application/json" \ -d '{ "sgtins": [ "1234567890123456" ] }' ``` ``` -------------------------------- ### PUT /api/v3/orders/{orderId}/meta/gtin Source: https://dev.wildberries.ru/api/swagger/yaml/ru/03-orders-fbs.yaml Метод обновляет GTIN в [метаданных сборочного задания](/openapi/orders-fbs#tag/Metadannye-FBS/paths/~1api~1marketplace~1v3~1orders~1meta/post) — уникальный ID товара в Беларуси.

У одного сборочного задания может быть только один GTIN. Добавлять маркировку можно только для заказов, которые доставляются WB и находятся в [статусе](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/~1api~1v3~1orders~1status/post) `confirm`.
Лимит запросов на один аккаунт продавца для всех методов закрепления метаданных FBS: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 1000 запросов | 60 мс | 20 запросов | Один запрос с кодом ответа 409 учитывается как 10 запросов
```markdown ### Parameters - **orderId** (integer (int64), path, required): ID сборочного задания (example: 5632423) ### Request Body **Content-Type:** application/json - **gtin** (string) (required): GTIN (example: "1234567890123") ### Responses #### 204 - Обновлено Empty response body #### 400 - Неправильный запрос **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - response **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 409 - Ошибка обновления метаданных **Error** - **code** (string): Код ошибки - **message** (string): Описание ошибки - **data** (object): Дополнительные данные ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X PUT "https://api.example.com/api/v3/orders/{orderId}/meta/gtin" \ -H "Content-Type: application/json" \ -d '{ "gtin": "1234567890123" }' ``` ```