Инструкция к модулю синхронизация Opencart и al-style.kz по API

Установка

Скачайте модуль с официального сайта api-pro.ru. Установите модуль стандартным способом с помощью Модули - Установка расширений.

Перед установкой мы рекомендуем скачать и установить расширение FIX (Opencart 3) (Opencart 2).

Перейдите в список модулей. Найдите Al-Style интеграция Api и активируйте его. 

Перейдите в раздел Система - Пользователи - Группы пользователей. 

Выберите группу и добавьте разрешения для:

• catalog/als_category
• catalog/als_product
• extension/module/als

Сохраните изменения.

Настройка

Перейдите в настройки модуля Каталог - Интеграция с Al-Style - Настройки модуля. 

Откройте личный кабинет на Al-Style и скопируйте API ключ. Вставьте ключ в поле Access-token.

Из Al-Style по каждой товарной позиции приходит 2 типа цены: 

• Цена розничная
• Цена дилерская

Настройка базовой цены товара

Настройте тип цены который будет использоваться для основной цены товара. Если требуется, настройте наценку на эту цену в процентах. 

Цена будет записываться в товаре Товар - Данные - Цена

Настройка акционной цены товара

Настройте тип цены для формировании акционной цены товара, если это требуется. 

При выборе группы покупателей загруженная цена будет доступна только им.

При выборе “Не загружать оптовую цену” цена не будет записана в Акции товара.

Настройка минимальной цены товара

Настройте цену ниже которой товары не будут загружены из Al Style

Настройка ограничения по минимальному остатку

Настройка позволяет активировать товар на сайте только если остаток у него на Al Style больше чем указан в настройках модуля. Это значит что при синхронизации товар будет загружен но выключен при остатке меньше чем в настройках модуля.

Выбор группы для добавления характеристик товара

Создайте или выберите группу для атрибутов товаров. При загрузке товаров из Al Style новые атрибуты будут иметь выбранную группу.

Настройка CRON для синхронизации данных

Для оптимизации весь процесс синхронизации был разделен на этапы. Последовательный запуск этапов позволяет полностью синхронизировать данные по товарам.

Первый этап - Синхронизация категорий

На этом этапе загружается полная иерархия категорий с Al Style. Это необходимо чтобы загруженные в последствии товары были распределены по категориям. В категориях можно настроить индивидуальные коэффициенты наценки на каждую. Как правило категории первоначально загружаются по нажатию кнопки на странице Синхронизация. После загрузки категорий на сайт часть категорий, которые вам не понадобятся можно отключить от синхронизации. При этом товары этих категорий не будет загружены на сайт.

Второй этап - Синхронизация товаров

На этом этапе загружаются базовые данные по товарам. Загружаются только товары из категорий по которым включена синхронизация. После синхронизации товаров они доступны к продаже на сайте. На этапе синхронизации товаров проверяется параметр минимальной цены и остатка. Если цена или остаток товара  меньше чем указано в настройках модуля, товар загружается но выключается на сайте. При очередной синхронизации товаров данное условие проверяется и товар может стать активным.

Третий этап - Синхронизация атрибутов

Синхронизация атрибутов производится только по товарам по которым она не была произведена. Остальные товары игнорируются.

Четвертый этап - Синхронизация изображений

Синхронизация изображений производится только по товарам по которым она не была произведена. Остальные товары игнорируются. При синхронизации изображение скачивается с Al Style, размещается в каталоге на сайте. После загрузке изображения товара и повторной синхронизации повторного скачивания изображения не происходит.

Пятый этап - Синхронизация остатков и цен

Синхронизация остатков и цен производится по загруженным на соответствующем этапе товарам. При синхронизации используется тип цены указанный в настройках модуля. При изменении настройки типа цены новая цена товара может быть загружена по нажатию кнопки “Остатки и цены” на странице Синхронизация.

Удаление загруженных данных

Для очистки загруженных категорий используйте кнопку в настройках модуля

Для очистки загруженных товаров с Al Style используйте кнопку в настройках модуля 

Важно! при нажатии на эти кнопки удаляются только загруженные с Al Style данные. Товары, категории добавленные вручную затронуты не будут.