Release Notes

Added the fields with information about seller own promos with additional discounts to the details for the realization reports:

• seller_promo_id — seller own promo ID with additional discount
• seller_promo_discount — additional discount from seller promo, %

The new fields will be displayed in daily reports starting with the report for December 29, and in weekly reports starting with the report for December 29–31.

Starting March 11, we will disable the deprecated method for getting the Supplies report.

Use the Supplies Information methods to get the supply data.

Added the new methods for getting reports with underreporting of package dimensions:

• Logistics and Storage Costs Multiplier
• Warehouse Measurements

The deprecated method for getting this data will be disabled on January 27.

Added responses with moderation statuses for the Get File from the Message method:

• 202 The file is under moderation
• 451 Moderation failed

As we shift to work with campaigns with custom and standard bids — 9 type, from February 2 we will disable the deprecated methods for standard bid campaigns — 8 type:

• List of Product Cards for Campaign with Standard Bid
• Changing the List of Product Cards in a Campaign with Standard Bid
• Statistics of a Campaign with Standard Bid by Phrase Clusters

The deprecation date for the Setting/Removing Minus-phrases for Campaigns with Standard Bid method changed from January 15 to February 2.

In the response of the Chat List method, we added the lastMessage object with information about the last message in the chat:

• text — message text
• addTimestamp — message time

Added the delivery_method field with information about the sales method and cargo type to the details for the realization reports. Now you can match report items with rates based on the delivery method.

The delivery_method field is only displayed for FBS , FBW, and DBW models.

The new field will de displayed in daily reports starting with the report for December 22, and in weekly reports starting with the report for December 22–28.

Updated the Realization Sales Report method responses. Now, if there is no data, the method returns the 204 No Data response, rather than an empty array [] in the 200 Success response.

Added the method for getting the Substitution and Incorrect Attachments report.

The deprecated methods for getting this data will be disabled on January 20:

• Substitutions
• Characteristics Change

Now you can use WB API to create and manage campaigns with cpc payment type — cost per click.

Added new versions of the methods:

• Campaign Information
• Minimum Bids for Product Cards
• Changing Campaigns Bids

Added the payment_type parameter — campaign payment type — to the following methods:

• Create Campaign
• Subjects for Campaigns

In the new versions of the methods, bids are displayed and passed in kopecks, not rubles. Previous versions of the methods will continue to support bids in rubles and will be available until February 2:

• Campaign Information
• Minimum Bids for Product Cards
• Changing Campaigns Bids

On February 2 we will also disable the deprecated versions of the methods

• Custom Bid Campaigns Information
• Changing Bids
• Promotional Configuration Values
• Setting/Removing Minus Phrases from Search

To the Get New Assembly Orders method response added a new sellerDate field with recommended delivery date for over dimensional products to the sorting center or warehouse.

The sellerDate field is only displayed for assembly orders with over dimensional products ODC, cargoType: 2.

Delivery over dimensional products to the warehouse on the recommended date facilitates acceptance and timely shipment to buyers. If oversized products are delivered to the warehouse earlier, the seller pays for storage until the recommended date. If items are delivered after the recommended date, a higher storage rate applies.

Added new statuses for DPX shipments to the response of the method Status History for Cross-Border Orders:

• dispatched_to_delivery_service — the order is handed over to delivery service in the seller country
• on_way_to_delivery_service — the order is on the way to delivery service's warehouse in the seller country

Added method for getting product brands by subject ID.

Use it to work with product cards. When creating a card, you can specify any brand that is available for the subject you need.

Added Pinned Feedback methods. Now you can use WB API for:

• getting the list of pinned or unpinned feedback 
• pinning feedback 
• unpinning feedback 
• getting pinned or unpinned feedback number 
• getting pinned feedback limits 

The method for pinning feedback is available for Jam subscription or Pin a feedback tariff option.

Now you can use WB API to get stickers for FBS assembly orders not only in the confirm status — in assembly, but also in the complete status — in delivery.

Added status values for cross-border DPX shipments in the wbStatus field of the Get Assembly Orders Statuses method response:

