Seller API Test Environment
Use the test scope of the service to set up the integration.
For authorization you need to use the token with the Test scope type.
The data in the test scope is randomly generated and does not belong to real sellers.
The using of the test scope does not carry the risk of unintentional disclosure of information.
Use the test scope of the service to set up the integration.
For authorization you need to use the token with the Test scope type.
The data in the test scope is randomly generated and does not belong to real sellers.
The using of the test scope does not carry the risk of unintentional disclosure of information.
To access the test environment, use the https://advert-api-sandbox.wildberries.cn address.
Campaigns will be deleted 30 days after the last modifications.
Deleted campaigns (-1 status) will be removed after 3 minutes.
A maximum of 50 campaigns can be created.
The maximum number of requests is the same as in the main API.
Statistics are generated only for campaigns of type 8 — automatic campaign and 9 — Auction.
To generate statistics:
- the campaign must be in status
9— on impressions - type
8campaign must have a positive bid - type
9campaign must have a positive bid in the catalog - the campaign budget must be positive
You can list items in the Content sandbox and use it in the Promotion sandbox.
Top-up test balance{{ /adv/v1/test/update/balance }}
Updates test balance, account and bonuses
Authorizations:
Request Body schema: application/json
| balance | integer Account top-up amount, ₽ |
| net | integer Balance top-up amount, ₽ |
| bonus | integer Bonuses top-up amount, ₽ |
Responses
Request samples
- Payload
{- "balance": 1000,
- "net": 1000,
- "bonus": 1000
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "balance": 9100,
- "net": 8000,
- "bonus": 10000
}To access the test environment, use the https://marketplace-api-sandbox.wildberries.cn address.
You can list items in the content sandbox and use the generated listing SKUs in the marketplace sandbox.
Regular expressions are used for:
- Supplies IDs —
^WB-GI-SAND-[0-9]+$ - Boxes IDs —
^WB-TRBX-SAND-[0-9]+$
There are two types of statuses for the assembly orders:
- supplierStatus — a status that can be changed by the seller.
- wbStatus — a status in the system. It can only be changed by WB.
In the sandbox, you can emulate WB actions by manually changing the wbStatus field. Use the following statuses:
| wbStatus | supplierStatus | Description | How to move the order to this status |
|---|---|---|---|
| waiting | new | New assembly order | Create a test FBS assembly order |
| declined_by_client | new | The assembly order was canceled by the buyer. It is available for one hour after creating an assembly order, only in the sandbox. | Notify that the buyer has canceled the order |
| waiting | confirm | On assembly | Add the order to the supply |
| canceled | cancel | The assembly order was canceled by the seller. Available at any stage until the supply is moved to the delivery. | Cancel the assembly order |
| waiting | complete | In delivery | Move the supply to the delivery |
| sorted | complete | WB has accepted the assembly order | Close supply |
| ready_for_pickup | complete | The order has arrived at the pickup point | Notify that the order has arrived at the pickup point |
| sold | complete | The buyer has received the order at the pickup point | Notify that the order has been accepted by the buyer |
| canceled_by_client | complete | The buyer has canceled the order upon receipt at the pickup point | Notify that the buyer has declined the order |
| defect | complete | The buyer has canceled the order due to a defect | Notify that the buyer has canceled the order due to a defect |
Create test FBS assembly orders{{ /api/v3/test/fbs/orders/make }}
The method allows you to create test FBS assembly orders, emulating buyer's actions.
A single request creates assembly orders for items from one buyer's cart. They share a single transaction ID — orderUid, which is included in the responses of methods for retrieving new and all assembly orders.
An assembly order could be created if:
- All item SKUs from the request have inventory in FBS warehouses.
- The inventory in the warehouse is greater than or equal to the amount in the request.
- The price of the item is not zero.
Authorizations:
Request Body schema: application/jsonrequired
required | Array of objects or null [ 1 .. 10 ] items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "amount": 1,
- "sku": "SKUTest123"
}
]
}Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Notify that the buyer has canceled the order{{ /api/v3/test/fbs/orders/{orderId}/decline }}
Method transfers the assembly order to the status "wbStatus":"declined_by_client" — declined by the buyer. It is available for one hour after creating an assembly order.
The method emulates WB actions
Authorizations:
path Parameters
| orderId required | integer <int64> >= 1 Assembly order ID |
Responses
Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Close supply{{ /api/v3/test/fbs/supplies/{supplyId}/close }}
The method closes the FBS supply and marks all assembly orders as requiring reshipment.
All orderId listed in the request are marked as requiring reshipment. Unspecified orderId related to the given supplyId are set to "wbStatus": "sorted".
The method emulates WB actions
Authorizations:
path Parameters
| supplyId required | string^WB-GI-SAND-[0-9]+$ Supply ID |
Request Body schema: application/json
| orderIds required | Array of integers or null <int64> >= 0 |
Responses
Request samples
- Payload
{- "orderIds": [
- 9007199254740991
]
}Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Notify that the order has arrived at the pickup point{{ /api/v3/test/fbs/orders/{orderId}/deliver }}
Method transfers the assembly order to the status "wbStatus":"ready_for_pickup" — the order has arrived at the pickup point.
The method emulates WB actions
Authorizations:
path Parameters
| orderId required | integer <int64> >= 1 Assembly order ID |
Responses
Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Notify that the order has been accepted by the buyer{{ /api/v3/test/fbs/orders/{orderId}/receive }}
Method transfers the assembly order to the status "wbStatus":"sold" — received by the buyer.
The method emulates WB actions
Authorizations:
path Parameters
| orderId required | integer <int64> >= 1 Assembly order ID |
Request Body schema: application/json
| code required | string Order retrieval code. In the test environment, you can use any combination of characters. |
Responses
Request samples
- Payload
{- "code": "string"
}Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Notify that the buyer has declined the order{{ /api/v3/test/fbs/orders/{orderId}/reject }}
Method transfers the assembly order to the status "wbStatus":"canceled_by_client" — declined upon receipt.
The method emulates WB actions
Authorizations:
path Parameters
| orderId required | integer <int64> >= 1 Assembly order ID |
Request Body schema: application/json
| code required | string Order retrieval code. In the test environment, you can use any combination of characters. |
Responses
Request samples
- Payload
{- "code": "string"
}Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Notify that the buyer has canceled the order due to a defect{{ /api/v3/test/fbs/orders/{orderId}/defect }}
Method transfers the assembly order to the status "wbStatus":"defect" — cancellation of the order due to a defect.
The method emulates WB actions
Authorizations:
path Parameters
| orderId required | integer <int64> >= 1 Assembly order ID |
Responses
Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}To access the test environment, use the https://feedbacks-api-sandbox.wildberries.cn address.
In the sandbox you can create test Questions and Feedbacks. Created Questions and Feedbacks are stored for 5 days
Create test feedbacks{{ /api/v1/test/make/feedbacks/batch }}
The method creates test feedbacks for test WB item numbers.
nmID are passed in the request, you will receive a successful response, but the feedbacks will not be created.
Authorizations:
Request Body schema: application/json
required | Array of objects <= 1000 items |
Responses
Request samples
- Payload
{- "feedbacks": [
- {
- "nmId": 123456789,
- "texts": [
- "Первый отзыв",
- "Второй отзыв",
- "Третий отзыв"
]
}, - {
- "nmId": 987654321,
- "texts": [ ]
}
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "nmId": 123456789,
- "feedbackIds": [
- "THI5C30CUyyHR9a6",
- "GZ1cVhwiVISKBwDW",
- "u4H0tIKOapinkxRN"
]
}, - {
- "nmId": 331645,
- "feedbackIds": [
- "ZAgd9FSSWglIuGrB"
]
}
]
}Delete test feedbacks{{ /api/v1/test/delete/feedbacks }}
The method removes test feedbacks.
Authorizations:
Request Body schema: application/jsonrequired
| ids required | Array of strings <= 1000 items List of feedback IDs |
Responses
Request samples
- Payload
{- "ids": [
- "vRyfJrG7LLiNtEQJ",
- "aB3cD4eF5gH6iJ7k"
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "results": [
- {
- "id": "vRyfJrG7LLiNtEQJ",
- "success": true
}, - {
- "id": "aB3cD4eF5gH6iJ7k",
- "error": {
- "status": 404,
- "title": "Not Found",
- "detail": "Feedback aB3cD4eF5gH6iJ7k not found"
}
}
]
}Create test questions{{ /api/v1/test/make/questions/batch }}
The method creates test questions for test WB item numbers.
nmID are passed in the request, you will receive a successful response, but the questions will not be created.
Authorizations:
Request Body schema: application/json
required | Array of objects <= 1000 items |
Responses
Request samples
- Payload
{- "questions": [
- {
- "nmId": 123456789,
- "texts": [
- "Первый вопрос",
- "Второй вопрос",
- "Третий вопрос"
]
}, - {
- "nmId": 987654321,
- "texts": [ ]
}
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "nmId": 333885,
- "questionIds": [
- "z1euscflMAbjVnp5",
- "5XS3EkL2keJJdKMO",
- "5UZ69YEGdwODwX8d"
]
}, - {
- "nmId": 331645,
- "questionIds": [
- "VXp6I50x9XT8UQZd"
]
}
]
}Delete test questions{{ /api/v1/test/delete/questions }}
The method removes test questions.
Authorizations:
Request Body schema: application/jsonrequired
| ids required | Array of strings <= 1000 items List of question IDs |
Responses
Request samples
- Payload
{- "ids": [
- "HZcc1B6yfYERUVcu",
- "aB3cD4eF5gH6iJ7k"
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "results": [
- {
- "id": "HZcc1B6yfYERUVcu",
- "success": true
}, - {
- "id": "aB3cD4eF5gH6iJ7k",
- "error": {
- "status": 404,
- "title": "Not Found",
- "detail": "Question aB3cD4eF5gH6iJ7k not found"
}
}
]
}To access the test environment, use the https://content-api-sandbox.wildberries.cn address
Delete listings from trash{{ /content/v1/cards/delete }}
The method deletes listings from the trash. You can not restore the listings after deleting them.
Use this method to free up space for creating new listings, including when approaching or reaching the limit on the number of listings.
Authorizations:
Request Body schema: application/jsonrequired
| nmIds required | Array of integers <int64> [ 1 .. 1000 ] items [ items <int64 > ] List of WB item numbers |
Responses
Request samples
- Payload
{- "nmIds": [
- 123456789,
- 987654321
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "nmId": 320791,
- "error": {
- "status": 404,
- "title": "Not Found",
- "detail": "nmID 123456789 does not exist"
}
}, - {
- "nmId": 987654321,
- "success": true
}
], - "error": false,
- "errorText": "",
- "additionalErrors": { }
}Create test DBS assembly orders{{ /api/v3/test/dbs/orders/make }}
The method allows you to create test DBS assembly orders, emulating buyer's actions.
A single request creates assembly orders for items from one buyer's cart. They share a single transaction ID — orderUid, which is included in the responses of methods for retrieving new and completed assembly orders.
An assembly order could be created if:
- All item SKUs from the request have inventory in DBS warehouses.
- The inventory in the warehouse is greater than or equal to the amount in the request.
- The price of the item is not zero.
Authorizations:
Request Body schema: application/jsonrequired
required | Array of objects [ 1 .. 10 ] items Array of item SKUs and item inventory for the assembly order |
object Delivery address of the assembly order. |
Responses
Request samples
- Payload
{- "orders": [
- {
- "sku": "SKUTest123",
- "amount": 1
}
], - "address": {
- "region": "Челябинская область",
- "locality": "Архангельское",
- "street": "переулок Солнечный",
- "houseNumber": "8А к 1",
- "entrance": "5",
- "intercom": "4857",
- "floor": "4",
- "apartment": "18"
}
}Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Notify that the buyer has canceled the order{{ /api/v3/test/dbs/orders/{orderId}/decline }}
Method transfers the assembly order to the "wbStatus":"declined_by_client" — declined by the buyer. It is available for one hour after creating an assembly order.
The method emulates WB actions
Authorizations:
path Parameters
| orderId required | integer <int64> >= 1 Assembly order ID |
Responses
Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Create test In-Store Pickup assembly orders{{ /api/v3/test/click-collect/orders/make }}
The method allows you to create test In-Store Pickup assembly orders, emulating buyer's actions.
A single request creates assembly orders for items from one buyer's cart with the same orderCode — buyer order ID, which is included in the response of the method for getting new assembly orders.
An assembly order could be created if:
- All item SKUs from the request have inventory in warehouses.
- The inventory in the warehouse is greater than or equal to the amount in the request.
- The price of the item is not zero.
Authorizations:
Request Body schema: application/jsonrequired
required | Array of objects or null [ 1 .. 10 ] items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "amount": 1,
- "sku": "SKUTest123"
}
]
}Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}Notify that the buyer has canceled the order{{ /api/v3/test/click-collect/orders/{orderId}/decline }}
Method transfers the assembly order to the "wbStatus":"declined_by_client" — declined by the buyer. It is available for one hour after creating an assembly order.
The method emulates WB actions
Authorizations:
path Parameters
| orderId required | integer <int64> >= 1 Assembly order ID |
Responses
Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Incorrect parameter"
}