Release Notes

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

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.

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.

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.

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

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.

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

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 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

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.

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

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 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.

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.

Starting September 1, IMEI is required for products costing 20,000 rubles or more for assembly orders of DBW, DBS, and In-Store Pickup models.

If the IMEI is not specified:

• DBW and DBS assembly orders cannot be processed to delivery
• for In-Store Pickup assembly orders, it will be impossible to notify that the assembly order is ready for pickup

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.

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

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

Changes in the FBW Supplies section:

• Added the transit directions method for forming supplies
• Added the supplies info methods for getting:
  • Supplies list
  • Supply details
  • Supply products
  • Supply package

To the response of the method Chat List added new object goodCard with information about the product card, for which the buyer started the chat:

• date — order date
• needRefund — has refund been requested
• nmID — WB article
• price — actual price with all discounts applied. Charged to the buyer
• priceCurrency — currency
• rid — unique order ID
• size — product size
• statusID — product status

In the sandbox added new fields with the final product price that the customer paid to the information about DBS and In-Store Pickup assembly orders:

• 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 orders in the sandbox:

• 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:

• Get new orders list (DBS)
• Get information on completed orders (DBS)
• Get new assembly orders list (In-Store Pickup)
• Retrieve information on completed assembly orders (In-Store Pickup)

1. Added the officeID field — ID of the WB warehouse associated with the seller's warehouse — to the methods:
   • Get new orders
   • Get orders
2. Added the destinationOfficeId field — ID of the destination office for the supply — to the methods:
   • Get a supplies list
   • Get supply details

Starting from September 1, in the method for adding assembly orders to a supply, an error 409 will be returned if the officeID of the assembly order does not match the destinationOfficeID of the supply.

The destinationOfficeId field will only be present in new supplies. If the supply has a cargoType field, changes will not affect it.