Release Notes

• 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

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.

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.

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.

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:

• assembly orders
• metadata

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.

• 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

• Added filtering by promo items:
  • Parameters in requests of the getting the main report, data to the main report with pagination by groups, data for the main report with pagination by products in а group, and the top search texts by product methods, also in the model SearchReportProductReq of creating reports in CSV format method:
    • includeSubstitutedSKUs — Show data for direct queries with promo items
    • includeSearchTexts — Show data for search queries without promo items
    • Both the parameters cannot have the value false at the same time
  • Field in responses of getting the main report, data to the main report with pagination by groups, and data for the main report with pagination by products in а group methods, also in the model SearchReportProductRes reports in CSV format:
    • isSubstitutedSKU — If the product was searched by the promo item. Displayed if the request contains the includeSubstitutedSKUs and/or includeSearchTexts parameters
• For sellers with the Advanced tariff now the maximum is 100:
  • The value of the limit parameter in the request of the getting the top search texts by product and the model SearchReportTextReq of creating reports in CSV format method
  • Number of elements in the searchTexts request array of the getting data on the number of orders and positions by queries method
• The Search Queries methods are only available with a Jam subscription

• The deprecated Retention Reports method for getting logistics and storage factor will be disabled on June 23
• We will soon add report methods for getting logistics and storage costs multiplier and warehouse measurements instead. Stay tuned for the updates

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:

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

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.

• Added an API-version of the seller balance widget to the main page of the personal account
• Access is provided via a token with the Finance category

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.

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:

• assembly orders
• metadata
• supplies
• passes

Additionally, methods for managing warehouses and warehouse inventory methods are available in the FBS orders sandbox

• 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

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.

• 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, %

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

• Added a new sandbox for testing DBS orders methods (available via token with the Test Scope option). The sandbox allows you to manage:
  • assembly orders
  • metadata
  • warehouses and warehouse inventory
• Also added a separate test method for creating DBS assembly orders

• In the response samples of the prices and discounts methods, updated the errorText values (see details below)

• 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