Release Notes

• 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

• On April 28 we will add new fields to the response of the Realization sales report method:
  • wibes_wb_discount_percent — Wibes discount, %
  • installment_cofinancing_amount — Co-financing program discount

• The irrelevant Sales Funnel method for retrieving product card group statistics for a period will be disabled on April 29. Use other Sales Funnel methods instead

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.

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.

As per your requests, we wrote the instruction on rate limits in the General section. Included links to the instruction in annotations for all methods

• Added to the description of Nomenclatures list method the needKiz field – is a labeling code required for the product

• In the new version, the report is generated asynchronously using separate methods: creation, status checking, and report retrieval. This ensures stable report generation regardless of data volume
• The current method will be disabled on May 29

• Added methods for generating stocks analytics with data on:
  • Groups
  • Products
  • Sizes
  • Warehouses
• It is also available for uploading in CSV format. Added descriptions and examples of models to the methods for creating and getting reports:
  • Requests — StocksReportReq
  • Successful responses (status code 200) — StocksReportRes
• This stocks report is available without Jam, in both formats
• This is information from the detailed product table and the region detail widget. You can obtain the stocks data in this version of the methods only for the current day

Added a method for changing product cards bids.

The Bid update method will be disabled on 27 april.

Added a method for obtaining delivery date and time.

The fields: ddate — planned delivery date, dTimeFrom — delivery time "from" and dTimeTo — delivery time "to" in the method for obtaining new orders will be disabled on April 9.

You can learn more about working with the In-Store Pickup model in the description.

• On March 24, we will exclude the inWayToClient, inWayFromClient, and quantityWarehousesFull fields from the getting report method
• Along with data on individual warehouses, products in transit and the total stock amount will be transmitted in the warehouses array —in the fields warehouseName and quantity. In warehouseName, the column names from the report version in the personal account are specified. This means that the value of warehouseName can be both "Koledino" and "To the client"

Added a B2B sale indicator to the API orders methods.

Date of update: 06.03.2025

Added a B2B sale indicator to the orders information (FBS and DBS) — the isB2B field in the options structure.

In orders completed before February 26, the isB2B will always be false, even if it was a B2B sale.

List of methods to whose responses we have added the indicator:

Get new orders (FBS)

Get orders (FBS)

Get new orders list (DBS)

Get information on completed orders (DBS)

• The weight of a packed product must now be provided in the weightBrutto parameter of the dimensions object during the creation, creation with merge, and editing of product cards. The weight should always be in kilograms.
• We have also added the weightBrutto field to the dimensions object in the list of product cards and list of product cards in the trash.
• On March 12, we will disable the transmission of objects containing the weight of the packed product in the responses of the method for obtaining subject characteristics.
• On March 31, we will disable specifying the weight of the packed product in the characteristics array. Afterward, if requests for creation, creation with merge, and editing of product cards contain objects with the weight of the packed product, a response with a status code of 400 will be returned.
• Also, on March 31, we will disable the transmission of the packed product in the characteristics array in the list of product cards and list of product cards in the trash.
• These changes do not affect the current algorithm for specifying the weight of the unpacked product. It will continue to be transmitted in the characteristics array in all the methods mentioned earlier.

• Added links to the WB help center in the Russian version of API documentation. They can be found in the annotations to the method sections. Example

• On March 31, we will disable outdated methods for retrieving questions and feedbacks in XLSX format. Instead, please use the methods for retrieving lists of questions and feedbacks.

• Added new version of the method for retrieving seller portal news
• Response differences from the current version:
  • The body of the news is now passed in the content field instead of the text field — and without HTML formatting
  • Added an array of tags — types
• The current version will be deprecated on April 7

• Changed the request for the method of creating reports in CSV format.
• Added the parameters to the SearchReportTextReq model — search texts:
  • subjectIds — IDs of subjects for filtering
  • tagIds — IDs of tags for filtering
• Removed the requirement for the parameters subjectId and tagId in the SearchReportProductReq model — search parameters
• The Seller Analytics CSV methods are only available with Jam subscription

• Excluded the section parameter from the request of the offer edit method. The change does not need a required update on your part, as it does not affect API integrations. If you don't remove the parameter from the request, it will be ignored by the system.

We plan to disable all subdomains ending with wb.ru that were listed on the openapi.wb.ru portal — they are not used in the new documentation. Instead of supporting two domains — wildberries.ru and wb.ru — we will only retain wildberries.ru.

Currently, the following services are operating on the wb.ru domain:

1. Promotion 
2. Prices and Discounts 
3. Reviews and Questions

The same methods and data are available on the wildberries.ru domain as on wb.ru.

It is necessary to switch from wb.ru to the current domain wildberries.ru by April 15, as the discontinuation of the wb.ru domain will affect the integration functionality.

• Added the ability to obtain reports on search texts the same methods
• Also added descriptions and examples of models to the methods for creating and getting reports:
  • Requests — SearchReportTextReq
  • Successful responses (status code 200) — SearchReportTextRes
• Added eight fields and two structures to the response of поисковых запросов по товару method:
  • nmId — WB article
  • subjectName — subject name
  • brandName — brand name
  • vendorCode — seller's article
  • name — product name
  • isCardRated — if the product card has a rating
  • rating — product card rating
  • feedbackRating — feedbacks rating
  • price — price
  • medianPosition — median position
• These methods are only available with Jam

• We have added a method for getting by token seller information to make it easier for sellers with more than one account to determine which accounts their authorization tokens belong to. You can use any token in request, as long as the Test Environment option is not selected.

