Імпорт прайсів постачальників для OpenCart 2.3, 3 і 4

Імпорт прайсів постачальників оновлює ціни й залишки в OpenCart з файлу, який надіслав постачальник — Excel, CSV або XML/YML, з комп’ютера або за посиланням. Є три збірки: для OpenCart 4.0.2 – 4.1.x, 3.0.2 – 3.0.5.0 і 2.3.0.x; функціональність однакова, відрізняється лише пакет. Код відкритий, ionCube не потрібен, файли ядра не змінюються.

Будь-який файл постачальника

Модуль читає XLSX (звичайний Excel, без перезбереження в CSV), CSV у UTF-8 або windows-1251 із будь-яким роздільником, а також XML і YML — той формат, у якому прайси віддають Rozetka, Prom і більшість українських дистриб’юторів. Роздільник, кодування й формат визначаються автоматично; аркуш Excel, кількість службових рядків згори й тег товару в XML за потреби вказуються вручну.

Прайс можна завантажити файлом або дати посилання — тоді модуль сам забирає його з сайту постачальника при кожному запуску.

Колонки визначаються самі

Модуль читає заголовок файлу й сам знаходить, де артикул, де ціна, де залишок: розуміє «Артикул», «Код товара», «Цена закупочная», «Наличие», «vendorCode», «stock_quantity» і десятки інших варіантів написання. Будь-яку відповідність можна перевизначити вручну — поруч показані перші рядки файлу, щоб було видно, що саме потрапить у магазин.

Товар знаходиться за артикулом (SKU, MPN або модель), окремо за моделлю чи за штрих-кодом (EAN, UPC, JAN, ISBN) — тим полем, яке реально заповнене у вашому каталозі.

Ціна рахується за вашими правилами

Ціна постачальника не потрапляє в магазин напряму. Спочатку вона переводиться з валюти прайсу за курсом магазину або за курсом, який ви вкажете. Далі застосовується націнка рівнями: до 500 грн — 40%, від 500 до 2000 — 25%, вище — 15% плюс фіксована сума, скільки рівнів потрібно. Потім — округлення: до гривні, до десятки або до звичного «…,99», «…,95», «…,50». Є й нижня межа ціни, нижче якої модуль не опускається.

Залишки розуміють не лише числа: «в наявності», «під замовлення», «немає» перетворюються на кількість за вашою таблицею відповідностей. Можна множити залишок на коефіцієнт, обмежувати стелею й автоматично вимикати товар, коли залишок став нулем.

Захист від зіпсованого прайсу

Постачальник один раз вивантажив ціни в копійках або зсунув колонку — і весь каталог поїхав. Щоб такого не сталося, вкажіть ліміт зміни у відсотках: рядки, де ціна змінюється сильніше, ніж дозволено, не записуються, а показуються окремим списком «Підозріла зміна». Ви дивитесь на них і вирішуєте самі.

Спочатку план, потім запис

Модуль ніколи не пише в каталог одразу. Спершу він читає файл, зіставляє його з товарами й показує повний план: скільки рядків прочитано, скільки знайдено в каталозі, які ціни й залишки зміняться — таблиця «було → стане» по кожному товару. Окремо видно рядки з невідомими кодами, підозрілі зміни, помилки й ті, де нічого не змінилося.

Лише після вашого підтвердження план застосовується — пакетами, тож 40 тисяч рядків не залежать від того, чи витримає один запит таймаут сервера.

Товари, яких немає у прайсі

Якщо постачальник більше не возить позицію, її можна автоматично обнулити за залишком, вимкнути або зробити і те, і те. Правило працює лише в межах вибраного виробника або категорії — саме тому частковий прайс одного постачальника не вимикає весь каталог.

Журнал і відкат

Кожен запуск зберігається: коли, з якого файлу, скільки рядків прочитано й скільки товарів оновлено. Усі зміни записуються по полях — стара й нова ціна, старий і новий залишок, — тож будь-який запуск відкочується одним кліком до значень, які були до нього. Це не «відновіть бекап бази», а точне повернення саме тих товарів, яких торкнувся імпорт.

Автоматичне оновлення за розкладом

Профіль постачальника з посиланням на прайс можна поставити на розклад — щогодини, кожні 6 годин, щодня або щотижня. Модуль сам забирає файл, рахує ціни за вашими правилами й оновлює каталог; результат кожного запуску лишається в історії з тим самим відкатом. Запуск виконується за адресою cron із секретним токеном, щоб ніхто сторонній не міг запустити імпорт.

Навіщо це магазину

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

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

Як встановити

1. Залийте архів через «Розширення → Установник розширень» і встановіть модуль.

2. Завантажте один прайс і перевірте, чи правильно визначились колонки.

3. Задайте правила ціни й поведінку для товарів поза прайсом.

4. Подивіться план змін, і лише тоді запускайте запис.