При обновлении рекомендаций товаров Wildberries ключевое решение — добавить позиции к существующей подборке или заменить её целиком. В API это разные режимы одного метода. Ошибка выбора режима может убрать нужные связи, даже если запрос сформирован правильно. Справка проверена 14 октября 2026 года.

Чем отличаются два режима

В /api/content/v1/recommendations/set параметр replace по умолчанию равен false: новые рекомендации добавляются к существующим. Значение true означает замену прежнего состава новым. Метод получения списка позволяет предварительно увидеть сохранённые рекомендации; оба метода доступны для персонального и сервисного токенов.

Редакционная рекомендация — указывать режим словами в задании менеджера: «дополнить» или «заменить». Формулировка «обновить товары» слишком неоднозначна. Разработчик не должен угадывать бизнес-решение по количеству строк файла.

Подготовьте снимок исходного состава

Сохраните для каждой исходной карточки текущую подборку и целевое изменение. Не путайте карточку, на которой показываются рекомендации, с товаром, включаемым в список. Одни и те же артикулы могут играть обе роли в разных связях.

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

Как избежать конфликтов между менеджерами

Если один сотрудник дополняет подборку, а другой одновременно заменяет её по старому снимку, итог может не соответствовать последнему согласованному решению. Это риск рабочего процесса, а не особое поведение, обещанное API. Назначьте одного ответственного за пакет и повторно прочитайте состав перед массовой заменой.

Не объединяйте в одном файле изменения, для которых команда ещё не выбрала режим. Спорные строки оставьте отдельно. Сохранённый снимок поможет восстановить намерение, но обратное изменение также требует проверки актуального каталога.

Как проверить результат и пользу

После ответа получите список рекомендаций повторно и сравните его с целевым набором по каждой карточке. Ошибки строк или несовпадения должны остаться видимыми в отчёте внедрения. Успешный запрос не доказывает, что подборка соответствует задаче магазина.

Техническая сверка состава и анализ переходов — разные проверки. В отчёте о точках входа Wildberries собственные рекомендации отделяются от автоматических блоков. Не относите изменение всего рекомендательного трафика к одной отредактированной подборке и не обещайте рост продаж лишь на основании её сохранения.