All updates

Clarified that in the parameter limit you need to transmit a value of no more than 50.

POST reports/shows-boost/generate

On the sheet Paid storage starting from 06/01-22 (file paid_storage_after_01-06-22) added columns:

LENGTH_PRODUCT_M (Information about the service/Length of the product unit, m);
WIDTH_PRODUCT_M (Information about the service/Width of the product unit, m);
HEIGHT_PRODUCT_M (Information about the service/The height of the product unit, m);
COUNT_PRODUCT_UNIT (Information about the service/The number of product units, pcs.);
VOLUME_UNITS_OF_GOODS (Information about the service/The volume of all units of goods, cubic meters);
MEASUREMENT_UNIT (Information about the service/Unit of measurement).

August 4th

Methods or documentation pages

Description of the changes

POST reports/banners-statistics/generate

POST reports/shelf-statistics/generate

The column was deleted AVERAGE_BID.

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

POST campaigns/{campaignId}/orders/status-update

POST notification

Deleted values USER_REFUSED_TO_PROVIDE_PERSONAL_DATA and RECEIVED_ON_DISTRIBUTION_CENTER in substatus.

GET campaigns/{campaignId}/outlets/{outletId}

GET campaigns/{campaignId}/outlets

The parameters have been deprecated shopOutletId and workingTime. Use them instead shopOutletCode and workingSchedule.

July 30th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update	Clarified that in the parameter `offerMappings` You do not need to transfer more than 100 products.

July 29th

Methods or documentation pages

Description of the changes

POST reports/stocks-on-warehouses/generate

They said that for the characteristics of the type ENUM You need to pass the parameters together. value and valueId.

July 28th

Methods or documentation pages	Description of the changes
Processing orders with digital goods	They told us: how to understand that the order contains digital goods; that the Market will send the keys to the buyer in the chat if the email could not be delivered.
POST businesses/{businessId}/offer-mappings/update	The parameter was deleted `cofinancePrice` and the value `COFINANCE_PRICE` in `deleteParameters`.
POST businesses/{businessId}/offer-mappings	The parameter was deleted `cofinancePrice`.
POST businesses/{businessId}/offers/recommendations	The filter was removed `FieldStateType` and the parameters `cofinancePriceFilter` and `cofinancePrice`.

July 26th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/promos/offers	The parameter was deleted `promocodeParams`.
POST businesses/{businessId}/promos/offers/update	The warning was deleted `PROMOCODE_PRICE_MORE_THAN_MAX_FAIR_PRICE`.

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

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

FBY-requests for the delivery of goods to the warehouse, export or disposal

POST campaigns/{campaignId}/supply-requests

It was clarified that parent and child applications are now being created for deliveries to the storage warehouse.

July 22nd

Methods or documentation pages	Description of the changes
POST tariffs/calculate	The method has become available to Market Yandex Go sellers.

July 21st

Methods or documentation pages

Description of the changes

Adding and editing products

They told me what would happen if you didn't pass the parameters. marketCategoryId or parameterValues.

July 17th

Methods or documentation pages

Description of the changes

They clarified that the reward and the price of the product are in the parameters subsidies, price, costPerItem and total includes VAT.

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

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods	Added examples for transferring multiple products with unique or identical identifiers.
Adding and editing products	They told us how to find out the source and time of the information update in the seller's office on the Market.
List of methods used in the FBY model List of methods used in the FBS model List of methods used in the Express model List of methods used in the DBS model	We talked about the models of work on the Market.

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.
GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}/transportation-waybill	They clarified that the bill of lading is returned only for those shipments in which the Market picks up goods from your warehouse.
GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}	Added the parameter value `availableActions` — `DOWNLOAD_TRANSPORTATION_WAYBILL` (download the bill of lading).

July 10th

Methods or documentation pages	Description of the changes
Adding and editing products	They said that the characteristics that are the features of the product variant may depend on the cabinet. To find them out, in the method POST category/{categoryId}/parameters pass the parameter `businessId`.
GET campaigns/{campaignId}/orders Test orders	They clarified that information on test orders is not returned by default.
Request and response data format	Added an example of the request body and response.

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

Methods or documentation pages

Description of the changes

A parameter was added in the response externalOrderId — the external order identifier in the store's system.

Added the following parameters:

estate — ownership;
building — the building.

July 7th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods	They told us which tags can be used to format the text in the activation instructions.

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 reports/shows-sales/generate	The column was deleted MAX_VISIBILITY_INDEX — maximum visibility index.
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 25th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/promos	They clarified that the response does not return information about the shares that the seller created.
PUT businesses/{businessId}/bids	They clarified that the data is not updated instantly.

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.
POST reports/documents/shipment-list/generate	They clarified that it is necessary to transmit in the method `shipmentId` or `orderIds`.

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

Methods or documentation pages	Description of the changes
POST reports/jewelry-fiscal/generate	Added a column BUYER_PRICE — the price of the product.

May 29th

Methods or documentation pages	Description of the changes
POST reports/sales-geography/generate	Added a report on the geography of sales.
Outdated methods have been removed.	`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`

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.

May 20th

Methods or documentation pages

Description of the changes

How to work with notifications

You have specified the maximum number of characteristics (parameter params in UpdateOfferDTO) — 600.

You specified the maximum length:

names of the characteristic (parameter name in OfferParamDTO) — 200 characters.
links to the instructions (parameter url in OfferManualDTO) — 512 characters.
the names of the instructions (parameter title in OfferManualDTO) — 200 characters.
comments (parameter comment in TimePeriodDTO) — 500 characters.

16th of May

Methods or documentation pages

Description of the changes

Processing of FBS orders

Express order processing

They told us that at the step of checking new orders, you need to use a range of delivery dates — parameters fromDate and toDate. And to get information about orders that have been changed, use filters. updatedAtFrom and updatedAtTo.

We have changed the frequency with which the Market repeats the request if the store does not meet the ten-second timeout or the request POST notification returns an error except 400. Now this frequency is every minute during the first hour.

May 13

Methods or documentation pages

Description of the changes

Methods where it is passed or returned campaignId.

In the parameter description campaignId (campaign ID) told us:

how to find out;
that it should not be confused with the store's identifier, which is listed in the seller's account on the Market next to the store's name and in some reports.

Calling methods

We talked about the path parameters and query parameters.

the 6th of May

