Формат CSV-файла в Эквиде
Чтобы успешно импортировать CSV-файлы в магазин, убедитесь, что они составлены в соответствии с форматом, который описан в этой статье.
Общие правила
Есть несколько общих правил, которые нужно учитывать при составлении CSV-файла:
- У каждого файла должна быть шапка с названиями колонок. Подробнее — в Списке поддерживаемых колонок →
- Порядок колонок не имеет значения, если вы используете правильные названия.
- Добавьте все колонки, которые нужны для импорта ваших данных. Остальные колонки в файл можно не включать: так он будет компактнее. Например, если вы обновляете уже существующие товары, вы можете использовать только те колонки, в которые вносите изменения, и колонки с идентификаторами.
- Обратите внимание на обязательные колонки. Они зависят от типа данных и от цели импорта (создать новые товары/категории или обновить существующие). Подробнее в статье Список колонок CSV-файла.
- Сохраните ваш CSV-файл с кодировкой UTF-8 (рекомендуемая кодировка).
Шапка
Самая важная часть вашего CSV-файла — его шапка. Это первая строка с названиями всех колонок, которые есть в файле. Названия позволяют импорту понять, какая именно информация содержится в конкретной колонке:
Файл не получится загрузить, если в нем не будет шапки.
Типы данных
Каждая строка в файле — кроме шапки — посвящена определенному набору данных. Чтобы указать, к чему именно относится информация в строке, используйте колонку “type” («тип»):
В зависимости от типа, строка может содержать информацию о:
- товаре (тип = ”product”)
- параметре товара или поле ввода (тип = ”product_option”)
- варианте товара (тип = ”product_variation”)
- файле товара (тип = ”product_file”)
- категории магазина (тип = ”category”)
- редиректе для Стартового сайта (тип = ”site_redirect”)
- покупателе магазина (тип = ”customer”)
Колонки
Все колонки в вашем файле импорта, — за исключением колонки “type”, — связаны с определенной информацией: названием товара, его артикулом, ценой и т. д.
Информация может относиться к товару, параметру товара (или полю ввода), варианту товара, файлу, категории магазина, редиректу Стартового сайта или покупателю магазина, в зависимости от конкретной строки.
Подробнее в разделе Список колонок CSV-файла. Вы можете разместить колонки в любом удобном вам порядке, главное — убедитесь, что названия колонок совпадают с названиями из раздела по ссылке.
Идентификаторы (ID)
Идентификаторы — или ID — нужны, чтобы сопоставить данные из определенной строки с конкретными товарами или категориями. Например, когда вам нужно указать, к какому товару относится параметр:
- Если вы обновляете существующий товар, укажите его ID или уникальный артикул.
- Если вы добавляете к товару параметр, поле ввода, вариант или файл, укажите уникальный артикул или ID товара, к которому они относятся.
- Если вы обновляете категории, которые уже существуют в магазине, укажите ID категории или полный путь до нее.
- Если вы обновляете или удаляете редирект Стартового сайта, укажите ID редиректа.
- Если вы обновляете или удаляете покупателя, укажите его основной адрес электронной почты или ID покупателя (используется, чтобы обновить основной адрес электронной почты).
Названия колонок должны быть указаны в соответствии со Списком колонок CSV-файла.
Подборка примеров CSV-файлов
Чтобы лучше понять, как устроены CSV-файлы в Эквиде, вы можете посмотреть готовые примеры. Мы подготовили несколько для разных задач:
- Добавить новый товар →
- Добавить новый товар с параметрами →
- Добавить новый товар с параметрами и вариантами→
- Добавить новый товар с файлами →
- Добавить новые категории магазина →
- Добавить атрибуты к существующим товарам →
- Добавить переводы к существующему товару →
- Включить отслеживание остатков для существующего товара →
- Обновить остатки существующего товара →
- Создать редиректы для Стартового сайта →
- Добавить список покупателей →
Вы можете использовать эти файлы как образец, чтобы увидеть, как строки и колонки связаны друг с другом. Замените тестовые данные в колонках на ваши товары или категории и добавьте больше колонок, если это необходимо.