Все обновления

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

Уточнили, что в параметре limit нужно передавать значение не больше 50.

На листе Платное хранение с 01.06.22 (файл paid_storage_after_01-06-22) добавили колонки:

LENGTH_PRODUCT_M (Информация об услуге/Длина единицы товара, м);
WIDTH_PRODUCT_M (Информация об услуге/Ширина единицы товара, м);
HEIGHT_PRODUCT_M (Информация об услуге/Высота единицы товара, м);
COUNT_PRODUCT_UNIT (Информация об услуге/Количество единиц товара, шт.);
VOLUME_UNITS_OF_GOODS (Информация об услуге/Объём всех единиц товара, кубометры);
MEASUREMENT_UNIT (Информация об услуге/Единица измерения).

4 августа

Методы или страницы документации

Описание изменений

POST v2/reports/shows-boost/generate

POST v2/reports/banners-statistics/generate

POST v2/reports/shelf-statistics/generate

Удалили колонку AVERAGE_BID.

1 августа

Методы или страницы документации	Описание изменений
POST v2/reports/stocks-on-warehouses/generate	Уточнили, что для моделей DBS, FBS и Экспресс параметр `campaignId` скоро станет недоступен. Для получения информации об остатках на складе магазина используйте `businessId` и идентификатор нужного магазина в `campaignIds`.
GET v2/campaigns/{campaignId}/settings	Отметили устаревшими параметры `showInContext`, `showInPremium` и `useOpenStat`.
`GET v2/campaigns/{campaignId}/region`	Удалили устаревший метод.

31 июля

Методы или страницы документации

Описание изменений

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

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

POST notification

Удалили значения USER_REFUSED_TO_PROVIDE_PERSONAL_DATA и RECEIVED_ON_DISTRIBUTION_CENTER в substatus.

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

GET v2/campaigns/{campaignId}/outlets

Отметили устаревшими параметры shopOutletId и workingTime. Вместо них используйте shopOutletCode и workingSchedule.

30 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update	Уточнили, что в параметре `offerMappings` нужно передавать не больше 100 товаров.

29 июля

Методы или страницы документации

Описание изменений

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

POST v2/reports/stocks-on-warehouses/generate

Рассказали, что для характеристик типа ENUM нужно передавать вместе параметры value и valueId.

28 июля

Методы или страницы документации	Описание изменений
Обработка заказов с цифровыми товарами	Рассказали: как понять, что в заказе есть цифровые товары; что Маркет отправит ключи покупателю в чат, если не получилось доставить письмо.
POST v2/businesses/{businessId}/offer-mappings/update	Удалили параметр `cofinancePrice` и значение `COFINANCE_PRICE` в `deleteParameters`.
POST v2/businesses/{businessId}/offer-mappings	Удалили параметр `cofinancePrice`.
POST v2/businesses/{businessId}/offers/recommendations	Удалили фильтр `FieldStateType` и параметры `cofinancePriceFilter` и `cofinancePrice`.

26 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/promos/offers	Удалили параметр `promocodeParams`.
POST v2/businesses/{businessId}/promos/offers/update	Удалили предупреждение `PROMOCODE_PRICE_MORE_THAN_MAX_FAIR_PRICE`.

25 июля

Методы или страницы документации	Описание изменений
POST v2/categories/max-sale-quantum	Отметили метод устаревшим.
POST v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers	Отметили устаревшим параметр `quantum`.
POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	Отметили устаревшим параметр `firstVideoAsCover`.

23 июля

Методы или страницы документации

Описание изменений

Параметр campaignId перестал быть обязательным. Если его передать, вернется отчет об остатках на соответствующем складе магазина.

Добавили параметр businessId. Если его передать, в отчете вернется информация об остатках на всех складах магазинов в кабинете, кроме FBY.

Добавили параметр campaignIds — фильтр по магазинам для отчета по кабинету (кроме модели FBY).

FBY-заявки на поставку товаров на склад, вывоз или утилизацию

POST v2/campaigns/{campaignId}/supply-requests

Уточнили, что родительские и дочерние заявки теперь создаются и для поставок на склад хранения.

22 июля

Методы или страницы документации	Описание изменений
POST v2/tariffs/calculate	Метод стал доступен для продавцов Market Yandex Go.

21 июля

Методы или страницы документации

Описание изменений

Добавление и редактирование товаров

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

Рассказали, что произойдет, если не передать параметры marketCategoryId или parameterValues.

17 июля

Методы или страницы документации

Описание изменений

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

Уточнили, что вознаграждение и цена товара в параметрах subsidies, price, costPerItem и total включает НДС.

16 июля

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Отметили устаревшим параметр `id` в `LogisticPickupPointDTO`.

15 июля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods	Добавили примеры для передачи нескольких товаров с уникальными или одинаковыми идентификаторами.
Добавление и редактирование товаров	Рассказали, как в кабинете продавца на Маркете узнать источник и время обновления информации.
Список методов, используемых в модели FBY Список методов, используемых в модели FBS Список методов, используемых в модели Экспресс Список методов, используемых в модели DBS	Рассказали о моделях работы на Маркете.

11 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-prices	Добавили новый метод. Он возвращает список цен, которые вы установили для всех магазинов.
POST v2/businesses/{businessId}/offer-prices/updates	Добавили параметр `minimumForBestseller` — минимальная цена товара для попадания в акцию «Бестселлеры Маркета».
GET v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/transportation-waybill	Уточнили, что транспортная накладная возвращается только для тех отгрузок, в которых Маркет забирает товары с вашего склада.
GET v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}	Добавили значение параметра `availableActions` — `DOWNLOAD_TRANSPORTATION_WAYBILL` (скачать транспортную накладную).

10 июля

Методы или страницы документации	Описание изменений
Добавление и редактирование товаров	Рассказали, что характеристики, которые являются особенностями варианта товара, могут зависеть от кабинета. Чтобы узнать их, в методе POST v2/category/{categoryId}/parameters передайте параметр `businessId`.
GET v2/campaigns/{campaignId}/orders Тестовые заказы	Уточнили, что информация по тестовым заказам по умолчанию не возвращается.
Формат данных запроса и ответа	Добавили пример тела запроса и ответа.

9 июля

Методы или страницы документации	Описание изменений
Чаты с покупателями Невыкупы и возвраты Как изменяются статусы возвратов для моделей FBY, FBS и Экспресс	Рассказали, что Экспресс-магазины могут принимать решения по возвратам и создавать чаты с покупателями, чтобы уточнять детали возврата.

8 июля

Методы или страницы документации

Описание изменений

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

В ответе добавили параметр externalOrderId — внешний идентификатор заказа в системе магазина.

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

Добавили параметры:

estate — владение;
building — строение.

7 июля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods	Рассказали, какие теги можно использовать для форматирования текста в инструкция по активации.

3 июля

Методы или страницы документации	Описание изменений
POST v2/reports/closure-documents/generate	Добавили новый метод. Он дает возможность получить закрывающие документы.
POST v2/reports/closure-documents/detalization/generate	Добавили отчет по схождению с закрывающими документами.
Типы ошибок и что с ними делать	Описали ошибку Contract with type MARKETING was signed with the agency (договор на маркетинг заключен с агентством), которую Маркет может вернуть в ответе на запрос.

1 июля

Методы или страницы документации	Описание изменений
Чаты с покупателями Невыкупы и возвраты	Рассказали, что FBS-магазины могут создавать чаты с покупателями не только по заказам, но и возвратам.

30 июня

Методы или страницы документации	Описание изменений
FBS-магазины DBS-магазины	Добавили схемы, как изменяются статусы возвратов.
POST v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/submit	Теперь метод передает и подтверждает решения по возврату для всех моделей размещения, кроме FBY.
Невыкупы и возвраты	Рассказали, как работать с возвратами, по которым требуется решение.
POST v2/reports/shows-sales/generate	Удалили колонку MAX_VISIBILITY_INDEX — максимальный индекс видимости.
POST v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision	Отметили метод устаревшим. Вместо него используйте POST v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/submit.

25 июня

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/promos	Уточнили, что в ответе не возвращаются данные об акциях, которые создал продавец.
PUT v2/businesses/{businessId}/bids	Уточнили, что данные обновляются не мгновенно.

23 июня

Методы или страницы документации	Описание изменений
Лог запросов	Рассказали о виджете с информацией об ошибках в запросах и ответах и фильтре Интеграция.
POST v2/reports/documents/shipment-list/generate	Уточнили, что в методе нужно обязательно передавать `shipmentId` или `orderIds`.

4 июня

Методы или страницы документации	Описание изменений
POST v2/reports/key-indicators/generate	Добавили отчет по ключевым показателям.
PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes	Отметили метод устаревшим. Вместо него используйте PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

3 июня

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offer-prices GET v2/campaigns/{campaignId}/offer-prices	Изменили лимиты на количество товаров — 150 000 товаров в минуту.
GET v2/campaigns/{campaignId}/offer-mapping-entries	Изменили лимит на количество товаров — 10 000 товаров в минуту.

30 мая

Методы или страницы документации	Описание изменений
POST v2/reports/jewelry-fiscal/generate	Добавили колонку BUYER_PRICE — цена товара.

29 мая

Методы или страницы документации	Описание изменений
POST v2/reports/sales-geography/generate	Добавили отчет по географии продаж.
Удалили устаревшие методы.	`GET v2/campaigns/{campaignId}/offers` `GET v2/campaigns/{campaignId}/offers/all` `GET v2/campaigns/{campaignId}/feeds` `GET v2/campaigns/{campaignId}/feeds/{feedId}` `GET v2/campaigns/{campaignId}/feeds/{feedId}/index-logs` `POST v2/campaigns/{campaignId}/feeds/{feedId}/params` `POST v2/campaigns/{campaignId}/feeds/{feedId}/refresh`

28 мая

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/orders/{orderId}/identifiers/status	Добавили новый метод. Он возвращает статусы проверки УИНов в заказе.

27 мая

Методы или страницы документации	Описание изменений
POST v2/reports/jewelry-fiscal/generate	Добавили отчет по заказам с ювелирными изделиями.

20 мая

Методы или страницы документации

Описание изменений

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

Указали максимальное количество характеристик (параметр params в UpdateOfferDTO) — 600.

Указали максимальную длину:

названия характеристики (параметр name в OfferParamDTO) — 200 символов;
ссылки на инструкцию (параметр url в OfferManualDTO) — 512 символов;
названия инструкции (параметр title в OfferManualDTO) — 200 символов;
комментария (параметр comment в TimePeriodDTO) — 500 символов.

16 мая

Методы или страницы документации

Описание изменений

Обработка FBS-заказов

Обработка Экспресс-заказов

Рассказали, что на шаге проверки новых заказов нужно использовать диапазон дат доставки — параметры fromDate и toDate. А для получения информации о заказах, в которых были изменения, — фильтры updatedAtFrom и updatedAtTo.

Как работать с уведомлениями

Изменили частоту, с которой Маркет повторяет запрос, если магазин не укладывается в десятисекундный таймаут или на запрос POST notification возвращает ошибку, кроме 400. Теперь эта частота — каждая минута в течение первого часа.

13 мая

Методы или страницы документации

Описание изменений

Методы, где передается или возвращается campaignId.

В описании параметра campaignId (идентификатор кампании) рассказали:

как его узнать;
что его не следует путать с идентификатором магазина, который указан в кабинете продавца на Маркете рядом с названием магазина и в некоторых отчетах.

