Поиск
API docs by Redocly

Поставки FBW (ordersfbw)

Узнать больше о поставках FBW можно в справочном центре

В разделе описаны методы получения:

Поставки FBW

Узнать больше о поставках FBW можно в справочном центре

В разделе описаны методы получения:

Информация для формирования поставок

Для доступа к методам используйте токен для категории Поставки

Получение информации для формирования поставок на склады WB:

  1. Опции приёмки
  2. Список складов
  3. Транзитные направления

Опции приёмки{{ /api/v1/acceptance/options }}

Описание метода

Метод временно отключён

Лимит запросов на один профиль продавца:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 6 запросов 10 сек 6 запросов
Сервисный 1 мин 6 запросов 10 сек 6 запросов
Базовый с секретом 1 мин 6 запросов 10 сек 6 запросов
Базовый 1 ч 2 запроса 30 мин 1 запрос
Authorizations:
HeaderApiKey
query Parameters
warehouseID
integer
Example: warehouseID=507

ID склада.
Если параметр не указан, возвращаются данные по всем складам.
Максимум одно значение

Request Body schema: application/json
required
Array (<= 5000 items)
quantity
integer [ 1 .. 999999 ]

Суммарное количество товаров, планируемых для поставки.
Максимум 999999

barcode
string

Баркод из карточки товара

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
{
  • "result": [
    ],
  • "requestId": "kr53d2bRKYmkK2N6zaNKHs"
}

Список складов{{ /api/v1/warehouses }}

Описание метода

Метод временно отключён

Лимит запросов на один профиль продавца:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 6 запросов 10 сек 6 запросов
Сервисный 1 мин 6 запросов 10 сек 6 запросов
Базовый с секретом 1 мин 6 запросов 10 сек 6 запросов
Базовый 12 ч 1 запрос 12 ч 1 запрос
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Транзитные направления{{ /api/v1/transit-tariffs }}

Описание метода

Метод временно отключён

Лимит запросов на один профиль продавца:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 6 запросов 10 сек 10 запросов
Сервисный 1 мин 6 запросов 10 сек 10 запросов
Базовый с секретом 1 мин 6 запросов 10 сек 10 запросов
Базовый 12 ч 1 запрос 12 ч 1 запрос
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Информация о поставках

Для доступа к методам используйте токен для категории Поставки

Получение информации о поставках товаров для хранения на складах WB:

  1. Список поставок
  2. Детали поставки
  3. Товары поставки
  4. Упаковка поставки

Список поставок{{ /api/v1/supplies }}

Описание метода

Метод возвращает список поставок, по умолчанию — последние 1000 поставок.

Лимит запросов на один профиль продавца:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 30 запросов 2 сек 10 запросов
Сервисный 1 мин 30 запросов 2 сек 10 запросов
Базовый с секретом 1 мин 30 запросов 2 сек 10 запросов
Базовый 1 ч 2 запроса 30 мин 1 запрос
Authorizations:
HeaderApiKey
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 1000

Количество записей в ответе

offset
integer
Default: 0

После какого элемента выдавать данные

Request Body schema: application/json
required
Array of objects

Фильтр по датам

statusIDs
Array of integers
Items Enum: 1 2 3 4 5 6

Фильтр поставок по статусам. Возможные значения:

  • 1 — Не запланировано
  • 2 — Запланировано
  • 3 — Отгрузка разрешена
  • 4 — Идёт приёмка
  • 5 — Принято
  • 6 — Отгружено на воротах

Responses

Request samples

Content type
application/json
{
  • "dates": [
    ],
  • "statusIDs": [
    ]
}

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Детали поставки{{ /api/v1/supplies/{ID} }}

Описание метода

Метод возвращает детали поставки по ID.

Лимит запросов на один профиль продавца:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 30 запросов 2 сек 10 запросов
Сервисный 1 мин 30 запросов 2 сек 10 запросов
Базовый с секретом 1 мин 30 запросов 2 сек 10 запросов
Базовый 1 ч 2 запроса 30 мин 1 запрос
Authorizations:
HeaderApiKey
path Parameters
ID
required
integer

