DOCS
← На лендингОткрыть билдер

Импорт товаров из CSV и XML-фидов

Как перенести каталог из таблицы или фида: загрузить файл, сопоставить столбцы, проверить результат и при необходимости отменить импорт.

РАЗДЕЛКаталогЧТЕНИЕ~8 минОБНОВЛ.

Какой нужен файл

  • CSV или TSV до 250 МБ и до 100 000 строк. Таблицу из Excel или Google Sheets сохраните как CSV — разделитель (запятая, точка с запятой, табуляция) и кодировку импорт определит сам.
  • Или XML-фид — YML либо фид Google — до 250 МБ и до 100 000 товаров.
  • Или выгрузка товаров Shopify или WooCommerce — она узнаётся по заголовкам столбцов. Как её получить и что перенесётся — в статьях «Переезд с Shopify» и «Переезд с WooCommerce».
  • Любой из этих файлов можно загрузить сжатым в .gz. Распакованный, он тоже должен быть не больше 250 МБ.
  • Первая строка — заголовки столбцов, дальше по товару в строке.
  • Фото — ссылками на картинки, несколько через запятую. Импорт скачает их в медиатеку сам, до 10 на товар.
  • Категории — путём через «>»: «Одежда > Футболки». Недостающие категории создадутся деревом.
Шаблон

«Каталог» → «Импорт» → «Шаблон CSV». В шаблоне наши столбцы: id, sku, name, price, stock_quantity, categories, images и другие, а также столбцы языков магазина (name:en) и характеристик (attr:код). Файл по шаблону узнаётся сам, и сопоставлять почти ничего не нужно.

Фиды YML

YML — XML-фид, в котором каталоги принимают маркетплейсы и отдают поставщики. Особенности площадки узнаются по тегам сами. Выгрузка Prom, Deal.by и Satu.kz читается из YML и из CSV; в CSV нет дерева групп, поэтому категории будут плоскими. Каталог из Horoshop выгрузите в формате Prom. Теги фида становятся столбцами и сопоставляются сами: категории берутся из дерева категорий фида, каждый param — характеристика (столбцы вида param:Цвет), а name_ua и description_ua — украинский перевод, если украинский есть среди языков магазина.

Фиды Google

Фид Google Merchant — XML (RSS или Atom) или таблица TSV или CSV с названиями атрибутов Google. Те же атрибуты у фидов Meta (Facebook, Instagram) и Microsoft Merchant Center — они загружаются так же. sale_price — цена со скидкой: если она заполнена, она становится ценой товара, а обычная цена — старой. google_product_category записывается в категорию Google товара, product_type — путём категорий «A > B > C», из него строится дерево категорий магазина, а product_detail становятся характеристиками.

Совместимые площадки

Подойдёт выгрузка товаров файлом. «Автоматически» значит, что формат узнаётся сам. «Через свой CSV» значит, что файл загрузится, а столбцы вы сопоставите на шаге «Поля». Если вашей площадки здесь нет, выгрузите товары в CSV и загрузите как свой CSV. Файл Excel сначала сохраните как CSV.

  • В любой стране: автоматически — Wix, Ecwid; через свой CSV — Etsy, Amazon, eBay, Squarespace, BigCommerce, Magento.
  • Канада: автоматически — Lightspeed.
  • США: через свой CSV — GoDaddy, Webflow.
  • Бразилия: автоматически — VTEX.
  • Аргентина: через свой CSV — Tiendanube.
  • Чили: через свой CSV — Jumpseller.
  • Германия: автоматически — Shopware.
  • Франция: через свой CSV — PrestaShop.
  • Польша: автоматически — Shoper.pl; через свой CSV — Allegro.pl.
  • Чехия: автоматически — Shoptet.cz.
  • Украина: автоматически — Prom.ua, Horoshop.ua.
  • Казахстан: автоматически — Satu.kz.
  • Турция: автоматически — ikas.
  • Индия: через свой CSV — Zoho Commerce.
  • Малайзия: через свой CSV — EasyStore.
  • Гонконг: через свой CSV — Shopline.
  • Саудовская Аравия: через свой CSV — Zid.sa.
  • Австралия: через свой CSV — Maropost.

Как проходит импорт

  1. Источник
    «Каталог» → «Импорт» → «Новый импорт», выберите файл. Каждая загрузка попадает в источник — повторная загрузка в тот же источник обновит его товары, а не создаст их заново. Если тот же каталог уже загружался в другой источник, мастер предложит обновить его.
  2. Формат
    Видно, сколько записей в файле, какие формат и кодировка определились, а таблица показывает первые записи и все столбцы. Если формат определился неверно, в таблице «кракозябры» или всё в одном столбце — смените формат, кодировку или разделитель и прочитайте файл заново.
  3. Поля, категории, характеристики
    Сопоставьте столбцы с полями товара, затем решите, какие категории и характеристики создать, а какие связать с уже существующими.
  4. Модификации
    Если в файле есть ключ группы или ссылка на родителя, мастер покажет найденные группы модификаций и их оси. Когда групп нет, шаг пропускается.
  5. Настройки
    Создавать и обновлять или только одно из двух, что делать с товарами, которых нет в файле, курс валюты, статус новых товаров, фото, фильтры. Обычно умолчаний достаточно.
  6. Проверка и запуск
    Импорт показывает, что создастся, обновится и пропустится, и только потом пишет в каталог. Импорт идёт в фоне: окно можно закрыть, а когда он закончится, придёт письмо.

Поля и преобразования

