Release Notes

2025
Jul

Mo

14

Tu

15

We

16

Th

17

Fr

18

Sa

19

Su

20

Mo

21

All changes
Select tags
Select tags

July
2025

New

Reports
Returns and Product Movement Report

New

07/16/2025
New fields in response of the /goods-return method
  • Added 5 fields in the Goods Return Report:
    • reason — the reason for the return
    • orderId — assembly order number
    • readyToReturnDt — date and time when the return is ready for delivery
    • expiredDt — expiration date and time of the storage period
    • completedDt — date and time the seller received return

New

FBS Orders
Metadata

New

07/15/2025
New Method for Setting Product Expiration Date

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

Product Management
Seller Warehouses

Changed

07/14/2025
Changes in the method for getting WB offices

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

FBW Supplies
Information for Supplies Formation

New

07/07/2025
Action Required
Changes in the FBW Supplies API

Added fields in the response of the method for getting the list of warehouses:

  • isActive — whether the warehouse is available as a destination warehouse
  • isTransitActive — whether the warehouse is available as a transit warehouse

Starting from July 14, the limit for the method of getting reception options is 6 requests per minute.

June
2025

New

In-Store Pickup Orders

New

06/30/2025
New sandbox for working with In-Store Pickup orders

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

Documents and Accounting
Financial Reports

Changed

06/27/2025
Action Required
Changes in details to the weekly realization reports
  • Starting from July 14th, in realization sales reports:
    • In 7 fields we’ll transmit data in percentages, not in fractions. The percentage value is 100 times greater than the value in fractions
      • 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, % Basic
      • ppvz_kvw_prc — The final Wildberries remuneration coefficient (cWR) without VAT, % Basic
      • sup_rating_prc_up — The amount of reduction in the Wildberries remuneration coefficient (cWR) due to the rating, %
    • We’ll exclude the deprecated rid field
  • The report for the period from July 7 to July 13 will be generated considering these changes

New

Analytics and Data
Search Texts

New

06/25/2025
Changes in the Search Queries methods

Deprecated

Reports
Retention Reports

Deprecated

06/18/2025
Action Required
Disabling the /storage-coefficient method

New

DBS Orders
DBS Assembly Orders

New

06/17/2025
New fields in DBS and In-Store Pickup assembly orders

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

Customer Communication
Buyers Chat

Deprecated

06/11/2025
Buyers chat method changes

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

Documents and Accounting
Balance

New

06/05/2025
New method for retrieving seller balance

New

DBS Orders
DBS Assembly Orders

New

06/03/2025
The new number to contact the buyer

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

FBS Orders

New

06/03/2025
Added the sandbox for working with FBS orders

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

Product Management
Product Cards Creation

Changed

05/29/2025
Action Required
Introducing separate rate limits for the /cards/uploads, /cards/upload/add and /cards/update methods
  • Starting from June 5, the methods for creating, creating with merge, and editing product cards will be excluded from the general limit of the Content category — a maximum of 100 requests per minute for all methods. Now, each of these three methods will have a limit of 10 requests per minute. The limit for all other methods in the Content category will remain unchanged
  • Please note that a single request can be used to create or edit up to 3000 product cards. We recommend including as many product cards as possible in one request to minimize the number of requests sent
  • Keep in mind that within the limit, you should not send all requests simultaneously. Distribute requests evenly over the time unit of the limit (in this case, 1 minute). More details in the request limits documentation

New

Customer Communication
Buyers Chat

New

05/28/2025
Action Required
Retrieving files from messages by ID

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

Pricing Plans
Commissions

New

05/21/2025
Added getting commissions for pickup and booking
  • In the response of the method for getting commissions by product categories, added the fields:
    • kgvpPickup — Commission on the model In-store pickup (C&C), %
    • kgvpBooking — Commission on the model Booking, %

New

DBS Orders
DBS Assembly Orders

New

05/20/2025
Action Required
Getting information on paid delivery for DBS orders
  • We have added the ability to obtain information on paid delivery:
    • the responses of methods for getting new and completed assembly task now include the groupId field — the ID of an assembly tasks group. The groupId combines tasks that have been received at the same seller warehouse (warehouseId) and as a part of the same customer transaction (orderUid). The field groupId also provides data on paid delivery.
    • implemented a method for getting information on paid delivery .

New

DBS Orders

New

05/13/2025
New sandbox for working with DBS orders

Changed

Product Management
Prices and Discounts

Changed

05/12/2025
Updated error texts in the methods of prices and discounts
  • In the response samples of the prices and discounts methods, updated the errorText values (see details below)

April
2025

Deprecated

Reports
Main Reports

Deprecated

04/22/2025
The orderType field will be removed from the responses to Orders and Sales methods
  • On April 29, we will remove the outdated field orderType – the type of order – from the responses to the Orders and Sales methods. Data on return orders to sellers is not transmitted via the Orders and Sales methods