• accepted_by_carrier — accepted by carrier. The order is handed over to delivery service in the seller country
• sent_to_carrier — dispatched to carrier. The order is on the way to delivery service's warehouse in the seller country

Added chrtId — product size ID — to the inventory management methods:

• Get Inventory — in request and response
• Update Inventory — in request
• Delete Inventory — in request

A product can only have one chrtId. You can get this using the Product Cards List method

Starting February 9, we will no longer use sku for inventory management

• Starting January 15 we will disable the methods:
  • Setting/Deleting Fixed Phrases
  • Managing the Activity of Fixed Phrases
  • Setting/Removing Minus-phrases for Campaigns with Standard Bid
  • Statistics on Keywords for Campaign with Custom Bid
  • Statistics on Keywords Up-to-date methods for working with search clusters and negative phrases are available in the Search Clusters subsection.
• Moved the method for getting search cluster statistics to the Statistics subsection.

Added a new Seller User Management methods. With these methods, you can:

• Create an invitation for a user with access to the seller account
• Get a list of the seller active or invited users
• Update user's access permissions for the seller account
• Revoke a user's access to the seller

You can manage user access only with a token from the active owner of the seller account.

To authorize, generate a Personal token with the Users category.

Moved the Acceptance Coefficients method to the Tariffs section. It will now be available by domain common-api.wildberries.ru. That is you can access supply tariffs with a token of any category.

In the Tariffs section, the method is named Supply Tariffs the same as the subsection on the seller portal, the address is GET /api/tariffs/v1/acceptance/coefficients.

Supply tariffs by domain https://supplies-api.wildberries.ru will be available till February 3.

Starting from December 8, the maximum value of the limit parameter in the request for the Sales Funnel Product card statistics for the period method will be 1000. The offset parameter remains unchanged.

On December 11, we will remove the deprecated valuation field — average rating of all feedbacks — from the response of the Unanswered Feedbacks method.

Removed data for campaigns with deprecated types from the responses of the Campaigns Lists and Campaigns Information methods. The removed types are:

• 4 — in catalog
• 5 — in product card
• 6 — in search
• 7 — in recommendations on the main page

It has been unavailable to create campaigns of these types since March 2024.

Added to details for the realization reports:

• payment_schedule — one-time instant money withdrawal rate

The field is used to display the commission for the service Withdraw Now.

We are temporarily removing complaint management from the API. On December 8, we will disable the following methods:

1. Get Lists of Reasons for Complaints about the Feedback and Product Issues
2. File a Complaint about the Feedback, Report a Product Issue

You can manage complaints through your personal account. This will help ensure data accuracy and simplify working with feedbacks.

We will provide a separate announcement when complaint management via the API is available again.

To the response of the Get New Assembly Orders method added a field optionalMeta with a list of metadata that could be specified in the assembly orders. A supply with the assembly order without this metadata can be transfered to the delivery, but metadata may be required, for example, when a customer returns a product.

The list of metadata that is required for the assembly order to be transferred to the delivery is specified in the requiredMeta field.

If your product requires mandatory marking, you must specify all metadata whether it was received in requiredMeta or optionalMeta field (see 4.6 of the Offer).

We recommend adding all metadata received in the requiredMeta and optionalMeta fields to the assembly orders.

Added a new version of the Get Assembly Orders Metadata method for FBS model. You can now pass up to 100 assembly task IDs in a single request, instead of just one.

Current version of the method will be disabled on December 24.

Starting November 27, in the Campaign Statistics method request, you will be able to pass a maximum of 50 campaign IDs in the ids array.

On December 4, will add the ChrtID column to the report of the StocksReportRes model. In the report creation request, the reportType of of this model is STOCK_HISTORY_REPORT_CSV.

The column will be displayed between SizeName и RegionName.

This report model is available without the Jam subscription.

Added a new version of the Add Assembly Orders to the Supply method. You can now pass up to 100 assembly task IDs in a single request, instead of just one.

The current version of the method will be disabled on December 18.

Added a new method for getting IDs of the supply assembly orders. Use it instead of the Get the Supply Orders method to optimize your supplies workflow. Detailed information for each assembly order is available in the separate method response.

