История обновлений API

20242024

19 апреля19 апреля

В методе GET campaigns/{campaignId}/returns указали максимальное количество идентификаторов заказов (параметр orderIds) — 50.

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

Указали неактуальные типы скидки (параметр type) в методах:

• POST cart;
• POST order/accept;
• POST order/status;
• POST order/cancellation/notify;
• GET campaigns/{campaignId}/orders;
• GET campaigns/{campaignId}/orders/{orderId};
• PUT campaigns/{campaignId}/orders/{orderId}/status.

Параметр status устарел в методах:

• POST order/accept;
• POST order/status;
• POST order/cancellation/notify;
• GET campaigns/{campaignId}/orders;
• GET campaigns/{campaignId}/orders/{orderId};
• PUT campaigns/{campaignId}/orders/{orderId}/status.

18 апреля18 апреля

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

Параметр price устарел в методах:

• GET campaigns/{campaignId}/orders;
• GET campaigns/{campaignId}/orders/{orderId};
• PUT campaigns/{campaignId}/orders/{orderId}/status.

17 апреля17 апреля

В методе GET campaigns/{campaignId}/orders добавили фильтрацию заказов по типу покупателя — параметр buyerType.

16 апреля16 апреля

В ответе на запрос POST businesses/{businessId}/chats теперь возвращается параметр orderId — идентификатор заказа.

В методе GET campaigns/{campaignId}/orders добавили фильтрацию по идентификаторам заказов — параметр orderIds.

11 апреля11 апреля

Изменили лимит на количество запросов в методе POST campaigns/{campaignId}/stats/skus — 5000 товаров в минуту, не более 500 товаров в одном запросе.

Убрали устаревший параметр feedCategoryId в методах:

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

10 апреля10 апреля

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

9 апреля9 апреля

В методе POST category/{categoryId}/parameters теперь возвращается информация о допустимых единицах измерения — параметр units. Их вы можете указывать при заполнении карточек товаров — метод POST businesses/{businessId}/offer-cards/update.

Изменения в методе POST cart:

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

4 апреля4 апреля

В методе POST campaigns/{campaignId}/first-mile/shipments/{shipmentId}/confirm убрали параметр orderIds — список идентификаторов заказов в отгрузке.

3 апреля3 апреля

В методах GET businesses/{businessId}/warehouses и GET warehouses убрали параметр additional — дополнительная информация.

2 апреля2 апреля

В методе POST tariffs/calculate добавили параметр parameters — детали расчета конкретной услуги Маркета.

1 апреля1 апреля

В методе POST businesses/{businessId}/offer-mappings/update увеличили до 6 максимальное количество ссылок на видео товара (параметр videos).

29 марта29 марта

Добавили возможность получать лист сборки для отгрузки — POST reports/documents/shipment-list/generate. А также описали в пошаговой инструкции по обработке FBS-заказов, как его генерировать. Читать

Изменения в методе PUT campaigns/{campaignId}/offers/stocks:

• Сделали необязательным параметр updatedAt. Если его не передать, будет использоваться текущее время.
• Убрали параметр warehouseId. Идентификатор склада будет определяться по campaignId.
• Убрали параметр type. Единственно возможное значение FIT будет передаваться автоматически.

22 марта22 марта

Теперь возвращается адрес пункта выдачи (параметр address) в ответах на запросы:

• GET campaigns/{campaignId}/orders/{orderId};
• GET campaigns/{campaignId}/orders;
• PUT campaigns/{campaignId}/orders/{orderId}/status.

В методе POST campaigns/{campaignId}/stats/skus убрали услугу FULFILLMENT — обработка товара на складе Маркета.

15 марта15 марта

Добавили метод POST categories/tree, который возвращает дерево категорий Маркета.

Добавили метод POST tariffs/calculate, который рассчитывает стоимость услуг Маркета для товаров с заданными параметрами.

Добавили возможность получать отчет по бусту продаж — POST reports/boost-consolidated/generate.

Параметр feedCategoryId устарел в методах:

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

14 марта14 марта

В методе POST businesses/{businessId}/offer-mappings/update и в ответе на запрос POST businesses/{businessId}/offer-mappings добавили параметр manuals — cписок инструкций по использованию товара.

