Major updates

Stay tuned for documentation updates in The Telegram channel.

2025

August 11th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Because you mistakenly marked the parameter `id` in `LogisticPickupPointDTO` outdated, this indication has been removed.

August 7th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings	Added a parameter `showcaseUrls` — links to the same product on different storefronts of the Market.

August 1st

Methods or documentation pages	Description of the changes
POST reports/stocks-on-warehouses/generate	It was clarified that for the DBS, FBS and Express models, the parameter `campaignId` it will become unavailable soon. To get information about the store's stock balances, use `businessId` and the ID of the required store in `campaignIds`.
GET campaigns/{campaignId}/settings	The parameters have been deprecated `showInContext`, `showInPremium` and `useOpenStat`.
`GET campaigns/{campaignId}/region`	An outdated method has been removed.

July 31

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/outlets/{outletId} GET campaigns/{campaignId}/outlets	The parameters have been deprecated `shopOutletId` and `workingTime`. Use them instead `shopOutletCode` and `workingSchedule`.

July 25th

Methods or documentation pages	Description of the changes
POST categories/max-sale-quantum	The method has been deprecated.
POST campaigns/{campaignId}/offers/update POST campaigns/{campaignId}/offers	The parameter has been deprecated `quantum`.
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/offer-mappings	The parameter has been deprecated `firstVideoAsCover`.

July 23rd

Methods or documentation pages

Description of the changes

POST reports/stocks-on-warehouses/generate

Parameter campaignId it is no longer mandatory. If you transfer it, you will receive a report on the balances in the corresponding store warehouse.

Added a parameter businessId. If you transfer it, the report will return information about the balances in all store warehouses in the cabinet, except for FBY.

Added a parameter campaignIds — filter by stores for the cabinet report (except for the FBY model).

July 16

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	The parameter has been deprecated `id` in `LogisticPickupPointDTO`.

July 11th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-prices	Added a new method. It returns a list of prices that you have set for all stores.
POST businesses/{businessId}/offer-prices/updates	Added a parameter `minimumForBestseller` — the minimum price of the product to be included in the "Best Sellers of the Market" promotion.

July 9th

Methods or documentation pages	Description of the changes
Chats with customers Non-purchases and refunds How do the refund statuses for the FBS and Express models change?	They said that Express stores can make decisions on refunds and create chats with customers to clarify the details of the refund.

July 3rd

Methods or documentation pages	Description of the changes
POST reports/closure-documents/generate	Added a new method. It provides an opportunity to receive closing documents.
POST reports/closure-documents/detalization/generate	Added a report on convergence with closing documents.
Types of errors and what to do about them	Described the error Contract with type MARKETING was signed with the agency (the marketing agreement has been concluded with the agency), which the Market can return in response to the request.

July 1st

Methods or documentation pages	Description of the changes
Chats with customers Non-purchases and refunds	They said that FBS stores can create chats with customers not only on orders, but also on refunds.

June 30

Methods or documentation pages	Description of the changes
FBS stores DBS stores	Added schemes for how refund statuses change.
POST campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/submit	Now the method transmits and confirms the refund decisions for all placement models except FBY.
Non-purchases and refunds	They told us how to work with refunds that require a solution.
POST campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision	The method has been deprecated. Instead, use POST campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/submit.

June 23rd

Methods or documentation pages	Description of the changes
Query log	We talked about a widget with information about errors in requests and responses and a filter Integration.

June 4th

Methods or documentation pages	Description of the changes
POST reports/key-indicators/generate	We have added a report on key indicators.
PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes	The method has been deprecated. Instead, use PUT campaigns/{campaignId}/orders/{orderId}/boxes.

June 3rd

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offer-prices GET campaigns/{campaignId}/offer-prices	The limits on the number of products have been changed — 150,000 products per minute.
GET campaigns/{campaignId}/offer-mapping-entries	The limit on the number of products has been changed — 10,000 products per minute.

May 29th

Methods or documentation pages	Description of the changes
POST reports/sales-geography/generate	Added a report on the geography of sales.
`GET campaigns/{campaignId}/offers` `GET campaigns/{campaignId}/offers/all` `GET campaigns/{campaignId}/feeds` `GET campaigns/{campaignId}/feeds/{feedId}` `GET campaigns/{campaignId}/feeds/{feedId}/index-logs` `POST campaigns/{campaignId}/feeds/{feedId}/params` `POST campaigns/{campaignId}/feeds/{feedId}/refresh`	Outdated methods have been removed.

May 28th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/orders/{orderId}/identifiers/status	Added a new method. It returns the verification statuses of the UINs in the order.

May 27th

Methods or documentation pages	Description of the changes
POST reports/jewelry-fiscal/generate	Added a report on jewelry orders.

the 6th of May

Methods or documentation pages	Description of the changes
POST reports/banners-statistics/generate	Added a report on the coverage promotion.

April 30th

