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

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

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

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

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

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

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

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

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

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

• Замовлення в BAS. Під час обміну замовленнями BAS забирає нові й змінені замовлення обраних статусів: покупець, адреса, телефон і e-mail, рядки товарів з ідентифікаторами BAS, доставка й збори як послуги, метод оплати.
• Статуси з BAS. «Скасовано», «оплачено», фінальний статус і власні правила вигляду «Відвантажено = completed». Кожна зміна пишеться нотаткою в замовлення.
• Чесна ознака «оплачено». Для післяплати — лише у статусі «Виконано», для картки — після підтвердження оплати.
• Варіації з характеристик товару: розмір, колір тощо стають варіаціями з власною ціною й залишком.
• Акційна ціна з другого виду цін (наприклад «Акційна») — коли вона нижча за звичайну.
• Склади: залишок на сайті — сума лише відмічених складів.
• Повне вивантаження: товари, які прийшли з BAS раніше, а в повному вивантаженні відсутні, — у чернетку або «немає в наявності». Коли повернуться в 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 у товарах, варіаціях, категоріях і зображеннях: жодних дублів при повторних обмінах і після перейменувань.
• Безпека. Окремі користувач і пароль для BAS із порівнянням у постійному часі; імена файлів перевіряються (жодних «../» і виконуваних розширень), zip розпаковується із захистом від виходу за папку.
• Файли поза публічною папкою. Модуль сам обирає для файлів обміну папку поза коренем сайту й видаляє XML одразу після імпорту — з файлами замовлень включно, бо в них персональні дані. Адмінка показує, де лежать файли.
• Сайт на простих посиланнях отримує адресу вигляду /index.php/bas-exchange/, яка доходить до WordPress без правил переписування.
• Прибирає за собою. З галочкою «Видаляти дані» видалення модуля прибирає його налаштування, журнал, папку обміну й ідентифікатори BAS; самі товари й категорії лишаються.

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

1. Плагіни → Додати новий → Завантажити плагін, оберіть catcode-bas-exchange-for-woocommerce-free-1.0.0.zip (безкоштовна версія) або catcode-bas-exchange-for-woocommerce-1.0.0.zip (Pro) і активуйте. Потрібен активний WooCommerce.
2. WooCommerce → Обмін з BAS → Підключення: скопіюйте адресу сайту для обміну, користувача й пароль. Командою curl з цієї ж вкладки можна перевірити, що адреса відповідає «success».
3. У BAS відкрийте налаштування обміну з сайтом за протоколом CommerceML і вставте ці три значення.
4. На вкладці «Каталог» оберіть, які поля BAS може оновлювати, і залиште «Зіставляти за артикулом», якщо товари на сайті вже є.
5. Запустіть обмін у BAS. Результат кожного кроку — у «Журналі». Після першого обміну оберіть вид цін (і для Pro — вид акційних цін і склади).
6. Для Pro: вставте ліцензійний ключ із листа після оплати або запустіть 7-денний тріал на вкладці «Ліцензія», потім увімкніть обмін замовленнями.