Вызов методов

Рассказали о параметрах пути (path parameters) и параметрах запроса (query parameters).

6 мая

Методы или страницы документации	Описание изменений
POST v2/reports/banners-statistics/generate	Добавили отчет по охватному продвижению.
Как работать с уведомлениями	Уточнили, что уведомления, связанные с заказами, приходят и по FBY-заказам, если они настроены для кабинета.

30 апреля

Методы или страницы документации	Описание изменений
POST v2/reports/shows-boost/generate	Добавили отчет по бусту показов.
POST v2/campaigns/{campaignId}/orders/{orderId}/external-id	Добавили новый метод. Он передает внешний идентификатор заказа в системе магазина.

29 апреля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offers/stocks	Добавили фильтр по идентификатору склада — параметр `stocksWarehouseId`.
POST v2/businesses/{businessId}/promos/offers	Добавили фильтр `MINIMUM_FOR_PROMOS` — товары с установленным минимумом по цене для акций, который соответствует порогу `maxPromoPrice`.

28 апреля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/supply-requests — получение информации о заявках на поставку, вывоз и утилизацию; POST v2/campaigns/{campaignId}/supply-requests/items — получение товаров в заявке на поставку, вывоз или утилизацию; POST v2/campaigns/{campaignId}/supply-requests/documents — получение документов по заявке на поставку, вывоз или утилизацию.	Добавили методы работы с FBY-заявками.
FBY-заявки на поставку товаров на склад, вывоз или утилизацию	Добавили пошаговую инструкцию по работе с FBY-заявками.

24 апреля

Методы или страницы документации	Описание изменений
POST v2/auth/token	Добавили новый метод. Он возвращает информацию о переданном авторизационном токене.
Модуль для системы «1С:Предприятие»	Рассказали о модуле для системы «1С:Предприятие», с помощью которого можно управлять товарами и обрабатывать заказы на Маркете.
Как работать с уведомлениями	Рассказали, какие роли нужны для настройки API-уведомлений.
POST v2/businesses/{businessId}/offer-mappings/update	Отметили устаревшим параметр `cofinancePrice`.

23 апреля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offers/recommendations	Удалили фильтр `recommendedCofinancePriceFilter`. Удалили параметр `recommendedCofinancePrice` в ответе.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status POST v2/campaigns/{campaignId}/orders/status-update	Удалили причину отмены заказа `DELIVERY_DATE_CHANGED_TOO_MUCH` — заказ перенесен на слишком много дней.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status POST v2/campaigns/{campaignId}/orders/status-update	Добавили причину отмены заказа `TOO_LONG_DELIVERY` — заказ доставляется слишком долго.

22 апреля

Методы или страницы документации	Описание изменений
POST v2/reports/united-netting/generate	Добавили отчет о баллах Маркета.
GET v2/businesses/{businessId}/chat — возвращает чат по его идентификатору; GET v2/businesses/{businessId}/chats/message — возвращает сообщение по его идентификатору.	Добавили методы работы с чатами.
POST notification	Добавили типы уведомлений: создание чата с покупателем; добавление сообщения в чате; начало спора; завершение спора; создание отзыва о товаре; создание комментария к отзыву.
Чаты с покупателями	Обновили инструкцию, как проверить, есть ли новые чаты или сообщения.
Как работать с уведомлениями	Рассказали, какие уведомления приходят только для кабинета, а какие — для кабинета и магазина.
Типы ошибок и что с ними делать	Добавили описание ошибки The method is not supported for Market Yandex Go sellers — метод недоступен для продавцов Market Yandex Go.

21 апреля

Методы или страницы документации

Описание изменений

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

Добавили лист Нанесение знака маркировки (файл product_marking).

Изменили название колонок:

SERVICE_DATE → SERVICE_DATE_TIME;
serviceDate → serviceDateTime;
Информация об услуге/Дата оказания услуги → Информация об услуге/Дата и время оказания услуги.

16 апреля

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/hidden-offers	Удалили параметр `PageNum`.
Методы, где передаются или возвращаются эти типы скидки.	Удалили устаревшие типы скидки: `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`

15 апреля

Методы или страницы документации	Описание изменений
Как пользоваться консолью	Рассказали, как авторизоваться в консоли в зависимости от типа токена.

11 апреля

Методы или страницы документации	Описание изменений
Методы, где передаются или возвращаются эти параметры.	Отметили устаревшими параметры `marketModelId`, `marketModelName`, `modelIds` и `modelId`.
GET v2/models/{modelId} POST v2/models GET v2/models/{modelId}/offers POST v2/models/offers GET v2/models	Отметили методы устаревшими.

10 апреля

Методы или страницы документации	Описание изменений
Работа со складами	Добавили пошаговую инструкцию, как работать со складами.

9 апреля

Методы или страницы документации	Описание изменений
POST v2/regions/countries	Добавили новый метод. Он возвращает список стран с их кодами.
POST v2/businesses/{businessId}/offer-prices/updates	Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 500 товаров в одном запросе в методе.
POST v2/campaigns/{campaignId}/offer-prices/updates	Изменили лимит на количество товаров — 10 000 товаров в минуту.
POST v2/businesses/{businessId}/goods-feedback	Уточнили, что не возвращаются отзывы, которые удалили покупатели или Маркет. Добавили параметр `feedbackIds` — идентификаторы отзывов.Не используйте его одновременно с другими фильтрами.
POST v2/businesses/{businessId}/goods-feedback/comments	Уточнили, что не возвращаются комментарии к удаленным отзывам и те, которые удалили пользователи или Маркет. Параметр `feedbackId` стал необязательным. Добавили параметр `commentIds` — идентификаторы комментариев. Не используйте его одновременно с другими фильтрами.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes PUT v2/campaigns/{campaignId}/orders/{orderId}/status PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers	Добавили параметр `countryCode` — страна производства.
Обработка заказов от юридических лиц	Описали особенности работы с заказами от юридических лиц.
Типы ошибок и что с ними делать	Добавили описание ошибки String (value) is not a valid country code according to ISO 3166-1 alpha-2 — недопустимый код страны. Укажите код страны в формате ISO 3166-1 alpha-2.

8 апреля

Методы или страницы документации

Описание изменений

Невыкупы и возвраты

Добавили пошаговую инструкцию, как работать с невыкупами и возвратами.

Запуск интеграции на Node.js Express

Уточнили, что заказ может перейти в статус PARTIALLY_DELIVERED не сразу.

Если в доставленном заказе был невыкуп, статус изменится только после получения заказа на складе Маркета.

6 апреля

Методы или страницы документации	Описание изменений
POST v2/reports/goods-realization/generate	Отчет по реализации стал доступен и для модели DBS.

4 апреля

Методы или страницы документации	Описание изменений
POST v2/category/{categoryId}/parameters	Изменили лимит на количество категорий — 100 категорий в минуту.
POST v2/categories/max-sale-quantum	Изменили лимит на количество запросов — 5 000 запросов в час.
POST v2/businesses/{businessId}/offer-cards/update POST v2/campaigns/{campaignId}/hidden-offers POST v2/campaigns/{campaignId}/hidden-offers/delete	Изменили лимиты на количество товаров — 10 000 товаров в минуту.
GET v2/campaigns/{campaignId}/hidden-offers	Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 500 товаров в одном запросе.
Обработка FBS-заказов	Рассказали, что с помощью метода GET v2/campaigns/{campaignId}/shipments/reception-transfer-act вы можете не только подтвердить отгрузку, но и подписать и получить электронный акт приема-передачи.
PUT v2/campaigns/{campaignId}/offers/stocks Передача остатков через API	Рассказали, как передавать остатки для группы складов — только для одного любого склада. Информация для остальных складов в этой группе обновится автоматически.
POST v2/reports/united-marketplace-services/generate	Изменили название колонки *Уменьшение (скидка) и увеличение стоимости услуги/Вызовы и награды/Скидка (гр.37=гр.35гр.36)/37*. Теперь она называется Уменьшение (скидка) и увеличение стоимости услуги/Вызовы и награды/Скидка с учётом минимального тарифа (гр.37=гр.35гр.36)/37.

3 апреля

Методы или страницы документации

Описание изменений

Добавили страницу о том, как настроить интеграцию для работы с уведомлениями на Node.js Express.

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

Добавили статусы товара в ответе:

RENEWED — успешно перенесен из предыдущей акции «Бестселлеры Маркета»;
RENEW_FAILED — не получилось перенести из предыдущей акции «Бестселлеры Маркета».

2 апреля

Методы или страницы документации	Описание изменений
—	Опубликовали спецификацию OpenAPI API-уведомлений. Она доступна на GitHub.

1 апреля

Методы или страницы документации	Описание изменений
Пошаговые инструкции и методы, где передаются или возвращаются коды маркировки в системе «Честный ЗНАК».	Рассказали, что маркировка товаров в системе «Честный ЗНАК» теперь необязательна для заказов от физических лиц. Для заказов от бизнеса все еще нужно передавать коды маркировки.

31 марта

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/warehouses — возвращает список складов и информацию о них; POST v2/campaigns/{campaignId}/warehouse/status — отключает или включает склад.	Добавили методы работы со складами.
POST v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers POST v2/campaigns/{campaignId}/offer-prices/updates POST v2/campaigns/{campaignId}/offer-prices	Удалили идентификатор НДС 12%. Уточнили, что для продавцов Market Yandex Go недоступна передача и получение НДС.
POST notification	Добавили параметр `updatedAt` — дата и время изменения статуса невыкупа или возврата.
GET v2/businesses/{businessId}/warehouses	Отметили метод устаревшим. Вместо него используйте POST v2/businesses/{businessId}/warehouses.

28 марта

Методы или страницы документации	Описание изменений
Как работать с уведомлениями	Уточнили диапазоны IP-адресов, которые использует Маркет.

27 марта

Методы или страницы документации

Описание изменений

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

POST v2/reports/goods-feedback/generate

Отметили недоступными для продавцов Market Yandex Go.

25 марта

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/goods-feedback/comments	В ответе добавили параметр `feedbackId` — идентификатор отзыва.
Типы ошибок и что с ними делать	Добавили описание ошибки Business is in migration — в кабинете происходят миграции магазинов.

20 марта

Методы или страницы документации	Описание изменений
Как работать с API Маркета продавцам Market Yandex Go	Добавили страницу о том, как работать с API Маркета продавцам Market Yandex Go.
POST v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers POST v2/campaigns/{campaignId}/offers/delete POST v2/campaigns/{campaignId}/price-quarantine POST v2/campaigns/{campaignId}/price-quarantine/confirm	Изменили лимиты на количество товаров — 10 000 товаров в минуту.
POST v2/businesses/{businessId}/offer-mappings/update	Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 100 товаров в одном запросе. Удалили тип товарного кода `PACK_CODE`.
POST v2/businesses/{businessId}/offer-mappings/delete POST v2/businesses/{businessId}/offer-mappings/archive POST v2/businesses/{businessId}/offer-mappings/unarchive POST v2/businesses/{businessId}/price-quarantine/confirm	Изменили лимиты на количество товаров — 10 000 товаров в минуту, не более 200 товаров в одном запросе.
POST v2/businesses/{businessId}/price-quarantine	Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 500 товаров в одном запросе.

18 марта