Methods or documentation pages	Description of the changes
POST reports/shows-boost/generate	Added a report on the boost of impressions.
POST campaigns/{campaignId}/orders/{orderId}/external-id	Added a new method. It transmits or modifies the external order ID in the store's system.

April 28

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/supply-requests — receiving information about requests for supply, export and disposal; POST campaigns/{campaignId}/supply-requests/items — receipt of goods in an application for delivery, export or disposal; POST campaigns/{campaignId}/supply-requests/documents — receipt of documents on the application for delivery, export or disposal.	Added methods for working with FBY applications.
FBY-requests for the delivery of goods to the warehouse, export or disposal	Added step-by-step instructions for working with FBY applications.

April 24th

Methods or documentation pages	Description of the changes
POST auth/token	Added a new method. It returns information about the transmitted authorization token.
Module for the 1C system:The enterprise"	We talked about the module for the 1C system.:Enterprise", with which you can manage products and process orders on the Market.
POST businesses/{businessId}/offer-mappings/update	The parameter has been deprecated `cofinancePrice`.

April 22nd

Methods or documentation pages	Description of the changes
POST reports/united-netting/generate	We have added a report on Yandex.Market scores.
GET businesses/{businessId}/chat — returns the chat by its ID; GET businesses/{businessId}/chats/message — returns a message by its ID.	Added methods for working with chats.
POST notification	Added notification types: creating a chat with a customer; adding a chat message; the beginning of the dispute; ending the dispute; creating a product review; creating a comment on the review.

April 16

Methods or documentation pages	Description of the changes
Methods where these types of discounts are transferred or returned.	Outdated discount types have been removed: `YANDEX_PLUS` `YANDEX_EMPLOYEE` `LIMITED_FREE_DELIVERY_PROMO` `FREE_DELIVERY_THRESHOLD` `MULTICART_DISCOUNT` `FREE_DELIVERY_FOR_LDI` `FREE_DELIVERY_FOR_LSC` `FREE_PICKUP` `SUPPLIER_MULTICART_DISCOUNT` `ANNOUNCEMENT_PROMO` `EMPTY_PROMO` `BLOCKING_PROMO` `MARKET_DEAL` `MARKET_PRIME` `BERU_PLUS`

April 15th

Methods or documentation pages	Description of the changes
How to use the console	They told us how to log in to the console, depending on the type of token.

April 11

Methods or documentation pages	Description of the changes
Methods where these parameters are passed or returned.	The parameters have been deprecated `marketModelId`, `marketModelName`, `modelIds` and `modelId`.
GET models/{modelId} POST models GET models/{modelId}/offers POST models/offers GET models	The methods have been deprecated.

April 10th

Methods or documentation pages	Description of the changes
Working with warehouses	Added step-by-step instructions on how to work with warehouses.

April 9th

Methods or documentation pages	Description of the changes
POST regions/countries	Added a new method. It returns a list of countries with their codes.
POST businesses/{businessId}/offer-prices/updates	The limit on the number of products has been changed — 10,000 products per minute, no more than 500 products per request in the method.
POST campaigns/{campaignId}/offer-prices/updates	The limit on the number of products has been changed — 10,000 products per minute.

April 8

Methods or documentation pages	Description of the changes
Non-purchases and refunds	Added step-by-step instructions on how to handle non-purchases and refunds.

6 april

Methods or documentation pages	Description of the changes
POST reports/goods-realization/generate	The implementation report is now available for the DBS model as well.

April, 4

Methods or documentation pages	Description of the changes
POST category/{categoryId}/parameters	The limit on the number of categories has been changed — 100 categories per minute.
POST categories/max-sale-quantum	The limit on the number of requests has been changed to 5,000 requests per hour.
POST businesses/{businessId}/offer-cards/update POST campaigns/{campaignId}/hidden-offers POST campaigns/{campaignId}/hidden-offers/delete	The limits on the number of products have been changed — 10,000 products per minute.
GET campaigns/{campaignId}/hidden-offers	The limit on the number of products has been changed — 10,000 products per minute, no more than 500 products per request.

April 1st

Methods or documentation pages	Description of the changes
Step-by-step instructions and methods where marking codes are transmitted or returned in the Honest SIGN system.	They said that the labeling of goods in the system "An honest SIGN" It is now optional for orders from individuals. For business orders, you still need to send the labeling codes.

March 31

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/warehouses — returns a list of warehouses and information about them. POST campaigns/{campaignId}/warehouse/status — turns off or turns on the warehouse.	Added methods of working with warehouses.
GET businesses/{businessId}/warehouses	The method has been deprecated. Instead, use POST businesses/{businessId}/warehouses.

20th of March