Methods or documentation pages	Description of the changes
POST reports/banners-statistics/generate	Added a report on the coverage promotion.
How to work with notifications	We clarified that notifications related to orders are also received for FBY orders, if they are configured for the cabinet.

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

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/offers/stocks	Added a filter by the warehouse ID — parameter `stocksWarehouseId`.
POST businesses/{businessId}/promos/offers	Added a filter `MINIMUM_FOR_PROMOS` — products with a set minimum price for shares that meets the threshold `maxPromoPrice`.

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.
How to work with notifications	They told us what roles are needed to configure API notifications.
POST businesses/{businessId}/offer-mappings/update	The parameter has been deprecated `cofinancePrice`.

April 23rd

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offers/recommendations	The filter was removed `recommendedCofinancePriceFilter`. The parameter was deleted `recommendedCofinancePrice` in the response.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status POST campaigns/{campaignId}/orders/status-update	The reason for the order cancellation has been deleted `DELIVERY_DATE_CHANGED_TOO_MUCH` — the order has been postponed for too many days.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status POST campaigns/{campaignId}/orders/status-update	Added the reason for canceling the order `TOO_LONG_DELIVERY` — the order is taking too long to be delivered.

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.
Chats with customers	Updated the instructions on how to check if there are any new chats or messages.
How to work with notifications	They told us which notifications are coming only for the cabinet, and which are for the cabinet and the store.
Types of errors and what to do about them	Added a description of the error The method is not supported for Market Yandex Go sellers — the method is not available for Market Yandex Go sellers.

The 21st of April

Methods or documentation pages

Description of the changes

Non-purchases and refunds

Added a sheet Application of the marking mark (file product_marking).

Changed the name of the columns:

SERVICE_DATE → SERVICE_DATE_TIME;
serviceDate → serviceDateTime;
Information about the service/Date of service provision → Information about the service/Date and time of service provision.

April 16

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/hidden-offers	The parameter was deleted `PageNum`.
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.
POST businesses/{businessId}/goods-feedback	They clarified that reviews that were deleted by customers or the Market are not being returned. Added a parameter `feedbackIds` — review IDs.Do not use it at the same time as other filters.
POST businesses/{businessId}/goods-feedback/comments	They clarified that comments to deleted reviews and those that were deleted by users or the Market are not returned. Parameter `feedbackId` became optional. Added a parameter `commentIds` — comment IDs. Do not use it at the same time as other filters.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/boxes PUT campaigns/{campaignId}/orders/{orderId}/status PUT campaigns/{campaignId}/orders/{orderId}/identifiers	Added a parameter `countryCode` — country of manufacture.
Processing orders from legal entities	We described the specifics of working with orders from legal entities.
Types of errors and what to do about them	Added a description of the error String (value) is not a valid country code according to ISO 3166-1 alpha-2 — invalid country code. Specify the country code in the ISO 3166-1 alpha-2 format.

April 8

Methods or documentation pages

Description of the changes

Added step-by-step instructions on how to handle non-purchases and refunds.

Launching integration on Node.js Express

Clarified that the order can change to the status PARTIALLY_DELIVERED not immediately.

If there was a non-purchase in the delivered order, the status will change only after the order is received at the Market warehouse.

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.
Processing of FBS orders	They said that using the method GET campaigns/{campaignId}/shipments/reception-transfer-act You can not only confirm the shipment, but also sign and receive an electronic acceptance certificate.
PUT campaigns/{campaignId}/offers/stocks Transfer of balances via API	They told us how to transfer leftovers for a group of warehouses — only for one of any warehouse. Information for the rest of the warehouses in this group will be updated automatically.
POST reports/united-marketplace-services/generate	Changed the column name *Decrease (discount) and increase in the cost of the service/Challenges and Rewards/Discount (gr.37=gr.35gr.36)/37. Now it's called Decrease (discount) and increase in the cost of the service/Challenges and Rewards/Discount based on the minimum tariff (gr.37=gr.35gr.36)/37*.

April 3

Methods or documentation pages

Description of the changes

We have added a page on how to set up integration for working with notifications on Node.js Express.

POST businesses/{businessId}/promos/offers

Added the product statuses in the response:

RENEWED — successfully transferred from the previous "Best Sellers of the Market" promotion;
RENEW_FAILED — it was not possible to transfer from the previous "Bestsellers of the Market" promotion.

April 2

Methods or documentation pages	Description of the changes
—	The specification of the OpenAPI API notifications has been published. It is available on GitHub.

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.
POST campaigns/{campaignId}/offers/update POST campaigns/{campaignId}/offers POST campaigns/{campaignId}/offer-prices/updates POST campaigns/{campaignId}/offer-prices	The 12% VAT ID was deleted. They clarified that the transfer and receipt of VAT is not available for sellers of the Yandex Go Market.
POST notification	Added a parameter `updatedAt` — date and time when the non-purchase or refund status was changed.
GET businesses/{businessId}/warehouses	The method has been deprecated. Instead, use POST businesses/{businessId}/warehouses.

March 28th

Methods or documentation pages	Description of the changes
How to work with notifications	We have clarified the ranges of IP addresses that the Market uses.

March 27th

Methods or documentation pages

Description of the changes

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

POST reports/goods-feedback/generate

Marked as unavailable to Yandex Go Market sellers.

March 25

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/goods-feedback/comments	The parameter was added in the response `feedbackId` — ID of the review.
Types of errors and what to do about them	Added a description of the error Business is in migration — store migrations are taking place in the office.

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. The product code type has been deleted `PACK_CODE`.
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.
GET campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET campaigns/{campaignId}/orders/{orderId}/delivery/labels POST reports/documents/labels/generate	Added examples of shortcuts for Yandex Go Market sellers.
POST businesses/{businessId}/offer-mappings/update	They told us how to transmit the name and description of the product to the sellers of the Yandex Go Market.

March 17th

Methods or documentation pages

Description of the changes

How order statuses change

POST campaigns/{campaignId}/orders/status-update

POST notification

Added a description of the sub-status PICKUP_EXPIRED — the storage period of the order in the PVZ has expired.

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.
Yandex.Market recommendations for cards	We have included information on how to use the recommendations of the Market in a separate instruction.
Adding and editing products	They told us how: change product categories; change product characteristics; delete product characteristics; combine products on a card.
Documentation of the Yandex.Market API for sellers.	The methods of working with product cards are now in the section Products.

March 13th

