ARTIMEX предназначен для массового импорта, обновления и экспорта товаров JoomShopping 5+ с помощью файлов XLS, XLSX и CSV.

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

• XLS
• XLSX
• CSV

Для текстовых данных рекомендуется использовать кодировку UTF-8.

Для импорта не нужно создавать файл с фиксированным набором или последовательностью колонок. ARTIMEX определяет назначение данных по названиям колонок.

В самом простом случае достаточно двух колонок:

• колонки, по которой определяется товар;
• колонки с данными, которые нужно создать или обновить.

Например, для обновления цены по артикулу достаточно колонок:

ean | price

Товар может определяться по одному из основных идентификаторов:

На первом листе файла можно использовать формулы Excel. Во время импорта ARTIMEX использует результат вычисления формулы.

Например, можно:

• хранить закупочную цену на отдельном листе;
• рассчитывать розничную цену формулой;
• импортировать уже полученный результат.

Ниже приведены основные поля, которые можно использовать в файле импорта. Ненужные колонки можно не добавлять.

Для категорий используется колонка categories.

Одна категория:

Категория

Несколько категорий:

Категория 1|Категория 2

Вложенная категория:

Категория/Подкатегория

Несколько веток категорий:

Категория 1/Подкатегория 1|Категория 2/Подкатегория 2

Категория с alias:

Категория:category

Категория с alias и изображением:

Категория:category:category.jpg

Категория с изображением без alias:

Категория::category.jpg

Для производителя используется колонка manufacturer.

Только название:

Coca-Cola

Название и alias:

Coca-Cola:coca-cola

Название, alias и изображение:

Coca-Cola:coca-cola:logo_coca.jpg

Дополнительные цены

Формат:

Единица;КоличествоОт:КоличествоДо:Скидка|КоличествоОт:КоличествоДо:Скидка

Пример:

Liter;1:10:5|11:20:10|21:30:15

Для налога используется колонка tax.

Название и ставка:

ПДВ 20%:20.00

Или только ставка:

20.00

Колонка currency может содержать ID, название, код или ISO-код валюты.

Примеры:

1
Гривна
грн.
UAH

Для создания новой валюты можно передать полный набор параметров вместе с курсом:

Гривна:грн.:UAH:1.000000

Для импорта изображений используется колонка images.

Несколько изображений разделяются символом |:

image1.jpg|image2.jpg|image3.jpg

Можно также указать название изображения:

image1.jpg:Название изображения|image2.jpg:Второе название

Первое изображение в списке используется как основное, если другое не задано отдельно.

Загрузка изображений по URL

Вместо локального файла можно указать URL:

https://supplier.example.com/images/product.jpg

ARTIMEX загрузит изображение на сайт и обработает его как локальное.

Можно также задать название и желаемое имя локального файла:

https://supplier.example.com/images/product.jpg:Назва:product-new.jpg

Без названия:

https://supplier.example.com/images/product.jpg::product-new.jpg

Основное изображение

Колонка image позволяет явно указать основное изображение товара:

image4.png

Если основным должно быть первое изображение из колонки images, використовувати image отдельно не нужно.

Колонка label.

Только название:

New

Название и изображение:

New:new.jpg

Колонка attributes позволяет импортировать комбинации зависимых атрибутов, например цвет и размер.

Пример:

Цвет:Красный,Чёрный;Размер:56,62;Цена:10;Количество:5;Код:product;Изображения:image.jpg

Для этого примера будут созданы комбинации:

• Красный + 56
• Красный + 62
• Чёрный + 56
• Чёрный + 62

Код и изображение не являются обязательными параметрами.

Формат:

Атрибут:Значение:Действие:Цена

Пример:

Цвет:Синий:+:50.00|Цвет:Красный:/:2.00|Размер:M:-:10.00|Размер:S:*:2.00

Поддерживаемые операции изменения цены:

+  -  *  /  =  %

Колонка free_attributes позволяет назначить товару свободные атрибуты.

Названия разделяются символом |:

Гравировка|Текст надписи|Пожелания

Для полной замены характеристик используется колонка extra_fields.

Пример:

Цвет:Красный,Чёрный|Размер:56,62

Для добавления характеристик к уже существующим можно использовать:

add_extra_fields

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

Формат:

Файл:Описаниеание файла:Демо-файл:Описаниеание демо

Несколько записей разделяются символом |:

File.zip:File Buy Desc:Demo.jpg:Demo Desc|::Demo2.jpg:Demo2

Для очистки файлов товара можно передать:

clear

Для регулярного обновления прайса поставщика можно использовать режим предварительного снятия товаров с публикации.

Типовой сценарий:

1. перед импортом товары снимаются с публикации;
2. ARTIMEX обрабатывает актуальный файл;
3. товары, присутствующие в файле, обновляются и публикуются;
4. позиции, которых больше нет в файле поставщика, остаются неопубликованными.

Это позволяет поддерживать актуальный каталог без ручного поиска товаров, которые поставщик удалил из нового прайса.

ARTIMEX поддерживает автоматический запуск импорта через CLI / Cron.

После создания и сохранения профиля импорта откройте соответствующую вкладку профиля. ARTIMEX сформирует пример CLI-команды для запуска этого профиля.

Команду можно добавить в Cron на сервере и выполнять импорт автоматически по необходимому расписанию.

Аналогично можно автоматизировать экспорт товаров.

Создайте профиль экспорта, настройте необходимые колонки и параметры, после чего используйте сформированную CLI-команду для запуска через Cron.

• Сначала протестируйте импорт на небольшом количестве товаров.
• Проверьте, по какому полю выполняется идентификация товаров.
• Убедитесь, что значения ID, EAN или кода производителя уникальны.
• Перед массовым обновлением каталога сделайте резервную копию базы данных.
• Не добавляйте в файл колонки, которые не нужно изменять.
• Особенно внимательно проверяйте импорт атрибутов, характеристик, категорий и файлов, поскольку некоторые поля заменяют текущие данные товара.