13 марта13 марта

Изменили лимит на количество запросов в методах POST campaigns/{campaignId}/hidden-offers и DELETE campaigns/{campaignId}/hidden-offers — 5000 товаров в минуту, не более 500 товаров в одном запросе.

В методе POST cart увеличили максимальное количество дат в параметре dates до 7.

12 марта12 марта

В методе POST campaigns/{campaignId}/stats/skus убрали услуги:

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

8 марта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 марта6 марта

В методе POST businesses/{businessId}/offer-mappings/update добавили значение NOT_SPECIFIED (не выбран) для параметров:

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

5 марта5 марта

В методах генерации отчета по оборачиваемости и в отчете «Цены на рынке» теперь доступны два формата отчета:

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

Теперь все отчеты доступы в формате FILE и CSV.

4 марта4 марта

В методе генерации отчета по остаткам на складах добавили фильтры по категориям на Маркете и по наличию остатков для всех моделей кроме FBY.

1 марта1 марта

В методе POST campaigns/{campaignId}/stats/orders убрали статус заказа REJECTED — заказ создан, но не оплачен.

29 февраля29 февраля

Убрали параметр emails (адрес электронной почты точки продаж) в методах:

• POST campaigns/{campaignId}/outlets;
• PUT campaigns/{campaignId}/outlets/{outletId};
• GET campaigns/{campaignId}/outlets;
• GET campaigns/{campaignId}/outlets/{outletId}.

В методе POST campaigns/{campaignId}/stats/skus добавили услуги:

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

27 февраля27 февраля

В методах генерации отчета по платежам, реализации, движению товаров и в отчете «Аналитика продаж» теперь доступны два формата отчета:

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

26 февраля26 февраля

В методе GET businesses/{businessId}/warehouses добавили параметр express — возможна ли доставка по модели Экспресс.

22 февраля22 февраля

В методе POST campaigns/{campaignId}/stats/orders добавили тип оплаты SPLIT — оплата картой по частям (Сплит).

15 февраля15 февраля

В методе генерации отчета по остаткам на складах теперь доступны два формата отчета:

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

14 февраля14 февраля

В ответе на запрос POST campaigns/{campaignId}/orders/{orderId}/documents теперь кроме УПД возвращается информация о других документах:

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

В ответах на запросы GET businesses/{businessId}/warehouses и GET warehouses теперь возвращается параметр address — адрес склада.

12 февраля12 февраля

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

8 февраля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 февраля7 февраля

Убрали параметр cost (стоимость самовывоза из точки продаж) в методах:

• POST campaigns/{campaignId}/outlets;
• PUT campaigns/{campaignId}/outlets/{outletId};
• GET campaigns/{campaignId}/outlets;
• GET campaigns/{campaignId}/outlets/{outletId}.

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

• POST cancellation/notify;
• GET campaigns/{campaignId}/orders/{orderId};
• PUT campaigns/{campaignId}/orders/{orderId}/status;
• GET campaigns/{campaignId}/orders.

2 февраля2 февраля

В ответе на запрос GET campaigns/{campaignId}/orders/{orderId}/delivery/labels/data теперь возвращается параметр boxId — идентификатор коробки.

1 февраля1 февраля

В методах генерации отчета по заказам и по стоимости услуг теперь доступны два формата отчета:

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

В методе PUT campaigns/{campaignId}/orders/{orderId}/identifiers убрали параметр feedId — идентификатор каталога товаров.

В методах PUT campaigns/{campaignId}/orders/{orderId}/status, GET campaigns/{campaignId}/orders и GET campaigns/{campaignId}/orders/{orderId}:

• Отметили параметр shopSku устаревшим. Используйте вместо него параметр offerId — идентификатор вашего товарного предложения для определенного товара.
• Убрали параметр feedId — идентификатор каталога товаров.

31 января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 января30 января

В методах GET campaigns/{campaignId}/orders/{orderId}/delivery/labels и GET campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes/{boxId}/label указали размеры ярлыков, которые возвращаются в PDF-файле.

29 января29 января

