### 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"
}'
```
```