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

Следите за обновлениями документации в Телеграм-канале.

2025

11 августа

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

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

GET campaigns/{campaignId}/returns

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

Так как ошибочно отметили параметр id в LogisticPickupPointDTO устаревшим, убрали это указание.

7 августа

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

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

POST businesses/{businessId}/offer-mappings

Добавили параметр showcaseUrls — ссылки на один и тот же товар на разных витринах Маркета.

6 августа

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

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

POST campaigns/{campaignId}/offers/stocks

Добавили параметр hasStocks — фильтр по наличию товаров.

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

Удалили значение параметра FIRST_VIDEO_AS_COVER.

5 августа

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

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

GET campaigns/{campaignId}/orders

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

POST reports/united-marketplace-services/generate

На листе Платное хранение с 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 reports/shows-boost/generate

POST reports/banners-statistics/generate

POST reports/shelf-statistics/generate

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

1 августа

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

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

POST reports/stocks-on-warehouses/generate

Уточнили, что для моделей DBS, FBS и Экспресс параметр campaignId скоро станет недоступен.

Для получения информации об остатках на складе магазина используйте businessId и идентификатор нужного магазина в campaignIds.

GET campaigns/{campaignId}/settings

Отметили устаревшими параметры showInContext, showInPremium и useOpenStat.

GET campaigns/{campaignId}/region

Удалили устаревший метод.

31 июля

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

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

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

GET campaigns/{campaignId}/orders

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

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

POST notification

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

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

GET campaigns/{campaignId}/outlets

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

30 июля

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

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

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

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

29 июля

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

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

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

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

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

28 июля

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

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

Обработка заказов с цифровыми товарами

Рассказали:

  • как понять, что в заказе есть цифровые товары;

  • что Маркет отправит ключи покупателю в чат, если не получилось доставить письмо.

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

Удалили параметр cofinancePrice и значение COFINANCE_PRICE в deleteParameters.

POST businesses/{businessId}/offer-mappings

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

POST businesses/{businessId}/offers/recommendations

Удалили фильтр FieldStateType и параметры cofinancePriceFilter и cofinancePrice.

26 июля

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

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

POST businesses/{businessId}/promos/offers

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

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

Удалили предупреждение PROMOCODE_PRICE_MORE_THAN_MAX_FAIR_PRICE.

25 июля

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

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

POST categories/max-sale-quantum

Отметили метод устаревшим.

POST campaigns/{campaignId}/offers/update

POST campaigns/{campaignId}/offers

Отметили устаревшим параметр quantum.

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

POST businesses/{businessId}/offer-mappings

Отметили устаревшим параметр firstVideoAsCover.

23 июля

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

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

POST reports/stocks-on-warehouses/generate

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

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

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

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

POST campaigns/{campaignId}/supply-requests

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

22 июля

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

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

POST tariffs/calculate

Метод стал доступен для продавцов Market Yandex Go.

21 июля

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

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

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

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

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

17 июля

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

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

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

GET campaigns/{campaignId}/orders

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

POST campaigns/{campaignId}/stats/orders

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

16 июля

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

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

GET campaigns/{campaignId}/returns

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

Отметили устаревшим параметр id в LogisticPickupPointDTO.

15 июля

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

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

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

Добавили примеры для передачи нескольких товаров с уникальными или одинаковыми идентификаторами.

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

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

Список методов, используемых в модели FBY

Список методов, используемых в модели FBS

Список методов, используемых в модели Экспресс

Список методов, используемых в модели DBS

Рассказали о моделях работы на Маркете.

11 июля

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

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

POST businesses/{businessId}/offer-prices

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

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

Добавили параметр minimumForBestseller — минимальная цена товара для попадания в акцию «Бестселлеры Маркета».

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

Уточнили, что транспортная накладная возвращается только для тех отгрузок, в которых Маркет забирает товары с вашего склада.

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

Добавили значение параметра availableActionsDOWNLOAD_TRANSPORTATION_WAYBILL (скачать транспортную накладную).

10 июля

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

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

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

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

Чтобы узнать их, в методе POST category/{categoryId}/parameters передайте параметр businessId.

GET campaigns/{campaignId}/orders

Тестовые заказы

Уточнили, что информация по тестовым заказам по умолчанию не возвращается.

Формат данных запроса и ответа

Добавили пример тела запроса и ответа.

9 июля

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

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

Чаты с покупателями

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

Как изменяются статусы возвратов для моделей FBS и Экспресс

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

8 июля

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

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

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

GET campaigns/{campaignId}/orders

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

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

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

GET campaigns/{campaignId}/orders

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

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

  • estate — владение;

  • building — строение.

7 июля

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

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

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

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

3 июля

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

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

POST reports/closure-documents/generate

Добавили новый метод. Он дает возможность получить закрывающие документы.

POST reports/closure-documents/detalization/generate

Добавили отчет по схождению с закрывающими документами.

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

Описали ошибку Contract with type MARKETING was signed with the agency (договор на маркетинг заключен с агентством), которую Маркет может вернуть в ответе на запрос.

1 июля

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

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

Чаты с покупателями

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

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

30 июня

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

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

FBS-магазины

DBS-магазины

Добавили схемы, как изменяются статусы возвратов.

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

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

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

Рассказали, как работать с возвратами, по которым требуется решение.

POST reports/shows-sales/generate

Удалили колонку MAX_VISIBILITY_INDEX — максимальный индекс видимости.

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

Отметили метод устаревшим. Вместо него используйте POST campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/submit.

25 июня

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

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

POST businesses/{businessId}/promos

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

PUT businesses/{businessId}/bids

Уточнили, что данные обновляются не мгновенно.

23 июня

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

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

Лог запросов

Рассказали о виджете с информацией об ошибках в запросах и ответах и фильтре Интеграция.

POST reports/documents/shipment-list/generate

Уточнили, что в методе нужно обязательно передавать shipmentId или orderIds.

4 июня

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

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

POST reports/key-indicators/generate

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

PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes

Отметили метод устаревшим. Вместо него используйте PUT campaigns/{campaignId}/orders/{orderId}/boxes.

3 июня

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

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

POST campaigns/{campaignId}/offer-prices

GET campaigns/{campaignId}/offer-prices

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

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

Изменили лимит на количество товаров — 10 000 товаров в минуту.

30 мая

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

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

POST reports/jewelry-fiscal/generate

Добавили колонку BUYER_PRICE — цена товара.

29 мая

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

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

POST reports/sales-geography/generate

Добавили отчет по географии продаж.

Удалили устаревшие методы.

GET campaigns/{campaignId}/offers

GET campaigns/{campaignId}/offers/all

GET campaigns/{campaignId}/feeds

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

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

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

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

28 мая

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

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

POST campaigns/{campaignId}/orders/{orderId}/identifiers/status

Добавили новый метод. Он возвращает статусы проверки УИНов в заказе.

27 мая

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

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

POST reports/jewelry-fiscal/generate

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

20 мая

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

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

POST 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 reports/banners-statistics/generate

Добавили отчет по охватному продвижению.

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

Уточнили, что уведомления, связанные с заказами, приходят и по FBY-заказам, если они настроены для кабинета.

30 апреля

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

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

POST reports/shows-boost/generate

Добавили отчет по бусту показов.

POST campaigns/{campaignId}/orders/{orderId}/external-id

Добавили новый метод. Он передает или изменяет внешний идентификатор заказа в системе магазина.

29 апреля

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

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

POST campaigns/{campaignId}/offers/stocks

Добавили фильтр по идентификатору склада — параметр stocksWarehouseId.

POST businesses/{businessId}/promos/offers

Добавили фильтр MINIMUM_FOR_PROMOS — товары с установленным минимумом по цене для акций, который соответствует порогу maxPromoPrice.

28 апреля

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

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

POST campaigns/{campaignId}/supply-requests — получение информации о заявках на поставку, вывоз и утилизацию;

POST campaigns/{campaignId}/supply-requests/items — получение товаров в заявке на поставку, вывоз или утилизацию;

POST campaigns/{campaignId}/supply-requests/documents — получение документов по заявке на поставку, вывоз или утилизацию.

Добавили методы работы с FBY-заявками.

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

Добавили пошаговую инструкцию по работе с FBY-заявками.

24 апреля

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

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

POST auth/token

Добавили новый метод. Он возвращает информацию о переданном авторизационном токене.

Модуль для системы «1С:Предприятие»

Рассказали о модуле для системы «1С:Предприятие», с помощью которого можно управлять товарами и обрабатывать заказы на Маркете.

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

Рассказали, какие роли нужны для настройки API-уведомлений.

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

Отметили устаревшим параметр cofinancePrice.

23 апреля

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

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

POST businesses/{businessId}/offers/recommendations

Удалили фильтр recommendedCofinancePriceFilter.