Методы или страницы документации	Описание изменений
POST notification	Добавили типы уведомлений: создание заявки на отмену заказа; изменение статуса невыкупа или возврата.
GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels POST v2/reports/documents/labels/generate	Добавили примеры ярлыков для продавцов Market Yandex Go.
POST v2/businesses/{businessId}/offer-mappings/update	Рассказали, как передавать название и описание товара для продавцов Market Yandex Go.

17 марта

Методы или страницы документации

Описание изменений

Как изменяются статусы заказов

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

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

POST notification

Добавили описание подстатуса PICKUP_EXPIRED — закончился срок хранения заказа в ПВЗ.

14 марта

Методы или страницы документации	Описание изменений
Как изменяются статусы заказов	Рассказали, как изменяются статусы DBS-заказов.
POST v2/reports/united-returns/generate	Добавили отчет по невыкупам и возвратам.
Рекомендации Маркета по карточкам	Вынесли в отдельную инструкцию информацию, как пользоваться рекомендациями Маркета.
Добавление и редактирование товаров	Рассказали, как: изменить категории товаров; изменить характеристики товаров; удалить характеристики товаров; объединить товары на карточке.
Документация API Маркета для продавцов.	Методы работы с карточками товаров теперь находятся в разделе Товары.

13 марта

Методы или страницы документации	Описание изменений
POST v2/reports/shelf-statistics/generate	Изменили название колонки Фактические расходы, ₽. Теперь она называется Фактические расходы (с НДС), ₽.

12 марта

Методы или страницы документации	Описание изменений
Типы ошибок и что с ними делать	Уточнили, что код `403` приходит не только, когда не сработал токен, но может означать и другую ошибку доступа. Добавили описание ошибок: Contact not found for login 'login' and campaignId 'campaignId' — не найдена учетная запись пользователя, логин которой передан для подписи электронного акта приема-передачи; Contacts with available roles for signing not found for login 'login' — учетная запись пользователя, логин которой передан для подписи электронного акта приема-передачи, не обладает необходимыми доступами.
POST notification	Рассказали, что Маркет может отправлять несколько уведомлений по одному и тому же событию. В некоторых случаях это нормальное поведение. Актуальным считайте более позднее время события.
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Уточнили, что параметр `refundStatus` актуален только для возвратов (`returnType=RETURN`).

11 марта

Методы или страницы документации

Описание изменений

Методы работы с кодами маркировки товаров.

Уточнили, что для продавцов Market Yandex Go параметры cis и hasCis актуальны и для системы «ASL BELGISI».

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

Уточнили описание параметров:

supplierShipmentDateTo равен supplierShipmentDateFrom + сутки, если промежуток времени между ними меньше суток;
toDate равен fromDate + сутки, если промежуток времени между ними меньше суток.

10 марта

Методы или страницы документации

Описание изменений

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

Добавили параметр signatory — логин пользователя в Яндекс ID, от имени которого будет подписываться электронный акт приема-передачи.

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

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

В ответе добавили параметр signature — информация о подписи акта приема-передачи.

7 марта

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Добавили параметры: `amount` — сумма возврата; `partnerCompensationAmount` — компенсация за обратную доставку. Отметили устаревшими параметры `refundAmount` и `partnerCompensation`. Вместо них используйте `amount` и `partnerCompensationAmount`.
POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-cards/update	Рассказали, что с помощью POST v2/category/{categoryId}/parameters можно проверить, какие категорийные характеристики доступны для заданной категории, и получить их настройки.
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Уточнили, что в ответе параметр `fastReturn` приходит только для возвратов (`returnType=RETURN`).

6 марта

Методы или страницы документации	Описание изменений
Как подписывать интеграции	Рассказали, как подписывать интеграции.

5 марта

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders POST v2/campaigns/{campaignId}/stats/skus	Добавили параметр `currency` — валюта, в которой указано значение тарифа.
POST v2/reports/united-orders/generate	Удалили колонки COUNT (Информация о заказах/Количество) и TRANSFERRED_FOR_DELIVERY (Информация о заказах/Передано в доставку).
POST v2/reports/united-orders/generate	Добавили колонки: TRANSFERRED_FOR_DELIVERY (Информация о заказах/Передано в доставку); DELIVERED_OR_RETURNED (Информация о заказах/Доставлено или возвращено); DELIVERY_DATE (Информация о заказах/Дата доставки заказа).

3 марта

Методы или страницы документации	Описание изменений
`GET v2/campaigns/{campaignId}/logins` `GET v2/campaigns/by_login/{login}`	Удалили устаревшие методы.

1 марта

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/promos/offers	Уточнили, что условия участия в акциях могут меняться, кроме параметров `price` и `promoPrice`.

27 февраля

Методы или страницы документации	Описание изменений
Обработка Экспресс-заказов	Добавили пошаговую инструкцию по обработке Экспресс-заказов.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Уточнили, что значение `MERCHANT_TO_COURIER` в параметре `eacType` временно не возвращается.
POST v2/reports/prices/generate	Уточнили, что информация возвращается только по 50 000 товаров. Если у вас их больше, используйте фильтры.
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Добавили значение `UNKNOWN` (неизвестный статус) в параметре `shipmentStatus`.

26 февраля

Методы или страницы документации	Описание изменений
POST v2/reports/goods-realization/generate	Удалили колонку ORDER_STATUS (Заказы/Статус заказа).

20 февраля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers	Отметили устаревшим параметр `available`. Вместо него используйте методы скрытия товаров с витрины: GET v2/campaigns/{campaignId}/hidden-offers POST v2/campaigns/{campaignId}/hidden-offers POST v2/campaigns/{campaignId}/hidden-offers/delete

19 февраля

Методы или страницы документации

Описание изменений

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

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

Добавили причины отмены заказа (параметр substatus):

TOO_MANY_DELIVERY_DATE_CHANGES — заказ переносили слишком много раз;
DELIVERY_DATE_CHANGED_TOO_MUCH — заказ перенесен на слишком много дней.

18 февраля

Методы или страницы документации	Описание изменений
Методы получения отчетов.	Рассказали, что структура и содержание отчетов могут изменяться без предварительного уведомления. Это связано с внутренними процессами Маркета.

13 февраля

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Отметили устаревшим параметр `details`.

12 февраля

Методы или страницы документации	Описание изменений
Отчеты, которые можно выгрузить в формате `FILE` или `CSV`.	Добавили формат — `JSON`. В пояснениях к колонкам появился блок Название колонки в JSON.

11 февраля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/skus	Удалили значение `DELIVERY_TO_CUSTOMER_RETURN` в параметре `TariffType`.

10 февраля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/suggestions	Отметили метод устаревшим.

7 февраля

Методы или страницы документации	Описание изменений
API Яндекс Маркета для продавцов	Рассказали о подключении API-уведомлений.
Формат данных запроса и ответа	Добавили страницу Формат данных API-уведомлений.
Сообщения об ошибках	Добавили описание ошибок: CANT_GET_RESPONSE (UNSUPPORTED_MEDIA_TYPE) — в заголовке ответа магазина указан формат данных, отличный от `application/json`; INVALID_RESPONSE (INVALID_DATA) — в теле ответа магазина переданы некорректные данные или их недостаточно.
POST v2/businesses/{businessId}/offer-mappings/update	Рассказали, как удалить переданные ранее параметры товара — в `deleteParameters` указать значения параметров, которые хотите удалить. Добавили описание ошибки Offer at index… cannot have parameter… deleted and set at the same time — можно передать либо значение параметра в `deleteParameters`, либо соответствующий параметр в `UpdateOfferDTO`.
POST v2/category/{categoryId}/parameters	Уточнили описание метода — возвращает список характеристик с допустимыми значениями для заданной листовой категории — той, у которой нет дочерних категорий.

5 февраля

Методы или страницы документации	Описание изменений
`GET v2/campaigns/{campaignId}/offers`	Изменили лимит на количество товаров — 100 товаров в час.

4 февраля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/promos/offers	Добавили параметр `statuses` — фильтр для товаров, которые могут участвовать в акции. Отметили устаревшим параметр `statusType`. Вместо него используйте `statuses`.
POST v2/businesses/{businessId}/promos	В ответе добавили параметр `renewalEnabled` — включен ли автоматический перенос ассортимента между акциями «Бестселлеры Маркета».
POST v2/businesses/{businessId}/offer-cards	Уточнили описание параметра `contentRating` — рейтинг карточки. Добавили параметры в ответе: `averageContentRating` — средний рейтинг карточки у товаров той категории, которая указана в `marketCategoryId`; `contentRatingStatus` — статус вычисления рейтинга карточки и рекомендаций; `remainingRatingPoints` — максимальное количество баллов рейтинга карточки, которые можно получить за выполнение рекомендаций.
POST v2/businesses/{businessId}/offer-cards POST v2/category/{categoryId}/parameters	Уточнили описание рекомендации `VIDEO_COUNT` — добавьте хотя бы одно видео.
GET v2/campaigns/{campaignId}/outlets/licenses	Добавили описание статусов проверки лицензии: `REVOKE` — лицензия отозвана службой качества; `DONT_WANT` — не проверяется; `FAIL_MANUAL` — лицензия не прошла проверку службы качества.
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	В детали причин возврата добавили описание значения `UNKNOWN` — детали причины не указаны. В решение по возврату добавили описание значения `UNKNOWN` — не указано. Удалили тип логистической точки `UNKNOWN`.
POST v2/campaigns/{campaignId}/stats/orders	В тип товара добавили описание значения `EXPIRED` — товар с истекшим сроком годности. Удалили типы товара: `FREEZE` `AVAILABLE` `QUARANTINE` `UTILIZATION` В тип оплаты заказа добавили значение `UNKNOWN` — неизвестный тип оплаты. Удалили типы оплаты: `CREDIT` `TINKOFF_CREDIT`

3 февраля

Методы или страницы документации	Описание изменений
`GET campaigns/{campaignId}/feedback/updates`	Удалили устаревший метод.

31 января

Методы или страницы документации

Описание изменений

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

На листе Поставка через транзитный склад добавили колонки:

SERVICES_COLUMN_MANY_WAREHOUSES_SUPPLY (Информация об услуге/Поставка для нескольких складов);
SERVICES_COLUMN_VDC_DIRECTIONS_COUNT (Информация об услуге/Количество доехавших направлений в поставке).

30 января

Методы или страницы документации	Описание изменений
POST notification	Уточнили, что разрешенное количество символов в параметрах `name` (название интеграции) и `version` (версия интеграции) — от 1 до 100.

29 января

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders	Уточнили, что параметр `payments` может вернуться пустым, если нет данных о денежных переводах. Удалили значение `UNKNOWN` в параметре `type`.
POST v2/businesses/{businessId}/offer-mappings/archive	В параметре `error` добавили описание значения `UNKNOWN` — неизвестная причина ошибки.
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Добавили описание статусов передачи возврата: `EXPIRED` — покупатель не принес товар на возврат вовремя; `NOT_IN_DEMAND` — возврат не забрали с почты; `READY_FOR_EXPROPRIATION` — товары в возврате направлены на перепродажу; `RECEIVED_FOR_EXPROPRIATION` — товары в возврате приняты для перепродажи. Добавили описание логистических статусов конкретных товаров: `CREATED` — возврат создан; `RECEIVED` — возврат принят у отправителя; `IN_TRANSIT` — возврат в пути; `READY_FOR_PICKUP` — возврат готов к выдаче магазину; `PICKED` — возврат выдан магазину; `RECEIVED_ON_FULFILLMENT` — возврат принят на складе Маркета; `CANCELLED` — возврат отменен; `LOST` — возврат утерян; `UTILIZED` — возврат утилизирован; `PREPARED_FOR_UTILIZATION` — возврат готов к утилизации; `EXPROPRIATED` — товары в возврате направлены на перепродажу; `NOT_IN_DEMAND` — возврат не забрали с почты.