Methods or documentation pages	Description of the changes
How to work with the Yandex.Market API for Market Yandex Go sellers	We have added a page on how to work with the Yandex.Market API for Yandex.Market Go sellers.
POST campaigns/{campaignId}/offers/update POST campaigns/{campaignId}/offers POST campaigns/{campaignId}/offers/delete POST campaigns/{campaignId}/price-quarantine POST campaigns/{campaignId}/price-quarantine/confirm	The limits on the number of products have been changed — 10,000 products per minute.
POST businesses/{businessId}/offer-mappings/update	The limit on the number of products has been changed — 10,000 products per minute, no more than 100 products per request.
POST businesses/{businessId}/offer-mappings/delete POST businesses/{businessId}/offer-mappings/archive POST businesses/{businessId}/offer-mappings/unarchive POST businesses/{businessId}/price-quarantine/confirm	The limits on the number of products have been changed — 10,000 products per minute, no more than 200 products per request.
POST businesses/{businessId}/price-quarantine	The limit on the number of products has been changed — 10,000 products per minute, no more than 500 products per request.

18th of March

Methods or documentation pages

Description of the changes

POST notification

Added notification types:

creating an order cancellation request;
changing the non-purchase or refund status.

March 14th

Methods or documentation pages	Description of the changes
How order statuses change	They told us how the statuses of DBS orders change.
POST reports/united-returns/generate	Added a report on non-purchases and refunds.

March 7th

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}/returns

GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}

Added parameters:

amount — refund amount;
partnerCompensationAmount — compensation for return shipping.

The parameters have been deprecated refundAmount and partnerCompensation. Use them instead amount and partnerCompensationAmount.

March, 6

Methods or documentation pages	Description of the changes
How to sign integrations	They told us how to sign integrations.

March, 3rd

Methods or documentation pages	Description of the changes
`GET campaigns/{campaignId}/logins` `GET campaigns/by_login/{login}`	Outdated methods have been removed.

February 27th

Methods or documentation pages	Description of the changes
Express order processing	Added step-by-step instructions for processing Express orders.

February 20th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offers/update POST campaigns/{campaignId}/offers	The parameter has been deprecated `available`. Instead, use methods to hide goods from the showcase: GET campaigns/{campaignId}/hidden-offers POST campaigns/{campaignId}/hidden-offers POST campaigns/{campaignId}/hidden-offers/delete

February 13th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `details`.

12th of February

Methods or documentation pages	Description of the changes
Reports that can be uploaded in the format `FILE` or `CSV`.	Added the format — `JSON`. A block has appeared in the explanations of the columns Column name in JSON.

February 10th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/suggestions	The method has been deprecated.

February 7

Methods or documentation pages	Description of the changes
Yandex.Market API for sellers	We talked about enabling API notifications.
Request and response data format	Added a page Data format API notifications.
POST businesses/{businessId}/offer-mappings/update	They told us how to delete the previously transmitted product parameters — in `deleteParameters` specify the values of the parameters that you want to delete.
POST businesses/{businessId}/offer-mappings/update	Added a description of the error Offer at index… cannot have parameter… deleted and set at the same time — you can either pass the parameter value to `deleteParameters`, or the corresponding parameter in `UpdateOfferDTO`.

February 5th

Methods or documentation pages	Description of the changes
`GET campaigns/{campaignId}/offers`	The limit on the number of goods has been changed — 100 goods per hour.

February 4th

Methods or documentation pages

Description of the changes

POST businesses/{businessId}/promos/offers

Added a parameter statuses — filter for products that can participate in the promotion.

The parameter has been deprecated statusType. Instead, use statuses.

February 3rd

Methods or documentation pages	Description of the changes
`GET campaigns/{campaignId}/feedback/updates`	An outdated method has been removed.

January 22

Methods or documentation pages

Description of the changes

How to work with notifications

Error messages

Receiving notifications

API notifications have been added. Enable them and Yandex.Market will send you information about events.:

creating an order;
order cancellation;
changing the order status;
creating a non-purchase or refund.

Test orders

We clarified that if you have API notifications enabled, the Market will send you a request. POST notification with information about the event also for test orders.

January 21st

Methods or documentation pages	Description of the changes
All methods.	You have specified the placement models for which the method is available.

January 20th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/bids/recommendations	The parameter has been deprecated `priceRecommendations`.

January 14th

Methods or documentation pages	Description of the changes
All methods where passed or returned `offset`.	An outdated parameter has been deleted `offset`.

2024

December 27th

Methods or documentation pages	Description of the changes
`GET campaigns/{campaignId}/logins` `GET campaigns/by_login/{login}`	The methods have been deprecated.

20th of December

Methods or documentation pages	Description of the changes
Comparison of methods by models	We have added tables where you can see which work models the method is available for.

December 17th

Methods or documentation pages	Description of the changes
GET models/{modelId} POST models	The limits on the number of models have been changed — 100,000 models per hour.
GET models/{modelId}/offers POST models/offers	The limits on the number of offers have been changed — 100,000 offers per hour.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `id` in `delivery`.

December 16th

Methods or documentation pages	Description of the changes
Instructions and methods of working with the push scheme.	The pages were deleted. We do not recommend setting up new integrations with the push component.
Test orders	Added instructions on how to work with test orders.
GET campaigns/{campaignId}/orders/{orderId}/buyer	Added a parameter `trusted` — a trusted customer. If the parameter is returned with the value `true` The market has already checked the buyer — do not call him. Process the order as usual and hand it over to the courier or take it to the PVZ.