We will disable the deprecated Get the Supply Orders method on December 17.

Increased the maximum number of elements in the sgtins array. You can now add up to 100 Data Matrix codes for FBS assembly order in one request.

Moved search clusters methods to the separate subsection.

Starting from November 19, the following methods will be disabled:

• Get response templates 
• Create a template 
• Edit template 
• Delete the template

Added Sales Funnel methods with new v3 version:

• Product Cards Statistics per Period
• Product Cards Statistics per Days
• Grouped Product Cards Statistics per Days

In the new version, we:

• Expanded the list of main metrics
• Added sales funnel metrics for WB Club
• Changed the pagination in the Product Cards Statistics per Period method
• Removed error fields from successful 200 responses
• Added the addToWishList field to the SalesFunnelProductRes and SalesFunnelGroupRes response models of the Get the report method in the Seller Analytics CSV

Methods with the current version v2 will be disabled on December 9.

In the Buyer information method response added the empty string value description in the fields:

• replacementPhone
• phone
• additionalPhoneCodes
• phoneCode

No values ("") in these fields means that the phone numbers or phone codes are not assigned for the buyer yet.

Added methods for campaigns with manual bids:

• for managing search cluster bids
  • List of search cluster bids
  • Set bids on search cluster
  • Delete bids from search cluster
• for managing minus phrases
  • List of campaign minus phrases
  • Setting and deleting minus phrases

Added the method for getting search cluster statistics for campaigns with manual and unified bids.

From November 5, IMEI will be required for the Smartphones subject, "subjectId":515 for the DBW and DBS assembly orders.

If IMEI is not specified, the assembly order cannot be transferred to delivery.

To the response of the method for getting stickers for cross-border assembly orders added the field parcelId — assembly order tracking number in the sticker.

Added the Underreporting of package dimensions method. Use this method to get new reports:

• Logistics and storage costs multiplier
• Warehouse measurements

Starting from October 27, the deprecated size field will be removed completely from the method responses:

• get question list
• get question by ID

Added the field isBadTurnover — an indicator of a non-liquid product — to the responses of the methods:

• Get products with prices 
• Get products with prices by articles 
• Get product sizes with prices 

The field will only be displayed for products with a low inventory index.

Now you can use the Realization sales report method to get details for the daily realization reports. Specify period=daily in the request to do this.

Added a method for getting stickers for cross-border assembly orders. Use this method to directly get stickers in PDF format.

Starting from October 23, we will disable the method for getting a list of links to stickers that are required for cross-bordering.

To the responses of the methods for getting supplies list and supply details added thestatusID field — supply status ID.

On November 3 will be disabled the fields with supplies types and statuses:

• statusName — supply status
• boxTypeName — supply type
• virtualTypeName — virtual supply type

Now, to specify the supply status and type, use the IDs:

• statusID — supply status ID
• boxTypeID — supply type ID
• virtualTypeID — virtual supply type ID

The corresponding of values is provided in the ID descriptions.

Combined campaigns with custom and standard bids into one type — 9. Campaign type 8 is deprecated, it will be impossible to create campaigns of this type starting from October 23. The bid type in a campaign is now specified in a separate field.

Updated the methods for Promotion campaigns to work with campaign type 9:

• The method Create campaign now creates campaigns of type 9 with custom or standard bid. The bid type is specified in the bid_type field in the response of the Custom bid campaigns information method
• To the response of the Custom bid campaigns information method added information about bid type in the bid_type field:
  • manual — custom bid
  • unified — standard bid
• The method Changing bids in campaigns with custom bid is now called Changing campaigns bids. To the request of this method added the placement parameter:
  • search — in search (for campaigns with custom bid)
  • recommendations— in recommendations (for campaigns with custom bid)
  • combined — in search and recommendations (for campaigns with standard bid)
