Обновления в API

Добавили

• Способ оплаты заказа BOUND_CARD_ON_DELIVERY (привязанной картой при получении) в методах:

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

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

— GET campaigns/{campaignId}/orders.

• Статус товара в магазине ARCHIVED (В архиве) в методе POST businesses/{businessId}/offer-mappings.

Изменили

Методы POST campaigns/{campaignId}/orders/{orderId}/business-buyer и POST campaigns/{campaignId}/orders/{orderId}/documents теперь доступны и для модели DBS.

Убрали

Устаревшие параметры id и shopSku из метода POST campaigns/{campaignId}/offer-prices/updates.

За всеми обновлениями в API можно следить в этом канале и на странице История обновлений API.

Обновления в API

Рассказали

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

• Как работать с отзывами о товарах. Инструкция в документации API Яндекс Маркета для продавцов

Добавили

• Верхнее ограничение для передачи номера страницы результатов — параметр page. Теперь нельзя указывать номер страницы больше 10 000 в методах:

- GET regions/{regionId}/children;

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

- GET campaigns;

- GET campaigns/by_login/{login};

- GET campaigns/{campaignId}/orders;

- GET models/{modelId}/offers.

• Методы работы с отзывами о товарах:

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

За всеми обновлениями в API можно следить в этом канале и на странице История обновлений API.

Работа с отзывами по API

Знаем, что многие из вас этого ждали — на Маркете появилась возможность работать с отзывами по API: получать отзывы о товарах, отвечать на них, редактировать свои ответы и удалять их, а также скачивать новый отчёт с аналитикой.

О том, как работать с отзывами через API, читайте в инструкции. А о том, как получить отчет, на странице Отчет по отзывам о товарах.

Обновления в API

Добавили

В отчете Конкурентная позиция теперь может отображаться новая величина: если в столбце POSITION указано \-1 — значит, в этот день не было заказов с товарами в указанной категории.

Изменили

— В методах POST businesses/{businessId}/offer-mappings/update и POST businesses/{businessId}/updateBusinessPrices/update повысили верхнее значение для минимальной стоимости товара без скидки до 99% — параметр discountBase.

— Параметр subsidy (общее вознаграждение партнеру за все скидки на товар) устарел в методе POST cart.

— Метод POST campaigns/{campaignId}/offer-prices/suggestions доступен только продавцам, устанавливающим цены в рублях.

— В ответе на запрос POST campaigns/{campaignId}/offers/delete дополнили причины, по которым не получается удалить товары: они не найдены или хранятся на складе Маркета.

За всеми обновлениями в API можно следить в этом канале и на странице История обновлений API.

Модуль для «Моего склада» перестанет работать 1 сентября

С осени мы остановим работу модуля для «Моего склада» — сейчас не можем гарантировать качественную интеграцию с помощью этого решения.

Понимаем, что переезд может быть хлопотным. Поэтому, если вы работаете с модулем и нужна помощь с выбором альтернативы, напишите нам — вместе подберём варианты.

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

Обновления в API

Изменили

— Метод DELETE campaigns/{campaignId}/hidden\-offers устарел. Вместо него используйте POST campaigns/{campaignId}/hidden-offers/delete с таким же контрактом.

— Параметр subsidy (общее вознаграждение партнеру за все скидки на товар) устарел в методах:
- POST order/accept;
- POST order/status;
- POST order/cancellation/notify.

Убрали

Верхнее ограничение для передачи минимального количества единиц товара в заказе (параметр minQuantity) в методе POST campaigns/{campaignId}/offers/update.

За всеми обновлениями в API можно следить в этом канале и на странице История обновлений API.

Обновления в API

Добавили

• Методы работы с индексом качества:

— POST businesses/{businessId}/ratings/quality — показывает значение индекса качества магазинов и его составляющие.

— POST campaigns/{campaignId}/ratings/quality/details — возвращает список заказов, которые повлияли на индекс качества магазина.

• Параметр currency (валюта в кабинете продавца на Маркете) в методе POST businesses/{businessId}/settings.

• Услугу ILLIQUID_GOODS_SALE (вознаграждение за продажу невывезенных товаров) в методе POST campaigns/{campaignId}/stats/orders.

• Подстатус заказа TECHNICAL_ERROR(техническая ошибка на стороне Маркета) в методах:

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

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

— GET campaigns/{campaignId}/orders;

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

Изменили

• Отметили устаревшим параметр buyerTotalBeforeDiscount (стоимость всех товаров в заказе в валюте покупателя до применения скидок и с учетом стоимости доставки) в методах GET campaigns/{campaignId}/orders, GET campaigns/{campaignId}/orders/{orderId} и PUT campaigns/{campaignId}/orders/{orderId}/status.

• Сделали обязательными параметры dateFrom и dateTo в методе PUT campaigns/{campaignId}/first-mile/shipments.

• Увеличили лимит на количество ссылок на изображения товара в методе POST businesses/{businessId}/offer-mappings/update — теперь можно передавать до 30 ссылок.

За всеми обновлениями в API можно следить в этом канале и на странице История обновлений API.

Обновления в API

Добавили

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

Изменили

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

- priceBeforeDiscount — стоимость товара в валюте магазина до применения скидок;

- buyerItemsTotal — стоимость всех товаров в заказе в валюте покупателя после применения скидок и без учета стоимости доставки;

- buyerTotal — стоимость всех товаров в заказе в валюте покупателя после применения скидок и с учетом стоимости доставки.

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

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

За всеми обновлениями в API можно следить в этом канале и на странице История обновлений API.