December 10th

Methods or documentation pages	Description of the changes
Methods where the parameter is passed or returned `vat`.	Added 5% and 7% VAT values `VAT_05` and `VAT_07` in the parameter `vat`. They will be applied to the simplified taxation system (STS) from 2025.

December 9th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/offer-mappings	Added a parameter `firstVideoAsCover` — the ability to use the first video in the card as a video background.

December 3

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET campaigns/{campaignId}/orders/{orderId}/delivery/labels POST reports/documents/labels/generate	Added a format for placing labels on the page — `A9_HORIZONTALLY`. It is only available to sellers from Russia.

November 29th

Methods or documentation pages	Description of the changes
Order processing and inventory View order information Manage prices View prices Manage products and cards View products and cards Product promotion View promotion information View financial data and reports Customer communication Store settings	Added pages listing all available methods for specific access.
POST businesses/{businessId}/offer-mappings	Added information about the product's media file — `OfferMediaFileDTO` in `uploadState`.
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/offer-mappings	Added parameters: `commodityCodes` (product codes) and its types `CommodityCodeType`: `CUSTOMS_COMMODITY_CODE` — the product code in the unified Commodity nomenclature of foreign economic activity (HS); `IKPU_CODE` — identification code of products and services (ICPU) in Uzbekistan; `PACK_CODE` — the packaging code for the ICPU. `language` — the language in which the values in the parameters are received and returned `name` and `description`.
POST businesses/{businessId}/offer-mappings/update	Added the error type and warnings `INVALID_COMMODITY_CODE` — an incorrect product code has been transmitted.
Methods where the parameter is passed or returned `vat`.	Added 12% VAT, which is used only in Uzbekistan, — ID `9` and the value `VAT_12` in the parameter `vat`.
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/offer-mappings	The parameter has been deprecated `customsCommodityCode`. Instead, use `commodityCodes` with the type `CUSTOMS_COMMODITY_CODE`.
GET campaigns/{campaignId}/orders/{orderId}/delivery/labels/data	The parameter has been deprecated `url`.

November 28th

Methods or documentation pages

Description of the changes

Methods where the SKU is passed or returned.

They told me that the SKU can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers.

POST businesses/{businessId}/offer-mappings/update

Added the ability to change the product category on the Market. To do this, pass the ID of the new category in the parameter marketCategoryId or categoryId.

They also clarified that when the category is changed, the values of the general characteristics for the old and new categories will remain, and they do not need to be transmitted.

The parameter has been deprecated category. Instead, use marketCategoryId.

November 26th

Methods or documentation pages	Description of the changes
All methods.	For sellers who use API-Key tokens: added a list of accesses, one of which is required to call this method.

November 22nd

Methods or documentation pages	Description of the changes
Reports that can be uploaded in the format `FILE` or `CSV`.	Added the names of the columns that are in the report.

November 20th

Methods or documentation pages

Description of the changes

POST campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods

Simplified the process of mass transfer of digital codes: each product is unique id it must be passed as a separate element in the array. items, and the product keys are in the array codes.

The parameter has been deprecated code. Instead, use codes.

November 8

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET campaigns/{campaignId}/orders/{orderId}/delivery/labels POST reports/documents/labels/generate.	Added a format for placing labels on the page — `A9`. Its design differs from other formats, and it is also available only to sellers from Russia.

November 6

Methods or documentation pages

Description of the changes

POST campaigns/{campaignId}/stats/orders

Added a parameter subsidies — accrual of points, which are used to reduce the cost of placement, and their write-off in case of non-purchase or refund.

Money transfer methods have been deprecated CASHBACK, MARKETPLACE and SPLIT.

November 2nd

Methods or documentation pages	Description of the changes
Methods where the SKU is passed or returned.	They clarified that the SKU of a product cannot consist only of spaces and tabs.

November 1st

Methods or documentation pages	Description of the changes
—	Product Feature name Colour changed to The color for the filter.

October 17th

Methods or documentation pages	Description of the changes
Pagination in requests to the Yandex Market API for sellers	They talked about pagination in queries.
Query log	They talked about the process of working with query logs and the unique query identifier, which will help you find logs faster and will be useful when contacting support.

October 14th

Methods or documentation pages

Description of the changes

Changed the limits on the number of requests — 100,000 requests per hour.

October 8th

Methods or documentation pages	Description of the changes
Authorization	We added an API Key token and explained how to use it to set up access only to certain groups of methods. We described how the authorization methods differ.

August 29th

Methods or documentation pages

Description of the changes

POST businesses/{businessId}/offer-mappings/update

POST businesses/{businessId}/offer-cards/update

Parameter value in parameterValues became optional.

They told us what to send.:

