BAS Exchange для OpenCart — обмін товарами, цінами, залишками й замовленнями з BAS

BAS Exchange для OpenCart — модуль обміну між магазином на OpenCart і BAS за протоколом CommerceML 2. Товари, ціни й залишки ведуться в BAS, а магазин отримує їх сам: без вивантажень у CSV чи Excel, без ручного переписування цін і без ситуації, коли на сайті «є в наявності» те, чого вже немає на складі. У зворотний бік (у Pro) BAS забирає замовлення з магазину й повертає їхні статуси.

Обмін запускає BAS: у налаштуваннях обміну з сайтом ви вказуєте адресу, користувача й пароль із вкладки «Підключення», а далі BAS за розкладом або вручну надсилає каталог і пропозиції й забирає замовлення. Магазин відповідає рівно так, як очікує протокол. Один модуль — три збірки: OpenCart 4.x, 3.x і 2.3.

Магазин на WordPress? Є BAS Exchange для WooCommerce з тим самим протоколом і тими самими налаштуваннями.

Як це виглядає для покупця

Покупець бачить на сайті те, що є в BAS, — і не бачить самого обміну:

• Актуальні ціни й наявність. Ціна з обраного виду цін і залишок оновлюються з кожним обміном.
• Каталог як в обліку. Групи BAS стають категоріями з тією самою вкладеністю (верхні — у меню вітрини), властивості — атрибутами на вкладці характеристик товару.
• Фото й опис приходять разом із товаром; повторний обмін не плодить копії зображень у image/catalog.
• Розміри й кольори (Pro) — обов’язкова опція «Розмір / Колір» з власним залишком і ціною кожного значення; значення, якого немає на складі, купити не можна. Акційна ціна показується поруч із закресленою звичайною.
• Товар, який у BAS позначили на видалення, вимикається й зникає з вітрини.

Що отримує адмін

Розширення → Модулі → Обмін з BAS, п’ять вкладок: «Підключення», «Каталог», «Замовлення» (Pro), «Журнал і ручний імпорт» і «Ліцензія».

• Підключення за хвилину. Адресу, користувача й пароль модуль створює під час встановлення — їх лишається скопіювати в BAS. Користувач і пароль окремі, це не обліковий запис адміністратора OpenCart.
• Контроль над полями. Назва, опис, артикул і штрихкод, категорії, зображення, атрибути, виробник — кожне поле можна віддати BAS або лишити редагованим у магазині. Тексти пишуться в усі мови магазину або лише в одну, якщо інші ви перекладаєте вручну.
• Види цін і склади модуль бере з файлів BAS і показує в налаштуваннях — назви не треба вгадувати.
• Журнал пише кожен крок обміну з результатом: що прийшло, скільки створено й оновлено, що пропущено і чому. Повна історія — у файлі cc_basx.log у папці журналів магазину.
• Ручний імпорт — завантажити import.xml, offers.xml або zip із зображеннями просто в адмінці. Зручно для першого заповнення й для перевірки проблемного файлу.

Pro: замовлення, характеристики, склади, акції

• Замовлення в BAS. Під час обміну замовленнями BAS забирає нові й змінені замовлення обраних статусів: покупець, адреса доставки, телефон і e-mail, рядки товарів з ідентифікаторами BAS (разом з характеристикою), доставка й збори як послуги, знижки й купони, розкладені по рядках.
• Статуси з BAS. «Оплачено», фінальний статус, «скасовано» і власні правила вигляду «Відвантажено = Complete». Зміна проходить через штатну історію замовлення OpenCart — з записом в історії, як при ручній зміні статусу.
• Чесна ознака «оплачено». Для післяплати — лише у статусі завершення, для передоплати — у статусах, які ви відмітили.
• Характеристики. В OpenCart немає варіацій, тому характеристики товару з BAS стають однією обов’язковою опцією з власним залишком і різницею в ціні; ціна товару — найдешевша характеристика.
• Акційна ціна з другого виду цін (наприклад «Акційна») — коли вона нижча за звичайну.
• Склади: залишок у магазині — сума лише відмічених складів.
• Повне вивантаження: товари, які прийшли з BAS раніше, а в повному вивантаженні відсутні, — вимкнути або залишок 0. Коли повернуться в BAS, знову з’являться на вітрині. Товари, додані в магазині вручну, не чіпаються ніколи.