Удалили параметр recommendedCofinancePrice в ответе.

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

GET campaigns/{campaignId}/orders

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

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

Удалили причину отмены заказа DELIVERY_DATE_CHANGED_TOO_MUCH — заказ перенесен на слишком много дней.

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

GET campaigns/{campaignId}/orders

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

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

Добавили причину отмены заказа TOO_LONG_DELIVERY — заказ доставляется слишком долго.

22 апреля

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

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

POST reports/united-netting/generate

Добавили отчет о баллах Маркета.

GET businesses/{businessId}/chat — возвращает чат по его идентификатору;

GET businesses/{businessId}/chats/message — возвращает сообщение по его идентификатору.

Добавили методы работы с чатами.

POST notification

Добавили типы уведомлений:

  • создание чата с покупателем;
  • добавление сообщения в чате;
  • начало спора;
  • завершение спора;
  • создание отзыва о товаре;
  • создание комментария к отзыву.

Чаты с покупателями

Обновили инструкцию, как проверить, есть ли новые чаты или сообщения.

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

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

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

Добавили описание ошибки The method is not supported for Market Yandex Go sellers — метод недоступен для продавцов Market Yandex Go.

21 апреля

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

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

POST reports/united-marketplace-services/generate

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

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

  • SERVICE_DATESERVICE_DATE_TIME;

  • serviceDateserviceDateTime;

  • Информация об услуге/Дата оказания услугиИнформация об услуге/Дата и время оказания услуги.

16 апреля

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

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

GET 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 models/{modelId}

POST models

GET models/{modelId}/offers

POST models/offers

GET models

Отметили методы устаревшими.

10 апреля

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

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

Работа со складами

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

9 апреля

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

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

POST regions/countries

Добавили новый метод. Он возвращает список стран с их кодами.

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

Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 500 товаров в одном запросе в методе.

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

Изменили лимит на количество товаров — 10 000 товаров в минуту.

POST businesses/{businessId}/goods-feedback

Уточнили, что не возвращаются отзывы, которые удалили покупатели или Маркет.

Добавили параметр feedbackIds — идентификаторы отзывов.Не используйте его одновременно с другими фильтрами.

POST businesses/{businessId}/goods-feedback/comments

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

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

Добавили параметр commentIds — идентификаторы комментариев. Не используйте его одновременно с другими фильтрами.

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

GET campaigns/{campaignId}/orders

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

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

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

Добавили параметр countryCode — страна производства.

Обработка заказов от юридических лиц

Описали особенности работы с заказами от юридических лиц.

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

Добавили описание ошибки String (value) is not a valid country code according to ISO 3166-1 alpha-2 — недопустимый код страны. Укажите код страны в формате ISO 3166-1 alpha-2.

8 апреля

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

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

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

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

POST campaigns/{campaignId}/stats/orders

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

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

6 апреля

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

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

POST reports/goods-realization/generate

Отчет по реализации стал доступен и для модели DBS.

4 апреля

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

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

POST category/{categoryId}/parameters

Изменили лимит на количество категорий — 100 категорий в минуту.

POST categories/max-sale-quantum

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

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

POST campaigns/{campaignId}/hidden-offers

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

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

GET campaigns/{campaignId}/hidden-offers

Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 500 товаров в одном запросе.

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

Рассказали, что с помощью метода GET campaigns/{campaignId}/shipments/reception-transfer-act вы можете не только подтвердить отгрузку, но и подписать и получить электронный акт приема-передачи.

PUT campaigns/{campaignId}/offers/stocks

Передача остатков через API

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

POST reports/united-marketplace-services/generate

Изменили название колонки Уменьшение (скидка) и увеличение стоимости услуги/Вызовы и награды/Скидка (гр.37=гр.35*гр.36)/37. Теперь она называется Уменьшение (скидка) и увеличение стоимости услуги/Вызовы и награды/Скидка с учётом минимального тарифа (гр.37=гр.35*гр.36)/37.

3 апреля

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

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

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

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

POST businesses/{businessId}/promos/offers

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

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

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

2 апреля

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

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

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

1 апреля

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

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

Пошаговые инструкции и методы, где передаются или возвращаются коды маркировки в системе «Честный ЗНАК».

Рассказали, что маркировка товаров в системе «Честный ЗНАК» теперь необязательна для заказов от физических лиц.

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

31 марта

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

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

POST businesses/{businessId}/warehouses — возвращает список складов и информацию о них;

POST campaigns/{campaignId}/warehouse/status — отключает или включает склад.

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

POST campaigns/{campaignId}/offers/update

POST campaigns/{campaignId}/offers

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

POST campaigns/{campaignId}/offer-prices

Удалили идентификатор НДС 12%.

Уточнили, что для продавцов Market Yandex Go недоступна передача и получение НДС.

POST notification

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

GET businesses/{businessId}/warehouses

Отметили метод устаревшим. Вместо него используйте POST businesses/{businessId}/warehouses.

28 марта

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

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

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

Уточнили диапазоны IP-адресов, которые использует Маркет.

27 марта

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

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

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

POST reports/goods-feedback/generate

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

25 марта

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

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

POST businesses/{businessId}/goods-feedback/comments

В ответе добавили параметр feedbackId — идентификатор отзыва.

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

Добавили описание ошибки Business is in migration — в кабинете происходят миграции магазинов.

20 марта

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

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

Как работать с API Маркета продавцам Market Yandex Go

Добавили страницу о том, как работать с API Маркета продавцам Market Yandex Go.

POST campaigns/{campaignId}/offers/update

POST campaigns/{campaignId}/offers

POST campaigns/{campaignId}/offers/delete

POST campaigns/{campaignId}/price-quarantine

POST campaigns/{campaignId}/price-quarantine/confirm

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

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

Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 100 товаров в одном запросе.

Удалили тип товарного кода PACK_CODE.

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

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

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

POST businesses/{businessId}/price-quarantine/confirm

Изменили лимиты на количество товаров — 10 000 товаров в минуту, не более 200 товаров в одном запросе.

POST businesses/{businessId}/price-quarantine

Изменили лимит на количество товаров — 10 000 товаров в минуту, не более 500 товаров в одном запросе.

18 марта

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

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

POST notification

Добавили типы уведомлений:

  • создание заявки на отмену заказа;
  • изменение статуса невыкупа или возврата.

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

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

POST reports/documents/labels/generate

Добавили примеры ярлыков для продавцов Market Yandex Go.

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

Рассказали, как передавать название и описание товара для продавцов Market Yandex Go.

17 марта

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

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

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

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

GET campaigns/{campaignId}/orders

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

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

POST notification

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

14 марта

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

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

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

Рассказали, как изменяются статусы DBS-заказов.

POST reports/united-returns/generate

Добавили отчет по невыкупам и возвратам.

Рекомендации Маркета по карточкам

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

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

Рассказали, как:

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

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

13 марта

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

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

POST 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 campaigns/{campaignId}/returns

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

Уточнили, что параметр refundStatus актуален только для возвратов (returnType=RETURN).

11 марта

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

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

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

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

GET campaigns/{campaignId}/orders

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

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

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

10 марта

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

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

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

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

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

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

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

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

7 марта

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

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

GET campaigns/{campaignId}/returns

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

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

  • amount — сумма возврата;
  • partnerCompensationAmount — компенсация за обратную доставку.

Отметили устаревшими параметры refundAmount и partnerCompensation. Вместо них используйте amount и partnerCompensationAmount.

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

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

Рассказали, что с помощью POST category/{categoryId}/parameters можно проверить, какие категорийные характеристики доступны для заданной категории, и получить их настройки.

GET campaigns/{campaignId}/returns

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

Уточнили, что в ответе параметр fastReturn приходит только для возвратов (returnType=RETURN).

6 марта

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

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

Как подписывать интеграции

Рассказали, как подписывать интеграции.

5 марта

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

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

POST campaigns/{campaignId}/stats/orders

POST campaigns/{campaignId}/stats/skus

Добавили параметр currency — валюта, в которой указано значение тарифа.

POST reports/united-orders/generate

Удалили колонки COUNT (Информация о заказах/Количество) и TRANSFERRED_FOR_DELIVERY (Информация о заказах/Передано в доставку).

POST reports/united-orders/generate

Добавили колонки:

  • TRANSFERRED_FOR_DELIVERY (Информация о заказах/Передано в доставку);

  • DELIVERED_OR_RETURNED (Информация о заказах/Доставлено или возвращено);

  • DELIVERY_DATE (Информация о заказах/Дата доставки заказа).

3 марта

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

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

GET campaigns/{campaignId}/logins

GET campaigns/by_login/{login}

Удалили устаревшие методы.

1 марта

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

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

POST businesses/{businessId}/promos/offers