В методах GET campaigns/{campaignId}/hidden-offers, POST campaigns/{campaignId}/hidden-offers и DELETE campaigns/{campaignId}/hidden-offers убрали параметры:

• ttlInHours — количество часов до возобновления показа товара;
• feedId — идентификатор прайс-листа.

25 января25 января

В методах GET campaigns/{campaignId}/hidden-offers, POST campaigns/{campaignId}/hidden-offers, DELETE campaigns/{campaignId}/hidden-offers убрали параметр marketSku — SKU на Маркете.

22 января22 января

В методе GET campaigns/{campaignId}/hidden-offers убрали устаревший параметр total — общее количество скрытых товаров магазина.

В методах PUT campaigns/{campaignId}/orders/{orderId}/status, GET campaigns/{campaignId}/orders/{orderId} и GET campaigns/{campaignId}/orders теперь устаревшими параметрами являются:

• total — общая сумма заказа в валюте заказа с учетом стоимости доставки, но без учета вознаграждения партнеру за скидки по промокодам, купонам, кешбэку и акциям;
• subsidyTotal — общее вознаграждение партнеру за DBS-доставку и все скидки;
• totalWithSubsidy — сумма стоимости всех товаров в заказе и вознаграждения за них в валюте магазина.

18 января18 января

Увеличили максимальное количество символов в названии товара до 256.

В методах GET campaigns/{campaignId}/hidden-offers, POST campaigns/{campaignId}/hidden-offers, DELETE campaigns/{campaignId}/hidden-offers убрали устаревшие параметры:

• comment — комментарий магазина;
• priority — приоритет скрытия предложений через API над скрытием в кабинете.

17 января17 января

В методе GET campaigns/{campaignId}/hidden-offers убрали устаревший параметр feed_id — идентификатор прайс-листа.

10 января10 января

Изменили лимит на количество запросов в методe POST campaigns/{campaignId}/offer-prices/updates — 5000 товаров в минуту, не более 500 товаров в одном запросе.

9 января9 января

Добавили возможность получить информацию:

• о покупателе — юридическом лице — метод POST campaigns/{campaignId}/orders/{orderId}/business-buyer;
• об УПД — метод POST campaigns/{campaignId}/orders/{orderId}/documents.

Добавили пошаговую инструкцию по работе с заказами от юридических лиц. Читать

20232023

29 декабря29 декабря

Теперь метод POST campaigns/{campaignId}/stats/orders называется Детальная информация по заказам.

Добавили новый отчет по заказам — POST reports/united-orders/generate.

С 1 марта 2024 года изменится лимит на количество запросов в методе PUT campaigns/{campaignId}/offers/stocks — 100 000 товаров в минуту, не более 500 товаров в одном запросе.

26 декабря26 декабря

Рассказали про компоненты API Маркета: pull-компонент (магазин отправляет запросы Маркету) и push-компонент (Маркет отправляет запросы магазину), а также о том, как настроить интеграцию. Читать

Добавили пошаговую инструкцию по обработке заказов для модели FBS — читать, а также дополнительную инструкцию по обработке заказов с помощью push-компонента — читать.

Следующие методы теперь являются устаревшими для модели FBS:

• PUT campaigns/{campaignId}/orders/{orderId}/identifiers;
• PUT campaigns/{campaignId}/orders/{orderId}/delivery/shipments/{shipmentId}/boxes;
• PUT campaigns/{campaignId}/orders/{orderId}/items.

Вместо них используйте новый метод PUT campaigns/{campaignId}/orders/{orderId}/boxes, который передает раскладку по коробкам и коды маркировки, а также изменяет состав заказа.

Добавили возможность получать отчет по оборачиваемости — POST reports/goods-turnover/generate.

25 декабря25 декабря

В пошаговой инструкции Управление каталогом рассказали, как управлять товарами в архиве. Читать

В методе POST campaigns/{campaignId}/stats/orders добавили новую услугу — INTAKE_SORTING — организация забора заказов со склада продавца.

22 декабря22 декабря

Добавили методы для общения с покупателями в чатах:

• cоздание нового чата — 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 — 5000 товаров в минуту, не более 200 товаров в одном запросе;
• PUT campaigns/{campaignId}/offers/stocks — 100 000 товаров в минуту.

8 декабря8 декабря

В ответе на запрос POST businesses/{businessId}/offers/recommendations появилось поле shows, где указано количество показов карточки товара за последние 7 дней.

6 декабря6 декабря

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

5 декабря5 декабря

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

27 ноября27 ноября

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

23 ноября23 ноября

Добавили методы для получения заказов по модели FBY — GET campaigns/{campaignId}/orders/{orderId} и GET campaigns/{campaignId}/orders.

20 ноября20 ноября

В методах POST businesses/{businessId}/offer-mappings и POST campaigns/{campaignId}/offers/stocks добавили фильтрацию по нахождению товаров в архиве.

15 ноября15 ноября

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

14 ноября14 ноября

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

8 ноября8 ноября

В методах POST campaigns/{campaignId}/hidden-offers и DELETE campaigns/{campaignId}/hidden-offers изменили лимит. Теперь это точное количество товаров — 1000 товаров в минуту, но не более 500 товаров в одном запросе.

23 октября23 октября

В методе GET regions:

• увеличили количество регионов в ответе на одной странице до 20 — параметр limit;
• добавили возможность указать идентификатор страницы c результатами — параметр page_token.

19 октября19 октября

В методе GET campaigns/{campaignId}/orders добавили фильтрацию по дате и времени обновления заказа.

В методе POST businesses/{businessId}/offers/recommendations добавили параметр price — цена товара в каталоге.

18 октября18 октября

В методы GET campaigns/{campaignId}/orders/{orderId}, PUT campaigns/{campaignId}/orders/{orderId}/status и GET campaigns/{campaignId}/orders добавили способ оплаты заказа B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

14 октября14 октября

В методе POST campaigns/{campaignId}/stats/skus параметр warehouses не будет возвращаться, если товара нет ни на одном складе.

05 октября05 октября

В методе POST campaigns/{campaignId}/stats/orders добавили статусы:

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

03 октября03 октября

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

Добавили возможность получать отчет «Аналитика продаж» — POST reports/shows-sales/generate.

29 сентября29 сентября

Методы GET campaigns и GET campaigns/by_login/{login} больше не работают для модели ADV.

Добавили метод POST campaigns/{campaignId}/offers/stocks, который возвращает информацию по остаткам товаров на витрине (для моделей FBY, FBS и Экспресс) и об оборачиваемости товаров (для модели FBY).

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

• акт приема-передачи;
• фактический акт приема-передачи;
• акт о расхождениях;
• транспортная накладная.

Теперь в запросе PUT campaigns/{campaignId}/orders/{orderId}/identifiers можно передавать параметры:

• rnpt — регистрационный номер партии товара;
• gtd — номер грузовой таможенной декларации.

Значения этих параметров теперь возвращаются в методах GET campaigns/{campaignId}/orders/{orderId} и GET campaigns/{campaignId}/orders.

28 сентября28 сентября

Теперь через API можно управлять контентом на карточках товаров — передавать категорийные характеристики товаров с помощью запроса POST businesses/{businessId}/offer-cards/update. Метод POST businesses/{businessId}/offer-cards показывает статусы и степень заполненности карточек, а POST category/{categoryId}/parameters возвращает список характеристик с допустимыми значениями для заданной категории.

Добавили метод PUT campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets, который передает количество упаковок в отгрузке.

Добавили метод GET campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallet/labels, который возвращает ярлыки для упаковок в отгрузке.

27 сентября27 сентября

Добавили возможность получать отчет «Цены на рынке» — POST reports/prices/generate.

25 сентября25 сентября

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

15 сентября15 сентября

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

14 сентября14 сентября

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

8 сентября8 сентября

В методе GET reports/info/{reportId} добавили подстатус TOO_LARGE — отчет превысил допустимый размер.

7 сентября7 сентября

Добавили возможность получать отчет по остаткам на складах магазина (FBS) — POST reports/stocks-on-warehouses/generate.

5 сентября5 сентября

Добавили возможность получать отчет по движению товаров — POST reports/goods-movement/generate.