Methods or documentation pages	Description of the changes
POST reports/shelf-statistics/generate	Changed the column name Actual expenses,. Now it's called Actual expenses (including VAT),.

March 12th

Methods or documentation pages	Description of the changes
Types of errors and what to do about them	Clarified that the code `403` it comes not only when the token failed, but it can also mean another access error. Added a description of the errors: Contact not found for login 'login' and campaignId 'campaignId' — the user account whose login was sent to sign the electronic acceptance certificate was not found; Contacts with available roles for signing not found for login 'login' — the user account whose login was transferred to sign the electronic acceptance certificate does not have the necessary access rights.
POST notification	They told me that Yandex.Market can send multiple notifications for the same event. In some cases, this is normal behavior. Consider the later time of the event to be relevant.
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Clarified that the parameter `refundStatus` valid only for refunds (`returnType=RETURN`).

March 11th

Methods or documentation pages

Description of the changes

Methods of working with product labeling codes.

It was clarified that for sellers of the Yandex Go Market, the parameters are cis and hasCis relevant to the system as well «ASL BELGISI».

POST campaigns/{campaignId}/first-mile/shipments/{shipmentId}/confirm

Clarified the description of the parameters:

supplierShipmentDateTo equal to supplierShipmentDateFrom + a day, if the time interval between them is less than a day;
toDate equal to fromDate + a day if the time interval between them is less than a day.

10th of March

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}/shipments/reception-transfer-act

Added a parameter signatory — the username of the user in Yandex ID, on whose behalf the electronic acceptance certificate will be signed.

GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}

PUT campaigns/{campaignId}/first-mile/shipments