Уточнили, что условия участия в акциях могут меняться, кроме параметров price и promoPrice.

27 февраля

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

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

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

Добавили пошаговую инструкцию по обработке Экспресс-заказов.

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

GET campaigns/{campaignId}/orders

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

Уточнили, что значение MERCHANT_TO_COURIER в параметре eacType временно не возвращается.

POST reports/prices/generate

Уточнили, что информация возвращается только по 50 000 товаров.

Если у вас их больше, используйте фильтры.

GET campaigns/{campaignId}/returns

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

Добавили значение UNKNOWN (неизвестный статус) в параметре shipmentStatus.

26 февраля

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

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

POST reports/goods-realization/generate

Удалили колонку ORDER_STATUS (Заказы/Статус заказа).

20 февраля

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

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

POST campaigns/{campaignId}/offers/update

POST campaigns/{campaignId}/offers

Отметили устаревшим параметр available. Вместо него используйте методы скрытия товаров с витрины:

GET campaigns/{campaignId}/hidden-offers

POST campaigns/{campaignId}/hidden-offers

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

19 февраля

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

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

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

GET campaigns/{campaignId}/orders

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

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

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

  • TOO_MANY_DELIVERY_DATE_CHANGES — заказ переносили слишком много раз;

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

18 февраля

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

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

Методы получения отчетов.

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

13 февраля

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

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

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

GET campaigns/{campaignId}/orders

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

Отметили устаревшим параметр details.

12 февраля

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

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

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

Добавили формат — JSON.

В пояснениях к колонкам появился блок Название колонки в JSON.

11 февраля

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

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

POST campaigns/{campaignId}/stats/skus

Удалили значение DELIVERY_TO_CUSTOMER_RETURN в параметре TariffType.

10 февраля

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

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

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

Отметили метод устаревшим.

7 февраля

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

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

API Яндекс Маркета для продавцов

Рассказали о подключении API-уведомлений.

Формат данных запроса и ответа

Добавили страницу Формат данных API-уведомлений.

Сообщения об ошибках

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

  • CANT_GET_RESPONSE (UNSUPPORTED_MEDIA_TYPE) — в заголовке ответа магазина указан формат данных, отличный от application/json;

  • INVALID_RESPONSE (INVALID_DATA) — в теле ответа магазина переданы некорректные данные или их недостаточно.

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

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

Добавили описание ошибки Offer at index… cannot have parameter… deleted and set at the same time — можно передать либо значение параметра в deleteParameters, либо соответствующий параметр в UpdateOfferDTO.

POST category/{categoryId}/parameters

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

5 февраля

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

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

GET campaigns/{campaignId}/offers

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

4 февраля

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

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

POST businesses/{businessId}/promos/offers

Добавили параметр statuses — фильтр для товаров, которые могут участвовать в акции.

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

POST businesses/{businessId}/promos

В ответе добавили параметр renewalEnabled — включен ли автоматический перенос ассортимента между акциями «Бестселлеры Маркета».

POST businesses/{businessId}/offer-cards

Уточнили описание параметра contentRating — рейтинг карточки.

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

  • averageContentRating — средний рейтинг карточки у товаров той категории, которая указана в marketCategoryId;

  • contentRatingStatus — статус вычисления рейтинга карточки и рекомендаций;

  • remainingRatingPoints — максимальное количество баллов рейтинга карточки, которые можно получить за выполнение рекомендаций.

POST businesses/{businessId}/offer-cards

POST category/{categoryId}/parameters

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

GET campaigns/{campaignId}/outlets/licenses

Добавили описание статусов проверки лицензии:

  • REVOKE — лицензия отозвана службой качества;

  • DONT_WANT — не проверяется;

  • FAIL_MANUAL — лицензия не прошла проверку службы качества.

GET campaigns/{campaignId}/returns

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

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

В решение по возврату добавили описание значения UNKNOWN — не указано.

Удалили тип логистической точки UNKNOWN.

POST campaigns/{campaignId}/stats/orders

В тип товара добавили описание значения EXPIRED — товар с истекшим сроком годности.

Удалили типы товара:

  • FREEZE

  • AVAILABLE

  • QUARANTINE

  • UTILIZATION

В тип оплаты заказа добавили значение UNKNOWN — неизвестный тип оплаты.

Удалили типы оплаты:

  • CREDIT

  • TINKOFF_CREDIT

3 февраля

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

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

GET campaigns/{campaignId}/feedback/updates

Удалили устаревший метод.

31 января

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

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

POST reports/united-marketplace-services/generate

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

  • SERVICES_COLUMN_MANY_WAREHOUSES_SUPPLY (Информация об услуге/Поставка для нескольких складов);

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

30 января

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

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

POST notification

Уточнили, что разрешенное количество символов в параметрах name (название интеграции) и version (версия интеграции) — от 1 до 100.

29 января

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

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

POST campaigns/{campaignId}/stats/orders

Уточнили, что параметр payments может вернуться пустым, если нет данных о денежных переводах.

Удалили значение UNKNOWN в параметре type.

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

В параметре error добавили описание значения UNKNOWN — неизвестная причина ошибки.

GET campaigns/{campaignId}/returns

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

Создать приложение

Уточнили случаи, когда токен нужно получать снова.

POST reports/united-netting/generate

На листе Отчёт о платежах добавили колонку BONUS_ACCOUNT_YEAR_MONTH (Информация о платежах/Расчётный период премии за участие в совместных акциях).

POST reports/united-marketplace-services/generate

Изменили название листа Пуши. Теперь он называется Пуш-уведомления.

27 января

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

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

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

POST businesses/{businessId}/offer-mappings

Добавили описание значения DEFAULT — передайте его в параметре type для товара, у которого установлен особый тип и вы хотите его убрать.

POST businesses/{businessId}/offer-cards

POST category/{categoryId}/parameters

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

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

Добавили описание причин, почему обновился состав заказа:

  • PARTNER_REQUESTED_REMOVE — магазин удалил товар;

  • USER_REQUESTED_REMOVE — покупатель попросил удалить товар.

24 января

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

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

POST campaigns/{campaignId}/stats/orders

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

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

  • items — информация о доставке заказа добавляется отдельным элементом в массиве items — параметр offerName со значением Доставка.

22 января

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

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

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

Сообщения об ошибках

Получение уведомлений

Добавили API-уведомления — подключите их и Маркет будет отправлять вам информацию о событиях:

  • создание заказа;
  • отмена заказа;
  • изменение статуса заказа;
  • создание невыкупа или возврата.

Тестовые заказы

Уточнили, что если у вас подключены API-уведомления, то Маркет будет отправлять вам запрос POST notification с информацией о событии также и по тестовым заказам.

POST reports/united-orders/generate

POST reports/goods-realization/generate

В названиях колонок в XLSX уточнили, что информация указывается в штуках.

21 января

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

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

Все методы.

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

20 января

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

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

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

Отметили обязательным параметр code — код для подтверждения ЭАПП.

PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes

Уточнили описание кода ошибки 400.

Из тела запроса удалили параметр id.

POST reports/united-marketplace-services/generate

Добавили пояснение к колонкам на листе Пуши.

POST businesses/{businessId}/bids/recommendations

Отметили устаревшим параметр priceRecommendations.

17 января

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

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

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

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

POST reports/documents/labels/generate

Добавили пример ярлыка формата A9_HORIZONTALLY и уточнили описание значения A4.

Методы, в ответе которых возвращается параметр status.

Добавили описание возможных значений параметра status.

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

Добавили описание возможных значений параметра mapping_kind.

GET campaigns/{campaignId}/outlets/licenses

POST campaigns/{campaignId}/outlets/licenses

В параметре LicenseType добавили описание значения UNKNOWN — неизвестный тип лицензии.

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

Удалили значение NOT_INDEXED в параметре FeedIndexLogsErrorType.

14 января

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

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

Все методы, где передается или возвращается offset.

Удалили устаревший параметр offset.

10 января

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

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

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

Уточнили принцип работы параметра onlyPartnerMediaContent — при передаче значения true из товаров удаляются данные, которые добавил Маркет.

2024

27 декабря

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

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

GET campaigns/{campaignId}/logins

GET campaigns/by_login/{login}

Отметили методы устаревшими.

26 декабря

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

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

Обработка заказов от юридических лиц

Рассказали, как определить, что заказ пришел от юридического лица.

24 декабря

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

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

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

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

  • REFUND_MONEY — вернуть деньги за товар;

  • REFUND_MONEY_INCLUDING_SHIPMENT — вернуть деньги за товар и обратную пересылку;

  • REPAIR — магазин устранит недостатки товара;

  • REPLACE — магазин заменит товар;

  • SEND_TO_EXAMINATION — магазин отправит товар на экспертизу;

  • DECLINE_REFUND — не возвращать деньги;

  • OTHER_DECISION — другое решение.

