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

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

Управление информацией для формирования поставок, складскими данными и статусами. Получение информации о поставках.

Поставки FBW

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

Управление информацией для формирования поставок, складскими данными и статусами. Получение информации о поставках.

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

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

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

Коэффициенты приёмки{{ /api/v1/acceptance/coefficients }}

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

Возвращает коэффициенты приёмки для конкретных складов на ближайшие 14 дней.

Приёмка для поставки доступна только при сочетании:
`coefficient` — `0` или `1`
и
`allowUnload` — `true`

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	6 запросов	10 секунд	6 запросов

Authorizations:

HeaderApiKey

query Parameters

warehouseIDs

string

Example: warehouseIDs=507,117501

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

Responses

Response samples

200
400
401
429

Content type

application/json

[{"date": "2024-04-11T00:00:00Z",
"coefficient": -1,
"warehouseID": 217081,
"warehouseName": "Сц Брянск 2",
"allowUnload": false,
"boxTypeName": "Суперсейф",
"boxTypeID": 6,
"storageCoef": null,
"deliveryCoef": null,
"deliveryBaseLiter": null,
"deliveryAdditionalLiter": null,
"storageBaseLiter": null,
"storageAdditionalLiter": null,
"isSortingCenter": true
}
]

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

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

Возвращает информацию о том, какие склады и типы упаковки доступны для поставки. Список складов определяется по баркоду товара и его количеству

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	6 запросов	10 секунд	6 запросов

Authorizations:

HeaderApiKey

query Parameters

warehouseID

string

Example: warehouseID=507

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

Request Body schema: application/json
required

Array (<= 5000 items)

quantity	integer [ 1 .. 999999 ] Суммарное количество товаров, планируемых для поставки. Максимум 999999
barcode	string Баркод из карточки товара

Responses

Request samples

Payload

Content type

application/json

[{"quantity": 1,
"barcode": "k"
},
{"quantity": 7,
"barcode": "1111111111"
}
]

Response samples

200
400
401
429

Content type

application/json

{"result": [{"barcode": "кrrr",
"warehouses": null,
"error": {"title": "barcode validation error",
"detail": "barcode кrrr is not found"
},
"isError": true
},
{"barcode": "123456789",
"warehouses": [{"warehouseID": 205349,
"canBox": true,
"canMonopallet": false,
"canSupersafe": false
},
{"warehouseID": 211622,
"canBox": false,
"canMonopallet": true,
"canSupersafe": false
},
{"warehouseID": 214951,
"canBox": true,
"canMonopallet": false,
"canSupersafe": false
},
{"warehouseID": 206319,
"canBox": true,
"canMonopallet": false,
"canSupersafe": false
}
]
}
],
"requestId": "kr53d2bRKYmkK2N6zaNKHs"
}

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

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

Возвращает список складов WB

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	6 запросов	10 секунд	6 запросов

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
429

Content type

application/json

[{"ID": 300461,
"name": "Гомель 2",
"address": "Гомель, Могилёвская улица 1/А",
"workTime": "24/7",
"acceptsQR": false,
"isActive": false,
"isTransitActive": true
}
]

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

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

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

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	6 запросов	10 секунд	10 запросов

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
429

Content type

application/json

[{"transitWarehouseName": "Обухово",
"destinationWarehouseName": "Краснодар",
"activeFrom": "2024-11-03T21:01:00Z",
"boxTariff": null,
"palletTariff": 7500
},
{"transitWarehouseName": "СЦ Гомель 2",
"destinationWarehouseName": "Краснодар (Тихорецкая)",
"activeFrom": "2025-04-08T21:00:48.019Z",
"boxTariff": [{"from": 0,
"to": 1500,
"value": 5.3
},
{"from": 1500,
"to": 0,
"value": 3.9
}
],
"palletTariff": 6500
}
]

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

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

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

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

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

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

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	30 запросов	2 секунды	10 запросов

Authorizations:

HeaderApiKey

query Parameters

limit	integer [ 1 .. 1000 ] Default: 1000 Количество записей в ответе
offset	integer Default: 0 После какого элемента выдавать данные

Request Body schema: application/json
required

	Array of objects (models.DateFilterRequest) Фильтр по датам
statusIDs	Array of integers (models.HandySupplyStatus) Items Enum: 1 2 3 4 5 6 7 Фильтр поставок по статусам. Возможные значения: `1` — Не запланировано `2` — Запланировано `3` — Отгрузка разрешена `4` — Идёт приёмка `5` — Принято `6` — Отгружено на воротах

Responses

Request samples

Payload

Content type

application/json

{"dates": [{"from": "2024-03-04",
"till": "2025-03-24",
"type": "factDate"
}
],
"statusIDs": [5,
6
]
}

Response samples

200
400
401
429

Content type

application/json

[{"phone": "+7 916 *** 44 44",
"supplyID": null,
"preorderID": 34597755,
"createDate": "2024-12-29T16:58:26+03:00",
"supplyDate": null,
"factDate": null,
"updatedDate": null,
"statusName": "Не запланировано"
},
{"phone": "+7 916 *** 33 33",
"supplyID": 26596368,
"preorderID": 34601223,
"createDate": "2024-12-29T16:57:59+03:00",
"supplyDate": "2024-12-29T00:00:00+03:00",
"factDate": null,
"updatedDate": null,
"statusName": "Запланировано"
},
{"phone": "+7 000 *** 36 76",
"supplyID": 22677736,
"preorderID": 27363170,
"createDate": "2024-08-22T18:10:59+03:00",
"supplyDate": "2024-08-22T00:00:00+03:00",
"factDate": "2024-08-22T12:24:14+03:00",
"updatedDate": "2024-08-22T18:33:45+03:00",
"statusName": "Отгружено на воротах"
}
]

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

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

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

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	30 запросов	2 секунды	10 запросов

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

200
400
401
404
429

Content type

application/json

{"phone": "+7 903 *** 98 62",
"statusName": "Принято",
"boxTypeID": 5,
"boxTypeName": "Монопаллеты",
"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
}

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

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

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

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	30 запросов	2 секунды	10 запросов

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

200
400
401
429

Content type

application/json

[{"barcode": "1234567891234",
"vendorCode": "wb4sewt0vg",
"nmID": 987456654,
"needKiz": true,
"tnved": "6204430000",
"techSize": "C",
"color": "красный",
"supplierBoxAmount": 10,
"quantity": 10,
"readyForSaleQuantity": 0,
"unloadingQuantity": 0,
"acceptedQuantity": 0
}
]

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

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

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

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	30 запросов	2 секунды	10 запросов

Authorizations:

HeaderApiKey

path Parameters

ID

required

integer

ID поставки

Responses

Response samples

200
400
401
429

Content type

application/json

[{"packageCode": "WB_689",
"quantity": 1,
"barcodes": [{"barcode": "1234567891234",
"quantity": 1
}
]
}
]

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