Release Notes

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

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

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.

• 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

• 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

• 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

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 a method for changing product cards bids.

The Bid update method will be disabled on 27 april.

• 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