20 декабря

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

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

Сравнение методов по моделям

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

17 декабря

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

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

GET models/{modelId}

POST models

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

GET models/{modelId}/offers

POST models/offers

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

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

Уточнили, что ответ 200 не значит, что ключи переданы покупателю.

Если письмо с ключами удалось доставить, Маркет переведет заказ в финальный статус DELIVERED.

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

GET campaigns/{campaignId}/orders

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

Отметили устаревшим параметр id в delivery.

16 декабря

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

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

Инструкции и методы работы с push-схемой.

Удалили страницы.

Не рекомендуем настраивать новые интеграции с push-компонентом.

Тестовые заказы

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

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

Добавили параметр trusted — проверенный покупатель.

Если параметр вернулся со значением true, Маркет уже проверил покупателя — не звоните ему. Обработайте заказ как обычно и передайте его курьеру или отвезите в ПВЗ.

13 декабря

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

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

POST reports/prices/generate

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

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

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

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

12 декабря

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

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

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

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

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

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

10 декабря

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

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

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

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

9 декабря

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

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

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

POST businesses/{businessId}/offer-mappings

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

3 декабря

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

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

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

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

POST reports/documents/labels/generate

Добавили формат размещения ярлыков на странице — A9_HORIZONTALLY.

Он доступен только для продавцов из России.

2 декабря

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

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

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

POST businesses/{businessId}/offer-mappings

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

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

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

  • в OrderItemPromoDTOsubsidy;

  • в OrderItemDetailDTOitemCount, itemStatus и updateDate;

  • в OrderSubsidyDTOtype и amount;

  • в OrderItemSubsidyDTOtype и amount;

  • в OrderItemDTOid, offerId, offerName, price, buyerPrice, buyerPriceBeforeDiscount, count и vat;

  • в OrderDeliveryDatesDTOfromDate;

  • в OrderTrackDTOdeliveryServiceId;

  • в OrderParcelBoxDTOid и fulfilmentId;

  • в OrderDeliveryDTOtype, serviceName, deliveryPartnerType, dates и deliveryServiceId;

  • в OrderBuyerBasicInfoDTOtype;

  • в OrderDTOid, status, substatus, creationDate, currency, itemsTotal, deliveryTotal, buyerItemsTotalBeforeDiscount, paymentType, paymentMethod, fake,delivery, buyer и taxSystem;

  • в RegionDTOid.

29 ноября

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

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

Обработка заказов и учёт товаров

Просмотр информации о заказах

Управление ценами

Просмотр цен

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

Просмотр товаров и карточек

Продвижение товаров

Просмотр информации о продвижении товаров

Просмотр финансовой информации и отчётности

Общение с покупателями

Настройка магазинов

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

POST businesses/{businessId}/offer-mappings

Добавили информацию о медиафайле товара — OfferMediaFileDTO в uploadState.

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

POST businesses/{businessId}/offer-mappings

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

  • commodityCodes (товарные коды) и его типы CommodityCodeType:
    • CUSTOMS_COMMODITY_CODE — код товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД);
    • IKPU_CODE — идентификационный код продукции и услуг (ИКПУ) в Узбекистане;
    • PACK_CODE — код упаковки для ИКПУ.
  • language — язык, на котором принимаются и возвращаются значения в параметрах name и description.

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

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

Добавили тип ошибки и предупреждения INVALID_COMMODITY_CODE — передан некорректный товарный код.

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

Добавили НДС 12%, который используется только в Узбекистане, — идентификатор 9 и значение VAT_12 в параметре vat.

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

Отметили устаревшим параметр url.

28 ноября

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

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

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

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

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

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

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

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

26 ноября

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

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

Все методы.

Для продавцов, которые используют API-Key-токены: добавили список доступов, один из которых необходим для вызова этого метода.

POST businesses/{businessId}/goods-feedback

Параметр orderId (идентификатор заказа на Маркете) стал необязательным.

25 ноября

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

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

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

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

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

POST reports/united-orders/generate

POST reports/united-netting/generate

POST 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 campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods

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

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

19 ноября

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

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

POST campaigns/{campaignId}/offers/stocks

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

Request

18 ноября

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

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

POST campaigns/{campaignId}/outlets

PUT campaigns/{campaignId}/outlets/{outletId}

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

  • datediff-is-to-big-local — при доставке по своему региону разница между максимальным и минимальным сроком доставки не должна превышать двух дней;

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

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

15 ноября

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

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

POST businesses/{businessId}/bids/recommendations

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

POST 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 businesses/{businessId}/offer-cards

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

  • PICTURE_COUNT

  • VIDEO_COUNT

  • MAIN

  • ADDITIONAL

  • DISTINCTIVE

13 ноября

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

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

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

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

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

8 ноября

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

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

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

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

POST reports/documents/labels/generate.

Добавили формат размещения ярлыков на странице — A9.

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

6 ноября

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

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

POST campaigns/{campaignId}/stats/orders

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

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

2 ноября

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

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

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

Уточнили, что SKU товара не может состоять только из пробелов и символов табуляции.

1 ноября

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

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

Название характеристики товара Цвет изменилось на Цвет для фильтра.

18 октября

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

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

GET campaigns/{campaignId}/returns

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

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

  • С опцией Быстрый возврат денег за дешевый брак, когда товар остается у покупателя (fastReturn=true).

  • По заказу от бизнеса, если:

    • статус возврата STARTED_BY_USER или WAITING_FOR_DECISION;
    • возврат отменен до передачи товара.

17 октября

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

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

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

Рассказали о пагинации в запросах.

Лог запросов

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

POST campaigns/{campaignId}/stats/orders

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

16 октября

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

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

POST cart

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

15 октября

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

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

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

POST businesses/{businessId}/offer-mappings

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

14 октября

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

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

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

GET campaigns/{campaignId}/orders

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

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

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

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

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

PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes

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

POST campaigns/{campaignId}/orders/{orderId}/delivery/track

PUT campaigns/{campaignId}/orders/{orderId}/delivery/date

PUT campaigns/{campaignId}/orders/{orderId}/delivery/storage-limit

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

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

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

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

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

11 октября

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

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

POST reports/united-netting/generate

POST reports/united-marketplace-services/generate

Изменили максимальный период для параметров dateTimeTo и dateTo. Теперь он составляет 3 месяца.

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

Добавили тип ошибок LOCKED_DIMENSIONS — переданы габариты упаковки, которые нельзя изменить.

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

GET campaigns/{campaignId}/orders

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

POST order/accept

POST order/status

POST order/cancellation/notify

Удалили способы отгрузки MARKET_PARTNER_OUTLET и DROPOFF.

10 октября

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

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

POST reports/documents/labels/generate

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

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

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

9 октября

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

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

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

GET campaigns/{campaignId}/orders

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

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

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

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

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

8 октября

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

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

Авторизация

Добавили API-Key-токен и рассказали, как с помощью него настроить доступ только к определенным группам методов.

Описали, чем различаются способы авторизации.

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

GET campaigns/{campaignId}/orders

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

  • ULTIMA — премиум-товар;

  • SAFE_TAG — товар с защитной меткой;

  • TURBO — товар, который быстро раскупают.

GET campaigns/{campaignId}/orders

Добавили фильтрацию заказов по дате оформления — параметры fromDate и toDate.

GET campaigns/{campaignId}/returns

Каждому невыкупу стали присваивать свой идентификатор.

19 сентября

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

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

POST businesses/{businessId}/promos/offers

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

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

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

4 сентября

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

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

POST reports/goods-turnover/generate

Добавили параметр date — дата, за которую нужно рассчитать оборачиваемость.

29 августа

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

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

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

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

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

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

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

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

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

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

26 августа

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

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

GET campaigns/{campaignId}/orders

Добавили параметры page_token и limit для навигации по страницам результатов.

POST businesses/{businessId}/offer-cards

POST category/{categoryId}/parameters

Рассказали, что рекомендации по дополнению или замене контента не возвращаются для карточек, которые заполнены Маркетом или содержат бывшие в употреблении товары.

POST businesses/{businessId}/offer-cards

POST category/{categoryId}/parameters

Отметили устаревшими рекомендации HAS_VIDEO, FILTERABLE, HAS_DESCRIPTION и HAS_BARCODE.

21 августа

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

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

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

GET campaigns/{campaignId}/feeds/categories

Удалили устаревшие методы.

16 августа

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

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

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

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

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

15 августа

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

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

GET campaigns/{campaignId}/feedback/updates

Отметили метод устаревшим.

13 августа

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

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

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

Добавили тип ошибки INVALID_PICKER_URL — передана ссылка на изображение для миниатюры, которой нет в переданных ссылках на изображение товара.

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

