FBW Supplies (ordersfbw)
This section describes the methods for getting:
This section describes the methods for getting:
Getting information for forming supplies to WB warehouses:
Acceptance coefficients{{ /api/v1/acceptance/coefficients }}
The method returns the acceptance coefficients for specific warehouses for the next 14 days.
`coefficient` — `0` or `1`
and
`allowUnload` — `true`
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 6 requests | 10 seconds | 6 requests |
Authorizations:
query Parameters
warehouseIDs | string Example: warehouseIDs=507,117501 Warehouse IDs. |
Responses
Response samples
- 200
- 400
- 401
- 429
[- {
- "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
}
]
Acceptance options{{ /api/v1/acceptance/options }}
The method returns information about warehouses and package types available for supply. The warehouses list is determined by product's barcode and quantity
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 6 requests | 10 seconds | 6 requests |
Authorizations:
query Parameters
warehouseID | string Example: warehouseID=507 Warehouse ID. |
Request Body schema: application/jsonrequired
quantity | integer [ 1 .. 999999 ] Total quantity of products planned for supply. |
barcode | string Barcode from the card of the product |
Responses
Request samples
- Payload
[- {
- "quantity": 1,
- "barcode": "k"
}, - {
- "quantity": 7,
- "barcode": "1111111111"
}
]
Response samples
- 200
- 400
- 401
- 429
{- "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"
}
Warehouses list{{ /api/v1/warehouses }}
The method returns Wildberries warehouses list.
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 6 requests | 10 seconds | 6 requests |
Authorizations:
Responses
Response samples
- 200
- 401
- 429
[- {
- "ID": 300461,
- "name": "Гомель 2",
- "address": "Гомель, Могилёвская улица 1/А",
- "workTime": "24/7",
- "acceptsQR": false,
- "isActive": false,
- "isTransitActive": true
}
]
Transit directions{{ /api/v1/transit-tariffs }}
The method returns information about available transit directions.
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 6 requests | 10 seconds | 10 requests |
Authorizations:
Responses
Response samples
- 200
- 401
- 429
[- {
- "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
}
]
Getting information about product supplies for storage in WB warehouses:
Supplies list{{ /api/v1/supplies }}
The method returns a list of supplies, the last 1000 supplies by default.
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 30 requests | 2 seconds | 10 requests |
Authorizations:
query Parameters
limit | integer [ 1 .. 1000 ] Default: 1000 Number of objects in the response |
offset | integer Default: 0 From which element to start outputting data |
Request Body schema: application/jsonrequired
Array of objects (models.DateFilterRequest) Filter by dates | |
statusIDs | Array of integers (models.HandySupplyStatus) Items Enum: 1 2 3 4 5 6 7 Filter the supply by statuses. Possible values:
|
Responses
Request samples
- Payload
{- "dates": [
- {
- "from": "2024-03-04",
- "till": "2025-03-24",
- "type": "factDate"
}
], - "statusIDs": [
- 5,
- 6
]
}
Response samples
- 200
- 400
- 401
- 429
[- {
- "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": "Отгружено на воротах"
}
]
Supply details{{ /api/v1/supplies/{ID} }}
The method returns supply details by ID.
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 30 requests | 2 seconds | 10 requests |
Authorizations:
path Parameters
ID required | integer ID of the supply or the order |
query Parameters
isPreorderID | boolean Default: false Search by:
|
Responses
Response samples
- 200
- 400
- 401
- 404
- 429
{- "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
}
Supply products{{ /api/v1/supplies/{ID}/goods }}
The method returns information about the products in the supply.
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 30 requests | 2 seconds | 10 requests |
Authorizations:
path Parameters
ID required | integer ID of the supply or the order |
query Parameters
limit | integer [ 1 .. 1000 ] Default: 100 Number of objects in the response |
offset | integer Default: 0 From which element to start outputting data |
isPreorderID | boolean Default: false Search by:
|
Responses
Response samples
- 200
- 400
- 401
- 429
[- {
- "barcode": "1234567891234",
- "vendorCode": "wb4sewt0vg",
- "nmID": 987456654,
- "needKiz": true,
- "tnved": "6204430000",
- "techSize": "C",
- "color": "красный",
- "supplierBoxAmount": 10,
- "quantity": 10,
- "readyForSaleQuantity": 0,
- "unloadingQuantity": 0,
- "acceptedQuantity": 0
}
]
Supply package{{ /api/v1/supplies/{ID}/package }}
The method returns information about the package of the supply.
Period | Limit | Interval | Burst |
---|---|---|---|
1 minute | 30 requests | 2 seconds | 10 requests |
Authorizations:
path Parameters
ID required | integer Supply ID |
Responses
Response samples
- 200
- 400
- 401
- 429
[- {
- "packageCode": "WB_689",
- "quantity": 1,
- "barcodes": [
- {
- "barcode": "1234567891234",
- "quantity": 1
}
]
}
]