---
title: "Создать поставку FBS у площадки"
method: POST
path: "/api/v1/marketplace/{platform}/fbs-supplies"
tags: ["Marketplace supplies"]
---

# Создать поставку FBS у площадки

`POST /api/v1/marketplace/{platform}/fbs-supplies`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marketplace/{platform}/fbs-supplies`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Заводит поставку в кабинете площадки (Wildberries POST
/api/v3/supplies) ключом магазина на запись и у нас. wave_id — сразу
сделать её поставкой волны. Нет ключа — 409
marketplace.fbs_supply.credentials_missing. Читает `Idempotency-Key`.

## Path parameters

- `platform` 'wildberries', required

## Headers

- `X-Tenant` string, required
- `Idempotency-Key` string

## Request body

- MarketplaceFbsSupplyCreateInput
  - `store_id` string, uuid
  - `name` string
  - `wave_id` string, uuid

## Response `201`

Поставка

- MarketplaceFbsSupplyEnvelope
  - `supply` MarketplaceFbsSupply, required
    - `id` string, uuid, required
    - `platform` 'wildberries', required
    - `store_id` string, uuid, required
    - `store_name` string, required
    - `external_id` string, required: Номер поставки у площадки
    - `name` string, required
    - `origin` 'akeda' | 'platform', required: Кто завёл: Akeda или кабинет площадки
    - `status` 'open' | 'delivered' | 'deleted', required
    - `cargo_type` integer, nullable, required
    - `platform_created_at` string, date-time, nullable, required
    - `delivered_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `synced_at` string, date-time, nullable, required
    - `last_error` string
    - `last_reason` string
    - `orders` object[], required
      - `posting` string, required
      - `source` 'akeda' | 'platform', required
      - `added_at` string, date-time, nullable, required
      - `packed` boolean, required
      - `wave_number` integer
      - `marks_status` 'none' | 'not_sent' | 'sent' | 'accepted' | 'rejected', required
    - `orders_count` integer, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Idempotency-Key уже использован для другого запроса: другое тело, другой адрес или другая операция. Код `idempotency.key_mismatch`; сохранённый ответ не раскрывается. Для новой команды берут новый ключ.
- `503`: Хранилище ключей идемпотентности недоступно, команда с заголовком Idempotency-Key не выполнялась. Код `idempotency.unavailable`; Retry-After говорит, когда повторить.

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)