ID поставки или заказа

query Parameters
isPreorderID
boolean
Default: false

Поиск по:

  • true — ID заказа, если в ID передаёте ID заказа
  • false — ID поставки, если в ID передаёте ID поставки

Responses

Response samples

Content type
application/json
{
  • "phone": "+7 903 *** 98 62",
  • "statusID": 5,
  • "boxTypeID": 2,
  • "createDate": "2025-07-15T17:17:45+03:00",
  • "supplyDate": "2025-07-15T00:00:00+03:00",
  • "factDate": "2025-07-18T11:37:32+03:00",
  • "updatedDate": "2025-07-18T12:59:53+03:00",
  • "warehouseID": 507,
  • "warehouseName": "Коледино",
  • "actualWarehouseID": 507,
  • "actualWarehouseName": "Коледино",
  • "transitWarehouseID": null,
  • "transitWarehouseName": "",
  • "acceptanceCost": 5000,
  • "paidAcceptanceCoefficient": 10,
  • "rejectReason": null,
  • "supplierAssignName": "Магазин",
  • "storageCoef": "215",
  • "deliveryCoef": "200",
  • "quantity": 10,
  • "readyForSaleQuantity": 0,
  • "acceptedQuantity": 10,
  • "unloadingQuantity": 10,
  • "depersonalizedQuantity": 0,
  • "discrepancies": 0,
  • "isBoxOnPallet": true
}

Товары поставки{{ /api/v1/supplies/{ID}/goods }}

Описание метода

Метод возвращает информацию о товарах в поставке.

Лимит запросов на один профиль продавца:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 30 запросов 2 сек 10 запросов
Сервисный 1 мин 30 запросов 2 сек 10 запросов
Базовый с секретом 1 мин 30 запросов 2 сек 10 запросов
Базовый 1 ч 2 запроса 30 мин 1 запрос
Authorizations:
HeaderApiKey
path Parameters
ID
required
integer

ID поставки или заказа

query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

Количество записей в ответе

offset
integer
Default: 0

После какого элемента выдавать данные

isPreorderID
boolean
Default: false

Поиск по:

  • true — ID заказа, если в ID передаёте ID заказа
  • false — ID поставки, если в ID передаёте ID поставки

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Упаковка поставки{{ /api/v1/supplies/{ID}/package }}

Описание метода

Метод возвращает информацию об упаковке поставки.

Лимит запросов на один профиль продавца:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 30 запросов 2 сек 10 запросов
Сервисный 1 мин 30 запросов 2 сек 10 запросов
Базовый с секретом 1 мин 30 запросов 2 сек 10 запросов
Базовый 1 ч 2 запроса 30 мин 1 запрос
Authorizations:
HeaderApiKey
path Parameters
ID
required
integer

ID поставки

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Расхождения в поставке{{ /api/supplies/v1/discrepancies/{supplyId} }}

Описание метода
Метод доступен по Персональному токену, Сервисному токену

Метод возвращает информацию о выявленных расхождениях между заявленным и фактическим количеством товара в поставке.
Для поставок принятых не позднее года назад.

Типы расхождений:

Расхождение в большую сторону:

  1. Избыток товара с заявленным баркодом:
  • "discrepancyType": "surplus"
  • "discrepancyLabel": "surplus"
  1. Избыток товара с несоответствующим заявленному баркодом:
  • "discrepancyType": "surplus"
  • "discrepancyLabel": "re-sorting"

Расхождение в меньшую сторону:

  1. Не хватает товара:
  • "discrepancyType": "shortage"
  • "discrepancyLabel": "shortage"
  1. Некоторые баркоды не соответствуют заявленным:
  • "discrepancyType": "shortage"
  • "discrepancyLabel": "re-sorting"
Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 1 запрос 1 мин 1 запрос
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string <integer>

ID поставки

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Черновики поставок

Для доступа к методам используйте токен для категории Поставки

Методы работы с черновиками поставок:

  1. Создать черновик
  2. Добавить товары в черновик
  3. Список черновиков
  4. Список товаров в черновике
  5. Удалить товары из черновика
  6. Удалить черновик

