Release Notes

2025
Jul

Mo

30

Tu

31

We

1

Th

2

Fr

3

Sa

4

Su

5

Mo

6

All changes
Select tags
Select tags

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 — Agreed discount
      • product_discount_for_report — Agreed discount
      • supplier_promo — Promo code
      • ppvz_spp_prc — Discount of regular customer
      • 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 — Size of cWR reduction due to 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

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

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.

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

Deprecated

Analytics and Data
Sales Funnel

Deprecated

04/21/2025
Disabling the /nm-report/grouped method

New

Documents and Accounting
Financial Reports

New

04/21/2025
New fields in details to the weekly realization reports

Changed

Product Management
Seller Warehouses Inventory

Changed

04/17/2025
Action Required
Changes to the Seller Warehouse Inventory API

Starting April 30, you will not be able to delete or update inventory at warehouses if the warehouse is already being updated or deleted.

In response to a request for such a warehouse, you will receive an error with status code 409 and the message "The store is processing"

Please wait a few seconds and try the request again.

Changed

Product Management
Seller Warehouses Inventory

Changed

04/16/2025
Action Required
Changes to the Seller Warehouse Inventory API

Starting May 26, you will not be able to update the inventory of small-sized goods ("cargoType": 1) using the FBS model if the virtual warehouse is designated for oversized and large items. These inventories can only be deleted.

Therefore, we recommend transferring the inventory of small-sized goods to appropriate virtual warehouses now.