28 января

Методы или страницы документации	Описание изменений
Типы ошибок и что с ними делать	Изменили описание ошибки Token is invalid на OAuth token is invalid. Добавили описание ошибки OAuth token is invalid (account has been globally logged out) — пользователь воспользовался функцией Выйти везде в Яндекс ID.
Создание и использование OAuth-токена	Уточнили случаи, когда токен нужно получать снова.
POST v2/reports/united-netting/generate	На листе Отчёт о платежах добавили колонку BONUS_ACCOUNT_YEAR_MONTH (Информация о платежах/Расчётный период премии за участие в совместных акциях).
POST v2/reports/united-marketplace-services/generate	Изменили название листа Пуши. Теперь он называется Пуш-уведомления.

27 января

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	Добавили описание значения `DEFAULT` — передайте его в параметре `type` для товара, у которого установлен особый тип и вы хотите его убрать.
POST v2/businesses/{businessId}/offer-cards POST v2/category/{categoryId}/parameters	Добавили рекомендацию по заполнению параметра `FIRST_VIDEO_SIZE` — замените первое видео на видео высокого качества.
PUT v2/campaigns/{campaignId}/orders/{orderId}/items	Добавили описание причин, почему обновился состав заказа: `PARTNER_REQUESTED_REMOVE` — магазин удалил товар; `USER_REQUESTED_REMOVE` — покупатель попросил удалить товар.

24 января

Методы или страницы документации

Описание изменений

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

Уточнили описание параметров:

updateFrom и updateTo — начальная или конечная дата периода, за который были изменения в заказе. Например, статуса или информации о платежах.
items — информация о доставке заказа добавляется отдельным элементом в массиве items — параметр offerName со значением Доставка.

22 января

Методы или страницы документации	Описание изменений
Как работать с уведомлениями Сообщения об ошибках Получение уведомлений	Добавили API-уведомления — подключите их и Маркет будет отправлять вам информацию о событиях: создание заказа; отмена заказа; изменение статуса заказа; создание невыкупа или возврата.
Тестовые заказы	Уточнили, что если у вас подключены API-уведомления, то Маркет будет отправлять вам запрос POST notification с информацией о событии также и по тестовым заказам.
POST v2/reports/united-orders/generate POST v2/reports/goods-realization/generate	В названиях колонок в XLSX уточнили, что информация указывается в штуках.

21 января

Методы или страницы документации	Описание изменений
Все методы.	Указали модели размещения, для которых доступен метод.

20 января

Методы или страницы документации	Описание изменений
PUT v2/campaigns/{campaignId}/orders/{orderId}/verifyEac	Отметили обязательным параметр `code` — код для подтверждения ЭАПП.
PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes	Уточнили описание кода ошибки `400`. Из тела запроса удалили параметр `id`.
POST v2/reports/united-marketplace-services/generate	Добавили пояснение к колонкам на листе Пуши.
POST v2/businesses/{businessId}/bids/recommendations	Отметили устаревшим параметр `priceRecommendations`.

17 января

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels POST v2/reports/documents/labels/generate	Добавили пример ярлыка формата `A9_HORIZONTALLY` и уточнили описание значения `A4`.
Методы, в ответе которых возвращается параметр `status`.	Добавили описание возможных значений параметра `status`.
GET v2/campaigns/{campaignId}/offer-mapping-entries	Добавили описание возможных значений параметра `mapping_kind`.
GET v2/campaigns/{campaignId}/outlets/licenses POST v2/campaigns/{campaignId}/outlets/licenses	В параметре `LicenseType` добавили описание значения `UNKNOWN` — неизвестный тип лицензии.
`GET v2/campaigns/{campaignId}/feeds/{feedId}/index-logs`	Удалили значение `NOT_INDEXED` в параметре `FeedIndexLogsErrorType`.

14 января

Методы или страницы документации	Описание изменений
Все методы, где передается или возвращается `offset`.	Удалили устаревший параметр `offset`.

10 января

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update	Уточнили принцип работы параметра `onlyPartnerMediaContent` — при передаче значения `true` из товаров удаляются данные, которые добавил Маркет.

2024

27 декабря

Методы или страницы документации	Описание изменений
`GET v2/campaigns/{campaignId}/logins` `GET v2/campaigns/by_login/{login}`	Отметили методы устаревшими.

26 декабря

Методы или страницы документации	Описание изменений
Обработка заказов от юридических лиц	Рассказали, как определить, что заказ пришел от юридического лица.

24 декабря

Методы или страницы документации

Описание изменений

Описали решения по товару в возврате:

REFUND_MONEY — вернуть деньги за товар;
REFUND_MONEY_INCLUDING_SHIPMENT — вернуть деньги за товар и обратную пересылку;
REPAIR — магазин устранит недостатки товара;
REPLACE — магазин заменит товар;
SEND_TO_EXAMINATION — магазин отправит товар на экспертизу;
DECLINE_REFUND — не возвращать деньги;
OTHER_DECISION — другое решение.

20 декабря

Методы или страницы документации	Описание изменений
Сравнение методов по моделям	Добавили таблицы, где можно посмотреть, для каких моделей работы доступен метод.

17 декабря

Методы или страницы документации	Описание изменений
GET v2/models/{modelId} POST v2/models	Изменили лимиты на количество моделей — 100 000 моделей в час.
GET v2/models/{modelId}/offers POST v2/models/offers	Изменили лимиты на количество предложений — 100 000 предложений в час.
POST v2/campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods	Уточнили, что ответ `200` не значит, что ключи переданы покупателю. Если письмо с ключами удалось доставить, Маркет переведет заказ в финальный статус `DELIVERED`.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Отметили устаревшим параметр `id` в `delivery`.

16 декабря

Методы или страницы документации	Описание изменений
Инструкции и методы работы с push-схемой.	Удалили страницы. Не рекомендуем настраивать новые интеграции с push-компонентом.
Тестовые заказы	Добавили инструкцию, как работать с тестовыми заказами.
GET v2/campaigns/{campaignId}/orders/{orderId}/buyer	Добавили параметр `trusted` — проверенный покупатель. Если параметр вернулся со значением `true`, Маркет уже проверил покупателя — не звоните ему. Обработайте заказ как обычно и передайте его курьеру или отвезите в ПВЗ.

13 декабря

Методы или страницы документации

Описание изменений

POST v2/reports/prices/generate

Уточнили, что данные в этом отчете постоянно обновляются, поэтому информация в нем и в кабинете продавца на Маркете на странице Цены может отличаться.

Пагинация в запросах к API Яндекс Маркета для продавцов

Рассказали, что в некоторых методах доступны оба вида пагинации — с идентификатором страницы (page_token) и с ее номером (page).

В таких случаях используйте идентификатор страницы.

12 декабря

Методы или страницы документации

Описание изменений

Как изменить цены на товары

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

Уточнили, что метод POST v2/campaigns/{campaignId}/offer-prices/updates доступен, только если в кабинете продавца на Маркете есть возможность установить уникальные цены в отдельных магазинах.

Как это проверить — в методе POST v2/businesses/{businessId}/settings в параметре onlyDefaultPrice возвращается значение false.

10 декабря

Методы или страницы документации	Описание изменений
Методы, где передается или возвращается параметр `vat`.	Добавили НДС 5% и 7% — значения `VAT_05` и `VAT_07` в параметре `vat`. Они будут применяться для упрощенной системы налогообложения (УСН) с 2025 года.

9 декабря

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	Добавили параметр `firstVideoAsCover` — возможность использовать первое видео в карточке как видеообложку.

3 декабря

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels POST v2/reports/documents/labels/generate	Добавили формат размещения ярлыков на странице — `A9_HORIZONTALLY`. Он доступен только для продавцов из России.

2 декабря

Методы или страницы документации

Описание изменений

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

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

Уточнили, что в параметре language по умолчанию выбран русский язык — RU.

Методы работы с заказами.

Стали обязательными параметры:

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

29 ноября

Методы или страницы документации	Описание изменений
Обработка заказов и учёт товаров Просмотр информации о заказах Управление ценами Просмотр цен Управление товарами и карточками Просмотр товаров и карточек Продвижение товаров Просмотр информации о продвижении товаров Просмотр финансовой информации и отчётности Общение с покупателями Настройка магазинов	Добавили страницы с перечислением всех доступных методов для определенного доступа.
POST v2/businesses/{businessId}/offer-mappings	Добавили информацию о медиафайле товара — `OfferMediaFileDTO` в `uploadState`.
POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	Добавили параметры: `commodityCodes` (товарные коды) и его типы `CommodityCodeType`: `CUSTOMS_COMMODITY_CODE` — код товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД); `IKPU_CODE` — идентификационный код продукции и услуг (ИКПУ) в Узбекистане; `PACK_CODE` — код упаковки для ИКПУ. `language` — язык, на котором принимаются и возвращаются значения в параметрах `name` и `description`. Отметили устаревшим параметр `customsCommodityCode`. Вместо него используйте `commodityCodes` с типом `CUSTOMS_COMMODITY_CODE`.
POST v2/businesses/{businessId}/offer-mappings/update	Добавили тип ошибки и предупреждения `INVALID_COMMODITY_CODE` — передан некорректный товарный код.
Методы, где передается или возвращается параметр `vat`.	Добавили НДС 12%, который используется только в Узбекистане, — идентификатор `9` и значение `VAT_12` в параметре `vat`.
GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels/data	Отметили устаревшим параметр `url`.

28 ноября

Методы или страницы документации

Описание изменений

Методы, где передается или возвращается SKU.

Рассказали, что SKU можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Добавили возможность изменить категорию товара на Маркете. Для этого передайте идентификатор новой категории в параметре marketCategoryId или categoryId.

Также уточнили, что при изменении категории значения общих характеристик для старой и новой категории сохранятся, передавать их не нужно.

Отметили устаревшим параметр category. Вместо него используйте marketCategoryId.

26 ноября

Методы или страницы документации	Описание изменений
Все методы.	Для продавцов, которые используют API-Key-токены: добавили список доступов, один из которых необходим для вызова этого метода.
POST v2/businesses/{businessId}/goods-feedback	Параметр `orderId` (идентификатор заказа на Маркете) стал необязательным.

25 ноября

Методы или страницы документации

Описание изменений

Как изменить цены на товары

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

Рассказали, что передавать НДС нужно с помощью параметра vat в методе POST v2/campaigns/{campaignId}/offers/update.

POST v2/reports/united-orders/generate

POST v2/reports/united-netting/generate

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

Добавили параметр language — язык отчета.

22 ноября

Методы или страницы документации

Описание изменений

Типы ошибок и что с ними делать

Описали ошибки с кодом 401:

Api-Key token format invalid — неправильный формат API-Key-токена;
Api-Key token length invalid — неправильная длина Api-Key-токена;
Api-Key token prefix invalid — неправильный префикс API-Key-токена.

Отчеты, которые можно выгрузить в формате FILE или CSV.

Добавили названия колонок, которые есть в отчете.