Як це працює — крок за кроком

1. BAS звертається на адресу обміну з користувачем і паролем і отримує сесію.
2. Магазин повідомляє, чи приймає zip-архіви і якого розміру частини файлів можна слати, — у межах того, що приймає ваш сервер.
3. BAS надсилає файли: import.xml (групи, властивості, товари), offers.xml (ціни й залишки) і зображення — частинами або одним архівом.
4. Магазин імпортує файл кроками: якщо час кроку вичерпано, відповідає «progress», і BAS повторює запит, доки імпорт не завершиться.
5. Кожен товар, категорія й характеристика отримують ідентифікатор BAS у таблицях модуля — наступні обміни оновлюють їх, а не створюють нові.
6. Файли обміну видаляються одразу після імпорту; у журналі лишається результат кожного кроку.
7. Pro: під час обміну замовленнями BAS отримує файл із замовленнями, підтверджує отримання, а наступного разу — лише нові й змінені. Статуси з BAS повертаються окремим файлом.

Що під капотом

• Потокове читання XML. Файли читаються по одному елементу, а не цілком у пам’ять, тож великий каталог не впирається в memory_limit. Файли в кодуванні windows-1251 теж читаються.
• Продовження з місця зупинки. Стан імпорту кожного файлу зберігається між кроками; повторний запит BAS продовжує, а не починає спочатку.
• Власні таблиці зв’язків з ідентифікаторами BAS для категорій, товарів, характеристик, атрибутів і зображень: жодних дублів при повторних обмінах і після перейменувань. Таблиці OpenCart отримують лише звичайні рядки каталогу.
• Безпека. Окремі користувач і пароль для BAS; імена файлів перевіряються (жодних «../» і виконуваних розширень), zip розпаковується із захистом від виходу за папку.
• Файли поза публічною папкою. Модуль сам обирає для файлів обміну папку поза коренем сайту й видаляє XML одразу після імпорту — з файлами замовлень включно, бо в них персональні дані. Адмінка показує, де лежать файли; іншу папку можна задати константою CC_BASX_EXCHANGE_DIR у config.php.
• Власний обробник помилок. Обмін працює під своїм error-handler: OpenCart 4 на будь-яке попередження PHP перекидає на сторінку помилки, а BAS має отримати відповідь протоколу.
• Прибирає за собою. З галочкою «Видаляти дані під час видалення модуля» видалення прибирає його таблиці, журнал і папку обміну; самі товари, категорії й замовлення лишаються.

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

1. OpenCart 4: Extensions → Installer → завантажте cc_basx.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Install». OpenCart 3: Extensions → Installer → cc_basx-oc3.ocmod.zip, потім Extensions → Modifications → Refresh. OpenCart 2.3: залийте вміст папки upload/ з cc_basx-oc2.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу).
2. Extensions → Extensions → Modules → «Обмін з BAS» (BAS Exchange) → «Install», потім «Edit».
3. Вкладка «Підключення»: скопіюйте адресу сайту для обміну, користувача й пароль. Командою curl з цієї ж вкладки можна перевірити, що адреса відповідає «success».
4. У BAS відкрийте налаштування обміну з сайтом за протоколом CommerceML і вставте ці три значення.
5. На вкладці «Каталог» оберіть, які поля BAS може оновлювати, і залиште «Зіставляти за артикулом», якщо товари в магазині вже є.
6. Спершу один обмін, потім склади. Запустіть обмін у BAS і перевірте «Журнал». Після першого обміну на вкладці «Каталог» з’являться види цін і склади — оберіть вид цін (для Pro — ще вид акційних цін і склади) і збережіть.
7. Для Pro: вставте ліцензійний ключ із листа після оплати або запустіть 7-денний тріал на вкладці «Ліцензія», потім увімкніть обмін замовленнями на вкладці «Замовлення».