an empty value to remove the characteristics that are specified in the parameters with the type string;
only those characteristics whose value you want to update;
parameterId with an empty value to delete the value of the specified characteristic.

POST businesses/{businessId}/offer-mappings/update

Added a parameter onlyPartnerMediaContent — only the images of the goods you have submitted will be used.

If you specified the value true and the product had images from the Market, they will be deleted.

August 26th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-cards POST category/{categoryId}/parameters	The recommendations were considered outdated `HAS_VIDEO`, `FILTERABLE`, `HAS_DESCRIPTION` and `HAS_BARCODE`.

August 21st

Methods or documentation pages	Description of the changes
`GET campaigns/{campaignId}/feeds/{feedId}/categories` `GET campaigns/{campaignId}/feeds/categories`	Outdated methods have been removed.

August 15th

Methods or documentation pages	Description of the changes
`GET campaigns/{campaignId}/feedback/updates`	The method has been deprecated.

August 12th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/promos — shows information about the Market's promotions. POST businesses/{businessId}/promos/offers — shows a list of products that participate or may participate in the promotion; POST businesses/{businessId}/promos/offers/update — adds products to the promotion or changes their prices; POST businesses/{businessId}/promos/offers/delete — removes products from the promotion.	Added methods for working with stocks.
Stock management	They told us how to manage stocks.

August 9th

Methods or documentation pages	Description of the changes
Documentation of the Yandex.Market API for sellers.	Updated the menu.

August 8th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offer-prices/suggestions	The method has been deprecated. Instead, use POST reports/goods-prices/generate.

August 5th

Methods or documentation pages	Description of the changes
`GET campaigns/{campaignId}/region`	The method has been deprecated. Instead, use GET campaigns/{campaignId}/settings.

August 2nd

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offer-prices/updates	Outdated parameters have been deleted `id` and `shopSku`.

July 31

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/orders/{orderId}/business-buyer POST campaigns/{campaignId}/orders/{orderId}/documents	The methods have also become available for the DBS model.

July 30th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/goods-feedback — shows all reviews of the seller's products; POST businesses/{businessId}/goods-feedback/comments — shows all the comments on the review. POST businesses/{businessId}/goods-feedback/comments/update — adds a store comment or modifies a comment that the store left earlier. POST businesses/{businessId}/goods-feedback/skip-reaction — skips reviews. POST businesses/{businessId}/goods-feedback/comments/delete — deletes the store's comment.	Added methods for working with product reviews.
Product Reviews	They told us how to work with product reviews.
POST reports/goods-feedback/generate	We have added a report on product reviews.

July 19th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/updateBusinessPrices/update	Increased the upper value for the minimum cost of the product without a discount to 99% — parameter `discountBase`.
`POST cart`	The parameter has been deprecated `subsidy`.

July 11th

Methods or documentation pages	Description of the changes
`DELETE campaigns/{campaignId}/hidden-offers`	The method has been deprecated. Instead, use POST campaigns/{campaignId}/hidden-offers/delete.

July 9th

Methods or documentation pages	Description of the changes
`POST order/accept` `POST order/status` `POST order/cancellation/notify`	The parameter has been deprecated `subsidy`. Instead, use `subsidies`.

July 8th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/ratings/quality — shows the value of the store quality index and its components; POST campaigns/{campaignId}/ratings/quality/details — returns a list of orders that affected the store's quality index.	Added methods for working with the quality index.

July 5th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId} PUT campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `buyerTotalBeforeDiscount`.

July 4th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId} PUT campaigns/{campaignId}/orders/{orderId}/status `POST order/accept` `POST order/status` `POST order/cancellation/notify`	An outdated parameter has been deleted `status`.

June 28th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/shipments/reception-transfer-act	Now, using the method, you can confirm the next shipment in advance, not only on the day of shipment or the day before.

June 27th

Methods or documentation pages	Description of the changes
POST categories/max-sale-quantum	Added a new method. It returns the limit for setting the quantum and the minimum number of items in the order.

June 26th

Methods or documentation pages	Description of the changes
Types of errors and what to do about them	Described the error Campaign type is not allowed (the method does not support your store's operating model), which the Market can return in response to the request.

June 24th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId} PUT campaigns/{campaignId}/orders/{orderId}/status	The parameters have been deprecated `priceBeforeDiscount`, `buyerItemsTotal` and `buyerTotal`.

June 20th

Methods or documentation pages	Description of the changes
Methods where the SKU is passed or returned.	Changed the parameter format `ShopSku`. Now it can be any sequence up to 255 characters long.

June 11th

Methods or documentation pages	Description of the changes
POST reports/documents/labels/generate	Added a new method. It starts generating a PDF file with shortcuts for multiple orders.

June 6th

Methods or documentation pages	Description of the changes
Processing orders with digital goods	Now you don't need to configure the push component of the Yandex.Market API to work with digital goods.