The parameter was added in the response signature — information about the signature of the acceptance certificate.

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`.
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/offer-cards/update	They said that with the help of POST category/{categoryId}/parameters You can check which category characteristics are available for a given category and get their settings.
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Clarified that the parameter in the response is `fastReturn` It only comes for refunds (`returnType=RETURN`).

March, 6

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

5th of March

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/orders POST campaigns/{campaignId}/stats/skus	Added a parameter `currency` — the currency in which the tariff value is indicated.
POST reports/united-orders/generate	Deleted the speakers COUNT (Information about orders/Quantity) and TRANSFERRED_FOR_DELIVERY (Information about orders/Delivered).
POST reports/united-orders/generate	Added columns: TRANSFERRED_FOR_DELIVERY (Information about orders/Delivered); DELIVERED_OR_RETURNED (Information about orders/Delivered or returned); DELIVERY_DATE (Information about orders/Order delivery date).

March, 3rd

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

March 1

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/promos/offers	It was clarified that the terms of participation in the promotions may change, except for the parameters `price` and `promoPrice`.

February 27th

Methods or documentation pages	Description of the changes
Express order processing	Added step-by-step instructions for processing Express orders.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status	Clarified that the value `MERCHANT_TO_COURIER` in the parameter `eacType` temporarily non-refundable.
POST reports/prices/generate	They clarified that the information is returned only for 50,000 products. If you have more than that, use filters.
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Added a value `UNKNOWN` (unknown status) in the parameter `shipmentStatus`.

February 26th

Methods or documentation pages	Description of the changes
POST reports/goods-realization/generate	The column was deleted ORDER_STATUS (Orders/Order status).

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

Methods or documentation pages

Description of the changes

POST campaigns/{campaignId}/orders/status-update

Added the reasons for canceling the order (parameter substatus):

TOO_MANY_DELIVERY_DATE_CHANGES — the order was postponed too many times.
DELIVERY_DATE_CHANGED_TOO_MUCH — the order has been postponed for too many days.

18th of Febuary

Methods or documentation pages	Description of the changes
Methods for getting reports.	They said that the structure and content of the reports may change without prior notice. This is due to the internal processes of the Market.

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

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/skus	The value was deleted `DELIVERY_TO_CUSTOMER_RETURN` in the parameter `TariffType`.

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.
Error messages	Added a description of the errors: CANT_GET_RESPONSE (UNSUPPORTED_MEDIA_TYPE) — the header of the store's response specifies a data format other than `application/json`; INVALID_RESPONSE (INVALID_DATA) — the body of the store's response contains incorrect or insufficient data.
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. 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`.
POST category/{categoryId}/parameters	Clarified the description of the method — returns a list of characteristics with acceptable values for the specified leafy A category is one that has no child categories.

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`.
POST businesses/{businessId}/promos	A parameter was added in the response `renewalEnabled` — whether the automatic transfer of the assortment between the "Bestsellers of the Market" promotions is enabled.
POST businesses/{businessId}/offer-cards	Clarified the parameter description `contentRating` — the rating of the card. Added parameters in the response: `averageContentRating` — the average rating of the card for products of the category indicated in `marketCategoryId`; `contentRatingStatus` — the status of calculating the card's rating and recommendations; `remainingRatingPoints` — the maximum number of card rating points that can be obtained for following recommendations.
POST businesses/{businessId}/offer-cards POST category/{categoryId}/parameters	Clarified the recommendation description `VIDEO_COUNT` — add at least one video.
GET campaigns/{campaignId}/outlets/licenses	Added a description of the license verification statuses: `REVOKE` — the license has been revoked by the quality service; `DONT_WANT` — it is not checked. `FAIL_MANUAL` — the license has not passed the quality control check.
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	A description of the value has been added to the details of the reasons for the refund `UNKNOWN` — the details of the reason are not specified. A description of the value has been added to the refund solution `UNKNOWN` — not specified. The type of logistics point has been removed `UNKNOWN`.
POST campaigns/{campaignId}/stats/orders	A description of the value has been added to the product type `EXPIRED` — expired product. The following product types were deleted: `FREEZE` `AVAILABLE` `QUARANTINE` `UTILIZATION` The value has been added to the order payment type `UNKNOWN` — unknown type of payment. Payment types have been removed: `CREDIT` `TINKOFF_CREDIT`

February 3rd

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

January 31st

Methods or documentation pages

Description of the changes

On the sheet Delivery via transit warehouse added columns:

SERVICES_COLUMN_MANY_WAREHOUSES_SUPPLY (Information about the service/Delivery for several warehouses);
SERVICES_COLUMN_VDC_DIRECTIONS_COUNT (Information about the service/The number of destinations reached in the delivery).

January 30th

Methods or documentation pages	Description of the changes
POST notification	Clarified that the allowed number of characters in the parameters is `name` (name of the integration) and `version` (integration version) — from 1 to 100.

January 29th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/orders	Clarified that the parameter `payments` it may return empty if there is no data about money transfers. The value was deleted `UNKNOWN` in the parameter `type`.
POST businesses/{businessId}/offer-mappings/archive	In the parameter `error` added a description of the value `UNKNOWN` — unknown error cause.
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Added a description of the refund transfer statuses: `EXPIRED` — the buyer did not bring the goods for return on time; `NOT_IN_DEMAND` — the refund was not picked up from the post office; `READY_FOR_EXPROPRIATION` — the items in the return are sent for resale; `RECEIVED_FOR_EXPROPRIATION` — Items in the return are accepted for resale. Added a description of the logistics statuses of specific products: `CREATED` — refund has been created. `RECEIVED` — the refund was accepted from the sender. `IN_TRANSIT` — return on the way; `READY_FOR_PICKUP` — the refund is ready to be issued to the store. `PICKED` — a refund has been issued to the store. `RECEIVED_ON_FULFILLMENT` — the refund is accepted at the Market warehouse; `CANCELLED` — the refund has been canceled. `LOST` — the refund is lost. `UTILIZED` — the refund has been disposed of; `PREPARED_FOR_UTILIZATION` — the return is ready for disposal; `EXPROPRIATED` — the items in the return are sent for resale; `NOT_IN_DEMAND` — the refund was not picked up from the post office.

january 28th

Methods or documentation pages	Description of the changes
Types of errors and what to do about them	Changed the error description Token is invalid on OAuth token is invalid. Added a description of the error OAuth token is invalid (account has been globally logged out) — the user used the function Get out everywhere in Yandex ID.
Create an application	We clarified the cases when the token needs to be received again.
POST reports/united-netting/generate	On the sheet Payment Report added a column BONUS_ACCOUNT_YEAR_MONTH (Information about payments/Billing period of the bonus for participation in joint promotions).
POST reports/united-marketplace-services/generate	Changed the name of the sheet Push messages. Now it's called Push notifications.

January 27

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/offer-mappings	Added a description of the value `DEFAULT` — pass it in the parameter `type` for a product that has a special type installed and you want to remove it.
POST businesses/{businessId}/offer-cards POST category/{categoryId}/parameters	Added a recommendation for filling in the parameter `FIRST_VIDEO_SIZE` — Replace the first video with a high-quality video.
PUT campaigns/{campaignId}/orders/{orderId}/items	Added a description of the reasons why the order composition was updated: `PARTNER_REQUESTED_REMOVE` — the store has deleted the product. `USER_REQUESTED_REMOVE` — the buyer asked to delete the product.

january 24th

Methods or documentation pages

Description of the changes

POST campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision

Clarified the description of the parameters:

updateFrom and updateTo — the start or end date of the period for which the order was changed. For example, the status or information about payments.
items — order delivery information is added as a separate element in the array items — parameter offerName with the value Delivery.

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.
POST reports/united-orders/generate POST reports/goods-realization/generate	XLSX specified in the column names that the information is indicated in units.

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
PUT campaigns/{campaignId}/orders/{orderId}/verifyEac	The parameter has been marked as mandatory `code` — the code to confirm the EAPP.
PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes	Clarified the description of the error code `400`. The parameter was removed from the request body `id`.
POST reports/united-marketplace-services/generate	Added an explanation to the columns on the sheet Push messages.
POST businesses/{businessId}/bids/recommendations	The parameter has been deprecated `priceRecommendations`.

January 17th

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 an example of a format shortcut `A9_HORIZONTALLY` and clarified the description of the value `A4`.
Methods that return the parameter in the response `status`.	Added a description of the possible parameter values `status`.
GET campaigns/{campaignId}/offer-mapping-entries	Added a description of the possible parameter values `mapping_kind`.
GET campaigns/{campaignId}/outlets/licenses POST campaigns/{campaignId}/outlets/licenses	In the parameter `LicenseType` added a description of the value `UNKNOWN` — unknown license type.
`GET campaigns/{campaignId}/feeds/{feedId}/index-logs`	The value was deleted `NOT_INDEXED` in the parameter `FeedIndexLogsErrorType`.

January 14th

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

January 10th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update	Clarified the operating principle of the parameter `onlyPartnerMediaContent` — when transmitting the value `true` items are being deleted the data that the Market added.

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.

December 26th

Methods or documentation pages	Description of the changes
Processing orders from legal entities	They told us how to determine that the order came from a legal entity.

December 24th

Methods or documentation pages

Description of the changes

Described the solutions for the product in the return:

REFUND_MONEY — refund the money for the product;
REFUND_MONEY_INCLUDING_SHIPMENT — refund the money for the product and the return shipment;
REPAIR — the store will eliminate the defects of the product;
REPLACE — the store will replace the product.
SEND_TO_EXAMINATION — the store will send the product for examination;
DECLINE_REFUND — do not return the money;
OTHER_DECISION — another solution.

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.
POST campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods	Clarified that the answer is `200` This does not mean that the keys have been transferred to the buyer. If the email with the keys was delivered, yandex.Market will transfer the order to the final status. `DELIVERED`.
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 13th

Methods or documentation pages

Description of the changes

POST reports/prices/generate

They clarified that the data in this report is constantly updated, so the information in it and in the seller's account on the Market is on the page Prices it may vary.

Pagination in requests to the Yandex Market API for sellers

They said that in some methods both types of pagination are available — with the page ID (page_token) and with her number (page).

In such cases, use the page ID.

December 12

Methods or documentation pages

Description of the changes

How to change product prices

POST campaigns/{campaignId}/offer-prices/updates

Clarified that the method POST campaigns/{campaignId}/offer-prices/updates It is available only if it is possible to set unique prices in individual stores in the seller's office on the Market.

How to check it is in the method POST businesses/{businessId}/settings in the parameter onlyDefaultPrice the value is returned false.

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.

December 2nd

Methods or documentation pages

Description of the changes

Clarified that in the parameter language The default language is Russian — RU.

Methods of working with orders.

The following parameters have become mandatory:

in OrderItemPromoDTO — subsidy;
in OrderItemDetailDTO — itemCount, itemStatus and updateDate;
in OrderSubsidyDTO — type and amount;
in OrderItemSubsidyDTO — type and amount;
in OrderItemDTO — id, offerId, offerName, price, buyerPrice, buyerPriceBeforeDiscount, count and vat;
in OrderDeliveryDatesDTO — fromDate;
in OrderTrackDTO — deliveryServiceId;
in OrderParcelBoxDTO — id and fulfilmentId;
in OrderDeliveryDTO — type, serviceName, deliveryPartnerType, dates and deliveryServiceId;
in OrderBuyerBasicInfoDTO — type;
in OrderDTO — id, status, substatus, creationDate, currency, itemsTotal, deliveryTotal, buyerItemsTotalBeforeDiscount, paymentType, paymentMethod, fake,delivery, buyer and taxSystem;
in RegionDTO — id.

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`. The parameter has been deprecated `customsCommodityCode`. Instead, use `commodityCodes` with the type `CUSTOMS_COMMODITY_CODE`.
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`.
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.

How to change product prices

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.
POST businesses/{businessId}/goods-feedback	Parameter `orderId` (the order ID on the Market) has become optional.

November 25th

Methods or documentation pages

Description of the changes

POST businesses/{businessId}/offer-prices/updates

They told us that you need to transfer VAT using the parameter vat in the method POST campaigns/{campaignId}/offers/update.

POST reports/united-orders/generate

POST reports/united-netting/generate

Types of errors and what to do about them

Added a parameter language — the language of the report.

November 22nd

Methods or documentation pages

Description of the changes

Described errors with the code 401:

Api-Key token format invalid — the API Key token format is incorrect.
Api-Key token length invalid — incorrect length of the Api Key token.
Api-Key token prefix invalid — incorrect prefix of the API Key token.

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 19

Methods or documentation pages

Description of the changes

POST campaigns/{campaignId}/offers/stocks

They said that for the FBY model, information about balances can be returned from several Market warehouses, which will have different warehouseId.

Request

November 18th

Methods or documentation pages

Description of the changes

POST businesses/{businessId}/bids/recommendations

Added a description of the errors with the code 400:

datediff-is-to-big-local — for delivery in your region, the difference between the maximum and minimum delivery time should not exceed two days;
datediff-is-to-big-remote — for delivery to other regions, the difference between the maximum and minimum delivery time should not exceed four days;
datediff-is-to-big-long-period — when delivering to other regions where the minimum delivery time is more than 18 days, the difference between the maximum and minimum delivery time should not exceed the minimum time.

15th of November

Methods or documentation pages

Description of the changes

Added a parameter benefits — a list of available subsidies.

POST businesses/{businessId}/bids/recommendations

Added types of additional promotion tools:

BESTS — participation in the "Best Sellers of the Market" campaign;
SPLIT_0_0_4 — the possibility of paying with a Split for a period of 4 months;
SPLIT_0_0_6 — the possibility of paying with a Split for a period of 6 months;
SPLIT_0_0_12 — the possibility of payment with a Split for a period of 12 months;
MARKET_SUBSIDY_1_4 — discount from the Market from 1 to 4%;
MARKET_SUBSIDY_5_9 — discount from the Market from 5 to 9%;
MARKET_SUBSIDY_10 — discount from the Market starting from 10%.

November 14th

Methods or documentation pages

Description of the changes

POST businesses/{businessId}/offer-cards

They said that the percentage of implementation is indicated for some recommendations:

PICTURE_COUNT
VIDEO_COUNT
MAIN
ADDITIONAL
DISTINCTIVE

the 13th of November

Methods or documentation pages

Description of the changes

They said that if there is an error for at least one product, the information in the catalog will not be updated for all transferred products.

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

GET campaigns/{campaignId}/returns

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 18

Methods or documentation pages

Description of the changes

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

They told me that the parameters logisticPickupPoint, shipmentRecipientType and shipmentStatus it may not be in the response in case of a refund:

With the option A quick refund for a cheap marriage when the product remains with the buyer (fastReturn=true).
By order from a business, if:
- refund status STARTED_BY_USER or WAITING_FOR_DECISION;
- The refund was cancelled before the transfer of the product.

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.
POST campaigns/{campaignId}/stats/orders	They said that information on created and updated orders can appear with a delay of up to 40 minutes.

October 16th

Methods or documentation pages	Description of the changes
`POST cart`	They told me that if in the parameter `outlets` If you specify non-existent pick-up point IDs, the delivery option will be ignored and its ID will not be received in the method. `POST order/accept`.

October 15th

Methods or documentation pages

Description of the changes

POST reports/documents/labels/generate

Added the product type ALCOHOL — alcohol.

October 14th

Methods or documentation pages

Description of the changes

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

October 11

Methods or documentation pages	Description of the changes
POST reports/united-netting/generate POST reports/united-marketplace-services/generate	Changed the maximum period for the parameters `dateTimeTo` and `dateTo`. Now it is 3 months old.
POST businesses/{businessId}/offer-mappings/update	Added the error type LOCKED_DIMENSIONS — the dimensions of the package have been transferred, which cannot be changed.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders PUT campaigns/{campaignId}/orders/{orderId}/status `POST order/accept` `POST order/status` `POST order/cancellation/notify`	Shipping methods have been removed `MARKET_PARTNER_OUTLET` and `DROPOFF`.

October 10th

Methods or documentation pages

Description of the changes

Added a parameter sortingType (the type of sorting labels in the file) and its values:

SORT_BY_GIVEN_ORDER — the order labels will be arranged in the same order as the order IDs were transmitted in the request;
SORT_BY_ORDER_CREATED_AT — The labels will be arranged according to the date the order was created and grouped by stores.

October 9th

Methods or documentation pages

Description of the changes

Added the type of product labeling CIS_OPTIONAL — the identifier of the product unit in the Honest SIGN system, which is optional, but will need to be transferred in the near future.

POST businesses/{businessId}/promos/offers

Added the error type INVALID_CATEGORY — a non-leaf category is specified.

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.
GET campaigns/{campaignId}/orders/{orderId} GET campaigns/{campaignId}/orders	For the parameter `tags` (product attributes) added values: `ULTIMA` — premium product; `SAFE_TAG` — a product with a protective label; `TURBO` — a product that sells out quickly.
GET campaigns/{campaignId}/orders	Added filtering of orders by checkout date — parameters `fromDate` and `toDate`.
GET campaigns/{campaignId}/returns	Each non-purchase began to be assigned its own identifier.

September 19

Methods or documentation pages

Description of the changes

POST businesses/{businessId}/promos/offers/update

POST businesses/{businessId}/promos/offers/delete

Added a description of the error Promo has ended — the promotion is over.

September 4

Methods or documentation pages	Description of the changes
POST reports/goods-turnover/generate	Added a parameter `date` — the date for which the turnover needs to be calculated.

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.

GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}

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
GET campaigns/{campaignId}/orders	Added parameters `page_token` and `limit` to navigate through the result pages.
POST businesses/{businessId}/offer-cards POST category/{categoryId}/parameters	They said that recommendations for adding or replacing content are not returned for cards that are filled with the Market or contain used goods.
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 16

Methods or documentation pages

Description of the changes

PUT campaigns/{campaignId}/first-mile/shipments

Added a parameter cancelledOrders — whether to refund cancelled orders.

August 15th

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

August 13th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update	Added the error type `INVALID_PICKER_URL` — a link to the thumbnail image has been transmitted, which is not included in the transmitted links to the product image.
PUT campaigns/{campaignId}/orders/{orderId}/status	Added a parameter `updatedAt` — date and time of the last order update.
PUT campaigns/{campaignId}/orders/{orderId}/status	They told us how to find orders in which the Market has postponed the shipment date.

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.
POST reports/united-orders/generate	Added a parameter `promoId` — the ID of the stock, the products from which are needed in the report.

August 9th

Methods or documentation pages

Description of the changes

Documentation of the Yandex.Market API for sellers.

Updated the menu.

Adding and editing products

Managing goods in the archive

How to change product prices

We shared the step-by-step instructions on "Catalog Management".

August 8th

Methods or documentation pages

Description of the changes

POST campaigns/{campaignId}/offer-prices/suggestions

The price type has been removed MAX_DISCOUNT_BASE, MARKET_OUTLIER_PRICE and MAX_DISCOUNT_PRICE

The method has been deprecated. Instead, use POST reports/goods-prices/generate.

August 5th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update	They told us in the description of the method that the parameter `offerId` It must be unique for all the products that you transfer.
`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

