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-дневный триал на вкладке «Лицензия», затем включите обмен заказами.