June 5th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update — when adding products to the catalog, it transmits their prices, categories on the Market and the characteristics necessary for these categories; POST businesses/{businessId}/offer-mappings — returns the categories of products on the Market and their characteristics; POST businesses/{businessId}/offer-cards — returns the transmitted product characteristics.	Updated the work with the Market categories and product characteristics that are necessary for these categories.
PUT campaigns/{campaignId}/outlets/{outletId} DELETE campaigns/{campaignId}/outlets/{outletId}	Added a description of the error Outlet is disabled for editing by partner — you cannot change the information or delete the store's point of sale.
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/offer-mappings	The parameter has been deprecated `params`. Instead, use `parameterValues`.

June 4th

Methods or documentation pages	Description of the changes
PUT campaigns/{campaignId}/orders/{orderId}/status GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders	Outdated parameters have been deleted `total`, `subsidyTotal` and `totalWithSubsidy`.

May 27th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/settings	Added a new method. It returns information about the cabinet settings.

May 24th

Methods or documentation pages	Description of the changes
Create an application	They told us that you will need to receive the token again if the user who created it logs out of all devices in your Yandex account.
POST reports/competitors-position/generate	The "Competitive Position" report has been added.

May 17

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offer-prices/updates	An outdated parameter has been deleted `marketSku`.

16th of May

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offer-prices/updates GET campaigns/{campaignId}/offer-prices	An outdated parameter has been deleted `feed`.

May 14th

Methods or documentation pages	Description of the changes
POST reports/shelf-statistics/generate	Added a summary report on the shelves.

May 8th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offers/stocks	The method for the FBY model has been improved. Now it transmits information on the turnover of goods for each warehouse separately, rather than the total value for all warehouses.

April 24th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offers/stocks	The method is now available for the DBS and Express models.
GET campaigns/{campaignId}/offer-prices	The method has been deprecated. Instead, use POST campaigns/{campaignId}/offer-prices.

April 19th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId} PUT campaigns/{campaignId}/orders/{orderId}/status `POST order/accept` `POST order/status` `POST order/cancellation/notify`	The parameter has been deprecated `status`.

April 18th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId} PUT campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `price`.

April 11

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/skus	The limit on the number of products has been changed — 5,000 products per minute, no more than 500 products per request.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status PUT campaigns/{campaignId}/orders/{orderId}/identifiers PUT campaigns/{campaignId}/orders/{orderId}/cis	An outdated parameter has been deleted `feedCategoryId`.

April 10th

Methods or documentation pages	Description of the changes
POST reports/united-marketplace-services/generate POST reports/united-netting/generate	The parameters have been deprecated `dateTimeFrom` and `dateTimeTo`. Use them instead `dateFrom` and `dateTo`.

April 9th

Methods or documentation pages

Description of the changes

POST cart

The method was disabled for the FBS model.

The method has been made optional for DBS stores that do not sell digital goods. We recommend that you do not use it and disable this feature in your account. In the lower—left corner, click on the name of your business and go to the page Modules and APIs to the tab Receiving requests from Yandex.Market and activate the option Do not use the POST cart method.

If you sell digital goods, the method remains mandatory.

March 29th

Methods or documentation pages	Description of the changes
POST reports/documents/shipment-list/generate	Added an assembly sheet for shipment.
Processing of FBS orders	They told us how to generate an assembly sheet.

March 15th

Methods or documentation pages	Description of the changes
POST categories/tree	Added a new method. It returns the category tree of the Market.
POST tariffs/calculate	Added a new method. It calculates the cost of Market services for products with the specified parameters.
POST reports/boost-consolidated/generate	Added a sales boost report.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status PUT campaigns/{campaignId}/orders/{orderId}/identifiers PUT campaigns/{campaignId}/orders/{orderId}/cis	The parameter has been deprecated `feedCategoryId`.

March 13th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/hidden-offers `DELETE campaigns/{campaignId}/hidden-offers`	The limits on the number of products have been changed — 5,000 products per minute, no more than 500 products per request.

5th of March

Methods or documentation pages

Description of the changes

POST reports/goods-turnover/generate

POST reports/prices/generate

Two report formats are now available:

FILE — a spreadsheet;
CSV — ZIP archive with CSV files.

February 27th

Methods or documentation pages

Description of the changes

POST reports/united-netting/generate

POST reports/goods-realization/generate

POST reports/goods-movement/generate

POST reports/shows-sales/generate

Two report formats are now available:

FILE — a spreadsheet;
CSV — ZIP archive with CSV files.

February, 15

Methods or documentation pages

Description of the changes

POST reports/stocks-on-warehouses/generate

Two report formats are now available:

FILE — a spreadsheet;
CSV — ZIP archive with CSV files.

The 14th of February

Methods or documentation pages

Description of the changes

POST campaigns/{campaignId}/orders/{orderId}/documents

Now, in addition to the UPD, information about other documents is returned.:

UKD;
The waybill;
the invoice;
the adjustment invoice.

12th of February

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-cards	We have changed the limit on the number of requests — 600 requests per minute, no more than 200 products per request.

