Major updates

Stay tuned for documentation updates in The Telegram channel.

2025

September 5th

Methods or documentation pages	Description of the changes
GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label	The parameter has been deprecated `shipmentId`.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `id` in `OrderShipmentDTO`.

August 21st

Methods or documentation pages	Description of the changes
POST notification	Added the notification type — order change.

August 19th

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

August 15th

Methods or documentation pages	Description of the changes
POST v2/reports/goods-prices/generate	The Prices report has been added.
POST v2/reports/prices/generate	The method has been deprecated. Instead, use POST v2/reports/goods-prices/generate.

August 11th

Methods or documentation pages	Description of the changes
GET v2/campaigns/{campaignId}/returns GET v2/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 v2/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 v2/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 v2/campaigns/{campaignId}/settings	The parameters have been deprecated `showInContext`, `showInPremium` and `useOpenStat`.
`GET v2/campaigns/{campaignId}/region`	An outdated method has been removed.

July 31

Methods or documentation pages	Description of the changes
GET v2/campaigns/{campaignId}/outlets/{outletId} GET v2/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 v2/categories/max-sale-quantum	The method has been deprecated.
POST v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers	The parameter has been deprecated `quantum`.
POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	The parameter has been deprecated `firstVideoAsCover`.

July 23rd

Methods or documentation pages

Description of the changes

POST v2/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 v2/campaigns/{campaignId}/returns GET v2/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 v2/businesses/{businessId}/offer-prices	Added a new method. It returns a list of prices that you have set for all stores.
POST v2/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 FBY, 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 v2/reports/closure-documents/generate	Added a new method. It provides an opportunity to receive closing documents.
POST v2/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 v2/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 v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision	The method has been deprecated. Instead, use POST v2/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 v2/reports/key-indicators/generate	We have added a report on key indicators.
PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes	The method has been deprecated. Instead, use PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

June 3

Methods or documentation pages	Description of the changes
POST v2/campaigns/{campaignId}/offer-prices GET v2/campaigns/{campaignId}/offer-prices	The limits on the number of products have been changed — 150,000 products per minute.
GET v2/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 v2/reports/sales-geography/generate	Added a report on the geography of sales.
`GET v2/campaigns/{campaignId}/offers` `GET v2/campaigns/{campaignId}/offers/all` `GET v2/campaigns/{campaignId}/feeds` `GET v2/campaigns/{campaignId}/feeds/{feedId}` `GET v2/campaigns/{campaignId}/feeds/{feedId}/index-logs` `POST v2/campaigns/{campaignId}/feeds/{feedId}/params` `POST v2/campaigns/{campaignId}/feeds/{feedId}/refresh`	Outdated methods have been removed.

May 28th

Methods or documentation pages	Description of the changes
POST v2/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 v2/reports/jewelry-fiscal/generate	Added a report on jewelry orders.

the 6th of May

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

April 30th

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

April 28

Methods or documentation pages	Description of the changes
POST v2/campaigns/{campaignId}/supply-requests — receiving information about requests for supply, export and disposal; POST v2/campaigns/{campaignId}/supply-requests/items — receipt of goods in an application for delivery, export or disposal; POST v2/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 v2/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 goods and process orders on the Market.
POST v2/businesses/{businessId}/offer-mappings/update	The parameter has been deprecated `cofinancePrice`.

April 22nd

Methods or documentation pages	Description of the changes
POST v2/reports/united-netting/generate	We have added a report on Yandex.Market scores.
GET v2/businesses/{businessId}/chat — returns the chat by its ID; GET v2/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 v2/models/{modelId} POST v2/models GET v2/models/{modelId}/offers POST v2/models/offers GET v2/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 v2/regions/countries	Added a new method. It returns a list of countries with their codes.
POST v2/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 v2/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 v2/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 v2/category/{categoryId}/parameters	The limit on the number of categories has been changed — 100 categories per minute.
POST v2/categories/max-sale-quantum	The limit on the number of requests has been changed to 5,000 requests per hour.
POST v2/businesses/{businessId}/offer-cards/update POST v2/campaigns/{campaignId}/hidden-offers POST v2/campaigns/{campaignId}/hidden-offers/delete	The limits on the number of products have been changed — 10,000 products per minute.
GET v2/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 v2/businesses/{businessId}/warehouses — returns a list of warehouses and information about them. POST v2/campaigns/{campaignId}/warehouse/status — turns off or turns on the warehouse.	Added methods of working with warehouses.
GET v2/businesses/{businessId}/warehouses	The method has been deprecated. Instead, use POST v2/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 v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers POST v2/campaigns/{campaignId}/offers/delete POST v2/campaigns/{campaignId}/price-quarantine POST v2/campaigns/{campaignId}/price-quarantine/confirm	The limits on the number of products have been changed — 10,000 products per minute.
POST v2/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 v2/businesses/{businessId}/offer-mappings/delete POST v2/businesses/{businessId}/offer-mappings/archive POST v2/businesses/{businessId}/offer-mappings/unarchive POST v2/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 v2/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 v2/reports/united-returns/generate	Added a report on non-purchases and refunds.