Added the payment method for the order BOUND_CARD_ON_DELIVERY — linked bank card upon receipt.

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.
POST businesses/{businessId}/offer-mappings	Added the product status in the store `ARCHIVED` — in the archive.

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

Methods or documentation pages

Description of the changes

GET regions/{regionId}/children

GET campaigns/{campaignId}/hidden-offers

GET campaigns

GET models/{modelId}/offers

GET campaigns/by_login/{login}

You have specified an upper limit for transmitting the page number of the results — the parameter page.

You can no longer specify a page number greater than 10,000.

July 24th

Methods or documentation pages

Description of the changes

Page Automatic renewal of the OAuth token.

They said that the token may not be updated if its remaining life is long enough.

The validity period of the OAuth token is one year. It needs to be updated before this period expires. For example, once every nine months.

July 19th

Methods or documentation pages	Description of the changes
Increased the upper value for the minimum cost of the product without a discount to 99% — parameter `discountBase`.	POST businesses/{businessId}/offer-mappings/update POST businesses/{businessId}/updateBusinessPrices/update
POST reports/competitors-position/generate	Added a new value: if in the column POSITION specified `-1` — it means that there were no orders for products in the specified category on that day.
POST campaigns/{campaignId}/offer-prices/suggestions	They clarified that the method is available only to sellers who set prices in rubles.
POST campaigns/{campaignId}/offers/delete	Added the reasons why it is not possible to delete the products.: they have not been found or are stored in the Market warehouse.
`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 campaigns/{campaignId}/offers/update

The upper limit for transmitting the minimum number of items in an order has been removed — the parameter minQuantity.

POST order/accept

POST order/status

POST order/cancellation/notify

Added a parameter subsidies — a list of subsidies by type.

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
POST businesses/{businessId}/settings	Added a parameter `currency` — currency in the seller's account on the Market.
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
PUT campaigns/{campaignId}/first-mile/shipments	Parameters `dateFrom` and `dateTo` they have become mandatory.
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 was deleted `status`.

July 3rd

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/orders	Added a service `ILLIQUID_GOODS_SALE` — remuneration for the sale of non-imported goods.
PUT campaigns/{campaignId}/orders/{orderId}/status POST campaigns/{campaignId}/orders/status-update GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId}	Added the order's sub-status `TECHNICAL_ERROR` — a technical error on the Market's side.
POST businesses/{businessId}/offer-mappings/update	Now you can send up to 30 links to product images.

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

Methods or documentation pages

Description of the changes

GET reports/info/{reportId}

Added a report generation sub-status RESOURCE_NOT_FOUND — some of the entities could not be found for this report.

Returned if when generating a PDF file with shortcuts in the method POST reports/documents/labels/generate some of the orders could not be found.

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 18

Methods or documentation pages

Description of the changes

Divided the type of subsidies into OrderSubsidyType and OrderItemSubsidyType.

June 13th

Methods or documentation pages

Description of the changes

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

The subsidy type has been removed SPASIBO.

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

June 3rd

Methods or documentation pages

Description of the changes

Added examples of requests for transmitting information about the distribution of goods.

Added a description of the errors:

CATEGORY_MISMATCH — a category is specified that does not match the product category.
INVALID_GROUP_ID_LENGTH — the name exceeds the allowed value of 255 characters.
INVALID_GROUP_ID_CHARACTERS — invalid characters are transmitted.

May 31

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update	Added a description of the error EMPTY_MARKET_CATEGORY — the Market category is not specified when transmitting the category characteristics.

May 29th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings	They told us how to transmit the values of one parameter if the product has several of them.
POST businesses/{businessId}/offer-cards	Added a parameter `parameterValues` — a list of characteristics with their values.
POST businesses/{businessId}/offer-mappings/update	Added a parameter `basicPrice` — the price of the product.

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.
GET campaigns/{campaignId}/returns GET campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Added a parameter `fastReturn` — is the option used? A quick refund for a cheap marriage.
PUT campaigns/{campaignId}/orders/{orderId}/status	They told me when to pass the parameter. `realDeliveryDate`.

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, 23rd

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}/returns

Added error types:

INVALID_GROUP_ID_LENGTH — the name exceeds the allowed value of 255 characters.
INVALID_GROUP_ID_CHARACTERS — invalid characters are transmitted.

May 22nd

Methods or documentation pages

Description of the changes

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

Added the refund status COMPLETE_WITHOUT_REFUND — No refund is required.

May 21st

Methods or documentation pages

Description of the changes

Additional rates have been added to the accommodation service:

CANCELLED_ORDER_FEE_QI — cancellation of the order due to the seller's fault;
LATE_ORDER_EXECUTION_FEE_QI — late shipment or delivery.

May 20th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/orders/{orderId}/business-buyer	Added `PROCESSING` to the list of order statuses where you can get information about the buyer — a legal entity.

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 was deleted `feed`.

May 14th

Methods or documentation pages	Description of the changes
POST reports/shelf-statistics/generate	Added a summary report on the shelves.
POST categories/tree	Added a parameter `language` — the language of categories.

May 13

Methods or documentation pages

Description of the changes

POST order/status

POST order/accept

Added a parameter shopOrderId — the order ID in the store.

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.
POST tariffs/calculate	Added a parameter for calculating the cost of services `quantity` — quantum of sale.
POST businesses/{businessId}/offer-mappings/update	Added: parameter `parameterValues` — a list of characteristics with their values; errors and warnings related to the transmitted characteristics.

May 3rd

Methods or documentation pages

Description of the changes

POST category/{categoryId}/parameters

Added a parameter marketCategoryId — the identifier of the category on the Market to which you attribute your product.

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

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/chats/history	A parameter was added in the response `orderId` — order ID.

April 19th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/returns	You specified the maximum number of order IDs (parameter `orderIds`) — 50.
POST campaigns/{campaignId}/offers/update	They told us how to reset the previously set quantum values.
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`	Specified irrelevant discount types — parameter `type`. The parameter has been deprecated `status`.
`POST cart`	Specified irrelevant discount types — parameter `type`.