• Added new fields to the description of the Realization sales report method:
  • dlv_prc – Fixed warehouse supply ratio
  • fix_tariff_date_from – Commitment start date
  • fix_tariff_date_to – Commit expiration date
  • payment_processing – Type of payment for Acquiring/Payment organization fees
  • srv_dbs – A sign of a paid delivery service
  • assembly_id – Assembly task number
  • is_legal_entity – B2B sale attribute
  • trbx_id – The number of the box for paid acceptance

• To the response of the method for obtaining configuration values added information about product categories with their minimum allowable rates. The structure — categories.

• Added a warehouseType field to the descriptions of the orders and sales methods. The field can have the following values:
  • Склад WB — WB Warehouse
  • Склад продавца — seller's Warehouse
• This allows you to determine the sales model without obtaining information about orders and comparing method responses
• This applies to operations after September 23, 2024

Added the display of Auction products bids in the response of the method for retrieving campaigns information. Structure — auction_multibids

Added a method for retrieving data on daily dynamics

A field named srid has been added to the response of the method for retrieving buyers returns claims. This field represents the unique order ID for which a product claim was created

Added a method for obtaining the service's configuration values, such as minimum campaign budget, minimum bid size for automatic campaigns and auctions and so on

• Added a ranging array to the responses of the detailed promotion information method, if product ranking in promotions is enabled. The array consists of objects based on ranking conditions. The objects include the following fields:
• condition — type of ranking
• participationRate — percentage of seller's products needed to advance to the next ranking level, %
• boost — current search boost level, %

• Поменяли термины в разделе Работа с товарами на актуальные в соответствии с личным кабинетом продавца:
  • Тег заменили на Ярлык
  • Номенклатура на Карточка товара
  • Карточка товара на Объединённая карточка товара
• Обновили описание всех методов, где были заменены термины.
• Перенесли методы складов продавца из раздела Заказы FBS в раздел Работа с товарами.

• Added a method for setting the WB Club discounts
• Added the field clubDiscount — the WB Club discount — to the responses of methods for detailing processed uploads, detailing unprocessed uploads, retrieving product prices and discounts and retrieving the size prices and discounts
• Added the field clubDiscountedPrice — the discounted price, including WB Club discount — to the responses of methods for retrieving product prices and discounts and retrieving the size prices and discounts

On December 2, we will add to the method for obtaining acceptance coefficients:

• Storage and logistic coefficients
• Cost of logistic and storage for boxes and mono-pallets
• Information on the availability of acceptance
• Information on the type of warehouse
• Change the error message warehouseIDs param is incorrect to Invalid warehouseIDs format We will add filters by warehouses to the method for obtaining acceptance options

• Добавили параметры пагинации и фильтрации в метод получения списка ключей

• Added the methods to obtain reports on search parameters in CSV format. Reports are downloaded using the same methods as Sales Funnel reports, in CSV format within a ZIP archive
• Added descriptions and examples of models to the methods for creating and getting the reports:
  • requests models: SearchReportGroupReq and SearchReportProductReq
  • successful responses models (status code 200): SearchReportGroupRes and SearchReportProductRes
• The Sales Funnel (Jam) section is now called Seller Analytics CSV. These methods are only available with Jam subscription
• Changes do not affect the methods in the Sales Funnel section

Starting from February 13, working with orders of the DBS (Delivery by Seller) scheme will only be possible via designated URLs like https://marketplace-api.wildberries.ru/api/v3/dbs/... We consolidated all dbs-methods in a separate section of the documentation

• Starting from November 14, in responses with status code 200, methods for creating the report, getting the list of reports, and report regeneration, only the data array will be included. The fields error, errorText, and the array additionalErrors will be excluded. Error information will be provided only in responses with the other status codes.

• On November 19, we will expand the errors list with status code 409 in the inventory update method.
  Instead of the "message": "The selected warehouse is not intended for goods with these dimensions. Add them to the appropriate warehouse " more detailed errors will be returned:
  • The selected warehouse is not suitable for goods with the type ODC. Upload the balances to the warehouse marked - ODC
  • The selected warehouse is not suitable for goods with the type CD+. Upload the balances to the warehouse marked - CD+
  • The selected warehouse is not suitable for goods with the type ODC/CD+. Upload the balances to the warehouse with the label - ODC or CD+
  • The selected warehouse is not suitable for goods with the type LCL (Less than Container Load). Upload the balances to the warehouse without the ODC or CD+ mark

• В метод основной страницы добавили параметры limit и offset
• В методе поисковых запросов по товару параметр nmId заменили на массив nmIds
  • limit, offset и nmIds станут обязательными с 14 ноября
• Исправлено описание метода заказов и позиций по поисковым запросам товара: запрашиваемый период равен 7 суткам, но необязательно текущим, а любым в рамках 365 суток с момента запроса
• Выгрузка отчёта доступна только с подпиской Джем

• Добавили методы формирования аналитики по поисковым запросам:
  • Основная страница
  • Пагинация по группам
  • Пагинация по товарам в группе
  • Поисковые запросы по товару
  • Заказы и позиции по поисковым запросам товара
• Методы доступны только с подпиской Джем

• Added a description of methods for working with the WB Courier Delivery scheme
• In the response of methods for retrieving new orders and orders information added the field comment — buyer's comment
• In the response of the method for retrieving new orders added the field salePrice — price in the currency of sale, including seller's discount, except the WB Club discount, multiplied by 100