Добавили параметр updatedAt — дата и время последнего обновления заказа.

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

Рассказали, как найти заказы, в которых Маркет перенес дату отгрузки.

12 августа

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

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

POST businesses/{businessId}/promos — показывает информацию об акциях Маркета;

POST businesses/{businessId}/promos/offers — показывает список товаров, которые участвуют или могут участвовать в акции;

POST businesses/{businessId}/promos/offers/update — добавляет товары в акцию или изменяет их цены;

POST businesses/{businessId}/promos/offers/delete — удаляет товары из акции.

Добавили методы работы с акциями.

Управление акциями

Рассказали, как управлять акциями.

POST reports/united-orders/generate

Добавили параметр promoId — идентификатор акции, товары из которой нужны в отчете.

9 августа

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

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

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

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

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

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

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

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

8 августа

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

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

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

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

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

5 августа

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

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

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

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

GET campaigns/{campaignId}/region

Отметили метод устаревшим. Вместо него используйте GET campaigns/{campaignId}/settings.

2 августа

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

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

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

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

GET campaigns/{campaignId}/orders

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

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

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

31 июля

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

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

POST campaigns/{campaignId}/orders/{orderId}/business-buyer

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

Методы стали доступны и для модели DBS.

POST businesses/{businessId}/offer-mappings

Добавили статус товара в магазине ARCHIVED — в архиве.

30 июля

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

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

POST businesses/{businessId}/goods-feedback — показывает все отзывы о товарах продавца;

POST businesses/{businessId}/goods-feedback/comments — показывает все комментарии к отзыву;

POST businesses/{businessId}/goods-feedback/comments/update — добавляет комментарий магазина или изменяет комментарий, который магазин оставлял ранее;

POST businesses/{businessId}/goods-feedback/skip-reaction — пропускает отзывы;

POST businesses/{businessId}/goods-feedback/comments/delete — удаляет комментарий магазина.

Добавили методы работы с отзывами о товарах.

Отзывы о товарах

Рассказали, как работать с отзывами о товарах.

POST reports/goods-feedback/generate

Добавили отчет по отзывам о товарах.

29 июля

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

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

GET regions/{regionId}/children

GET campaigns/{campaignId}/hidden-offers

GET campaigns

GET campaigns/{campaignId}/orders

GET models/{modelId}/offers

GET campaigns/by_login/{login}

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

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

24 июля

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

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

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

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

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

19 июля

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

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

Повысили верхнее значение для минимальной стоимости товара без скидки до 99% — параметр discountBase.

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

POST businesses/{businessId}/updateBusinessPrices/update

POST reports/competitors-position/generate

Добавили новую величину: если в столбце POSITION указано -1 — значит, в этот день не было заказов с товарами в указанной категории.

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

Уточнили, что метод доступен только продавцам, устанавливающим цены в рублях.

POST campaigns/{campaignId}/offers/delete

Дополнили причины, по которым не получается удалить товары: они не найдены или хранятся на складе Маркета.

POST cart

Отметили устаревшим параметр subsidy.

11 июля

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

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

DELETE campaigns/{campaignId}/hidden-offers

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

9 июля

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

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

POST campaigns/{campaignId}/offers/update

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

POST order/accept

POST order/status

POST order/cancellation/notify

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

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

8 июля

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

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

POST businesses/{businessId}/ratings/quality — показывает значение индекса качества магазинов и его составляющие;

POST campaigns/{campaignId}/ratings/quality/details — возвращает список заказов, которые повлияли на индекс качества магазина.

Добавили методы работы с индексом качества.

5 июля

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

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

POST businesses/{businessId}/settings

Добавили параметр currency — валюта в кабинете продавца на Маркете.

GET campaigns/{campaignId}/orders

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

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

Отметили устаревшим параметр buyerTotalBeforeDiscount.

4 июля

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

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

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

Параметры dateFrom и dateTo стали обязательными.

GET campaigns/{campaignId}/orders

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

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

POST order/accept

POST order/status

POST order/cancellation/notify

Удалили устаревший параметр status.

3 июля

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

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

POST campaigns/{campaignId}/stats/orders

Добавили услугу ILLIQUID_GOODS_SALE — вознаграждение за продажу невывезенных товаров.

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

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

GET campaigns/{campaignId}/orders

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

Добавили подстатус заказа TECHNICAL_ERROR — техническая ошибка на стороне Маркета.

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

Теперь можно передавать до 30 ссылок на изображения товара.

28 июня

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

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

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

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

27 июня

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

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

POST categories/max-sale-quantum

Добавили новый метод. Он возвращает лимит на установку кванта и минимального количества товаров в заказе.

26 июня

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

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

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

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

24 июня

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

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

GET campaigns/{campaignId}/orders

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

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

Отметили устаревшими параметры priceBeforeDiscount, buyerItemsTotal и buyerTotal.

21 июня

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

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

GET reports/info/{reportId}

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

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

20 июня

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

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

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

Изменили формат параметра ShopSku. Теперь это может быть любая последовательность длиной до 255 знаков.

18 июня

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

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

GET campaigns/{campaignId}/orders

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

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

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

13 июня

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

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

POST campaigns/{campaignId}/stats/orders

GET campaigns/{campaignId}/orders

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

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

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

11 июня

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

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

POST reports/documents/labels/generate

Добавили новый метод. Он запускает генерацию PDF-файла с ярлыками для нескольких заказов.

6 июня

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

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

Обработка заказов с цифровыми товарами

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

5 июня

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

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

POST businesses/{businessId}/offer-mappings/update — при добавлении товаров в каталог передает их цены, категории на Маркете и характеристики, необходимые для этих категорий;

POST businesses/{businessId}/offer-mappings — возвращает категории товаров на Маркете и их характеристики;

POST businesses/{businessId}/offer-cards — возвращает переданные характеристики товаров.

Обновили работу с категориями Маркета и характеристиками товаров, которые необходимы для этих категорий.

PUT campaigns/{campaignId}/outlets/{outletId}

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

Добавили описание ошибки Outlet is disabled for editing by partner — нельзя изменить информацию или удалить точку продажи магазина.

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

POST businesses/{businessId}/offer-mappings

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

4 июня

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

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

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

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

GET campaigns/{campaignId}/orders

Удалили устаревшие параметры total, subsidyTotal и totalWithSubsidy.

3 июня

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

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

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

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

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

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

  • CATEGORY_MISMATCH — указана категория, которая не совпадает с категорией товара;

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

  • INVALID_GROUP_ID_CHARACTERS — переданы недопустимые символы.

31 мая

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

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

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

Добавили описание ошибки EMPTY_MARKET_CATEGORY — не указана категория Маркета при передаче характеристик категории.

29 мая

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

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

POST businesses/{businessId}/offer-mappings

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

POST businesses/{businessId}/offer-cards

Добавили параметр parameterValues — список характеристик с их значениями.

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

Добавили параметр basicPrice — цена на товар.

27 мая

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

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

POST businesses/{businessId}/settings

Добавили новый метод. Он возвращает информацию о настройках кабинета.

GET campaigns/{campaignId}/returns

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

Добавили параметр fastReturn — используется ли опция Быстрый возврат денег за дешевый брак.

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

Рассказали, когда надо передавать параметр realDeliveryDate.

24 мая

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

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

Создать приложение

Рассказали, что токен нужно будет получать снова, если пользователь, который его создал, выйдет со всех устройств в аккаунте Яндекса.

POST reports/competitors-position/generate

Добавили отчет «Конкурентная позиция».

23 мая

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

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

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

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

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

  • INVALID_GROUP_ID_CHARACTERS — переданы недопустимые символы.

22 мая

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

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

GET campaigns/{campaignId}/returns

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

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

21 мая

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

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

POST campaigns/{campaignId}/stats/skus

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

  • CANCELLED_ORDER_FEE_QI — отмена заказа по вине продавца;

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

20 мая

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

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

POST campaigns/{campaignId}/orders/{orderId}/business-buyer

Добавили PROCESSING к списку статусов заказа, в которых можно получить информацию о покупателе — юридическом лице.

17 мая

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

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

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

Удалили устаревший параметр marketSku.

16 мая

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

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

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

GET campaigns/{campaignId}/offer-prices

Удалили устаревший параметр feed.

14 мая

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

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

POST reports/shelf-statistics/generate

Добавили сводный отчет по полкам.

POST categories/tree

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

13 мая

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

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

POST order/status

POST order/accept

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

8 мая

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

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

POST campaigns/{campaignId}/offers/stocks

Доработали метод для модели FBY — теперь по нему передается информация по оборачиваемости товаров по каждому складу отдельно, а не общее значение по всем складам.

POST tariffs/calculate

Добавили параметр для расчета стоимости услуг quantity — квант продажи.

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

