15 октября Walmart объявил новую версию Item spec 5.0. Для подходящих неновых предложений появился необязательный атрибут conditionNotes: в нём можно описать состояние конкретного экземпляра, не меняя общее описание продукта.

Обновление относится к американскому Marketplace API. Номер спецификации — 5.0.20260829-12_49_39-api; дата внутри номера не является датой объявления релиза.

Для чего нужен conditionNotes

Поле предназначено для подходящих предложений Resold, включая Pre-Owned и Restored. Оно позволяет уточнять физическое, внешнее и функциональное состояние, упаковку и комплектность. Заметку можно добавить при создании товара и менять при обслуживании карточки без снятия предложения с публикации.

Значение должно соответствовать выбранному состоянию и содержать конкретные факты. Например, полезнее отдельно перечислить подтверждённую комплектность и видимые следы использования, чем написать «товар отличный». Это редакционный пример организации описания, а не обязательный шаблон Walmart.

Почему нельзя менять общее описание продукта

Заметка относится к состоянию предложения и дополняет поле Condition. Общие свойства модели и особенности конкретного экземпляра решают разные задачи. Если у одного устройства отсутствует коробка, это не превращает отсутствие коробки в характеристику всех товаров этой модели.

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

Что ещё изменилось в разрешённых состояниях

Walmart расширил доступность существующих состояний для отдельных Product Types, включая некоторые детские товары, спорттовары, автотовары и электронику. Это изменение конфигурации типов продукции, а не появление новых универсальных определений состояния.

Поэтому сначала проверяют конкретный Product Type и допустимое для него значение. Нельзя делать вывод, что любая вещь из широкой категории теперь принимается как Pre-Owned или Open Box. Сопоставление следует хранить отдельно от свободного текста заметки.

Как принять обновление в интеграции

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

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