20 ноября

Методы или страницы документации

Описание изменений

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

Упростили процесс массовой передачи цифровых кодов: каждый товар с уникальным id нужно передавать в виде отдельного элемента в массиве items, а ключи товара — в массиве codes.

Отметили устаревшим параметр code. Вместо него используйте codes.

19 ноября

Методы или страницы документации

Описание изменений

POST v2/campaigns/{campaignId}/offers/stocks

Рассказали, что для модели FBY информация об остатках может возвращаться с нескольких складов Маркета, у которых будут разные warehouseId.

Идентификаторы складов Маркета

18 ноября

Методы или страницы документации

Описание изменений

POST v2/businesses/{businessId}/bids/recommendations

Добавили описание ошибок с кодом 400:

datediff-is-to-big-local — при доставке по своему региону разница между максимальным и минимальным сроком доставки не должна превышать двух дней;
datediff-is-to-big-remote — при доставке в другие регионы разница между максимальным и минимальным сроком доставки не должна превышать четырех дней;
datediff-is-to-big-long-period — при доставке в другие регионы, где минимальный срок доставки больше 18 дней, разница между максимальным и минимальным сроком доставки не должна превышать минимальный срок.

15 ноября

Методы или страницы документации

Описание изменений

Добавили параметр benefits — список доступных субсидий.

POST v2/businesses/{businessId}/bids/recommendations

Добавили типы дополнительных инструментов продвижения:

BESTS — участие в акции «Бестселлеры Маркета»;
SPLIT_0_0_4 — возможность оплаты со Сплитом сроком на 4 месяца;
SPLIT_0_0_6 — возможность оплаты со Сплитом сроком на 6 месяцев;
SPLIT_0_0_12 — возможность оплаты со Сплитом сроком на 12 месяцев;
MARKET_SUBSIDY_1_4 — скидка от Маркета от 1 до 4%;
MARKET_SUBSIDY_5_9 — скидка от Маркета от 5 до 9%;
MARKET_SUBSIDY_10 — скидка от Маркета от 10%.

14 ноября

Методы или страницы документации

Описание изменений

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

Рассказали, что процент выполнения указывается для некоторых рекомендаций:

PICTURE_COUNT
VIDEO_COUNT
MAIN
ADDITIONAL
DISTINCTIVE

13 ноября

Методы или страницы документации

Описание изменений

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

Рассказали, что, если хотя бы по одному товару есть ошибка, информация в каталоге не обновится по всем переданным товарам.

8 ноября

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels POST v2/reports/documents/labels/generate.	Добавили формат размещения ярлыков на странице — `A9`. Его дизайн отличается от других форматов, а также он доступен только для продавцов из России.

6 ноября

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/returns

Добавили параметр subsidies — начисление баллов, которые используются для уменьшения стоимости размещения, и их списание в случае невыкупа или возврата.

Отметили устаревшими cпособы денежного перевода CASHBACK, MARKETPLACE и SPLIT.

2 ноября

Методы или страницы документации	Описание изменений
Методы, где передается или возвращается SKU.	Уточнили, что SKU товара не может состоять только из пробелов и символов табуляции.

1 ноября

Методы или страницы документации	Описание изменений
—	Название характеристики товара Цвет изменилось на Цвет для фильтра.

18 октября

Методы или страницы документации

Описание изменений

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

Рассказали, что параметров logisticPickupPoint, shipmentRecipientType и shipmentStatus может не быть в ответе в случае возврата:

С опцией Быстрый возврат денег за дешевый брак, когда товар остается у покупателя (fastReturn=true).
По заказу от бизнеса, если:
- статус возврата STARTED_BY_USER или WAITING_FOR_DECISION;
- возврат отменен до передачи товара.

17 октября

Методы или страницы документации	Описание изменений
Пагинация в запросах к API Яндекс Маркета для продавцов	Рассказали о пагинации в запросах.
Лог запросов	Рассказали о процессе работы с логами запросов и об уникальном идентификаторе запроса, который поможет быстрее найти логи и пригодится при обращении в поддержку.
POST v2/campaigns/{campaignId}/stats/orders	Рассказали, что информация по созданным и обновленным заказам может появляться с задержкой до 40 минут.

16 октября

Методы или страницы документации	Описание изменений
`POST cart`	Рассказали, что если в параметре `outlets` указать несуществующие идентификаторы пунктов самовывоза, то опция доставки проигнорируется и ее идентификатор не придет в методе `POST order/accept`.

15 октября

Методы или страницы документации

Описание изменений

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

POST v2/reports/documents/labels/generate

Добавили тип товара ALCOHOL — алкоголь.

14 октября

Методы или страницы документации

Описание изменений

Изменили лимиты на количество запросов — 100 000 запросов в час.

11 октября

Методы или страницы документации	Описание изменений
POST v2/reports/united-netting/generate POST v2/reports/united-marketplace-services/generate	Изменили максимальный период для параметров `dateTimeTo` и `dateTo`. Теперь он составляет 3 месяца.
POST v2/businesses/{businessId}/offer-mappings/update	Добавили тип ошибок LOCKED_DIMENSIONS — переданы габариты упаковки, которые нельзя изменить.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status `POST order/accept` `POST order/status` `POST order/cancellation/notify`	Удалили способы отгрузки `MARKET_PARTNER_OUTLET` и `DROPOFF`.

10 октября

Методы или страницы документации

Описание изменений

Добавили параметр sortingType (тип сортировки ярлыков в файле) и его значения:

SORT_BY_GIVEN_ORDER — ярлыки заказов будут расположены в том же порядке, в каком были переданы идентификаторы заказов в запросе;
SORT_BY_ORDER_CREATED_AT — ярлыки будут расположены в соответствии с датой создания заказа с группировкой по магазинам.

9 октября

Методы или страницы документации

Описание изменений

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

Добавили вид маркировки товара CIS_OPTIONAL — идентификатор единицы товара в системе «Честный ЗНАК», который необязателен для заполнения, но в ближайшее время потребуется его передача.

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

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

Добавили тип ошибок INVALID_CATEGORY — указана нелистовая категория.

8 октября

Методы или страницы документации	Описание изменений
Авторизация	Добавили API-Key-токен и рассказали, как с помощью него настроить доступ только к определенным группам методов. Описали, чем различаются способы авторизации.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders	Для параметра `tags` (признаки товара) добавили значения: `ULTIMA` — премиум-товар; `SAFE_TAG` — товар с защитной меткой; `TURBO` — товар, который быстро раскупают.
GET v2/campaigns/{campaignId}/orders	Добавили фильтрацию заказов по дате оформления — параметры `fromDate` и `toDate`.
GET v2/campaigns/{campaignId}/returns	Каждому невыкупу стали присваивать свой идентификатор.

19 сентября

Методы или страницы документации

Описание изменений

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

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

Добавили описание ошибки Promo has ended — акция закончилась.

4 сентября

Методы или страницы документации	Описание изменений
POST v2/reports/goods-turnover/generate	Добавили параметр `date` — дата, за которую нужно рассчитать оборачиваемость.

29 августа

Методы или страницы документации

Описание изменений

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

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

Параметр value в parameterValues стал необязательным.

Рассказали, что нужно передавать:

пустое значение, чтобы удалить характеристики, которые заданы в параметрах с типом string;
только те характеристики, значение которых хотите обновить;
parameterId с пустым value, чтобы удалить значение заданной характеристики.

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

Добавили параметр onlyPartnerMediaContent — будут использоваться только переданные вами изображения товаров.

Если вы указали значение true и у товара были изображения от Маркета, они удалятся.

26 августа

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders	Добавили параметры `page_token` и `limit` для навигации по страницам результатов.
POST v2/businesses/{businessId}/offer-cards POST v2/category/{categoryId}/parameters	Рассказали, что рекомендации по дополнению или замене контента не возвращаются для карточек, которые заполнены Маркетом или содержат бывшие в употреблении товары.
POST v2/businesses/{businessId}/offer-cards POST v2/category/{categoryId}/parameters	Отметили устаревшими рекомендации `HAS_VIDEO`, `FILTERABLE`, `HAS_DESCRIPTION` и `HAS_BARCODE`.

21 августа

Методы или страницы документации	Описание изменений
`GET v2/campaigns/{campaignId}/feeds/{feedId}/categories` `GET v2/campaigns/{campaignId}/feeds/categories`	Удалили устаревшие методы.

16 августа

Методы или страницы документации

Описание изменений

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

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

Добавили параметр cancelledOrders — возвращать ли отмененные заказы.

15 августа

Методы или страницы документации	Описание изменений
`GET campaigns/{campaignId}/feedback/updates`	Отметили метод устаревшим.

13 августа

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update	Добавили тип ошибки `INVALID_PICKER_URL` — передана ссылка на изображение для миниатюры, которой нет в переданных ссылках на изображение товара.
PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Добавили параметр `updatedAt` — дата и время последнего обновления заказа.
PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Рассказали, как найти заказы, в которых Маркет перенес дату отгрузки.

12 августа

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/promos — показывает информацию об акциях Маркета; POST v2/businesses/{businessId}/promos/offers — показывает список товаров, которые участвуют или могут участвовать в акции; POST v2/businesses/{businessId}/promos/offers/update — добавляет товары в акцию или изменяет их цены; POST v2/businesses/{businessId}/promos/offers/delete — удаляет товары из акции.	Добавили методы работы с акциями.
Управление акциями	Рассказали, как управлять акциями.
POST v2/reports/united-orders/generate	Добавили параметр `promoId` — идентификатор акции, товары из которой нужны в отчете.

9 августа

Методы или страницы документации

Описание изменений

Документация API Маркета для продавцов.

Обновили меню.

Добавление и редактирование товаров

Управление товарами в архиве

Как изменить цены на товары

Разделили пошаговую инструкцию «Управление каталогом».

8 августа

Методы или страницы документации

Описание изменений

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

Удалили тип цены MAX_DISCOUNT_BASE, MARKET_OUTLIER_PRICE и MAX_DISCOUNT_PRICE

Отметили метод устаревшим. Вместо него используйте POST v2/reports/goods-prices/generate.

5 августа

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update	Рассказали в описание метода, что параметр `offerId` должен быть уникальным для всех товаров, которые вы передаете.
`GET v2/campaigns/{campaignId}/region`	Отметили метод устаревшим. Вместо него используйте GET v2/campaigns/{campaignId}/settings.

2 августа

Методы или страницы документации

Описание изменений

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

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

Добавили способ оплаты заказа BOUND_CARD_ON_DELIVERY — привязанной картой при получении.

Удалили устаревшие параметры id и shopSku.

31 июля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/orders/{orderId}/business-buyer POST v2/campaigns/{campaignId}/orders/{orderId}/documents	Методы стали доступны и для модели DBS.
POST v2/businesses/{businessId}/offer-mappings	Добавили статус товара в магазине `ARCHIVED` — в архиве.

30 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/goods-feedback — показывает все отзывы о товарах продавца; POST v2/businesses/{businessId}/goods-feedback/comments — показывает все комментарии к отзыву; POST v2/businesses/{businessId}/goods-feedback/comments/update — добавляет комментарий магазина или изменяет комментарий, который магазин оставлял ранее; POST v2/businesses/{businessId}/goods-feedback/skip-reaction — пропускает отзывы; POST v2/businesses/{businessId}/goods-feedback/comments/delete — удаляет комментарий магазина.	Добавили методы работы с отзывами о товарах.
Отзывы о товарах	Рассказали, как работать с отзывами о товарах.
POST v2/reports/goods-feedback/generate	Добавили отчет по отзывам о товарах.