Добавили:

  • параметр parameterValues — список характеристик с их значениями;
  • ошибки и предупреждения, которые касаются переданных характеристик.

3 мая

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

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

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

POST businesses/{businessId}/offer-mappings

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

24 апреля

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

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

POST campaigns/{campaignId}/offers/stocks

Метода стал доступен для моделей DBS и Экспресс.

GET campaigns/{campaignId}/offer-prices

Отметили метод устаревшим. Вместо него используйте POST campaigns/{campaignId}/offer-prices.

23 апреля

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

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

POST businesses/{businessId}/chats/history

В ответе добавили параметр orderId — идентификатор заказа.

19 апреля

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

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

GET campaigns/{campaignId}/returns

Указали максимальное количество идентификаторов заказов (параметр orderIds) — 50.

POST campaigns/{campaignId}/offers/update

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

GET campaigns/{campaignId}/orders

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

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

POST order/accept

POST order/status

POST order/cancellation/notify

Указали неактуальные типы скидки — параметр type.

Отметили устаревшим параметр status.

POST cart

Указали неактуальные типы скидки — параметр type.

18 апреля

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

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

Передача остатков через API

Рассказали, как можно проверить работоспособность интеграции по передаче остатков.

GET campaigns/{campaignId}/orders

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

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

Отметили устаревшим параметр price.

17 апреля

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

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

GET campaigns/{campaignId}/orders

Добавили фильтрацию заказов по типу покупателя — параметр buyerType.

16 апреля

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

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

POST businesses/{businessId}/chats

В ответе добавили параметр orderId — идентификатор заказа.

GET campaigns/{campaignId}/orders

Добавили фильтрацию по идентификаторам заказов — параметр orderIds.

11 апреля

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

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

POST campaigns/{campaignId}/stats/skus

Изменили лимит на количество товаров — 5 000 товаров в минуту, не более 500 товаров в одном запросе.

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

GET campaigns/{campaignId}/orders

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

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

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

Удалили устаревший параметр feedCategoryId.

10 апреля

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

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

POST reports/united-marketplace-services/generate

POST reports/united-netting/generate

Отметили устаревшими параметры dateTimeFrom и dateTimeTo. Вместо них используйте dateFrom и dateTo.

9 апреля

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

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

POST cart

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

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

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

POST category/{categoryId}/parameters

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

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

4 апреля

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

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

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

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

3 апреля

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

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

GET businesses/{businessId}/warehouses

GET warehouses

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

2 апреля

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

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

POST tariffs/calculate

Добавили параметр parameters — детали расчета конкретной услуги Маркета.

1 апреля

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

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

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

Увеличили до 6 максимальное количество ссылок на видео товара — параметр videos.

29 марта

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

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

POST reports/documents/shipment-list/generate

Добавили лист сборки для отгрузки.

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

Рассказали, как генерировать лист сборки.

PUT campaigns/{campaignId}/offers/stocks

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

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

Удалили параметр warehouseId. Идентификатор склада будет определяться по campaignId.

Удалили параметр type. Единственно возможное значение FIT будет передаваться автоматически.

22 марта

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

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

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

GET campaigns/{campaignId}/orders

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

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

POST campaigns/{campaignId}/stats/skus

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

15 марта

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

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

POST categories/tree

Добавили новый метод. Он возвращает дерево категорий Маркета.

POST tariffs/calculate

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

POST reports/boost-consolidated/generate

Добавили отчет по бусту продаж.

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

GET campaigns/{campaignId}/orders

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

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

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

Отметили устаревшим параметр feedCategoryId.

14 марта

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-mappings/update

POST businesses/{businessId}/offer-mappings

Добавили параметр manuals — список инструкций по использованию товара.

13 марта

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/hidden-offers

DELETE campaigns/{campaignId}/hidden-offers

Изменили лимиты на количество товаров — 5 000 товаров в минуту, не более 500 товаров в одном запросе.

POST cart

Увеличили максимальное количество дат в параметре dates до 7.

12 марта

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/skus

Удалили услуги CANCELLED_ORDER_FEE и LATE_ORDER_EXECUTION_FEE.

8 марта

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/skus

Добавили услуги:

  • 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 марта

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-mappings/update

Добавили значение NOT_SPECIFIED (не выбран) для параметров:

  • type — тип уценки;

  • quality — внешний вид товара.

5 марта

Методы или страницы документации

Описание изменений

POST reports/goods-turnover/generate

POST reports/prices/generate

Теперь доступны два формата отчета:

  • FILE — электронная таблица;
  • CSV — ZIP-архив с CSV-файлами.

4 марта

Методы или страницы документации

Описание изменений

POST reports/stocks-on-warehouses/generate

Добавили фильтры по категориям на Маркете и по наличию остатков для всех моделей кроме FBY.

1 марта

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Удалили статус заказа REJECTED.

29 февраля

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/outlets

PUT campaigns/{campaignId}/outlets/{outletId}

GET campaigns/{campaignId}/outlets

GET campaigns/{campaignId}/outlets/{outletId}

Удалили параметр emails.

POST campaigns/{campaignId}/stats/skus

Добавили услуги:

  • CROSSREGIONAL_DELIVERY_RETURN — доставка невыкупов и возвратов;

  • MIDDLE_MILE — средняя миля;

  • LATE_ORDER_EXECUTION_FEE — отгрузка или доставка не вовремя;

  • RETURN_PROCESSING — обработка невыкупов и возвратов.

27 февраля

Методы или страницы документации

Описание изменений

POST reports/united-netting/generate

POST reports/goods-realization/generate

POST reports/goods-movement/generate

POST reports/shows-sales/generate

Теперь доступны два формата отчета:

  • FILE — электронная таблица;
  • CSV — ZIP-архив с CSV-файлами.

26 февраля

Методы или страницы документации

Описание изменений

GET businesses/{businessId}/warehouses

Добавили параметр express — возможна ли доставка по модели Экспресс.

22 февраля

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Добавили тип оплаты SPLIT — оплата картой по частям (Сплит).

15 февраля

Методы или страницы документации

Описание изменений

POST reports/stocks-on-warehouses/generate

Теперь доступны два формата отчета:

  • FILE — электронная таблица;
  • CSV — ZIP-архив с CSV-файлами.

14 февраля

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/orders/{orderId}/documents

Теперь кроме УПД возвращается информация о других документах:

  • УКД;
  • товарной накладной;
  • счете-фактуре;
  • корректировочном счете-фактуре.

GET businesses/{businessId}/warehouses

GET warehouses

В ответе добавили параметр address — адрес склада.

12 февраля

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-cards

Изменили лимит на количество запросов — 600 запросов в минуту, не более 200 товаров в одном запросе.

8 февраля

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Добавили услугу для FBY-магазинов RETURN_PROCESSING — обработка заказов на складе.

GET campaigns/{campaignId}/orders

GET campaigns/{campaignId}/orders/{orderId}

Отметили устаревшим параметр phone.

Чтобы получить номер телефона покупателя, используйте метод GET campaigns/{campaignId}/orders/{orderId}/buyer.

7 февраля

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/outlets

PUT campaigns/{campaignId}/outlets/{outletId}

GET campaigns/{campaignId}/outlets

GET campaigns/{campaignId}/outlets/{outletId}

Удалили параметр cost.

GET campaigns/{campaignId}/orders/{orderId}

PUT campaigns/{campaignId}/orders/{orderId}/status

GET campaigns/{campaignId}/orders

POST cancellation/notify

Параметр email (адрес электронной почты покупателя) больше не возвращается в ответах.

2 февраля

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/orders/{orderId}/delivery/labels/data

В ответе добавили параметр boxId — идентификатор коробки.

1 февраля

Методы или страницы документации

Описание изменений

POST reports/united-orders/generate

POST reports/united-marketplace-services/generate

Теперь доступны два формата отчета:

  • FILE — электронная таблица;
  • CSV — ZIP-архив с CSV-файлами.

PUT campaigns/{campaignId}/orders/{orderId}/status

GET campaigns/{campaignId}/orders

GET campaigns/{campaignId}/orders/{orderId}

Удалили параметр feedId.

Отметили устаревшим параметр shopSku. Вместо него используйте offerId.

PUT campaigns/{campaignId}/orders/{orderId}/identifiers

Удалили параметр feedId.

31 января

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/outlets

PUT campaigns/{campaignId}/outlets/{outletId}

DELETE campaigns/{campaignId}/outlets/{outletId}

GET campaigns/{campaignId}/outlets

GET campaigns/{campaignId}/outlets/{outletId}