April 18th

Methods or documentation pages	Description of the changes
Transfer of balances via API	They told us how to check the functionality of the balance transfer integration.
GET campaigns/{campaignId}/orders GET campaigns/{campaignId}/orders/{orderId} PUT campaigns/{campaignId}/orders/{orderId}/status	The parameter has been deprecated `price`.

April 17th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders	Added filtering of orders by customer type — parameter `buyerType`.

April 16

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/chats	The parameter was added in the response `orderId` — order ID.
GET campaigns/{campaignId}/orders	Added filtering by order IDs — parameter `orderIds`.

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.

A parameter was added in the response units — information about acceptable units of measurement.

You can specify them when filling out product cards — method POST businesses/{businessId}/offer-cards/update.

April, 4

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/first-mile/shipments/{shipmentId}/confirm	The parameter was deleted `orderIds`.

April 3

Methods or documentation pages

Description of the changes

GET businesses/{businessId}/warehouses

GET warehouses

The parameter was deleted additional.

April 2

Methods or documentation pages	Description of the changes
POST tariffs/calculate	Added a parameter `parameters` — details of the calculation of a specific Market service.

April 1st

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update	Increased the maximum number of links to the product video to 6 — parameter `videos`.

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.
PUT campaigns/{campaignId}/offers/stocks	Parameter `updatedAt` became optional. If it is not transmitted, the current time will be used. The parameter was deleted `warehouseId`. The warehouse ID will be determined by `campaignId`. The parameter was deleted `type`. The only possible value `FIT` it will be transmitted automatically.