March 7th

Methods or documentation pages

Description of the changes

GET v2/campaigns/{campaignId}/returns

GET v2/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 v2/campaigns/{campaignId}/logins` `GET v2/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 v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers	The parameter has been deprecated `available`. Instead, use methods to hide goods from the showcase: GET v2/campaigns/{campaignId}/hidden-offers POST v2/campaigns/{campaignId}/hidden-offers POST v2/campaigns/{campaignId}/hidden-offers/delete

February 13th

Methods or documentation pages	Description of the changes
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/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 v2/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 v2/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 v2/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 v2/campaigns/{campaignId}/offers`	The limit on the number of products has been changed — 100 products per hour.

February 4th

Methods or documentation pages

Description of the changes

POST v2/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, then yandex.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 v2/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 v2/campaigns/{campaignId}/logins` `GET v2/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 v2/models/{modelId} POST v2/models	The limits on the number of models have been changed — 100,000 models per hour.
GET v2/models/{modelId}/offers POST v2/models/offers	The limits on the number of offers have been changed — 100,000 offers per hour.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/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 v2/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 v2/businesses/{businessId}/offer-mappings/update POST v2/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 v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels POST v2/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 accounting of goods Viewing information about orders Price management Viewing prices Product and card management Viewing products and cards Product promotion Viewing information about product promotions Viewing financial information and statements Communication with customers Setting up Stores	Added pages listing all available methods for specific access.
POST v2/businesses/{businessId}/offer-mappings	Added information about the product's media file — `OfferMediaFileDTO` in `uploadState`.
POST v2/businesses/{businessId}/offer-mappings/update POST v2/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 v2/businesses/{businessId}/offer-mappings/update	Added the error type and warnings `INVALID_COMMODITY_CODE` — an incorrect product code was 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 v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	The parameter has been deprecated `customsCommodityCode`. Instead, use `commodityCodes` with the type `CUSTOMS_COMMODITY_CODE`.
GET v2/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 v2/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, 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 v2/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 v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels POST v2/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 v2/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 v2/businesses/{businessId}/offer-mappings/update

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

Parameter value in parameterValues became optional.

They told us what to send.:

an empty value to delete 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 v2/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 v2/businesses/{businessId}/offer-cards POST v2/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 v2/campaigns/{campaignId}/feeds/{feedId}/categories` `GET v2/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 v2/businesses/{businessId}/promos — shows information about the Market's promotions. POST v2/businesses/{businessId}/promos/offers — shows a list of products that participate or may participate in the promotion; POST v2/businesses/{businessId}/promos/offers/update — adds products to the promotion or changes their prices; POST v2/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 v2/campaigns/{campaignId}/offer-prices/suggestions	The method has been deprecated. Instead, use POST v2/reports/goods-prices/generate.

August 5th

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

August 2nd

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

July 31

Methods or documentation pages	Description of the changes
POST v2/campaigns/{campaignId}/orders/{orderId}/business-buyer POST v2/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 v2/businesses/{businessId}/goods-feedback — shows all reviews of the seller's products; POST v2/businesses/{businessId}/goods-feedback/comments — shows all the comments on the review. POST v2/businesses/{businessId}/goods-feedback/comments/update — adds a store comment or modifies a comment that the store left earlier. POST v2/businesses/{businessId}/goods-feedback/skip-reaction — skips reviews. POST v2/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 v2/reports/goods-feedback/generate	We have added a report on product reviews.

July 19th

Methods or documentation pages	Description of the changes
POST v2/businesses/{businessId}/offer-mappings/update POST v2/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 v2/campaigns/{campaignId}/hidden-offers`	The method has been deprecated. Instead, use POST v2/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 v2/businesses/{businessId}/ratings/quality — shows the value of the store quality index and its components; POST v2/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 v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `buyerTotalBeforeDiscount`.

July 4th

Methods or documentation pages	Description of the changes
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/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 v2/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 v2/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 v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/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 v2/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 v2/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 v2/businesses/{businessId}/offer-mappings — returns the categories of products on the Market and their characteristics; POST v2/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 v2/campaigns/{campaignId}/outlets/{outletId} DELETE v2/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 v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	The parameter has been deprecated `params`. Instead, use `parameterValues`.

