Обмін з УкрСклад
УкрСклад (ukrsklad.com) — настільна програма складського обліку й продажів. Її вбудована «Синхронізація з Інтернет-магазином» сама ходить на сайт по HTTP і обмінюється ZIP-архівами з CSV-файлами. Модуль ECMS9 говорить цим протоколом з боку сайту — програма налаштовується так само, як для магазину на OpenCart, з URL і доступами, які показує модуль.
Сторінка налаштувань — Обмін з УкрСклад у списку модулів (відкривається
/admin/ukrsklad). Обмін активний лише коли заповнено і логін, і пароль; з
порожніми доступами точка обміну відповідає 403, і програма не може
під'єднатись.
Що передається
З УкрСкладу на сайт («Надіслати дані на сайт» у програмі):
- групи товарів → категорії магазину (створюються або оновлюються за назвою);
- товари → варіанти товарів: одна позиція УкрСкладу = один варіант. Ціна (акційна ціна стає поточною, стара зберігається), залишок, код → артикул (SKU), штрихкод → поле артикулу-штрихкоду, назва, опис, бренд і категорія. Товар, у якого вже кілька варіантів, отримує лише оновлення ціни / залишку / кодів — його назва, опис і категорія не чіпаються;
- фото (сайт просить до 20 за один обмін, тож вони доходять за кілька прогонів);
- код УКТ ЗЕД кожної позиції, який записується в кастом-поле товару.
З сайту в УкрСклад («Прийняти дані в УкрСклад»):
- категорії, товари з цінами й залишками, метадані фото;
- покупці — зареєстровані та гості;
- замовлення з позиціями, змінені після дати, яку пам'ятає програма («Дата і час останніх отриманих даних з сайту»), з фільтрами, описаними нижче.
Великі каталоги передаються порціями автоматично. Вага й габарити в обмін не входять.
Налаштування
Картка Доступ для програми:
| Поле | Значення |
|---|---|
| URL обміну (вставте у програму) | https://ваш-сайт/import_ukrsklad.php — лише для читання, з кнопкою копіювання. В УкрСкладі це поле «URL магазину» на вкладці «OpenCart / ocStore». |
| Логін обміну / Пароль обміну | Доступи basic-auth, які надсилає програма. Згенерувати доступи підставляє стійкі випадкові. |
Картка Налаштування обміну:
| Поле | Типово | Значення |
|---|---|---|
| Мова обміну (назви й описи) | мова сайту | Якою мовою читаються і пишуться назви й описи. |
| Які статуси замовлень віддавати в УкрСклад | усі | Нічого не вибрано = всі статуси. Програма додатково фільтрує за власними налаштуваннями статусів резерву/оплати. |
| Віддавати лише оплачені замовлення | вимк. | Експортувати лише замовлення з прапорцем оплати. |
| Статус після вигрузки замовлення в УкрСклад | Не змінювати | Застосовується один раз — коли замовлення вперше потрапляє у вигрузку. |
| Віддавати фото товарів | увімк. | Вимкніть, щоб віддавати лише дані. |
| Кастом-поле товару з кодом УКТ ЗЕД | uktzed | Див. нижче. |
| Режим прев'ю (dry-run) | вимк. | Див. нижче. |
Режим прев'ю для першого імпорту
Перше вивантаження з програми в уже наповнений каталог — ризиковий момент:
кожна позиція, яку модуль не зміг зіставити з наявним варіантом, створюється
заново, тобто стає дублем. Перемикач Режим прев'ю (dry-run): не змінювати БД,
лише будувати звіт зіставлення прибирає цей ризик: поки він увімкнений,
вивантаження з програми нічого не пише в каталог — кожна позиція лише
аналізується і записується у звіт зіставлення (/admin/ukrsklad/dryrun,
посилання Відкрити звіт зіставлення).
Зіставлення йде трьома рівнями, однаково у прев'ю і в справжньому імпорті:
- id варіанта на сайті, який програма запам'ятала з попереднього обміну;
- власна мапа модуля (номер в УкрСкладі → варіант);
- пошук усередині цільової категорії за назвою, за кодом або за назвою + кодом — як задано в налаштуванні програми «шукати товар за».
Звіт підсумовує позиції як Зіставлено (оновилось би), Лише за нормалізованою назвою (рятується) (строгого збігу нема, але десь на сайті є варіант з такою ж нормалізованою назвою — підказка вирівняти назви чи коди до справжнього прогону), Без збігу (створився б = ризик дубля) і Групи ще нема на сайті (пропуск категорії), а також перелічує кожну позицію з рівнем збігу і зіставленим товаром. Виправте назви/коди, запустіть вивантаження ще раз і вимикайте режим прев'ю, коли в колонці «створився б» лишаться тільки справді нові товари.
Поки він увімкнений, кожне вивантаження з програми — пробне, каталог не змінюється. Вимкніть його, коли закінчите, інакше справжній імпорт так і не відбудеться.
Спільне з фіскалізацією поле УКТ ЗЕД
УКТ ЗЕД — один атрибут товару, яким користуються два модулі: модуль
Фіскалізації (ПРРО) передає його в чеках, УкрСклад
віддає й приймає як «Код УКТ ЗЕД». Щоб обидва дивились в одне поле: коли модуль
Фіскалізації присутній і в ньому задано назву поля, перемагає та назва, а
налаштування УкрСкладу ігнорується; лише без модуля Фіскалізації діє
налаштування тут (а далі — типове uktzed).
Потік статусів замовлення
Типовий потік: рахунок → очікує оплату → оплачено й підтверджено (склад пакує) → передано на склад → відправлено. В УкрСклад замовлення зазвичай переносять тоді, коли їх має побачити склад, тож:
- виберіть статуси для вигрузки в Які статуси замовлень віддавати в УкрСклад і, за бажанням, увімкніть Віддавати лише оплачені замовлення;
- за потреби задайте Статус після вигрузки замовлення в УкрСклад — замовлення перейде туди один раз, коли вперше потрапить у вигрузку; наступні обміни його статус уже не чіпають. Кожне замовлення також несе прапорець оплати і статус сайту, які програма мапить на свої статуси «резерв» / «оплачено».
Налаштування програми УкрСклад
Кроки повторюють інструкцію на сторінці налаштувань:
- Заповніть логін/пароль і збережіть.
- В УкрСкладі відкрийте «Синхронізація з Інтернет-магазином» → Параметри, вкладка «OpenCart / ocStore».
- Увімкніть «Синхронізація включена», вставте URL обміну в «URL магазину», а доступи — в «Логін до скрипту» / «Пароль до скрипту».
- Натисніть «Тест з'єднання» — сайт відповідає «Тест ОК».
- Натисніть «Інформація про сайт» — програма підтягне мови сайту і статуси замовлень; далі виберіть статуси для «Резервування товару» і «Товар оплачений».
- Встановіть «Дата і час останніх отриманих даних з сайту» — замовлення, змінені після цієї дати, прийдуть при наступному обміні.
- Перший прогін: «Надіслати дані на сайт» віддає каталог УкрСкладу на сайт (спершу з увімкненим режимом прев'ю, див. вище); «Прийняти дані в УкрСклад» забирає замовлення й покупців.
Журнал
Картка Журнал обмінів (останні 20) фіксує кожен запит від програми: час,
дію (test, upload, download, …), кількість рядків, результат і
повідомлення з деталями — перше місце, куди дивитись, коли програма повідомляє
про помилку. Очистити журнал спорожнює його.