March 22nd

Methods or documentation pages

Description of the changes

A parameter was added in the response address — the address of the pick-up point.

The service was deleted FULFILLMENT.

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

Methods or documentation pages

Description of the changes

Added a parameter manuals — a list of instructions on how to use the product.

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.
`POST cart`	Increased the maximum number of dates in the parameter `dates` until 7.

March 12th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/skus	Services have been deleted `CANCELLED_ORDER_FEE` and `LATE_ORDER_EXECUTION_FEE`.

March 8th

Methods or documentation pages

Description of the changes

Added services:

EXPRESS_CANCELLED_BY_PARTNER — cancellation of an order with express delivery;
DELIVERY_TO_CUSTOMER_RETURN — return of the delivered goods to the warehouse;
CROSSBORDER_DELIVERY — delivery from abroad;
INTAKE_SORTING_BULKY_CARGO — sorting orders with bulky goods that the Market has taken from the seller's warehouse;
INTAKE_SORTING_SMALL_GOODS — sorting orders with small-sized goods that the Market has taken from the seller's warehouse;
INTAKE_SORTING_DAILY — organization of picking up orders from the seller's warehouse;
FF_STORAGE_BILLING — storage of goods in a warehouse.

March, 6

Methods or documentation pages

Description of the changes

POST reports/goods-turnover/generate

POST reports/prices/generate

Added a value NOT_SPECIFIED (not selected) for the parameters:

type — the type of markdown;
quality — the appearance of the product.

5th of March

Methods or documentation pages

Description of the changes

Two report formats are now available:

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

March 4

Methods or documentation pages	Description of the changes
POST reports/stocks-on-warehouses/generate	Added filters by category on the Market and by the presence of residues for all models except FBY.

March 1

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/orders	The order status has been deleted `REJECTED`.

February 29th

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}/outlets

GET campaigns/{campaignId}/outlets/{outletId}

The parameter was deleted emails.

POST reports/united-netting/generate

POST reports/goods-realization/generate

POST reports/goods-movement/generate

POST reports/shows-sales/generate

Added services:

CROSSREGIONAL_DELIVERY_RETURN — delivery of non-purchases and refunds;
MIDDLE_MILE — average mile.
LATE_ORDER_EXECUTION_FEE — shipment or delivery is not on time;
RETURN_PROCESSING — processing of non-purchases and refunds.

February 27th

Methods or documentation pages

Description of the changes

Two report formats are now available:

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

February 26th

Methods or documentation pages	Description of the changes
GET businesses/{businessId}/warehouses	Added a parameter `express` — is it possible to deliver using the Express model?

February 22nd

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/orders	Added a payment type `SPLIT` — payment by card in parts (Split).

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.

GET businesses/{businessId}/warehouses

GET warehouses

The parameter was added in the response address — the address of the warehouse.

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
POST campaigns/{campaignId}/stats/orders	Added a service for FBY stores `RETURN_PROCESSING` — order processing at the warehouse.
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.

February 7

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}/outlets

GET campaigns/{campaignId}/outlets/{outletId}

The parameter was deleted cost.

POST cancellation/notify

