Какие данные важны
Идентификатор должен оставаться неизменным между загрузками. Название и адрес делают запись пригодной для выдачи; модуль Битрикса пропускает элементы без пригодного заголовка или URL. Описание объясняет назначение товара, а характеристики нужны для фильтров, сравнения и подбора. Не записывайте цену или наличие только в описание: это отдельные коммерческие данные.
| Поле в настройке источника Битрикса | Как выбрать |
|---|---|
| «Чем является», «Индексировать» | Реальный тип материала и явное включение источника |
| «Адрес страницы», «Заголовок» | Публичная карточка и понятное покупателю название |
| «Описание», «Картинка» | Нужные поля элемента или свойства; описаний может быть несколько |
| «Категория» | Раздел инфоблока либо подходящее свойство |
| «Цена», «Ценовая колонка» | Торговый каталог и нужная группа либо свойство с ценой |
| «Цена до скидки», «Скидки каталога» | Исходная цена и применение публичных каталожных скидок |
| «Товары без цены» | Нужны ли в выдаче позиции без положительной цены |
| «Остатки по складам», «Варианты товара» | Складские данные и свойства выбора предложения |
| «Режим», «Свойства» | Все текстовые свойства либо явно выбранный набор |
Настройка источника по шагам
- В Битриксе откройте «Подключение → Что индексировать → Список разделов сайта» и настройку нужного источника.
- Проверьте тип и «Индексировать». Не включайте инфоблок предложений отдельно только ради количества карточек: варианты собираются в родительский товар.
- Проверьте «Адрес страницы». Для собственного шаблона доступны
#ELEMENT_ID#,#CODE#,#SECTION_ID#,#IBLOCK_ID#. Например,/catalog/#CODE#/годится только если такие страницы действительно существуют. - Выберите название, описание, изображение и категорию. Убедитесь, что выбранные поля заполнены у контрольного товара, а не только у одной удачной карточки.
- Для «Цены» выберите «Из торгового каталога» или соответствующее свойство. Если доступны несколько ценовых колонок, выберите публичную; по умолчанию используется базовая.
- Решите, применять ли скидки и исключать ли товары без цены. Не путайте нулевую цену, отсутствие цены и отсутствие товара на складе.
- Выберите свойства вариантов, например цвет и размер, затем характеристики товара. В режиме «только выбранные» пустой выбор означает отсутствие свойств, а не автоматический выбор всех.
- Сохраните источник, повторите выгрузку и проверьте родительскую карточку, каждый контрольный вариант, цену и корзину.
Цена и наличие
Каталожные скидки Битрикс рассчитывает для группы «Все пользователи». Персональные скидки и правила корзины могут дать другому покупателю другую сумму. Сравнивайте публичную поисковую цену с публичной карточкой, а выбранный вариант отдельно с корзиной.
Если задана только «Цена до скидки», она может стать обычной ценой. Не используйте поле как способ показать скидку без действующей цены. У товара с предложениями цена карточки берётся по самому дешёвому доступному предложению; наличие родителя означает, что доступно хотя бы одно. Это не означает доступность любого цвета или размера.
Если доступных предложений нет, карточка может сохранять цену из недоступных вариантов. Проверяйте цену вместе с наличием; само число не является разрешением покупки. Остаток и разрешение покупки не тождественны: правила Битрикса могут разрешать покупку при нулевом количестве. Складские сведения зависят от данных учёта и выбранной выгрузки. Не обещайте наличие в конкретном городе по одному общему признаку доступности.
Пример фида
Ниже иллюстративный JSON для одного простого товара без вариантов. Замените адрес, валюту и значения своими; пример не описывает персональную цену.
{"items":[{"id":"sample-chair","name":"Sample chair","url":"https://shop.example/catalog/sample-chair/","price":120,"currency":"EUR","available":true,"description":"Wooden chair","properties":{"material":"wood"}}]}
Характеристики и ручные правки
Передавайте реальные признаки с единицами измерения и стабильными названиями. «Ширина: 60 см» полезнее, чем отдельное число без смысла. Не выбирайте реквизиты обмена, внутренние заметки и рекламные заготовки как варианты товара. Отсутствующее значение не подтверждает соответствие условию; настройка фильтра не создаёт отсутствующие факты.
Бренд, артикул и штрихкод модуль пробует определить по типовым свойствам, например BRAND, CML2_ARTICLE и BARCODE. Проверьте фактическую выдачу: необычные коды могут потребовать настройки вашей интеграции, а отдельного универсального редактора этих полей в форме источника нет. Не заменяйте идентификатор товара артикулом при каждом обновлении.
В «Товарах» (/lk/products) найдите карточку и нажмите «Редактировать». Здесь меняются описание и характеристики, не цена и складской остаток. После «Сохранить» правка остаётся поверх выгрузки. Рядом с изменённым полем «Вернуть из фида» снимает переопределение. Правки характеристик сохраняются набором: проверьте все строки перед сохранением, не только добавленную.
Если исчез товар, проверьте адрес, заголовок и исключение без цены. Если пропал фильтр, проверьте экспорт свойства и его значение. Если новая выгрузка не меняет текст, снимите ненужную ручную правку. Продолжение: каталог, поиск, корзина.