• To the response of the Campaigns lists method added information about campaign type in the description of the type field:
  • 4 — in catalog (deprecated type)
  • 5 — in product card (deprecated type)
  • 6 — in search (deprecated type)
  • 7 — in recommendations on the main page (deprecated type)
  • 8 — campaign with standard bid (deprecated type)
  • 9 — campaign with standard or custom bid.  The bid type is specified in the bid_type field in the response of the Custom bid campaigns information method
• The method Changing the list of product cards in campaigns with custom bid is now called Changing the list of product cards in campaigns

On October 24 we will disable the field needFRefund with product refund information from the methods:

• Chat list
• Chat events

Use the separate method to retrieve buyers returns applications.

Now you can create campaign with custom or standard bid via one method. To specify the bid type in the campaign, pass it in the bid_type parameter of the method request:

• manual — custom bid, specified by default
• unified — standard bid

For campaign with custom bid, specify the display zones in the placement_types parameter:

• search — display in search, specified by default
• recommendations — display in recommendations

The method for creating campaign with standard bid is available by October 23.

Added to the details for the weekly realization report:

• cashback_commission_change — loyalty program participation cost

Added new method for getting prices. Now you can specify more than one article in request.

Added new fields to the response of the Courier info method:

• fullName — courier's full name
• pTimeFrom — date and time from which the courier will arrive
• pTimeTo — date and time by which the courier will arrive

Moved Promotion Statistics from Analytics and Data to Marketing and Promotions.

Added new version of the method for getting promotion statistics:

• Changed the request schema of the method — now only campaign IDs and time intervals need to be specified in the request.
• Changed the HTTP-request type — now the GET method should be used to get statistics.
• Added the field canceled — cancellations, pcs. The number of promoted products that were ordered but not delivered to the customer due to technical reasons.

Current version is available until September 30.

A cashbacks array with information about promo bonuses added to the response of the method for getting balance:

• sum — promo bonuses, ₽
• percent — the percentage of the campaign budget top-up amount that can be paid with promo bonuses at one time
• expiration_date — promo bonuses expiration date

Added parameters for topping up the campaign budget with promo bonuses:

• cashback_sum — top-up budget sum paid with promo bonuses
• cashback_percent — The percentage of the top-up amount that can be paid with promo bonuses

Added to the details for the weekly realization report:

• order_uid — transaction ID. Orders in the same buyer's cart will have the same order_uid

On September 30 we will disable the methods:

• Setting/removing minus-phrases of phrase matching
• Setting/removing minus of exact match phrases

From September 17, IMEI will be required for the Smartphones subject, "subjectId":515 for the DBW and DBS assembly orders.

If IMEI is not specified, the assembly order cannot be transferred to delivery.

The previous conditions are no longer applicable.

Added to the sandbox new methods for creating test feedbacks and questions. Created questions and feedbacks are stored for 5 days.

Added new error of the 200 response to the Processed upload details method:

You can't change the item price. Item was added to the Sale due to high inventory

The error means that the product is put on sale based on its inventory index.

Added new version of the method for getting list of failed product cards with errors (drafts). In the new version of the method implemented pagination and data transfer in batches.

The current version will be disabled on September 30.

Added fields descriptions to the method for getting seller warehouses list:

• isDeleting — warehouse is being deleted: false — no, true — yes.
  After deletion, the warehouse will disappear from the list
• isProcessing — warehouse is being updated: false — no, true — yes.
  Data update may take several minutes. When true, update and deletion of inventory will be unavailable

We are disabling the ability to update inventory for small-sized products for the FBS model on warehouses that correspond to over dimensional cargo products and dimensional cargo+ products.

All small-sized product inventories on unsuitable warehouses ("cargoType": 2 and "cargoType": 3) will be automatically deleted on September 10. Please move the inventories to suitable virtual warehouses ("cargoType": 1) before this date.

On September 8:

• we will add pagination parameters limit and offset to the method for getting documents list. It will be able to request a maximum of 50 elements
• it will be able to request a maximum of 50 documents in the method for getting documents

Added method for getting minimum bids for product cards. Now you can obtain minimum bids by parameters:

• nm_id — WB articles array
• advert_id — campaign ID
• payment_type — payment type
• placement_types — display zones

We will disable the method for getting promotional configuration values on September 16. New method for obtaining configuration values will be announced later.

