Как передать свои атрибуты товара
Как добавить в YML-каталог произвольные данные о товаре через элемент custom_attributes и где эти данные потом доступны
Добавьте элемент custom_attributes в YML-каталог, если о товаре нужно передать данные, для которых в формате нет подходящего поля: наличие по складам, код поставщика, признак распродажи.
Добавьте элемент в фид
Внутри <offer> положите JSON — по ключу на атрибут:
<offer id="1">
<custom_attributes>
<![CDATA[
{
"available_msk": true,
"available_spb": false,
"supplier_code": "AC-1099"
}
]]>
</custom_attributes>
</offer>
Обёртка CDATA необязательна: экранированный JSON платформа читает так же. С ней удобнее, потому что кавычки и скобки не нужно экранировать.
Имя элемента пишется ровно так — custom_attributes. Написание через дефис и camelCase, которые платформа понимает для group_id, здесь не работают: элемент с другим именем просто игнорируется.
Проверьте значения
Значением может быть строка, число, дата или true/false. Вложенные объекты и массивы платформа не принимает: ключ сохранится, но окажется пустым — без ошибки и без записи в отчёте импорта. Если атрибут в карточке товара выглядит пустым, начните проверку отсюда.
Ошибка в самом JSON тоже проходит молча: товар импортируется со старым набором атрибутов, а в счётчике ошибок задачи это не отражается. Проверяйте синтаксис на своей стороне.
Формат BV элемент custom_attributes не поддерживает — атрибуты передаются только в YML.
Измените или уберите атрибут
Новый импорт дописывает атрибуты к уже сохранённым, а не заменяет их целиком. Поэтому изменить значение можно, передав ключ с новым значением, а вот убрать ключ, удалив его из фида, не получится: прежнее значение останется в карточке.
Чтобы атрибут исчез, передайте товар через Platform API со значением null у этого ключа.
Где потом доступны атрибуты
| Где | Доступны |
|---|---|
| Карточка товара в кабинете | да |
| Экспорт товаров | да |
| Вебхуки | да |
| Шаблоны виджетов | да |
| Сопоставление товаров по произвольному атрибуту | да |
| Widgets API и Content API | нет |
| Условия правил автоматизации | нет |
| Сегменты товаров | нет |
Смотрите также: требования к каталогу товаров, как объединить варианты товара в группу.