February 8

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId}	The parameter has been deprecated `phone`. To get the buyer's phone number, use the method GET campaigns/{campaignId}/orders/{orderId}/buyer.

1st of February

Methods or documentation pages

Description of the changes

POST reports/united-orders/generate

POST reports/united-marketplace-services/generate

Two report formats are now available:

FILE — a spreadsheet;
CSV — ZIP archive with CSV files.

PUT campaigns/{campaignId}/orders/{orderId}/status

GET campaigns/{campaignId}/orders

GET campaigns/{campaignId}/orders/{orderId}

The parameter has been deprecated shopSku. Instead, use offerId.

January 22

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/hidden-offers	An outdated parameter has been deleted `total`.
PUT campaigns/{campaignId}/orders/{orderId}/status GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders	The parameters have been deprecated `total`, `subsidyTotal` and `totalWithSubsidy`.

January 18th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/hidden-offers POST campaigns/{campaignId}/hidden-offers `DELETE campaigns/{campaignId}/hidden-offers`	Outdated parameters have been deleted `comment` and `priority`.

January 17th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/hidden-offers	An outdated parameter has been deleted `feed_id`.

January 10th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offer-prices/updates	The limit on the number of products has been changed — 5,000 products per minute, no more than 500 products per request.

January 9th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/orders/{orderId}/business-buyer	Added the ability to get information about the buyer, which is a legal entity.
POST campaigns/{campaignId}/orders/{orderId}/documents	Added the ability to get information about the UPD.
Processing orders from legal entities	Added step-by-step instructions for handling orders from legal entities.

2023

December 29th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/orders	Now the method is called Detailed information on orders.
POST reports/united-orders/generate	Added a report on orders.

December 26th

Methods or documentation pages	Description of the changes
Yandex.Market API for sellers	We talked about the components of the Yandex.Market API: the pull component (the store sends requests to the Market) and the push component (the Market sends requests to the store), as well as how to configure integration.
Processing of FBS orders	Added step-by-step instructions for order processing for the FBS model.
POST reports/goods-turnover/generate	Added a turnover report.
PUT campaigns/{campaignId}/orders/{orderId}/boxes	Added a new method. It transmits the box layout and labeling codes, as well as changes the composition of the order.
PUT campaigns/{campaignId}/orders/{orderId}/identifiers PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes PUT campaigns/{campaignId}/orders/{orderId}/items	The methods were considered obsolete for the FBS model. Use them instead PUT campaigns/{campaignId}/orders/{orderId}/boxes.

December 25

Methods or documentation pages	Description of the changes
Managing goods in the archive	They told us how to manage the goods in the archive.

December 22nd

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/chats/new — creates a chat; POST businesses/{businessId}/chats/message — sends a message to the chat; POST businesses/{businessId}/chats/file/send — sends the file to the chat; POST businesses/{businessId}/chats — returns a list of chats. POST businesses/{businessId}/chats/history — returns the message history.	Added methods for communicating with customers in chats.
Chats with customers	Added step-by-step instructions for working with chats.
PUT campaigns/{campaignId}/orders/{orderId}/verifyEac	The request limit has been changed to 1,000,000 requests per hour.
POST campaigns/{campaignId}/offers	The limit on the number of products has been changed — 5,000 products per minute, no more than 200 products per request.
PUT campaigns/{campaignId}/offers/stocks	The limit on the quantity of goods has been changed — 100,000 goods per minute.

December 8th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offers/recommendations	Added a parameter `shows`, where the number of product card impressions in the last 7 days is indicated.

December 6th

Methods or documentation pages	Description of the changes
How to change product prices	They told us how to change prices in a particular store.

5th of December

Methods or documentation pages	Description of the changes
Working with a sales boost	Added step-by-step instructions for working with sales boost.

November 27th

Methods or documentation pages	Description of the changes
Launching integration in JavaScript	Added step-by-step instructions for launching integration in JavaScript.

November 23rd

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders	Added methods for receiving orders using the FBY model.

November 20th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings POST campaigns/{campaignId}/offers/stocks	Added filtering by finding products in the archive.

November 14th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/archive — puts the goods in the archive; POST businesses/{businessId}/offer-mappings/unarchive — restores items from the archive.	Added methods for working with the archive.

November 8

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/hidden-offers `DELETE campaigns/{campaignId}/hidden-offers`	The limit on the number of products has been changed — 1,000 products per minute, no more than 500 products per request.

October 3rd

Methods or documentation pages	Description of the changes
POST reports/shows-sales/generate	Added the Sales Analytics report.
Methods of working with orders from external sites.	The methods were deleted.

September 29th

Methods or documentation pages	Description of the changes
GET campaigns `GET campaigns/by_login/{login}`	The methods no longer work for the ADV model.
POST campaigns/{campaignId}/offers/stocks	Added a new method. It returns information on the remaining goods in the showcase (for the FBY, FBS and Express models) and on the turnover of goods (for the FBY model).
Acceptance and transfer certificate The actual act of acceptance and transfer The act of discrepancies Bill of lading	Added methods for obtaining shipment documents (FBS).
PUT campaigns/{campaignId}/orders/{orderId}/identifiers GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders	Added parameters: `rnpt` — batch registration number of the product; `gtd` — the number of the cargo customs declaration.