Стали необязательными параметрами:

  • name — название точки продаж;

  • phones — номера телефонов точки продаж;

  • address — адрес точки продаж;

  • regionId — идентификатор региона;

  • workingSchedule — список режимов работы точки продаж;

  • scheduleItems — список расписаний работы точки продаж;

  • startDay — день недели, в который точка продаж начинает работать;

  • endDay — день недели, в который точка продаж заканчивает работать;

  • startTime — время начала работы точки продаж;

  • endTime — время окончания работы точки продаж;

  • cost — стоимость самовывоза из точки продаж;

  • type — тип точки продаж.

30 января

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/orders/{orderId}/delivery/labels

GET campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label

Указали размеры ярлыков, которые возвращаются в PDF-файле.

29 января

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/hidden-offers

POST campaigns/{campaignId}/hidden-offers

DELETE campaigns/{campaignId}/hidden-offers

Удалили параметры ttlInHours и feedId.

25 января

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/hidden-offers

POST campaigns/{campaignId}/hidden-offers

DELETE campaigns/{campaignId}/hidden-offers

Удалили параметр marketSku.

22 января

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/hidden-offers

Удалили устаревший параметр total.

PUT campaigns/{campaignId}/orders/{orderId}/status

GET campaigns/{campaignId}/orders/{orderId}

GET campaigns/{campaignId}/orders

Отметили устаревшими параметры total, subsidyTotal и totalWithSubsidy.

18 января

Методы или страницы документации

Описание изменений

Методы, где передается название товара.

Увеличили максимальное количество символов в названии товара до 256.

GET campaigns/{campaignId}/hidden-offers

POST campaigns/{campaignId}/hidden-offers

DELETE campaigns/{campaignId}/hidden-offers

Удалили устаревшие параметры comment и priority.

17 января

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/hidden-offers

Удалили устаревший параметр feed_id.

10 января

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/offer-prices/updates

Изменили лимит на количество товаров — 5 000 товаров в минуту, не более 500 товаров в одном запросе.

9 января

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/orders/{orderId}/business-buyer

Добавили возможность получить информацию о покупателе — юридическом лице.

POST campaigns/{campaignId}/orders/{orderId}/documents

Добавили возможность получить информацию об УПД.

Обработка заказов от юридических лиц

Добавили пошаговую инструкцию по работе с заказами от юридических лиц.

2023

29 декабря

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Теперь метод называется Детальная информация по заказам.

POST reports/united-orders/generate

Добавили отчет по заказам.

PUT campaigns/{campaignId}/offers/stocks

С 1 марта 2024 года изменится лимит на количество запросов в методе — 100 000 товаров в минуту, не более 500 товаров в одном запросе.

26 декабря

Методы или страницы документации

Описание изменений

API Яндекс Маркета для продавцов

Рассказали про компоненты API Маркета: pull-компонент (магазин отправляет запросы Маркету) и push-компонент (Маркет отправляет запросы магазину), а также о том, как настроить интеграцию.

Обработка FBS-заказов

Добавили пошаговую инструкцию по обработке заказов для модели FBS.

POST reports/goods-turnover/generate

Добавили отчет по оборачиваемости.

PUT campaigns/{campaignId}/orders/{orderId}/boxes

Добавили новый метод. Он передает раскладку по коробкам и коды маркировки, а также изменяет состав заказа.

PUT campaigns/{campaignId}/orders/{orderId}/identifiers

PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes

PUT campaigns/{campaignId}/orders/{orderId}/items

Отметили методы устравшими для модели FBS. Вместо них используйте PUT campaigns/{campaignId}/orders/{orderId}/boxes.

25 декабря

Методы или страницы документации

Описание изменений

Управление товарами в архиве

Рассказали, как управлять товарами в архиве.

POST campaigns/{campaignId}/stats/orders

Добавили услугу INTAKE_SORTING — организация забора заказов со склада продавца.

22 декабря

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/chats/new — создает чат;

POST businesses/{businessId}/chats/message — отправляет сообщение в чат;

POST businesses/{businessId}/chats/file/send — отправляет файл в чат;

POST businesses/{businessId}/chats — возвращает список чатов;

POST businesses/{businessId}/chats/history — возвращает историю сообщений.

Добавили методы для общения с покупателями в чатах.

Чаты с покупателями

Добавили пошаговую инструкцию по работе с чатами.

PUT campaigns/{campaignId}/orders/{orderId}/verifyEac

Изменили лимит на количество запросов — 1 000 000 запросов в час.

POST campaigns/{campaignId}/offers

Изменили лимит на количеств товаров — 5 000 товаров в минуту, не более 200 товаров в одном запросе.

PUT campaigns/{campaignId}/offers/stocks

Изменили лимит на количеств товаров — 100 000 товаров в минуту.

8 декабря

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offers/recommendations

Добавили параметр shows, где указано количество показов карточки товара за последние 7 дней.

6 декабря

Методы или страницы документации

Описание изменений

Как изменить цены на товары

Рассказали, как изменить цены в конкретном магазине.

5 декабря

Методы или страницы документации

Описание изменений

Работа с бустом продаж

Добавили пошаговую инструкцию по работе с бустом продаж.

27 ноября

Методы или страницы документации

Описание изменений

Запуск интеграции на JavaScript

Добавили пошаговую инструкцию по запуску интеграции на JavaScript.

23 ноября

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/orders/{orderId}

GET campaigns/{campaignId}/orders

Добавили методы для получения заказов по модели FBY.

20 ноября

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-mappings

POST campaigns/{campaignId}/offers/stocks

Добавили фильтрацию по нахождению товаров в архиве.

15 ноября

Методы или страницы документации

Описание изменений

Методы, где передается SKU.

Теперь в идентификаторе товара в магазине (SKU) можно использовать букву ё.

14 ноября

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-mappings/archive — помещает товары в архив;

POST businesses/{businessId}/offer-mappings/unarchive — восстанавливает товары из архива.

Добавили методы работы с архивом.

8 ноября

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/hidden-offers

DELETE campaigns/{campaignId}/hidden-offers

Изменили лимит на количество товаров — 1 000 товаров в минуту, не более 500 товаров в одном запросе.

23 октября

Методы или страницы документации

Описание изменений

GET regions

Увеличили количество регионов в ответе на одной странице до 20 — параметр limit.

Добавили возможность указать идентификатор страницы c результатами — параметр page_token.

19 октября

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/orders

Добавили фильтрацию по дате и времени обновления заказа.

POST businesses/{businessId}/offers/recommendations

Добавили параметр price — цена на товар в каталоге.

18 октября

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/orders/{orderId}

PUT campaigns/{campaignId}/orders/{orderId}/status

GET campaigns/{campaignId}/orders

Добавили способ оплаты заказа B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

14 октября

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/skus

Уточнили, что параметр warehouses не будет возвращаться, если товара нет ни на одном складе.

5 октября

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Добавили статусы:

  • PARTIALLY_DELIVERED — заказ частично доставлен;
  • LOST — заказ утерян.

3 октября

Методы или страницы документации

Описание изменений

POST reports/shows-sales/generate

Добавили отчет «Аналитика продаж».

Методы работы с заказами с внешних площадок.

Удалили методы.

29 сентября

Методы или страницы документации

Описание изменений

GET campaigns

GET campaigns/by_login/{login}

Методы больше не работают для модели ADV.

POST campaigns/{campaignId}/offers/stocks

Добавили новый метод. Он возвращает информацию по остаткам товаров на витрине (для моделей FBY, FBS и Экспресс) и об оборачиваемости товаров (для модели FBY).

Акт приема-передачи

Фактический акт приема-передачи

Акт расхождений

Транспортная накладная

Добавили методы для получения документов по отгрузкам (FBS).

PUT campaigns/{campaignId}/orders/{orderId}/identifiers

GET campaigns/{campaignId}/orders/{orderId}

GET campaigns/{campaignId}/orders

Добавили параметры:

  • rnpt — регистрационный номер партии товара;
  • gtd — номер грузовой таможенной декларации.

28 сентября

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-cards/update — передает категорийные характеристики товаров;

POST businesses/{businessId}/offer-cards — показывает статусы и степень заполненности карточек;

POST category/{categoryId}/parameters — возвращает список характеристик с допустимыми значениями для заданной категории.

Теперь через API можно управлять контентом на карточках товаров.

PUT campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets

Добавили новый метод. Он передает количество упаковок в отгрузке.

GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallet/labels

Добавили новый метод. Он возвращает ярлыки для упаковок в отгрузке.

27 сентября

Методы или страницы документации

Описание изменений

POST reports/prices/generate

Добавили отчет «Цены на рынке».

25 сентября

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/price-quarantine

Добавили параметр verdicts — причины попадания товара в карантин, где type — это тип карантина, а params — цена, из-за которой товар попал в карантин, и значения для сравнения.

POST campaigns/{campaignId}/price-quarantine

Отметили устаревшими параметры currentPrice и lastValidPrice. Вместо них используйте params.

