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

20242024

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.

Добавили возможность получать отчет по оборачиваемости — 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 — номер грузовой таможенной декларации.

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.