29 июля

Методы или страницы документации

Описание изменений

GET v2/regions/{regionId}/children

GET v2/campaigns/{campaignId}/hidden-offers

GET v2/campaigns

GET v2/models/{modelId}/offers

GET v2/campaigns/by_login/{login}

Указали верхнее ограничение для передачи номера страницы результатов — параметр page.

Теперь нельзя указывать номер страницы больше 10 000.

24 июля

Методы или страницы документации

Описание изменений

Страница Автоматическое обновление OAuth-токена.

Рассказали, что токен может не обновиться, если оставшийся срок его жизни достаточно длительный.

Срок действия OAuth-токена — год. Его нужно обновлять до истечения этого срока. Например, раз в девять месяцев.

19 июля

Методы или страницы документации	Описание изменений
Повысили верхнее значение для минимальной стоимости товара без скидки до 99% — параметр `discountBase`.	POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/updateBusinessPrices/update
POST v2/reports/competitors-position/generate	Добавили новую величину: если в столбце POSITION указано `-1` — значит, в этот день не было заказов с товарами в указанной категории.
POST v2/campaigns/{campaignId}/offer-prices/suggestions	Уточнили, что метод доступен только продавцам, устанавливающим цены в рублях.
POST v2/campaigns/{campaignId}/offers/delete	Дополнили причины, по которым не получается удалить товары: они не найдены или хранятся на складе Маркета.
`POST cart`	Отметили устаревшим параметр `subsidy`.

11 июля

Методы или страницы документации	Описание изменений
`DELETE v2/campaigns/{campaignId}/hidden-offers`	Отметили метод устаревшим. Вместо него используйте POST v2/campaigns/{campaignId}/hidden-offers/delete.

9 июля

Методы или страницы документации

Описание изменений

POST v2/campaigns/{campaignId}/offers/update

Убрали верхнее ограничение для передачи минимального количества единиц товара в заказе — параметр minQuantity.

POST order/accept

POST order/status

POST order/cancellation/notify

Добавили параметр subsidies — список субсидий по типам.

Отметили устаревшим параметр subsidy. Вместо него используйте subsidies.

8 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/ratings/quality — показывает значение индекса качества магазинов и его составляющие; POST v2/campaigns/{campaignId}/ratings/quality/details — возвращает список заказов, которые повлияли на индекс качества магазина.	Добавили методы работы с индексом качества.

5 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/settings	Добавили параметр `currency` — валюта в кабинете продавца на Маркете.
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Отметили устаревшим параметр `buyerTotalBeforeDiscount`.

4 июля

Методы или страницы документации	Описание изменений
PUT v2/campaigns/{campaignId}/first-mile/shipments	Параметры `dateFrom` и `dateTo` стали обязательными.
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/campaigns/{campaignId}/orders/{orderId}/status `POST order/accept` `POST order/status` `POST order/cancellation/notify`	Удалили устаревший параметр `status`.

3 июля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders	Добавили услугу `ILLIQUID_GOODS_SALE` — вознаграждение за продажу невывезенных товаров.
PUT v2/campaigns/{campaignId}/orders/{orderId}/status POST v2/campaigns/{campaignId}/orders/status-update GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId}	Добавили подстатус заказа `TECHNICAL_ERROR` — техническая ошибка на стороне Маркета.
POST v2/businesses/{businessId}/offer-mappings/update	Теперь можно передавать до 30 ссылок на изображения товара.

28 июня

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/shipments/reception-transfer-act	Теперь с помощью метода вы можете подтверждать ближайшую отгрузку заранее, не только в день отгрузки или накануне.

27 июня

Методы или страницы документации	Описание изменений
POST v2/categories/max-sale-quantum	Добавили новый метод. Он возвращает лимит на установку кванта и минимального количества товаров в заказе.

26 июня

Методы или страницы документации	Описание изменений
Типы ошибок и что с ними делать	Описали ошибку Campaign type is not allowed (метод не поддерживает модель работы вашего магазина), которую Маркет может вернуть в ответе на запрос.

24 июня

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Отметили устаревшими параметры `priceBeforeDiscount`, `buyerItemsTotal` и `buyerTotal`.

21 июня

Методы или страницы документации

Описание изменений

GET v2/reports/info/{reportId}

Добавили подстатус генерации отчета RESOURCE_NOT_FOUND — для такого отчета не удалось найти часть сущностей.

Возвращается, если при генерации PDF-файла с ярлыками в методе POST v2/reports/documents/labels/generate не удалось найти часть заказов.

20 июня

Методы или страницы документации	Описание изменений
Методы, где передается или возвращается SKU.	Изменили формат параметра `ShopSku`. Теперь это может быть любая последовательность длиной до 255 знаков.

18 июня

Методы или страницы документации

Описание изменений

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

Разделили тип субсидий на OrderSubsidyType и OrderItemSubsidyType.

13 июня

Методы или страницы документации

Описание изменений

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

Удалили тип субсидии SPASIBO.

11 июня

Методы или страницы документации	Описание изменений
POST v2/reports/documents/labels/generate	Добавили новый метод. Он запускает генерацию PDF-файла с ярлыками для нескольких заказов.

6 июня

Методы или страницы документации	Описание изменений
Обработка заказов с цифровыми товарами	Теперь для работы с цифровыми товарами не нужно настраивать push-компонент API Маркета.

5 июня

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update — при добавлении товаров в каталог передает их цены, категории на Маркете и характеристики, необходимые для этих категорий; POST v2/businesses/{businessId}/offer-mappings — возвращает категории товаров на Маркете и их характеристики; POST v2/businesses/{businessId}/offer-cards — возвращает переданные характеристики товаров.	Обновили работу с категориями Маркета и характеристиками товаров, которые необходимы для этих категорий.
PUT v2/campaigns/{campaignId}/outlets/{outletId} DELETE v2/campaigns/{campaignId}/outlets/{outletId}	Добавили описание ошибки Outlet is disabled for editing by partner — нельзя изменить информацию или удалить точку продажи магазина.
POST v2/businesses/{businessId}/offer-mappings/update POST v2/businesses/{businessId}/offer-mappings	Отметили устаревшим параметр `params`. Вместо него используйте `parameterValues`.

4 июня

Методы или страницы документации	Описание изменений
PUT v2/campaigns/{campaignId}/orders/{orderId}/status GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders	Удалили устаревшие параметры `total`, `subsidyTotal` и `totalWithSubsidy`.

3 июня

Методы или страницы документации

Описание изменений

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

Добавили примеры запросов для передачи информации о распределении товаров.

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

Добавили описание ошибок:

CATEGORY_MISMATCH — указана категория, которая не совпадает с категорией товара;
INVALID_GROUP_ID_LENGTH — в названии превышено допустимое значение символов — 255;
INVALID_GROUP_ID_CHARACTERS — переданы недопустимые символы.

31 мая

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update	Добавили описание ошибки EMPTY_MARKET_CATEGORY — не указана категория Маркета при передаче характеристик категории.

29 мая

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings	Рассказали, как передавать значения одного параметра, если у товара их несколько.
POST v2/businesses/{businessId}/offer-cards	Добавили параметр `parameterValues` — список характеристик с их значениями.
POST v2/businesses/{businessId}/offer-mappings/update	Добавили параметр `basicPrice` — цена товара.

27 мая

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/settings	Добавили новый метод. Он возвращает информацию о настройках кабинета.
GET v2/campaigns/{campaignId}/returns GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}	Добавили параметр `fastReturn` — используется ли опция Быстрый возврат денег за дешевый брак.
PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Рассказали, когда надо передавать параметр `realDeliveryDate`.

24 мая

Методы или страницы документации	Описание изменений
Создание и использование OAuth-токена	Рассказали, что токен нужно будет получать снова, если пользователь, который его создал, выйдет со всех устройств в аккаунте Яндекса.
POST v2/reports/competitors-position/generate	Добавили отчет «Конкурентная позиция».

23 мая

Методы или страницы документации

Описание изменений

GET v2/campaigns/{campaignId}/returns

Добавили типы ошибок:

INVALID_GROUP_ID_LENGTH — в названии превышено допустимое значение символов — 255;
INVALID_GROUP_ID_CHARACTERS — переданы недопустимые символы.

22 мая

Методы или страницы документации

Описание изменений

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

Добавили статус возврата денег COMPLETE_WITHOUT_REFUND — возврат денег не требуется.

21 мая

Методы или страницы документации

Описание изменений

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

Добавили дополнительные тарифы к услуге размещения:

CANCELLED_ORDER_FEE_QI — отмена заказа по вине продавца;
LATE_ORDER_EXECUTION_FEE_QI — несвоевременная отгрузка или доставка.

20 мая

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/orders/{orderId}/business-buyer	Добавили `PROCESSING` к списку статусов заказа, в которых можно получить информацию о покупателе — юридическом лице.

17 мая

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offer-prices/updates	Удалили устаревший параметр `marketSku`.

16 мая

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offer-prices/updates GET v2/campaigns/{campaignId}/offer-prices	Удалили устаревший параметр `feed`.

14 мая

Методы или страницы документации	Описание изменений
POST v2/reports/shelf-statistics/generate	Добавили сводный отчет по полкам.
POST v2/categories/tree	Добавили параметр `language` — язык категорий.

13 мая

Методы или страницы документации

Описание изменений

POST order/status

POST order/accept

Добавили параметр shopOrderId — идентификатор заказа в магазине.

8 мая

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offers/stocks	Доработали метод для модели FBY — теперь по нему передается информация по оборачиваемости товаров по каждому складу отдельно, а не общее значение по всем складам.
POST v2/tariffs/calculate	Добавили параметр для расчета стоимости услуг `quantity` — квант продажи.
POST v2/businesses/{businessId}/offer-mappings/update	Добавили: параметр `parameterValues` — список характеристик с их значениями; ошибки и предупреждения, которые касаются переданных характеристик.

3 мая

Методы или страницы документации

Описание изменений

POST v2/category/{categoryId}/parameters

Добавили параметр marketCategoryId — идентификатор категории на Маркете, к которой вы относите свой товар.

24 апреля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offers/stocks	Метода стал доступен для моделей DBS и Экспресс.
GET v2/campaigns/{campaignId}/offer-prices	Отметили метод устаревшим. Вместо него используйте POST v2/campaigns/{campaignId}/offer-prices.

23 апреля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/chats/history	В ответе добавили параметр `orderId` — идентификатор заказа.

19 апреля

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/returns	Указали максимальное количество идентификаторов заказов (параметр `orderIds`) — 50.
POST v2/campaigns/{campaignId}/offers/update	Рассказали, как сбросить ранее установленные значения кванта.
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/campaigns/{campaignId}/orders/{orderId}/status `POST order/accept` `POST order/status` `POST order/cancellation/notify`	Указали неактуальные типы скидки — параметр `type`. Отметили устаревшим параметр `status`.
`POST cart`	Указали неактуальные типы скидки — параметр `type`.

18 апреля

Методы или страницы документации	Описание изменений
Передача остатков через API	Рассказали, как можно проверить работоспособность интеграции по передаче остатков.
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId} PUT v2/campaigns/{campaignId}/orders/{orderId}/status	Отметили устаревшим параметр `price`.