September 28th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-cards/update — transmits the categorical characteristics of the goods. POST businesses/{businessId}/offer-cards — shows the statuses and the degree of card occupancy; POST category/{categoryId}/parameters — returns a list of characteristics with acceptable values for the specified category.	Now you can use the API to manage the content on product cards.
PUT campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets	Added a new method. It transmits the number of packages in the shipment.
GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallet/labels	Added a new method. It returns the labels for the packages in the shipment.

September 27th

Methods or documentation pages	Description of the changes
POST reports/prices/generate	The "Market Prices" report has been added.

September 25th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/price-quarantine	The parameters have been deprecated `currentPrice` and `lastValidPrice`. Use them instead `params`.

September 15th

Methods or documentation pages	Description of the changes
POST reports/stocks-on-warehouses/generate	We have added a report on the balances in the Market warehouses (FBY).

September 14th

Methods or documentation pages	Description of the changes
GET warehouses	Added a new method. It returns a list of Market warehouses (FBY) with their IDs.

September 7th

Methods or documentation pages	Description of the changes
POST reports/stocks-on-warehouses/generate	Added a report on the store's stock balances (FBS).

September 5th

Methods or documentation pages	Description of the changes
POST reports/goods-movement/generate	Added a report on the movement of goods.

September 4

Methods or documentation pages	Description of the changes
All methods.	Now in the answer `400 Bad Request` we return the name of the field that contains the error.

August 4th

Methods or documentation pages	Description of the changes
POST reports/goods-realization/generate	Added a report on the implementation.
POST reports/united-marketplace-services/generate	Added a report on the cost of services.
POST reports/united-netting/generate	A payment report has been added.

July 20th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/bids/recommendations	Added a new method. It shows the recommended bids.

July 19th

Methods or documentation pages	Description of the changes
GET businesses/{businessId}/warehouses	Added a new method. It shows a list of warehouses and warehouse groups.

July 13th

Methods or documentation pages	Description of the changes
—	The format of the authorization token has been changed — instead of 21 characters, it now has 48 characters. You can update the token right now to strengthen the protection of your integration.
Page Automatic renewal of the OAuth token.	They told us how to automatically update the OAuth token via the Yandex ID API.
POST businesses/{businessId}/bids/info	Added a new method. It shows the bid values for the specified products.
POST campaigns/{campaignId}/orders/status-update	Now you don't need to transmit the order processing stages or the reasons for its cancellation — parameter `substatus` in `orders` became optional.

June 22nd

Methods or documentation pages

Description of the changes

Adding products

Price changes

Big update: expanded API capabilities for working with the catalog.

Now you can:

work with general product data in the cabinet and manage the placement in individual stores;
set the basic price;
check the goods that are in quarantine;
delete products from the cabinet and store.

POST campaigns/{campaignId}/offer-mapping-entries/suggestions

POST campaigns/{campaignId}/offer-mapping-entries/updates

GET campaigns/{campaignId}/offer-mapping-entries

GET campaigns/{campaignId}/offers

GET campaigns/{campaignId}/offers/all

GET campaigns/{campaignId}/feeds

GET campaigns/{campaignId}/feeds/{feedId}

GET campaigns/{campaignId}/feeds/{feedId}/index-logs

POST campaigns/{campaignId}/feeds/{feedId}/params

POST campaigns/{campaignId}/feeds/{feedId}/refresh

The methods have been deprecated.

May 30th

Methods or documentation pages	Description of the changes
PUT campaigns/{campaignId}/orders/{orderId}/identifiers	Added a new method. He gives the Market the marking codes of the "Honest Mark" and the UIN for jewelry.
PUT campaigns/{campaignId}/orders/{orderId}/cis	The method has been deprecated. Instead, use PUT campaigns/{campaignId}/orders/{orderId}/identifiers

14th of April

Methods or documentation pages	Description of the changes
Methods in which limits are calculated using the formula.	We've changed the limits on the number of requests. We're specifying the exact number of requests per hour. This will make it easier for you to plan integrations, and for the Market to plan load.
Processing orders with digital goods	They told us how to work with digital goods.

March 29th

Methods or documentation pages	Description of the changes
PUT businesses/{businessId}/bids — creates a campaign, adds products to it, assigns or changes bids.	Added a new method. It helps to manage the sales boost.

March 17th

Methods or documentation pages

Description of the changes

Documentation of the Yandex.Market API for sellers.

Redesign of documentation:

We've put together instructions for different models;
The appearance has been modernized;
added step-by-step instructions for frequent scenarios.

How to use the console

The query testing console has been launched.

Was the article helpful?

Feedback

Outdated methods and parameters