Каталог импортозамещения

MS: Каталог импортозамещения

Описание

Модуль ms_import_substitution_catalog обеспечивает интеграцию с каталогом импортозамещения (URL с выдачей информации о товарах в JSON формате). Модуль позволяет импортировать данные из каталога импортозамещения и экспортировать данные в формат каталога.

Основные возможности

• Импорт из каталога: Импорт категорий, товаров, производителей, торговых предложений из каталога импортозамещения
• Экспорт в каталог: Экспорт данных в формат каталога импортозамещения через API
• Фильтрация данных: Исключение скрытых категорий, товаров и подкатегорий из импорта/экспорта
• Сопоставление сущностей: Настройка сопоставления характеристик товаров с данными каталога
• Защита паролем: Защита доступа к API паролем

Как работает модуль

Модуль использует следующие механизмы:

1. База данных (upgrades/migrations/): При установке модуль выполняет миграции для создания необходимых структур данных

1. API контроллер (controllers/frontend/ms_import_substitution_catalog.php):

• Предоставляет API endpoint для экспорта данных в формате JSON
• Проверяет пароль доступа
• Формирует JSON ответ с данными о категориях, товарах, производителях

1. Функции импорта (func.php):

• Функции для обработки данных при импорте из каталога
• Создание категорий, товаров, связей на основе JSON данных

1. Настройки сопоставления:

• Сопоставление характеристик товаров с полями каталога
• Настройка фильтрации характеристик по категориям

Где находится функциональность

• Административная панель:
• Настройки модуля с параметрами импорта/экспорта
• Настройки сопоставления сущностей
• API:
• Endpoint для экспорта данных в формате JSON каталога импортозамещения

Настройки модуля

Общие настройки

• Пароль доступа (access_password): Пароль для доступа к API экспорта (по умолчанию "password")
• Информация о ссылке (url_info): Информация о URL для экспорта данных

Настройка импорта

• Импортировать категории (import_categories): Включить импорт категорий
• Импортировать зависимости категорий (import_categories_relations): Включить импорт связей категорий
• Импортировать субъекты хозяйственной деятельности (import_economic_entities): Включить импорт компаний
• Импортировать товары (import_products): Включить импорт товаров
• Импортировать связь товара и производителя (import_product_manufacturers): Включить импорт связей с производителями
• Импортировать связь товара и категории (import_product_categories): Включить импорт связей товаров с категориями
• Импортировать торговые предложения (import_product_offers): Включить импорт торговых предложений
• Импортировать связь торгового предложения и расположения (import_product_offer_locations): Включить импорт связей с расположениями

Исключения из импорта

• Исключить скрытые и выключенные категории (exclude_hidden_categories): Исключить из экспорта
• Исключить подкатегории у скрытых категорий (exclude_hidden_subcategories): Исключить подкатегории
• Исключить скрытые и выключенные товары (exclude_hidden_products): Исключить из экспорта
• Исключить товары у скрытых категорий (exclude_hidden_categories_products): Исключить товары
• Не передавать остатки товара (exclude_product_amount): Исключить информацию об остатках

Сопоставления сущностей

• Хозяйствующий субъект (economic_entity): Характеристика для сопоставления с субъектом хозяйственной деятельности
• Тип хозяйствующего субъекта (economic_entity_type): Тип (Company или Outlet)
• ISO-код страны (country_code_iso): Код страны (по умолчанию RU)
• Единица измерения количества (amount_unit): Единица измерения (по умолчанию "шт")
• Категории (enable_categories): Выбор категорий для импорта/экспорта
• Способ фильтрации (filter_features_in_categories): Фильтрация характеристик внутри категорий или вместе с категориями
• Использовать значения характеристик (enable_feature_variants_tpl): Настройка сопоставления вариантов характеристик

Использование

1. Настройка модуля:

• Укажите пароль доступа
• Настройте параметры импорта
• Настройте исключения из импорта
• Настройте сопоставления сущностей

1. Экспорт данных:

• Используйте API endpoint с паролем для получения данных в формате JSON

1. Импорт данных:

• Получите данные из каталога импортозамещения
• Выполните импорт через API или стандартную систему импорта

Технические детали

• Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
• При установке выполняет миграции для создания необходимых структур данных
• Предоставляет API endpoint для экспорта данных
• Работает с JSON форматом данных каталога импортозамещения