Как загрузить товары из XML?
Зачем это нужно вашему бизнесу
XML — формат, похожий на товарные фиды Яндекс.Маркета (YML), и если ваш каталог уже где-то выгружается в этом формате — например, из вашей CMS или учётной системы, — вы можете загрузить его в ChatMarket без ручного переноса каждого товара.
Что это даёт бизнесу:
- Экономит десятки часов — перенос каталога занимает минуты вместо ручного заполнения каждой карточки.
- Подходит для автоматизации — если ваша система уже формирует YML/XML-фид для других площадок, тот же файл можно использовать и здесь.
- Упрощает регулярное обновление каталога — на тарифе «Бизнес» файл можно обновлять по ссылке автоматически, без повторной загрузки вручную.
Формат более технический, чем Excel, поэтому ниже — подробный разбор структуры файла и каждого поля с примерами. Если вам удобнее работать с таблицей, а не с XML-тегами — инструкция по загрузке из Excel есть в отдельной статье.
⚠️ Прежде чем начать: важно понимать про источники товаров
В ChatMarket есть несколько способов наполнить каталог: загрузка из файла, по ссылке, импорт с Wildberries и с Ozon. Все они работают с одним и тем же каталогом, поэтому:
- Загрузка товаров из одного источника может изменить или удалить позиции, ранее загруженные из другого. Например, импорт из файла может затереть товары, которые вы раньше загрузили с Wildberries или Ozon.
- Товары, добавленные вручную, эта проблема не затрагивает — они сохраняются при любом импорте.
Если вы используете сразу несколько источников товаров, заранее продумайте, какой из них будет «основным», чтобы случайно не потерять часть каталога.
Как загрузить товары из XML: пошаговая инструкция
Шаг 1. Скачайте пример файла
Не пишите структуру с нуля — скачайте готовый пример и подставьте в него свои данные, скопировав структуру тегов:
Скачать пример: XML
Файл должен начинаться с корневого тега, внутри — блок, а в нём уже категории и товары.
Ограничение: размер файла — не больше 10 МБ.
Важно
XML чувствителен к структуре — каждый открывающий тег должен иметь закрывающий (…), а вложенность блоков должна точно соответствовать примеру. Одна лишняя или недостающая закрывающая скобка может сломать чтение всего файла.
Шаг 2. Заполните категории
Категории перечисляются внутри блока. Каждая категория — тег с уникальным атрибутом id и названием между открывающим и закрывающим тегом.
Совет
Придумайте систему нумерации id заранее (C1, C2, C3…) — на следующем шаге товары привязываются к категории именно по этому идентификатору, а не по названию.
Шаг 3. Заполните обязательные поля товаров
Товары перечисляются внутри блока. Каждый товар — тег с уникальным атрибутом id.
Для каждого товара обязательно укажите:
| Тег | Описание |
|---|---|
| Название товара | |
| Описание товара | |
| Цена в рублях, целое число | |
| ID категории из раздела категорий | |
| Ссылка на фото по протоколу https. Минимум одно фото, максимум десять. Форматы: PNG, JPEG, WebP |
Важно
Ссылка в должна вести напрямую на файл изображения (не на страницу сайта, где эта картинка размещена) и начинаться с https://. Если ссылка ведёт не на сам файл, изображение не подтянется.
Шаг 4. Заполните необязательные поля товаров
Эти теги можно добавлять по необходимости — они расширяют карточку товара, но без них импорт тоже пройдёт успешно:
- и — скидка. Тип: «В процентах» или «В рублях». Если тип не указан, считается «В процентах».
- — альтернативный способ указать скидку: старая цена выше текущей, разница автоматически считается скидкой в рублях.
- — бонусные баллы за покупку.
- — количество товара в наличии.
- — артикул.
- значение — характеристика (размер, цвет и т. д.).
- — дополнительная платная услуга, например подарочная упаковка.
- — кнопка со ссылкой на карточке товара. На один товар — не больше одной кнопки.
Пример товара с несколькими дополнительными полями:
Совет
Если у товара несколько значений одной характеристики — например, размеры 41, 42 и 43, как в примере выше — не перечисляйте их через запятую в одном теге. Добавьте отдельный тег на каждое значение.
Важно
Чтобы пометить товар как неактивный (например, он временно недоступен), добавьте атрибут available="false» прямо в открывающий тег: . Такой товар покупатель не увидит.
Шаг 5. Загрузите файл в ChatMarket
Когда файл готов, переходите к импорту:
- Откройте раздел «Товары», в меню действий выберите «Импорт товаров».
- Выберите вкладку «Файл» и прикрепите готовый XML.
- При необходимости включите дополнительные настройки: • «Удалять отсутствующие позиции» — товары, которых нет в загружаемом файле, будут удалены из каталога.• «Обновлять изменённые позиции» — если товар с таким же id уже есть в каталоге, его данные обновятся на новые из файла.
- Нажмите «Продолжить».
Важно
Перед включением «Удалять отсутствующие позиции»: при удалении из каталога исчезнут не только товары, которых нет в вашем файле, но и позиции, ранее загруженные из другого источника — Wildberries, Ozon или по ссылке. Товары, добавленные вручную, при этом не удаляются. Включайте эту настройку осознанно, особенно если параллельно используете другие способы импорта.
Импорт может занять до 30 минут — не закрывайте страницу до завершения. Если в файле есть ошибки, сервис покажет их список: исправьте нужные теги и загрузите файл заново.
Готово — что дальше?
Каталог загружен, и теперь все товары доступны клиентам без единой карточки, заполненной вручную.
Если вы на тарифе «Бизнес» — тот же XML-файл можно разместить в интернете и указать ссылку на него во вкладке «Ссылка» при импорте. Тогда каталог будет обновляться автоматически каждые 8 часов, и вам не придётся заново загружать файл вручную при каждом изменении ассортимента.
Следующий шаг: сохраните готовую структуру файла как шаблон –при следующем обновлении каталога вам останется просто изменить нужные теги, а не собирать файл заново с нуля.