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