Новости Маркета: комиссия 3PL и обновления API

В этом выпуске — технические обновления API Яндекс.Маркета, которые влияют на расчёт себестоимости, интеграции и документооборот. Разбираем, что проверить в своих выгрузках и учётных процессах.

Новая комиссия за перевозку и ТЭО в стоимости заказов

В информацию о стоимости услуг добавили значение `AGENCY_COMMISSION_3PL` — это отдельная строка для комиссии за услуги перевозки и транспортно-экспедиционного обслуживания. Значение появляется в данных метода статистики заказов (`POST v2/campaigns/{campaignId}/stats/orders`).

Касается продавцов, которые считают юнит-экономику по данным API и сверяют фактические затраты по каждому заказу.

Что делать:
- Проверьте, учитывает ли ваша таблица или сервис аналитики новое значение `AGENCY_COMMISSION_3PL` — иначе часть расходов выпадет из расчёта маржи.
- Пересчитайте себестоимость по товарам, где логистика занимает заметную долю цены.
- Если по итогам пересмотра меняете цены, следите за реакцией покупателей: рост цены часто отражается в отзывах, и такие сигналы стоит отрабатывать аргументированно.

Источники:
- Яндекс.Маркет API — релизы

Новые лимиты параметра limit в методах остатков

В методах работы с остатками (`POST v2/campaigns/{campaignId}/offers/stocks` и `POST v3/businesses/{businessId}/offers/stocks`) изменили параметр `limit`: максимальное значение снижено с 200 до 100, значение по умолчанию — со 100 до 50. Если передать значение больше 100, оно обрезается до 100 без ошибки валидации.

Касается всех, у кого остатки синхронизируются через API — напрямую или через сторонний сервис.

Что делать:
- Проверьте запросы, где раньше передавали `limit=200`: теперь вернётся максимум 100 позиций, и часть данных можно не получить.
- Убедитесь, что в выгрузке остатков настроена постраничная загрузка, иначе при большом ассортименте возможны расхождения.
- Поскольку значение по умолчанию уменьшилось вдвое, явно задавайте `limit` там, где он не указан.

Источники:
- Яндекс.Маркет API — релизы

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

Добавили методы для создания, обновления, удаления и получения документов на товары. Создавать, обновлять и удалять документы можно пакетами до 100 штук, доступны фильтры и постраничная загрузка.

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

Что делать:
- Если документы на товары вы ведёте вручную, оцените перевод этой рутины на пакетную загрузку через API.
- Наведите порядок в сопоставлении «товар — документ», прежде чем загружать пакетами: массовая операция тиражирует и ошибки тоже.

Источники:
- Яндекс.Маркет API — релизы

Склады на уровне кабинета и УПД-1: что добавилось

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

Методы для работы со складами и остатками на уровне кабинета (получение списка складов, передача остатков, включение и выключение модели работы склада, генерация отчёта по остаткам) теперь дополнены деталью: метод `POST v2/campaigns/{campaignId}/warehouse/status` помечен как устаревший. Методы рассчитаны на кабинеты без групп складов. О самих методах ранее писали в предыдущем выпуске.

По закрывающим документам появилось уточнение: УПД-1 заменяет акт об оказанных услугах и счёт-фактуру не только по договору на маркетинг (с августа 2026 года), но и по договору на размещение — с октября 2026 года и последующих месяцев. О переходе на УПД-1 мы рассказывали ранее.

Что делать:
- Если используете устаревающий метод управления складом, запланируйте переход на новые методы уровня кабинета.
- Предупредите бухгалтерию: закрывающие документы по размещению за октябрь 2026 года и далее придут в формате УПД-1.

Источники:
- Яндекс.Маркет API — релизы

Технические изменения редко видны покупателю напрямую, но смена цен и логистики почти всегда отражается в отзывах — отслеживать их и отвечать в тоне бренда помогает otvet.im.