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

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

Для імпорту не потрібно створювати файл із фіксованим набором або послідовністю колонок. 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 або коду виробника унікальні.
• Перед масовим оновленням каталогу зробіть резервну копію бази даних.
• Не додавайте у файл колонки, які не потрібно змінювати.
• Особливо уважно перевіряйте імпорт атрибутів, характеристик, категорій та файлів, оскільки деякі поля замінюють поточні дані товару.