Starting from September 1, we will disable the method for obtaining the Turnover Dynamics report.

You can obtain the turnover dynamics data in the Stocks Report: the saleRate and avgStockTurnover objects.

Added new fields to the response of getting new assembly orders method:

• finalPrice — the sum charged to the buyer in the currency of sale including all discounts, multiplied by 100
• convertedFinalPrice — the sum charged to the buyer in the currency of the seller's country including all discounts, multiplied by 100

Currency codes are specified in thecurrencyCode and convertedСurrencyCode fields. The sums are provided for informational purposes only.

Added the wholesale object to the requests and responses of the Content methods. Use it to:

• create and create with merge product cards for wholesale
• identify them in the lists of product cards and product cards in trash

Added new methods for campaigns with custom bid, previously, Auction:

• Custom bid campaigns information
• Changing placements in campaigns with custom bid
• Changing bids in campaigns with custom bid
• Changing the list of product cards in campaigns with custom bid

Starting from September 9, it will be impossible to get campaigns with custom bid and change their bids using the Campaigns information and Changing bids methods.

Added list of complaint reasons submitted through the seller portal in the response of the method for getting list of reasons for complaints about feedbacks and product issues:

• 11 — Review is not related to the product
• 12 — Review was left by competitors
• 13 — Spam advertisement in the text
• 14 — Spam advertisement in photo or video
• 15 — Inappropriate content in photo or video
• 16 — Inappropriate language
• 17 — Photo or video is not related to the product
• 18 — Review with political context
• 19 — Other
• 20 — Threats insults

The lists of complaint reasons on the seller portal and in the API are different. It is not possible to submit a complaint via the API using a reason from the seller portal.

If a complaint is submitted via the seller portal (for example, 13 — Spam in the text), the reason specified on the portal (13 — Spam in the text) will be displayed in the responses of the methods for getting the feedback by ID, feedbacks list and the list of archived feedbacks.

If a complaint is submitted via the API (for example, with reason 3 — Spam), the reason passed via the API will be displayed in the responses of the same methods, while the corresponding reason from the seller portal list (13 — Spam in the text) will be displayed on the seller portal.

Now in the sandbox In-Store Pickup assembly orders automatically receive the same orderCode, if you create multiple assembly orders with a single request. The generated orderCode is passed in the response of the method of getting new assembly orders.

Now when forming a supply for delivery to a pickup point, it is enough to specify the number of boxes when adding them to the supply. It is no longer necessary to add a list of assembly orders to the box.

Starting August 18, will be disabled:

• the methods for adding and deleting assembly orders from boxes
• list of assembly orders in the method for getting the list of boxes. The orders array will be removed from the method response

Added new fields to the response of the Box tariffs method:

• boxDeliveryCoefExpr — coefficient Logistics, %. The logistics cost is multiplied by it. Already included in the tariffs
• boxDeliveryMarketplaceBase — FBS logistics of the first liter, ₽
• boxDeliveryMarketplaceCoefExpr — coefficient FBS, %. The FBS logistics cost is multiplied by it. Already included in the tariffs
• boxDeliveryMarketplaceLiter — FBS logistics of every next liter, ₽  
• boxStorageCoefExpr — coefficient Storage, %. The storage cost is multiplied by it. Already included in the tariffs
• geoName — country, for Russian Federation — federal district  

The field boxDeliveryAndStorageExpr will be removed on August 19.

Separate environment for working with DBW model methods:

• Starting from November 7, working with DBW assembly orders will only be available via designated URLs like https://marketplace-api.wildberries.ru/api/v3/dbw/...
• Added a method of getting courier information 

Information on all DBW methods is now in the new DBW Orders section of the documentation.

Divided rate limits for Marketplace methods according to sales models:

• FBS assembly orders, supplies and passes
• DBS assembly orders
• In-Store Pickup assembly orders

Separated the limits for getting and deleting metadata for FBS, DBS, and In-Store Pickup from the limits for methods for adding metadata.

Allocated separate rate limits for methods:

• Seller Warehouses 
• Inventory