Список черновиков{{ /api/supplies/v1/drafts }}

Описание метода
Метод доступен по Персональному токену, Сервисному токену

Метод возвращает список черновиков поставок.

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 30 запросов 2 сек 10 запросов
Authorizations:
HeaderApiKey
query Parameters
limit
integer [ 0 .. 1000 ]
Default: 1000

Количество черновиков в ответе

offset
integer >= 0
Default: 0

Сколько элементов пропустить. Например, для значения 10 ответ начнется с 11 элемента

sort
string
Default: createDt
Enum: createDt updateDt

Сортировка:

  • createdDt — по дате создания черновика
  • updatedDt — по дате обновления черновика
order
string
Default: desc
Enum: asc desc

Порядок выдачи:

  • desc — по убыванию
  • asc — по возрастанию

Responses

Response samples

Content type
application/json
{
  • "drafts": [
    ],
  • "total": 1
}

Создать черновик{{ /api/supplies/v1/drafts }}

Описание метода
Метод доступен по Персональному токену, Сервисному токену

Метод создаёт пустой черновик поставки.

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 30 запросов 2 сек 10 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "draftId": "cd20d135-f13f-47a0-903c-3bd268b92047"
}

Удалить черновик{{ /api/supplies/v1/drafts/{draftId} }}

Описание метода
Метод доступен по Персональному токену, Сервисному токену

Метод удаляет черновик поставки по его ID.

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 30 запросов 2 сек 10 запросов
Authorizations:
HeaderApiKey
path Parameters
draftId
required
string <UUID>

ID черновика

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "title": "bad request",
  • "detail": "Неверный формат draftId",
  • "requestId": "a6bdc2a4d2fde51c2036fa8af2483886",
  • "origin": "supply-api"
}

Список товаров в черновике{{ /api/supplies/v1/drafts/{draftId}/items }}

Описание метода
Метод доступен по Персональному токену, Сервисному токену

Метод возвращает список товаров черновика.

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 30 запросов 2 сек 10 запросов
Authorizations:
HeaderApiKey
path Parameters
draftId
required
string

ID черновика

Responses

Response samples

Content type
application/json
{
  • "items": [],
  • "skuQuantity": 1,
  • "itemQuantity": 1
}

Добавить товары в черновик{{ /api/supplies/v1/drafts/{draftId}/items }}

Описание метода
Метод доступен по Персональному токену, Сервисному токену

Метод добавляет товары в черновик поставки.

Метод работает по принципу атомарности:

  • если все баркоды прошли валидацию успешно, то все товары добавятся в черновик. В ответе вернётся {"results":[]}
  • если хотя бы один баркод не прошел валидацию, ни один товар в черновик не добавится. В ответе вернётся список невалидных баркодов
Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 30 запросов 2 сек 10 запросов
Authorizations:
HeaderApiKey
path Parameters
draftId
required
string

ID черновика

Request Body schema: application/json
required
required
Array of objects <= 1000 items

Список товаров

Responses

Request samples

Content type
application/json
{
  • "items": [
    ]
}

Response samples

Content type
application/json
Example

Переданы некорректные баркоды. Ни один баркод не добавлен в черновик

{
  • "results": [
    ]
}

Удалить товары из черновика{{ /api/supplies/v1/drafts/{draftId}/items }}

Описание метода
Метод доступен по Персональному токену, Сервисному токену

Метод удаляет товары из черновика поставки по списку баркодов.

Баркоды не валидируются. Если в запросе вы передали некорректные баркоды, вы не получите ошибку. При этом корректные баркоды будут удалены из черновика.
Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 30 запросов 2 сек 10 запросов
Authorizations:
HeaderApiKey
path Parameters
draftId
required
string

ID черновика

Request Body schema: application/json
required
skus
required
Array of strings non-empty

Список баркодов

Responses

Request samples

Content type
application/json
{
  • "skus": [
    ]
}

Response samples

Content type
application/json

Успешно

{
  • "results": [ ]
}