Parameter email (buyer's email address) is no longer returned in replies.

February 2

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders/{orderId}/delivery/labels/data	The parameter was added in the response `boxId` — the ID of the box.

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 was deleted `feedId`. The parameter has been deprecated `shopSku`. Instead, use `offerId`.
PUT campaigns/{campaignId}/orders/{orderId}/identifiers	The parameter was deleted `feedId`.

January 31st

Methods or documentation pages

Description of the changes

DELETE campaigns/{campaignId}/outlets/{outletId}

GET campaigns/{campaignId}/outlets

GET campaigns/{campaignId}/outlets/{outletId}

The following parameters have become optional:

name — the name of the point of sale;
phones — phone numbers of the point of sale;
address — the address of the point of sale;
regionId — the region's identifier.
workingSchedule — a list of operating modes of the point of sale;
scheduleItems — a list of opening hours of the point of sale;
startDay — the day of the week on which the point of sale starts operating;
endDay — the day of the week on which the point of sale finishes working;
startTime — the start time of the point of sale;
endTime — the end time of the point of sale;
cost — the cost of pickup from the point of sale;
type — type of point of sale.

January 30th

Methods or documentation pages

Description of the changes

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

GET campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label

You have specified the sizes of the labels that are returned in the PDF file.

January 29th

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}/hidden-offers

POST campaigns/{campaignId}/hidden-offers

DELETE campaigns/{campaignId}/hidden-offers

Deleted the parameters ttlInHours and feedId.

The 25th of January

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}/hidden-offers

POST campaigns/{campaignId}/hidden-offers

DELETE campaigns/{campaignId}/hidden-offers

The parameter was deleted marketSku.

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
Methods where the product name is transmitted.	Increased the maximum number of characters in the product name to 256.
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.
PUT campaigns/{campaignId}/offers/stocks	Starting from March 1, 2024, the limit on the number of requests in the method will change — 100,000 items per minute, no more than 500 items per request.

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 items in the archive.
POST campaigns/{campaignId}/stats/orders	Added a service `INTAKE_SORTING` — organization of picking up orders from the seller's warehouse.

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

15th of November

Methods or documentation pages	Description of the changes
Methods where the SKU is passed.	You can now use the letter e in the store's product identifier (SKU).

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

Methods or documentation pages

Description of the changes

GET regions

Increased the number of regions in the response on one page to 20 — parameter limit.

Added the option to specify the ID of the results page — parameter page_token.

October 19th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/orders	Added filtering by date and time of the order update.
POST businesses/{businessId}/offers/recommendations	Added a parameter `price` — the price of the product in the catalog.

October 18

Methods or documentation pages

Description of the changes

Added the payment method for the order B2B_ACCOUNT_POSTPAYMENT — the order is paid for by the organization after delivery.

October 14th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/skus	Clarified that the parameter `warehouses` It will not be refunded if the product is not in any warehouse.

October 5th

Methods or documentation pages

Description of the changes

Added the following statuses:

PARTIALLY_DELIVERED — the order has been partially delivered.
LOST — the order is lost.

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 businesses/{businessId}/price-quarantine	Added a parameter `verdicts` — the reasons for the product being quarantined, where `type` — it's a type of quarantine, eh `params` — the price due to which the product was quarantined, and the values for comparison.
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 8th

Methods or documentation pages	Description of the changes
GET reports/info/{reportId}	Added a sub-status `TOO_LARGE` — the report exceeded the allowed size.

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 31

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/skus	The parameter was deleted `storage`.

August 29th

Methods or documentation pages	Description of the changes
GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}	Outdated shipment statuses have been deleted.

August 28th

Methods or documentation pages

Description of the changes

Now you don't need to include an empty body in the request.

Don't send it if you want to get a list of all the products in the catalog.

August 24th

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/orders/status-update	We have set a limit on the maximum number of orders for which the status can be changed in one request — 30.

August 23rd

Methods or documentation pages	Description of the changes
POST campaigns/{campaignId}/stats/orders	The parameter was deleted `predicted`.

August 15th

Methods or documentation pages

Description of the changes

POST cart

POST order/accept

POST order/status

POST order/cancellation/notify

In address added a parameter district — the area in the order delivery address.

August 12th

Methods or documentation pages

Description of the changes

PUT campaigns/{campaignId}/offers/stocks

In OrderDeliveryAddressDTO added a parameter district — the area in the order delivery address.

August 8th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings	Now you can transmit no more than 200 values on a single page if the request is made for specific products.
POST campaigns/{campaignId}/stats/skus	Deleted the types of remaining items `SUGGEST` and `TRANSIT`.

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.

August 1st

Methods or documentation pages

Description of the changes

POST stocks

Now you need to transfer the quantity of available goods in the warehouse without taking into account the reserve.

July 27th

Methods or documentation pages

Description of the changes

Now you can find out:

the threshold for discounts with Yandex.Market at the time of placing the order is the parameter cofinanceThreshold;
discount with Yandex.Market — parameter cofinanceValue.

July 26th

Methods or documentation pages

Description of the changes

GET campaigns/{campaignId}

Added information about the cost of services:

AGENCY — acceptance of the buyer's payment;
AUCTION_PROMOTION — boost sales;
DELIVERY_TO_CUSTOMER — delivery to the buyer;
EXPRESS_DELIVERY_TO_CUSTOMER — express delivery to the buyer;
FEE — product placement on the Market;
FULFILLMENT — warehouse processing;
INSTALLMENT — installments;
LOYALTY_PARTICIPATION_FEE — participation in the loyalty program and reviews for points, if they are enabled;
PAYMENT_TRANSFER — transfer of the buyer's payment;
RETURNED_ORDERS_STORAGE — storage of non-purchases and refunds;
SORTING — order processing.

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.

July 7th

Methods or documentation pages	Description of the changes
POST businesses/{businessId}/offer-mappings/update	We have updated the instructions for adding a new product — we have listed the parameters without which it will not be possible to add the product to the catalog.

July 4th

Methods or documentation pages

Description of the changes

GET campaigns

GET campaigns/by_login/{login}

Now you can find out:

The business ID is a parameter id in business;
business name is a parameter name in business.

July 3rd

Methods or documentation pages

Description of the changes

GET campaigns

GET campaigns/{campaignId}

GET campaigns/by_login/{login}

Now you can find out the model that the store uses — the parameter placementType.

June 30

Methods or documentation pages

Description of the changes