Слева — столбцы файла с примерами значений, справа — куда их записать: поле товара, текст на языке магазина, категория, фото, характеристика или «Пропустить». Похожие по имени столбцы сопоставляются сами, подходящие варианты стоят в списке первыми. Сопоставление сохраняется в источнике и подставится при следующей загрузке.

Кнопка «Преобразование» у столбца меняет значение по пути в каталог: заменить или убрать текст («ОПТ», имя поставщика), добавить текст в начало или конец, сменить регистр, обрезать, подставить значение для пустых, заменить значения по таблице, собрать значение из нескольких столбцов шаблоном вроде {Бренд} {Модель}, умножить, прибавить или округлить число — например, наценка. Правила применяются по порядку, рядом видно «было → стало».

Ключ

Повторная загрузка находит товары по столбцу id, а без него — по SKU. Если в файле нет ни того ни другого, каждая загрузка создаст товары заново.

Модификации

  • Модификация — отдельный товар в группе. Группа собирается из столбца с общим ключом группы (group_id в YML, item_group_id в фиде Google) или из столбца со ссылкой на родителя — id или SKU родительского товара; сам родитель тоже входит в группу.
  • Оси — характеристики, которыми модификации отличаются: цвет, размер. По умолчанию ими становятся характеристики, значения которых различаются внутри группы; на шаге «Модификации» оси можно выбрать самому — до трёх. Выключите «Собирать модификации», и каждый товар импортируется отдельно.
  • Главный товар группы — родитель, а без него — первый товар группы в файле. Модификации без своего описания, категорий или фото берут их у главного товара, как и недостающие характеристики.
  • Группа больше 100 товаров, с осями больше трёх, с осью не типа «Список» или «Цвет», с товаром без значения оси или с повторяющимся сочетанием значений не собирается: её товары импортируются поодиночке, а у их строк остаётся предупреждение.
  • Повторная загрузка добавляет новые модификации в уже собранную группу.

Фильтры

Фильтры на шаге «Настройки» берут из файла только часть записей — например, один бренд или товары дороже 100. Условие — столбец, сравнение (равно, содержит, больше, меньше, одно из списка через запятую, пусто и другие) и значение; значение сравнивается после преобразований столбца. Импорт возьмёт только записи, подходящие под все условия, остальные не создаются и не обновляются. Сколько записей отсеяно, видно на шаге «Проверка». Условий — до 20.

Валюта и курс

Цены в другой валюте пересчитываются в валюту магазина: по курсу из фида (currencies в YML), для USD с курсом NBU в гривневом магазине — по текущему курсу НБУ, иначе — по «Курсу источника» на шаге «Настройки»: сколько стоит единица валюты файла в валюте магазина. Без курса импорт не запустится: проверка покажет, для какой валюты его нет, — так цены в долларах не попадут на сайт гривнами.

Проверка

На шаге «Проверка» в каталог ещё ничего не записано. Сверху — сколько товаров создастся, обновится и пропустится и сколько строк с ошибками, ниже — вкладки «Товары», «Категории» и «Характеристики». У каждой строки — номер строки в файле и причина ошибки. Снимите отметку со строки, чтобы исключить её из этого импорта. «Отчёт об ошибках» скачивает их списком в CSV.

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

Проверка перед публикацией

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

Остановка и отмена

  • «Остановить» во время записи срабатывает после текущей пачки. Дальше — «Продолжить» с того же места, «Завершить как есть» или «Отменить импорт». Без решения остановленный импорт через сутки завершается как есть.
  • Импорт, который ещё не запущен, закрывается кнопкой «Закрыть» на карточке источника или удаляется вместе с источником: в каталог он ничего не записал.
  • «Отменить импорт» есть у последнего импорта источника, который писал в каталог. Он удаляет созданные импортом товары, а также категории и характеристики, которыми больше ничего не пользуется. Товары с заказами уходят в архив. Окно подтверждения покажет, сколько товаров удалится и сколько из них правили после импорта.
  • Обновлённые поля существующих товаров отмена назад не возвращает.

Лимит тарифа

Товаров в магазине может быть до 100 на Free, до 5 000 на Pro и до 15 000 на Team. Если файл не помещается, импорт скажет об этом сразу после чтения файла: перейдите на тариф выше или исключите лишние строки на шаге «Проверка». Импорт, который выведет магазин за лимит, не запустится.

Синхронизация по ссылке

Вместо файла можно дать ссылку на фид поставщика: «Новый импорт» → «По ссылке». Импорт скачает фид (до 100 МБ) и пройдёт те же шаги, что и с файлом. Если фид открывается по логину и паролю, отметьте «Закрытый фид» и укажите их — они хранятся зашифрованными.

  • На Pro и Team источник по ссылке обновляется по расписанию — раз в 1, 3, 6, 12 или 24 часа. Расписание включается в меню источника → «Изменить».
  • По умолчанию синхронизация обновляет цену, старую цену, наличие и остаток, а товары, которых больше нет в фиде, убирает в архив. Это меняется в настройках источника.
  • Наценка в процентах или суммой и округление цены — до целого или до .99 — применяются к цене и старой цене после пересчёта валюты.
  • Если фид не изменился с прошлого запуска, синхронизация его пропускает — в истории запуск отмечен «Фид не изменился».
  • Заметные изменения — те же, что требуют подтверждения при ручном запуске, или фид, ставший намного короче, — синхронизация сама не записывает: источник встаёт на паузу, а вам приходит письмо. Откройте проверку и запустите импорт или снимите паузу.
  • Пять сбоев подряд — фид не скачался или по ссылке открылась страница вместо фида — тоже ставят источник на паузу. Проверьте ссылку и доступ, затем снимите паузу.