17 апреля

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders	Добавили фильтрацию заказов по типу покупателя — параметр `buyerType`.

16 апреля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/chats	В ответе добавили параметр `orderId` — идентификатор заказа.
GET v2/campaigns/{campaignId}/orders	Добавили фильтрацию по идентификаторам заказов — параметр `orderIds`.

11 апреля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/skus	Изменили лимит на количество товаров — 5 000 товаров в минуту, не более 500 товаров в одном запросе.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers PUT v2/campaigns/{campaignId}/orders/{orderId}/cis	Удалили устаревший параметр `feedCategoryId`.

10 апреля

Методы или страницы документации	Описание изменений
POST v2/reports/united-marketplace-services/generate POST v2/reports/united-netting/generate	Отметили устаревшими параметры `dateTimeFrom` и `dateTimeTo`. Вместо них используйте `dateFrom` и `dateTo`.

9 апреля

Методы или страницы документации

Описание изменений

POST cart

Для модели FBS отключили метод.

Для DBS-магазинов, которые не продают цифровые товары, сделали метод необязательным. Рекомендуем не использовать его и отключить эту возможность в кабинете — в левом нижнем углу нажмите на название своего бизнеса, перейдите на страницу Модули и API во вкладку Получение запросов от Маркета и активируйте опцию Не использовать метод POST cart.

Если вы продаете цифровые товары, метод остается обязательным.

В ответе добавили параметр units — информация о допустимых единицах измерения.

Их вы можете указывать при заполнении карточек товаров — метод POST v2/businesses/{businessId}/offer-cards/update.

4 апреля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/confirm	Удалили параметр `orderIds`.

3 апреля

Методы или страницы документации

Описание изменений

GET v2/businesses/{businessId}/warehouses

GET v2/warehouses

Удалили параметр additional.

2 апреля

Методы или страницы документации	Описание изменений
POST v2/tariffs/calculate	Добавили параметр `parameters` — детали расчета конкретной услуги Маркета.

1 апреля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update	Увеличили до 6 максимальное количество ссылок на видео товара — параметр `videos`.

29 марта

Методы или страницы документации	Описание изменений
POST v2/reports/documents/shipment-list/generate	Добавили лист сборки для отгрузки.
Обработка FBS-заказов	Рассказали, как генерировать лист сборки.
PUT v2/campaigns/{campaignId}/offers/stocks	Параметр `updatedAt` стал необязательным. Если его не передать, будет использоваться текущее время. Удалили параметр `warehouseId`. Идентификатор склада будет определяться по `campaignId`. Удалили параметр `type`. Единственно возможное значение `FIT` будет передаваться автоматически.

22 марта

Методы или страницы документации

Описание изменений

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

В ответе добавили параметр address — адрес пункта выдачи.

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

Удалили услугу FULFILLMENT.

15 марта

Методы или страницы документации	Описание изменений
POST v2/categories/tree	Добавили новый метод. Он возвращает дерево категорий Маркета.
POST v2/tariffs/calculate	Добавили новый метод. Он рассчитывает стоимость услуг Маркета для товаров с заданными параметрами.
POST v2/reports/boost-consolidated/generate	Добавили отчет по бусту продаж.
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders PUT v2/campaigns/{campaignId}/orders/{orderId}/status PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers PUT v2/campaigns/{campaignId}/orders/{orderId}/cis	Отметили устаревшим параметр `feedCategoryId`.

14 марта

Методы или страницы документации

Описание изменений

Добавили параметр manuals — список инструкций по использованию товара.

13 марта

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/hidden-offers `DELETE v2/campaigns/{campaignId}/hidden-offers`	Изменили лимиты на количество товаров — 5 000 товаров в минуту, не более 500 товаров в одном запросе.
`POST cart`	Увеличили максимальное количество дат в параметре `dates` до 7.

12 марта

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/skus	Удалили услуги `CANCELLED_ORDER_FEE` и `LATE_ORDER_EXECUTION_FEE`.

8 марта

Методы или страницы документации

Описание изменений

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

Добавили услуги:

EXPRESS_CANCELLED_BY_PARTNER — отмена заказа с экспресс-доставкой;
DELIVERY_TO_CUSTOMER_RETURN — возврат доставляемого товара на склад;
CROSSBORDER_DELIVERY — доставка из-за рубежа;
INTAKE_SORTING_BULKY_CARGO — сортировка заказов с крупногабаритными товарами, которые Маркет забрал со склада продавца;
INTAKE_SORTING_SMALL_GOODS — сортировка заказов с малогабаритными товарами, которые Маркет забрал со склада продавца;
INTAKE_SORTING_DAILY — организация забора заказов со склада продавца;
FF_STORAGE_BILLING — хранения товаров на складе.

6 марта

Методы или страницы документации

Описание изменений

Добавили значение NOT_SPECIFIED (не выбран) для параметров:

type — тип уценки;
quality — внешний вид товара.

5 марта

Методы или страницы документации

Описание изменений

POST v2/reports/goods-turnover/generate

POST v2/reports/prices/generate

Теперь доступны два формата отчета:

FILE — электронная таблица;
CSV — ZIP-архив с CSV-файлами.

4 марта

Методы или страницы документации	Описание изменений
POST v2/reports/stocks-on-warehouses/generate	Добавили фильтры по категориям на Маркете и по наличию остатков для всех моделей кроме FBY.

1 марта

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders	Удалили статус заказа `REJECTED`.

29 февраля

Методы или страницы документации

Описание изменений

GET v2/campaigns/{campaignId}/outlets

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

Удалили параметр emails.

POST v2/reports/united-netting/generate

POST v2/reports/goods-realization/generate

POST v2/reports/goods-movement/generate

POST v2/reports/shows-sales/generate

Добавили услуги:

CROSSREGIONAL_DELIVERY_RETURN — доставка невыкупов и возвратов;
MIDDLE_MILE — средняя миля;
LATE_ORDER_EXECUTION_FEE — отгрузка или доставка не вовремя;
RETURN_PROCESSING — обработка невыкупов и возвратов.

27 февраля

Методы или страницы документации

Описание изменений

Теперь доступны два формата отчета:

FILE — электронная таблица;
CSV — ZIP-архив с CSV-файлами.

26 февраля

Методы или страницы документации	Описание изменений
GET v2/businesses/{businessId}/warehouses	Добавили параметр `express` — возможна ли доставка по модели Экспресс.

22 февраля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders	Добавили тип оплаты `SPLIT` — оплата картой по частям (Сплит).

15 февраля

Методы или страницы документации

Описание изменений

POST v2/reports/stocks-on-warehouses/generate

Теперь доступны два формата отчета:

FILE — электронная таблица;
CSV — ZIP-архив с CSV-файлами.

14 февраля

Методы или страницы документации

Описание изменений

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

Теперь кроме УПД возвращается информация о других документах:

УКД;
товарной накладной;
счете-фактуре;
корректировочном счете-фактуре.

GET v2/businesses/{businessId}/warehouses

GET v2/warehouses

В ответе добавили параметр address — адрес склада.

12 февраля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-cards	Изменили лимит на количество запросов — 600 запросов в минуту, не более 200 товаров в одном запросе.

8 февраля

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders	Добавили услугу для FBY-магазинов `RETURN_PROCESSING` — обработка заказов на складе.
GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId}	Отметили устаревшим параметр `phone`. Чтобы получить номер телефона покупателя, используйте метод GET v2/campaigns/{campaignId}/orders/{orderId}/buyer.

7 февраля

Методы или страницы документации

Описание изменений

GET v2/campaigns/{campaignId}/outlets

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

Удалили параметр cost.

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

POST cancellation/notify

Параметр email (адрес электронной почты покупателя) больше не возвращается в ответах.

2 февраля

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels/data	В ответе добавили параметр `boxId` — идентификатор коробки.

1 февраля

Методы или страницы документации	Описание изменений
POST v2/reports/united-orders/generate POST v2/reports/united-marketplace-services/generate	Теперь доступны два формата отчета: `FILE` — электронная таблица; `CSV` — ZIP-архив с CSV-файлами.
PUT v2/campaigns/{campaignId}/orders/{orderId}/status GET v2/campaigns/{campaignId}/orders GET v2/campaigns/{campaignId}/orders/{orderId}	Удалили параметр `feedId`. Отметили устаревшим параметр `shopSku`. Вместо него используйте `offerId`.
PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers	Удалили параметр `feedId`.

31 января

Методы или страницы документации

Описание изменений

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

GET v2/campaigns/{campaignId}/outlets

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

Стали необязательными параметрами:

name — название точки продаж;
phones — номера телефонов точки продаж;
address — адрес точки продаж;
regionId — идентификатор региона;
workingSchedule — список режимов работы точки продаж;
scheduleItems — список расписаний работы точки продаж;
startDay — день недели, в который точка продаж начинает работать;
endDay — день недели, в который точка продаж заканчивает работать;
startTime — время начала работы точки продаж;
endTime — время окончания работы точки продаж;
cost — стоимость самовывоза из точки продаж;
type — тип точки продаж.

30 января

Методы или страницы документации

Описание изменений

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

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

Указали размеры ярлыков, которые возвращаются в PDF-файле.

29 января

Методы или страницы документации

Описание изменений

GET v2/campaigns/{campaignId}/hidden-offers

POST v2/campaigns/{campaignId}/hidden-offers

DELETE v2/campaigns/{campaignId}/hidden-offers

Удалили параметры ttlInHours и feedId.

25 января

Методы или страницы документации

Описание изменений

GET v2/campaigns/{campaignId}/hidden-offers

POST v2/campaigns/{campaignId}/hidden-offers

DELETE v2/campaigns/{campaignId}/hidden-offers

Удалили параметр marketSku.

22 января

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/hidden-offers	Удалили устаревший параметр `total`.
PUT v2/campaigns/{campaignId}/orders/{orderId}/status GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders	Отметили устаревшими параметры `total`, `subsidyTotal` и `totalWithSubsidy`.

18 января

Методы или страницы документации	Описание изменений
Методы, где передается название товара.	Увеличили максимальное количество символов в названии товара до 256.
GET v2/campaigns/{campaignId}/hidden-offers POST v2/campaigns/{campaignId}/hidden-offers `DELETE v2/campaigns/{campaignId}/hidden-offers`	Удалили устаревшие параметры `comment` и `priority`.

17 января

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/hidden-offers	Удалили устаревший параметр `feed_id`.

10 января

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/offer-prices/updates	Изменили лимит на количество товаров — 5 000 товаров в минуту, не более 500 товаров в одном запросе.

9 января

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/orders/{orderId}/business-buyer	Добавили возможность получить информацию о покупателе — юридическом лице.
POST v2/campaigns/{campaignId}/orders/{orderId}/documents	Добавили возможность получить информацию об УПД.
Обработка заказов от юридических лиц	Добавили пошаговую инструкцию по работе с заказами от юридических лиц.

2023

29 декабря

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders	Теперь метод называется Детальная информация по заказам.
POST v2/reports/united-orders/generate	Добавили отчет по заказам.
PUT v2/campaigns/{campaignId}/offers/stocks	С 1 марта 2024 года изменится лимит на количество запросов в методе — 100 000 товаров в минуту, не более 500 товаров в одном запросе.

26 декабря

