Новости Маркета: 3PL-комиссия и API, ноябрь 2026

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

Комиссия за перевозку и ТЭО теперь видна отдельной строкой

В отчёт о стоимости услуг (метод `stats/orders`) добавили значение `AGENCY_COMMISSION_3PL` — это услуги перевозки и транспортно-экспедиционного обслуживания. Теперь затраты на логистику по схеме 3PL выделены в детализации отдельно, а не растворены в прочих услугах.

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

Что сделать:
- Обновить парсер отчётов: добавить обработку нового кода услуги, чтобы он не попадал в «прочее» и не ломал сверку.
- Пересобрать расчёт себестоимости заказа с учётом отдельной строки на перевозку и ТЭО.
- Сверить новые начисления с фактическими списаниями за ближайший период.

Источники:
- Яндекс.Маркет API — релизы (добавление `AGENCY_COMMISSION_3PL` в `stats/orders`)

В точках продаж тип региона TOWN убрали

В методах создания и изменения точек продаж (`outlets`) тип идентификатора региона `TOWN` помечен как устаревший и удалён. Допустимые типы теперь — `CITY`, `VILLAGE` и `REPUBLIC_AREA`; вместо `TOWN` следует указывать `VILLAGE`.

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

Что сделать:
- Найти в коде и интеграциях все обращения, где регион точки передаётся как `TOWN`.
- Заменить `TOWN` на `VILLAGE` или другой подходящий тип из списка.
- Прогнать тестовое создание и обновление точки, чтобы убедиться, что запрос проходит без ошибки валидации.

Источники:
- Яндекс.Маркет API — релизы (обновление типов региона в `outlets`)

У скрытых товаров изменилась пагинация

Из метода получения скрытых товаров (`GET hidden-offers`) удалили устаревший параметр `prevPageToken`. Для перехода между страницами теперь используется только `nextPageToken`.

Касается тех, кто выгружает список скрытых товаров постранично и опирался на обратный токен.

Что сделать:
- Убрать из запросов `prevPageToken`.
- Перестроить логику обхода страниц только на `nextPageToken`.
- Проверить, что выгрузка доходит до конца списка без потери страниц.

Источники:
- Яндекс.Маркет API — релизы (удаление `prevPageToken` из `hidden-offers`)

Новая ошибка при отслеживании доставки

В методе трекинга доставки (`orders/{orderId}/delivery/track`) добавили ошибку `Campaign 'campaignId' has no order id 'orderId'`. Она возвращается, если заказ не принадлежит указанному магазину.

Касается продавцов и сервисов, которые передают статусы доставки по API, особенно при работе с несколькими кампаниями.

Что сделать:
- Добавить обработку этой ошибки в интеграцию, чтобы не считать её сбоем системы.
- Проверять соответствие `campaignId` и `orderId` перед отправкой запроса.
- Логировать такие случаи — чаще всего это признак перепутанной кампании или устаревшего заказа.

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

Источники:
- Яндекс.Маркет API — релизы (новая ошибка в `delivery/track`)

Коротко: закрывающие документы и лимиты остатков

В релизах снова фигурируют переход на УПД-1 и новые лимиты параметра `limit` в методах остатков — мы уже разбирали это в материале «Маркет: УПД-1, лимиты API и склады — октябрь 2026». Новый нюанс по документам: УПД-1 заменяет акт и счёт-фактуру по договору на маркетинг с августа 2026 года, а по договору на размещение — с октября 2026 года; за более ранние периоды по-прежнему доступны акт и счёт-фактура. Если выгружаете закрывающие документы по договору на размещение, учтите эту дату при сверке.

Источники:
- Яндекс.Маркет API — релизы (состав закрывающих документов, лимиты `limit` в методах остатков)

Пока вы перенастраиваете интеграции, следить за новыми отзывами и отвечать на них в едином тоне бренда помогает наш сервис otvet.im.