- dodano obsługę multi-store kompletną
Найважливіші функції та переваги
- Масове оновлення кількості: зміна залишків багатьох позицій з одного файлу, без ручного редагування кожної картки товару.
- Окремі режими товарів і комбінацій: оновлення товарів без варіантів або залишків конкретних варіантів, з перерахунком їх суми на рівні товару.
- Зіставлення за каталожними кодами: артикул, тобто SKU, EAN13, UPC, ID товару, ID комбінації, а також MPN, якщо відповідне поле доступне в установці.
- Зіставлення колонок постачальника: вказання колонок ідентифікатора та кількості, пропуск додаткових даних, а також пропозиція зіставлення на основі розпізнаних заголовків.
- Встановлення або додавання кількості: використання повного переліку залишків або файлу, що містить кількості для додавання, наприклад із поставки.
- Урахування відкритих замовлень: опціональне віднімання кількості із замовлень із вказаними статусами перед застосуванням значень із файлу.
- Симуляція перед записом: перевірка зіставлень, запланованих змін і причин пропуску позицій без зміни залишків у каталозі.
- Налаштовувані ліміти: контроль відсоткового зростання та зменшення кількості, обнулення залишків, а також частки рядків без зіставлення з магазином.
- Обробка від’ємного результату: вибір між записом від’ємного значення, підняттям його до нуля та пропуском позиції.
- CSV-звіт і екран відмінностей: кількості до та після операції, різниця, ідентифікатори, а також рішення щодо конкретного рядка; у панелі доступні фільтри та пагінація звіту.
- Історія та відновлення кількості: доступ до виконаних запусків і скасування збережених змін, якщо збережено знімок залишків до імпорту.
- Експорт поточних залишків: CSV-файл для товарів або комбінацій із вибором магазину, ідентифікатора та роздільника, з урахуванням збереженого зіставлення колонок.
- Завантаження від постачальника та профілі налаштувань: імпорт файлів з адреси HTTP/HTTPS або сервера FTP/FTPS, а також збереження конфігурацій, що використовуються для різних джерел даних.
- Підтримка циклічних оновлень: адреса для зовнішнього CRON, перегляд результату останнього виклику та продовження розпочатого імпорту.
- Поетапна обробка більших файлів: індикатор прогресу та можливість продовження з панелі, також за допомогою кнопки, коли JavaScript вимкнено.
- Контроль індексу ідентифікатора: інформація про відсутній індекс бази даних і інструмент для його додавання, корисний під час зіставлення позицій у більшому каталозі.
- Підсумок електронною поштою: опціональне повідомлення після виконаного оновлення, зі звітом як вкладенням, якщо його розмір це дозволяє.
Як працює оновлення залишків товарів і варіантів?
Режим товарів призначений для оновлення позицій без комбінацій. Товар, що має комбінації, у цьому режимі пропускається й отримує відповідний запис у звіті. Щоб змінити кількості варіантів, слід вибрати режим комбінацій і зіставити ідентифікатори з файлу з відповідними варіантами. Після запису модуль перераховує загальний залишок товару як суму кількостей його комбінацій.
- Встановити залишок: якщо магазин має 10 шт., а файл містить 25, новий залишок становитиме 25 шт.
- Додати до залишку: за наявності 10 шт. у магазині та значення 25 у файлі результат становитиме 35 шт.
- Відняти відкриті замовлення: у режимі встановлення, за значення 25 у файлі та 4 шт. у замовленнях із вибраними статусами, результат становитиме 21 шт.
Приклади передбачають правильне зіставлення та відсутність блокування лімітами; у перших двох віднімання замовлень вимкнено. Опція віднімання використовує замовлення цільового магазину й не підтримує зіставлення за MPN. За спільних каталожних кодів можна оновлювати перше зіставлення або всі зіставлені позиції.
CSV-файл зі складу або гуртівні
Базова структура містить ідентифікатор і кількість. Можна налаштувати роздільник, зокрема табуляцію, визначити наявність заголовка та призначити інші позиції колонок. Попередній перегляд даних полегшує перевірку зіставлення, а пропозиція, розпізнана із заголовків, потребує підтвердження. Файл слід підготувати в UTF-8; зчитувач видаляє позначку BOM і підтримує поля в лапках.
Приклад для роздільника крапка з комою, ідентифікації за артикулом і ввімкненого пропуску заголовка:
код;кількість
SKU-001;25
SKU-002;0
SKU-003;8
Кількості записуються як цілі числа. Значення 3,9 або 3.9 буде зчитано як 3, а -3,9 як -3. Порожні або нечислові значення пропускаються з інформацією у звіті. Коректне число 0 означає пропозицію встановити нуль у режимі встановлення залишків і надалі підлягає налаштованим лімітам.
Контроль змін і скасування імпорту
Симуляція за замовчуванням увімкнена у формі запуску оновлення. Ліміти дають змогу пропустити заблоковану позицію або відхилити імпорт після аналізу, виконаного перед записом. Відсоткове зростання та зменшення оцінюються відносно додатного залишку, що існує в магазині. Окремий поріг може зупинити імпорт, коли частка коректно зчитаних рядків без корисного зіставлення з магазином досягне встановленого значення.
Звіт показує рішення щодо даних, а історія зберігає інформацію про файл, магазин, режим і результати запуску. За ввімкненого збереження знімків функція відновлення відтворює попередні кількості для позицій, охоплених знімком. Кількість збережених запусків можна налаштувати; за замовчуванням це 10. Відновлення записує кількості до імпорту, тому може перезаписати їхні пізніші зміни, що виникли внаслідок замовлень, ручного редагування або наступних оновлень.
Завантаження файлів і автоматичне оновлення залишків
Файл можна завантажити вручну або отримати з публічної адреси HTTP/HTTPS чи сервера FTP/FTPS. SFTP доступний, якщо його підтримує бібліотека cURL на сервері магазину. Завантаження вимагає розширення cURL і джерела, доступного за публічною адресою; адреси приватної мережі відхиляються.
Після ввімкнення автоматизації модуль надає адресу, захищену секретним токеном. Частота викликів визначається у зовнішньому розкладі CRON. Наступний виклик продовжує активний імпорт; якщо розпочатого запуску немає, можна завантажити новий файл і виконати оновлення, лише завантажити файл або запустити імпорт уже збереженого файлу. Також доступна перевірка статусу.
Профілі постачальників зберігають, зокрема, роздільник, зіставлення, ідентифікатор, режим кількості, ліміти та джерело завантаження. Вони зберігаються окремо для цільового магазину. Вони не містять пароля постачальника або токена CRON, тому зміна профілю вимагає перевірки поточного пароля в налаштуваннях автоматизації.
Робота в multistore і межі дії модуля
- Вибір магазину: імпорт і експорт мають налаштування цільового магазину. Якщо група магазинів спільно використовує залишки, оновлення стосується її спільного ресурсу, що також впливає на інші магазини, які використовують ці кількості. Поточні налаштування модуля є спільними для всієї установки.
- Оновлення наявного каталогу: модуль не створює товари чи комбінації та не імпортує ціни, описи, зображення чи нові ідентифікаційні коди. Немає функції автоматичного обнулення всіх позицій, відсутніх у файлі.
- Формат і розмір файлу: приймаються файли CSV і TXT зі структурою CSV, без прямого імпорту XLSX або XML. Ліміт модуля становить 32 MiB; ліміт ручного завантаження може бути нижчим через налаштування сервера.
- Продовження роботи: при поетапному імпорті, запущеному в панелі, наступні кроки вимагають відкритої сторінки, ручного продовження або викликів CRON. Закриття вкладки не запускає окремий фоновий процес.
- Сумісність із складськими доповненнями: пакетний запис не викликає хук
actionUpdateQuantityі не створює записів рухів складуstock_mvt. Доповнення, що потребують цих подій, вимагають окремої перевірки сумісності. - Заявлена сумісність для версії 2.0.0: PrestaShop від 1.7.6.0 до серії 9.x; документація модуля вказує PHP 7.0–8.5. Версія PHP водночас має відповідати вимогам використовуваної версії PrestaShop.
Порядок роботи з модулем
- Виберіть магазин, тип оновлення, ідентифікатор і спосіб застосування кількості.
- Завантажте або отримайте файл, перевірте роздільник і заголовок, а потім збережіть зіставлення колонок.
- Налаштуйте ліміти, збереження знімків і, за потреби, віднімання кількості з вибраних статусів замовлень.
- Запустіть симуляцію та перегляньте підсумок і звіт відмінностей.
- Після перевірки даних запустіть оновлення з вимкненою симуляцією, а результат перевірте в історії.
Посилання на демо модуля:
Демо панель адміністратора:
https://moduly-prestashop.eu/csvquantityupd/admin-dev
Демо фронт-офіс:
https://moduly-prestashop.eu/csvquantityupd