July
2025
New
New
reason
— the reason for the returnorderId
— assembly order numberreadyToReturnDt
— date and time when the return is ready for deliveryexpiredDt
— expiration date and time of the storage periodcompletedDt
— date and time the seller received returnNew
New
Starting from July 21, you can set the product expiration date in the metadata of FBS assembly order.
To check if you can set the product expiration date for assembly order, use the method Get new orders. If the response to the method has the value expiration
in the requiredMeta
field, you can set the product expiration date. If the response does not return the expiration
value, it is not possible to set the product expiration date for this assembly order.
To set the product expiration date, use the new method Add expiration date to the order. The minimum period is 30 days. The product expiration date can only be set for assembly orders in the confirm
status. To change the expiration date, send a request with the new date.
To check the set product expiration date, use the method Get order metadata. The set expiration date will be displayed in the expiration
field. If the field expiration
contains the value null
, the product expiration date hasn’t been set yet.
It is impossible to remove the expiration date from the metadata of the assembly order.
Changed
Changed
To the method response for getting the WB offices added the new federalDistrict
field — federal district of the WB office. If the value of the field is null
, the office is located outside the Russian Federation or the federal district is not specified.
New
New
Added fields in the response of the method for getting the list of warehouses:
isActive
— whether the warehouse is available as a destination warehouseisTransitActive
— whether the warehouse is available as a transit warehouseStarting from July 14, the limit for the method of getting reception options is 6 requests per minute.
June
2025
New
New
In the new sandbox, you can test the In-Store Pickup orders methods. The sandbox is available via token with the Test Scope option.
The sandbox allows you to manage:
Methods for managing warehouses and warehouse inventory are also available.
Updated the sandbox description with a status model and separate test methods for creating and cancelling In-Store Pickup assembly orders.
Changed
Changed
sale_percent
— Harmonized product discount, %product_discount_for_report
— Final agreed discount, %supplier_promo
— Promo code, %ppvz_spp_prc
— Regular Customer Discount (RCD), %ppvz_kvw_prc_base
— The amount of the Wildberries remuneration coefficient (cWR) without VAT, % Basicppvz_kvw_prc
— The final Wildberries remuneration coefficient (cWR) without VAT, % Basicsup_rating_prc_up
— The amount of reduction in the Wildberries remuneration coefficient (cWR) due to the rating, %rid
fieldNew
New
SearchReportProductReq
of creating reports in CSV format method:
includeSubstitutedSKUs
— Show data for direct queries with promo itemsincludeSearchTexts
— Show data for search queries without promo itemsfalse
at the same timeSearchReportProductRes
reports in CSV format:
isSubstitutedSKU
— If the product was searched by the promo item. Displayed if the request contains the includeSubstitutedSKUs
and/or includeSearchTexts
parameterslimit
parameter in the request of the getting the top search texts by product and the model SearchReportTextReq
of creating reports in CSV format methodsearchTexts
request array of the getting data on the number of orders and positions by queries methodDeprecated
Deprecated
June 23
New
New
Added new fields with the final product price that the customer paid to the information about DBS and In-Store Pickup assembly tasks:
• finalPrice
— the price in the currency of sale including all discounts, multiplied by 100
• convertedFinalPrice
— the price in the currency of seller’s country including all discounts, multiplied by 100
Also added new fields to the information about In-Store Pickup assembly tasks:
• convertedPrice
— the price in the currency of seller’s country including all discounts, except the WB Wallet discount, multiplied by 100
• convertedCurrencyCode
— the currency code of the seller's country
The prices are provided for informational purposes.
New fields are added to the responses of the methods:
Deprecated
Deprecated
The refund
object has been deprecated from the method for retrieving chat events. Now, events can only be of the message
type. To obtain refund claims, use the buyers returns methods.
New
New
Finance
categoryNew
New
Added the field replacementPhone
to the retrieving buyer information method response — the main phone number for contacting the customer. It eliminates the need to enter additional codes.
The current contact method remains as a backup in case the replacementPhone
is unavailable.
New
New
In the new sandbox, you can test the FBS orders methods The sandbox is available via token with the Test Scope option.
The sandbox allows you to manage:
Additionally, methods for managing warehouses and warehouse inventory methods are available in the FBS orders sandbox
May
2025
Changed
Changed
New
New
We are gradually transitioning to a mechanism for retrieving files by ID instead of direct link access. This new approach eliminates direct access to message files.
Currently, the new mechanism affects a small portion of files. The file ID is provided along with "url":""
. Gradually, files from all new messages will be accessible only by ID.
Changes:
• added a downloadID
field to the files
and images
message structures — the file ID.
• added a method for retrieving a file from a message — use the file ID from the message body to obtain the file through this method.
We will notify you once the transition to the new file retrieval mechanism is complete.
For all messages containing a direct file link, the file retrieval mechanism will remain unchanged.
New
New
kgvpPickup
— Commission on the model In-store pickup (C&C), %kgvpBooking
— Commission on the model Booking, %New
New
New
New
Changed
Changed
errorText
values (see details below)April
2025
Deprecated
Deprecated