Методы или страницы документации	Описание изменений
API Яндекс Маркета для продавцов	Рассказали про компоненты API Маркета: pull-компонент (магазин отправляет запросы Маркету) и push-компонент (Маркет отправляет запросы магазину), а также о том, как настроить интеграцию.
Обработка FBS-заказов	Добавили пошаговую инструкцию по обработке заказов для модели FBS.
POST v2/reports/goods-turnover/generate	Добавили отчет по оборачиваемости.
PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes	Добавили новый метод. Он передает раскладку по коробкам и коды маркировки, а также изменяет состав заказа.
PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes PUT v2/campaigns/{campaignId}/orders/{orderId}/items	Отметили методы устравшими для модели FBS. Вместо них используйте PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

25 декабря

Методы или страницы документации	Описание изменений
Управление товарами в архиве	Рассказали, как управлять товарами в архиве.
POST v2/campaigns/{campaignId}/stats/orders	Добавили услугу `INTAKE_SORTING` — организация забора заказов со склада продавца.

22 декабря

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/chats/new — создает чат; POST v2/businesses/{businessId}/chats/message — отправляет сообщение в чат; POST v2/businesses/{businessId}/chats/file/send — отправляет файл в чат; POST v2/businesses/{businessId}/chats — возвращает список чатов; POST v2/businesses/{businessId}/chats/history — возвращает историю сообщений.	Добавили методы для общения с покупателями в чатах.
Чаты с покупателями	Добавили пошаговую инструкцию по работе с чатами.
PUT v2/campaigns/{campaignId}/orders/{orderId}/verifyEac	Изменили лимит на количество запросов — 1 000 000 запросов в час.
POST v2/campaigns/{campaignId}/offers	Изменили лимит на количеств товаров — 5 000 товаров в минуту, не более 200 товаров в одном запросе.
PUT v2/campaigns/{campaignId}/offers/stocks	Изменили лимит на количеств товаров — 100 000 товаров в минуту.

8 декабря

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offers/recommendations	Добавили параметр `shows`, где указано количество показов карточки товара за последние 7 дней.

6 декабря

Методы или страницы документации	Описание изменений
Как изменить цены на товары	Рассказали, как изменить цены в конкретном магазине.

5 декабря

Методы или страницы документации	Описание изменений
Работа с бустом продаж	Добавили пошаговую инструкцию по работе с бустом продаж.

27 ноября

Методы или страницы документации	Описание изменений
Запуск интеграции на JavaScript	Добавили пошаговую инструкцию по запуску интеграции на JavaScript.

23 ноября

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders	Добавили методы для получения заказов по модели FBY.

20 ноября

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings POST v2/campaigns/{campaignId}/offers/stocks	Добавили фильтрацию по нахождению товаров в архиве.

15 ноября

Методы или страницы документации	Описание изменений
Методы, где передается SKU.	Теперь в идентификаторе товара в магазине (SKU) можно использовать букву ё.

14 ноября

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/archive — помещает товары в архив; POST v2/businesses/{businessId}/offer-mappings/unarchive — восстанавливает товары из архива.	Добавили методы работы с архивом.

8 ноября

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/hidden-offers `DELETE v2/campaigns/{campaignId}/hidden-offers`	Изменили лимит на количество товаров — 1 000 товаров в минуту, не более 500 товаров в одном запросе.

23 октября

Методы или страницы документации

Описание изменений

GET v2/regions

Увеличили количество регионов в ответе на одной странице до 20 — параметр limit.

Добавили возможность указать идентификатор страницы c результатами — параметр page_token.

19 октября

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/orders	Добавили фильтрацию по дате и времени обновления заказа.
POST v2/businesses/{businessId}/offers/recommendations	Добавили параметр `price` — цена товара в каталоге.

18 октября

Методы или страницы документации

Описание изменений

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

Добавили способ оплаты заказа B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

14 октября

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/skus	Уточнили, что параметр `warehouses` не будет возвращаться, если товара нет ни на одном складе.

5 октября

Методы или страницы документации

Описание изменений

Добавили статусы:

PARTIALLY_DELIVERED — заказ частично доставлен;
LOST — заказ утерян.

3 октября

Методы или страницы документации	Описание изменений
POST v2/reports/shows-sales/generate	Добавили отчет «Аналитика продаж».
Методы работы с заказами с внешних площадок.	Удалили методы.

29 сентября

Методы или страницы документации	Описание изменений
GET v2/campaigns `GET v2/campaigns/by_login/{login}`	Методы больше не работают для модели ADV.
POST v2/campaigns/{campaignId}/offers/stocks	Добавили новый метод. Он возвращает информацию по остаткам товаров на витрине (для моделей FBY, FBS и Экспресс) и об оборачиваемости товаров (для модели FBY).
Акт приема-передачи Фактический акт приема-передачи Акт расхождений Транспортная накладная	Добавили методы для получения документов по отгрузкам (FBS).
PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers GET v2/campaigns/{campaignId}/orders/{orderId} GET v2/campaigns/{campaignId}/orders	Добавили параметры: `rnpt` — регистрационный номер партии товара; `gtd` — номер грузовой таможенной декларации.

28 сентября

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-cards/update — передает категорийные характеристики товаров; POST v2/businesses/{businessId}/offer-cards — показывает статусы и степень заполненности карточек; POST v2/category/{categoryId}/parameters — возвращает список характеристик с допустимыми значениями для заданной категории.	Теперь через API можно управлять контентом на карточках товаров.
PUT v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets	Добавили новый метод. Он передает количество упаковок в отгрузке.
GET v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallet/labels	Добавили новый метод. Он возвращает ярлыки для упаковок в отгрузке.

27 сентября

Методы или страницы документации	Описание изменений
POST v2/reports/prices/generate	Добавили отчет «Цены на рынке».

25 сентября

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/price-quarantine	Добавили параметр `verdicts` — причины попадания товара в карантин, где `type` — это тип карантина, а `params` — цена, из-за которой товар попал в карантин, и значения для сравнения.
POST v2/campaigns/{campaignId}/price-quarantine	Отметили устаревшими параметры `currentPrice` и `lastValidPrice`. Вместо них используйте `params`.

15 сентября

Методы или страницы документации	Описание изменений
POST v2/reports/stocks-on-warehouses/generate	Добавили отчет по остаткам на складах Маркета (FBY).

14 сентября

Методы или страницы документации	Описание изменений
GET v2/warehouses	Добавили новый метод. Он возвращает список складов Маркета (FBY) с их идентификаторами.

8 сентября

Методы или страницы документации	Описание изменений
GET v2/reports/info/{reportId}	Добавили подстатус `TOO_LARGE` — отчет превысил допустимый размер.

7 сентября

Методы или страницы документации	Описание изменений
POST v2/reports/stocks-on-warehouses/generate	Добавили отчет по остаткам на складах магазина (FBS).

5 сентября

Методы или страницы документации	Описание изменений
POST v2/reports/goods-movement/generate	Добавили отчет по движению товаров.

4 сентября

Методы или страницы документации	Описание изменений
Все методы.	Теперь в ответе `400 Bad Request` возвращаем название поля, в котором есть ошибка.

31 августа

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/skus	Удалили параметр `storage`.

29 августа

Методы или страницы документации	Описание изменений
GET v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}	Удалили неактуальные статусы отгрузки.

28 августа

Методы или страницы документации

Описание изменений

Теперь можно не включать пустое тело в запрос.

Не передавайте его, если хотите получить список всех товаров в каталоге.

24 августа

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/orders/status-update	Установили ограничение на максимальное количество заказов, у которых можно изменить статус в одном запросе, — 30.

23 августа

Методы или страницы документации	Описание изменений
POST v2/campaigns/{campaignId}/stats/orders	Удалили параметр `predicted`.

15 августа

Методы или страницы документации

Описание изменений

POST cart

POST order/accept

POST order/status

POST order/cancellation/notify

В address добавили параметр district — район в адресе доставки заказа.

12 августа

Методы или страницы документации

Описание изменений

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

В OrderDeliveryAddressDTO добавили параметр district — район в адресе доставки заказа.

8 августа

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings	Теперь на одной странице можно передать не более 200 значений, если запрос выполняется по конкретным товарам.
POST v2/campaigns/{campaignId}/stats/skus	Удалили типы остатков товаров `SUGGEST` и `TRANSIT`.

4 августа

Методы или страницы документации	Описание изменений
POST v2/reports/goods-realization/generate	Добавили отчет по реализации.
POST v2/reports/united-marketplace-services/generate	Добавили отчет по стоимости услуг.
POST v2/reports/united-netting/generate	Добавили отчет по платежам.

1 августа

Методы или страницы документации

Описание изменений

PUT v2/campaigns/{campaignId}/offers/stocks

POST stocks

Теперь нужно передавать количество доступного товара на складе без учета резерва.

27 июля

Методы или страницы документации

Описание изменений

Теперь можно узнать:

порог для скидок с Маркетом на момент оформления заказа — параметр cofinanceThreshold;
скидку с Маркетом — параметр cofinanceValue.

26 июля

Методы или страницы документации

Описание изменений

GET v2/campaigns/{campaignId}

Добавили информацию о стоимости услуг:

AGENCY — прием платежа покупателя;
AUCTION_PROMOTION — буст продаж;
DELIVERY_TO_CUSTOMER — доставка покупателю;
EXPRESS_DELIVERY_TO_CUSTOMER — экспресс-доставка покупателю;
FEE — размещение товара на Маркете;
FULFILLMENT — складская обработка;
INSTALLMENT — рассрочка;
LOYALTY_PARTICIPATION_FEE — участие в программе лояльности и отзывы за баллы, если они подключены;
PAYMENT_TRANSFER — перевод платежа покупателя;
RETURNED_ORDERS_STORAGE — хранение невыкупов и возвратов;
SORTING — обработка заказа.

20 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/bids/recommendations	Добавили новый метод. Он показывает рекомендованные ставки.

19 июля

Методы или страницы документации	Описание изменений
GET v2/businesses/{businessId}/warehouses	Добавили новый метод. Он показывает список складов и групп складов.

13 июля

Методы или страницы документации	Описание изменений
—	Изменили формат авторизационного токена — вместо 21 знака теперь в нем 48 знаков. Вы можете обновить токен прямо сейчас, чтобы усилить защиту своей интеграции.
Страница Автоматическое обновление OAuth-токена.	Рассказали, как автоматически обновлять OAuth-токен через API сервиса Яндекс ID.
POST v2/businesses/{businessId}/bids/info	Добавили новый метод. Он показывает значения ставок для заданных товаров.
POST v2/campaigns/{campaignId}/orders/status-update	Теперь можно не передавать этапы обработки заказа или причины его отмены — параметр `substatus` в `orders` стал необязательным.

7 июля

Методы или страницы документации	Описание изменений
POST v2/businesses/{businessId}/offer-mappings/update	Дополнили инструкцию по добавлению нового товара — перечислили параметры, без которых добавить товар в каталог не получится.

4 июля

Методы или страницы документации

Описание изменений

GET v2/campaigns

GET v2/campaigns/by_login/{login}

Теперь можно узнать:

идентификатор бизнеса — параметр id в business;
название бизнеса — параметр name в business.

3 июля

Методы или страницы документации

Описание изменений

GET v2/campaigns

GET v2/campaigns/{campaignId}

GET v2/campaigns/by_login/{login}

Теперь можно узнать модель, по которой работает магазин, — параметр placementType.

30 июня

Методы или страницы документации

Описание изменений