June 4th

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

May 27th

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

May 24th

Methods or documentation pages	Description of the changes
Creating and using an OAuth token	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 v2/reports/competitors-position/generate	The "Competitive Position" report has been added.

May 17

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

16th of May

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

May 14th

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

May 8th

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

April 19th

Methods or documentation pages	Description of the changes
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/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 v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `price`.

April 11

Methods or documentation pages	Description of the changes
POST v2/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 v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers PUT v2/campaigns/{campaignId}/orders/{orderId}/cis	An outdated parameter has been deleted `feedCategoryId`.

April 10th

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

March 13th

Methods or documentation pages	Description of the changes
POST v2/campaigns/{campaignId}/hidden-offers `DELETE v2/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 v2/reports/goods-turnover/generate

POST v2/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 v2/reports/united-netting/generate

POST v2/reports/goods-realization/generate

POST v2/reports/goods-movement/generate

POST v2/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 v2/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 v2/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 v2/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 v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId}	The parameter has been deprecated `phone`. To get the buyer's phone number, use the method GET v2/campaigns/{campaignId}/orders/{orderId}/buyer.

1st of February

Methods or documentation pages

Description of the changes

POST v2/reports/united-orders/generate

POST v2/reports/united-marketplace-services/generate

Two report formats are now available:

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

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

GET v2/campaigns/{campaignId}/orders

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

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

January 22

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

January 18th

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

January 17th

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

January 10th

Methods or documentation pages	Description of the changes
POST v2/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 v2/campaigns/{campaignId}/orders/{orderId}/business-buyer	Added the ability to get information about the buyer, which is a legal entity.
POST v2/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 v2/campaigns/{campaignId}/stats/orders	Now the method is called Detailed information on orders.
POST v2/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 set up integration.
Processing of FBS orders	Added step-by-step instructions for order processing for the FBS model.
POST v2/reports/goods-turnover/generate	Added a turnover report.
PUT v2/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 v2/campaigns/{campaignId}/orders/{orderId}/identifiers PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes PUT v2/campaigns/{campaignId}/orders/{orderId}/items	The methods were considered obsolete for the FBS model. Use them instead PUT v2/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 items in the archive.

December 22nd

Methods or documentation pages	Description of the changes
POST v2/businesses/{businessId}/chats/new — creates a chat; POST v2/businesses/{businessId}/chats/message — sends a message to the chat; POST v2/businesses/{businessId}/chats/file/send — sends the file to the chat; POST v2/businesses/{businessId}/chats — returns a list of chats. POST v2/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 v2/campaigns/{campaignId}/orders/{orderId}/verifyEac	The request limit has been changed to 1,000,000 requests per hour.
POST v2/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 v2/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 v2/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 v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders	Added methods for receiving orders using the FBY model.

November 20th

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

November 14th

Methods or documentation pages	Description of the changes
POST v2/businesses/{businessId}/offer-mappings/archive — puts the goods in the archive; POST v2/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 v2/campaigns/{campaignId}/hidden-offers `DELETE v2/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 v2/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 v2/campaigns `GET v2/campaigns/by_login/{login}`	The methods no longer work for the ADV model.
POST v2/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 v2/campaigns/{campaignId}/orders/{orderId}/identifiers GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/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 v2/businesses/{businessId}/offer-cards/update — transmits the categorical characteristics of the goods. POST v2/businesses/{businessId}/offer-cards — shows the statuses and the degree of card occupancy; POST v2/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 v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets	Added a new method. It transmits the number of packages in the shipment.
GET v2/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 v2/reports/prices/generate	The "Market Prices" report has been added.

September 25th

Methods or documentation pages	Description of the changes
POST v2/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 v2/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 v2/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 v2/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 v2/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 v2/reports/goods-realization/generate	Added a report on the implementation.
POST v2/reports/united-marketplace-services/generate	Added a report on the cost of services.
POST v2/reports/united-netting/generate	A payment report has been added.

July 20th

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

July 19th

Methods or documentation pages	Description of the changes
GET v2/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 v2/businesses/{businessId}/bids/info	Added a new method. It shows the bid values for the specified products.
POST v2/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 v2/campaigns/{campaignId}/offer-mapping-entries/suggestions

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

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

GET v2/campaigns/{campaignId}/offers

GET v2/campaigns/{campaignId}/offers/all

GET v2/campaigns/{campaignId}/feeds

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

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

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

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

The methods have been deprecated.

May 30th

Methods or documentation pages	Description of the changes
PUT v2/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 v2/campaigns/{campaignId}/orders/{orderId}/cis	The method has been deprecated. Instead, use PUT v2/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 v2/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