# Wildberries API: Собрать заказы FBS и передать поставку в доставку

Сценарий из mcp-everything. Актуально на 2026-10-24.

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

1. Создай токен в кабинете продавца с категорией «Маркетплейс» и проверь его запросом /ping на хосте https://marketplace-api.wildberries.ru.
2. Забери новые заказы: GET /api/v3/orders/new. Каждый заказ — сборочное задание с id, артикулом и складом.
3. Создай поставку: POST /api/v3/supplies с name. В ответе — id поставки вида WB-GI-1234567.
4. Добавь задания в поставку: PATCH /api/marketplace/v3/supplies/{supplyId}/orders с массивом orders (до 100 за запрос). Задания перейдут в статус confirm.
5. Напечатай стикеры: POST /api/v3/orders/stickers с type (png, svg или zpl), width и height (58×40 или 40×30) и orders — до 100 заданий. Наклей стикер на каждую упаковку.
6. Когда всё собрано, закрой поставку: PATCH /api/v3/supplies/{supplyId}/deliver. Задания уйдут в доставку.

```bash
H="Authorization: $WB_TOKEN"
API=https://marketplace-api.wildberries.ru

curl "$API/api/v3/orders/new" -H "$H"

SUPPLY=$(curl -s -X POST "$API/api/v3/supplies" -H "$H" -H 'Content-Type: application/json' \
  -d '{"name": "Поставка 24.10"}' | jq -r .id)

curl -X PATCH "$API/api/marketplace/v3/supplies/$SUPPLY/orders" -H "$H" -H 'Content-Type: application/json' \
  -d '{"orders": [5632423, 5632424]}'

curl -X POST "$API/api/v3/orders/stickers?type=png&width=58&height=40" -H "$H" -H 'Content-Type: application/json' \
  -d '{"orders": [5632423, 5632424]}'

curl -X PATCH "$API/api/v3/supplies/$SUPPLY/deliver" -H "$H"
```

## Базовые URL

- Боевой (Контент): `https://content-api.wildberries.ru`
- Тестовый (Контент): `https://content-api-sandbox.wildberries.ru`
- Боевой (Цены и скидки): `https://discounts-prices-api.wildberries.ru`
- Тестовый (Цены и скидки): `https://discounts-prices-api-sandbox.wildberries.ru`
- Боевой (Маркетплейс): `https://marketplace-api.wildberries.ru`
- Боевой (Статистика): `https://statistics-api.wildberries.ru`
- Тестовый (Статистика): `https://statistics-api-sandbox.wildberries.ru`
- Боевой (Аналитика): `https://seller-analytics-api.wildberries.ru`
- Боевой (Продвижение): `https://advert-api.wildberries.ru`
- Боевой (Вопросы и отзывы): `https://feedbacks-api.wildberries.ru`
- Боевой (Чат с покупателями): `https://buyer-chat-api.wildberries.ru`
- Боевой (Поставки): `https://supplies-api.wildberries.ru`
- Боевой (Возвраты): `https://returns-api.wildberries.ru`
- Боевой (Документы): `https://documents-api.wildberries.ru`
- Боевой (Тарифы, Новости): `https://common-api.wildberries.ru`

## Авторизация

Тип: API-ключ

Токен создаётся в кабинете продавца: «Настройки» → «Доступ к API» → выбрать категории → «Создать токен». Сохраните его сразу — повторно посмотреть нельзя. Токен — JWT, действует 180 дней. Передаётся в заголовке `Authorization`.

Типы токенов: стандартный (полный доступ к выбранным категориям), тестовый (работает только в песочнице) и «только на чтение». Категория токена должна совпадать с категорией вызываемого API, иначе будет `401`.

Проверить доступ можно методом `/ping` на хосте категории, например `https://content-api.wildberries.ru/ping`. Ответ:

```
{"TS": "...", "Status": "OK"}
```

## Методы сценария

### GET /api/v3/orders/new — Новые сборочные задания

Хост «Маркетплейс». Возвращает все новые сборочные задания (FBS). Параметров нет.

### POST /api/v3/supplies — Создание поставки

Возвращает ID поставки.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `name` | body | string | да | Название, 1–128 символов |

### PATCH /api/marketplace/v3/supplies/{supplyId}/orders — Добавить задания в поставку

Добавляет до 100 сборочных заданий к поставке и переводит их в статус `confirm`. Может перемещать задания между активными поставками.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `supplyId` | path | string | да | ID поставки, например WB-GI-1234567 |
| `orders` | body | array | да | ID сборочных заданий, от 1 до 100 |

### PATCH /api/v3/supplies/{supplyId}/deliver — Передать поставку в доставку

Закрывает поставку и переводит её задания в статус доставки.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `supplyId` | path | string | да | ID поставки |

### POST /api/v3/orders/stickers — Стикеры сборочных заданий

Стикеры для заданий в статусе `confirm`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `type` | query | string | да | svg, zplv, zplh или png |
| `width` | query | integer | да | 58 или 40 |
| `height` | query | integer | да | 40 или 30 |
| `orders` | body | array | да | ID заданий, от 1 до 100 |

## Нюансы

- У каждой категории свой хост и свой токен-доступ; токен без нужной категории даёт `401`.
- Лимиты работают по алгоритму token bucket: допустимы всплески, а `X-Ratelimit-Remaining` показывает, сколько запросов можно сделать без задержки.
- При `429` приходят заголовки `X-Ratelimit-Retry` (через сколько секунд повторять), `X-Ratelimit-Limit` (размер всплеска) и `X-Ratelimit-Reset` (через сколько секунд всплеск восстановится). Повтор раньше `Retry` снова вернёт `429`.
- В категории «Маркетплейс» ответ `409` засчитывается как 5 запросов.
- Создание карточек асинхронное: успешный ответ не гарантирует создание, ошибки смотрят отдельным методом.
- Обновление карточки перезаписывает её целиком.

## Другие сценарии

- [Обновить остатки на своём складе](https://mcp-everything.ru/integrations/wildberries/scenarios/obnovit-ostatki-na-svoem-sklade.md)
- [Изменить цены и скидки](https://mcp-everything.ru/integrations/wildberries/scenarios/izmenit-tseny-i-skidki.md)
- [Выгрузить все карточки товаров](https://mcp-everything.ru/integrations/wildberries/scenarios/vygruzit-vse-kartochki-tovarov.md)
- [Создать карточку товара](https://mcp-everything.ru/integrations/wildberries/scenarios/sozdat-kartochku-tovara.md)

---

Если этого недостаточно — официальная документация: https://dev.wildberries.ru/openapi/api-information
Вся интеграция одним документом: https://mcp-everything.ru/integrations/wildberries.md