15 сентября

Методы или страницы документации

Описание изменений

POST reports/stocks-on-warehouses/generate

Добавили отчет по остаткам на складах Маркета (FBY).

14 сентября

Методы или страницы документации

Описание изменений

GET warehouses

Добавили новый метод. Он возвращает список складов Маркета (FBY) с их идентификаторами.

8 сентября

Методы или страницы документации

Описание изменений

GET reports/info/{reportId}

Добавили подстатус TOO_LARGE — отчет превысил допустимый размер.

7 сентября

Методы или страницы документации

Описание изменений

POST reports/stocks-on-warehouses/generate

Добавили отчет по остаткам на складах магазина (FBS).

5 сентября

Методы или страницы документации

Описание изменений

POST reports/goods-movement/generate

Добавили отчет по движению товаров.

4 сентября

Методы или страницы документации

Описание изменений

Все методы.

Теперь в ответе 400 Bad Request возвращаем название поля, в котором есть ошибка.

31 августа

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/skus

Удалили параметр storage.

29 августа

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}

Удалили неактуальные статусы отгрузки.

28 августа

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-mappings

Теперь можно не включать пустое тело в запрос.

Не передавайте его, если хотите получить список всех товаров в каталоге.

24 августа

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/orders/status-update

Установили ограничение на максимальное количество заказов, у которых можно изменить статус в одном запросе, — 30.

23 августа

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Удалили параметр predicted.

15 августа

Методы или страницы документации

Описание изменений

POST cart

POST order/accept

POST order/status

POST order/cancellation/notify

В address добавили параметр district — район в адресе доставки заказа.

12 августа

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/orders

GET campaigns/{campaignId}/orders/{orderId}

PUT campaigns/{campaignId}/orders/{orderId}/status

В OrderDeliveryAddressDTO добавили параметр district — район в адресе доставки заказа.

8 августа

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-mappings

Теперь на одной странице можно передать не более 200 значений, если запрос выполняется по конкретным товарам.

POST campaigns/{campaignId}/stats/skus

Удалили типы остатков товаров SUGGEST и TRANSIT.

4 августа

Методы или страницы документации

Описание изменений

POST reports/goods-realization/generate

Добавили отчет по реализации.

POST reports/united-marketplace-services/generate

Добавили отчет по стоимости услуг.

POST reports/united-netting/generate

Добавили отчет по платежам.

1 августа

Методы или страницы документации

Описание изменений

PUT campaigns/{campaignId}/offers/stocks

POST stocks

Теперь нужно передавать количество доступного товара на складе без учета резерва.

27 июля

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Теперь можно узнать:

  • порог для скидок с Маркетом на момент оформления заказа — параметр cofinanceThreshold;
  • скидку с Маркетом — параметр cofinanceValue.

26 июля

Методы или страницы документации

Описание изменений

POST campaigns/{campaignId}/stats/orders

Добавили информацию о стоимости услуг:

  • AGENCY — прием платежа покупателя;
  • AUCTION_PROMOTION — буст продаж;
  • DELIVERY_TO_CUSTOMER — доставка покупателю;
  • EXPRESS_DELIVERY_TO_CUSTOMER — экспресс-доставка покупателю;
  • FEE — размещение товара на Маркете;
  • FULFILLMENT — складская обработка;
  • INSTALLMENT — рассрочка;
  • LOYALTY_PARTICIPATION_FEE — участие в программе лояльности и отзывы за баллы, если они подключены;
  • PAYMENT_TRANSFER — перевод платежа покупателя;
  • RETURNED_ORDERS_STORAGE — хранение невыкупов и возвратов;
  • SORTING — обработка заказа.

20 июля

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/bids/recommendations

Добавили новый метод. Он показывает рекомендованные ставки.

19 июля

Методы или страницы документации

Описание изменений

GET businesses/{businessId}/warehouses

Добавили новый метод. Он показывает список складов и групп складов.

13 июля

Методы или страницы документации

Описание изменений

Изменили формат авторизационного токена — вместо 21 знака теперь в нем 48 знаков. Вы можете обновить токен прямо сейчас, чтобы усилить защиту своей интеграции.

Страница Автоматическое обновление OAuth-токена.

Рассказали, как автоматически обновлять OAuth-токен через API сервиса Яндекс ID.

POST businesses/{businessId}/bids/info

Добавили новый метод. Он показывает значения ставок для заданных товаров.

POST campaigns/{campaignId}/orders/status-update

Теперь можно не передавать этапы обработки заказа или причины его отмены — параметр substatus в orders стал необязательным.

7 июля

Методы или страницы документации

Описание изменений

POST businesses/{businessId}/offer-mappings/update

Дополнили инструкцию по добавлению нового товара — перечислили параметры, без которых добавить товар в каталог не получится.

4 июля

Методы или страницы документации

Описание изменений

GET campaigns

GET campaigns/{campaignId}

GET campaigns/by_login/{login}

Теперь можно узнать:

  • идентификатор бизнеса — параметр id в business;
  • название бизнеса — параметр name в business.

3 июля

Методы или страницы документации

Описание изменений

GET campaigns

GET campaigns/{campaignId}

GET campaigns/by_login/{login}

Теперь можно узнать модель, по которой работает магазин, — параметр placementType.

30 июня

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/orders/{orderId}

GET campaigns/{campaignId}/orders

Добавили параметр priceBeforeDiscount, где указана стоимость товара в валюте магазина до применения скидок.

22 июня

Методы или страницы документации

Описание изменений

Добавление товаров

Изменение цен

Большое обновление: расширили возможности API для работы с каталогом.

Теперь можно:

  • работать с общими данными о товарах в кабинете и управлять размещением в отдельных магазинах;
  • устанавливать основную цену;
  • проверять товары, которые находятся в карантине;
  • удалять товары из кабинета и магазина.

POST campaigns/{campaignId}/offer-mapping-entries/suggestions

POST campaigns/{campaignId}/offer-mapping-entries/updates

GET campaigns/{campaignId}/offer-mapping-entries

GET campaigns/{campaignId}/offers

GET campaigns/{campaignId}/offers/all

GET campaigns/{campaignId}/feeds

GET campaigns/{campaignId}/feeds/{feedId}

GET campaigns/{campaignId}/feeds/{feedId}/index-logs

POST campaigns/{campaignId}/feeds/{feedId}/params

POST campaigns/{campaignId}/feeds/{feedId}/refresh

Отметили методы устаревшими.

21 июня

Методы или страницы документации

Описание изменений

Опубликовали спецификацию OpenAPI для продавцов. Она поможет:

  • быстрее написать собственную интеграцию с Маркетом и настроить ее методы под себя;
  • сгенерировать файлы клиента на любом языке или фреймворке, которые поддерживает OpenAPI-генератор;
  • найти нужный метод и варианты его параметров с минимальным обращением к документации.

Спецификация OpenAPI для запросов магазина к Маркету доступна на GitHub.

30 мая

Методы или страницы документации

Описание изменений

PUT campaigns/{campaignId}/orders/{orderId}/identifiers

Добавили новый метод. Он передает Маркету коды маркировки «Честного знака» и УИН для ювелирных изделий.

PUT campaigns/{campaignId}/orders/{orderId}/cancellation/accept

Добавили причину отмены ORDER_IN_DELIVERY.

Теперь вы можете отказать покупателю в отмене, если заказ уже находится у курьера.

PUT campaigns/{campaignId}/orders/{orderId}/cis

Отметили метод устаревшим. Вместо него используйте PUT campaigns/{campaignId}/orders/{orderId}/identifiers

26 мая

Методы или страницы документации

Описание изменений

GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}

Теперь можно узнать:

  • можно ли указать число палет — параметр CHANGE_PALLETS_COUNT;
  • Количество палет, которое указано в заявке и которое приняли в сортировочном центре, — параметр PalletsCount.

14 апреля

Методы или страницы документации

Описание изменений

Методы, в которых лимиты вычисляются по формуле.

Изменили лимиты на количество запросов — указываем точное количество запросов в час. Так вам будет легче планировать интеграции, а Маркету — нагрузку.

Обработка заказов с цифровыми товарами

Рассказали, как работать с цифровыми товарами.

29 марта

Методы или страницы документации

Описание изменений

PUT businesses/{businessId}/bids — создает кампанию, добавляет в нее товары, назначает или изменяет ставки.

Добавили новый метод. Он помогает управлять бустом продаж.

17 марта

Методы или страницы документации

Описание изменений

Документация API Маркета для продавцов.

Редизайн документации:

  • собрали вместе инструкции для разных моделей;
  • осовременили внешний вид;
  • добавили пошаговые инструкции для частых сценариев.

Как пользоваться консолью

Запустили консоль — интерфейс тестирования запросов.