# Инструкция по использованию модуля ms_commerceml_modification

Установка

1. Установите модуль через раздел Модули → Скачанные модули
2. Активируйте модуль Модификация импорта CommerceML

Опционально:

• Для работы с артикулом поставщика установите модуль rf_stock_parser
• Для работы с ценами "rf_cost" установите модуль rf_supplier_price

Настройка

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

1. Перейдите в Модули → Скачанные модули → Модификация импорта CommerceML
2. Настройте параметры:

Удалять вариацию товара, если её нет в наличии:

• Включите для автоматического удаления вариаций при отсутствии в наличии
• По умолчанию выключено

Не создавать товары без штрих-кода:

• Включите для предотвращения создания товаров без штрих-кода
• Товары без штрих-кода или с кодом, начинающимся с "2", не будут созданы
• По умолчанию выключено

Заменять код продукта при отсутствии штрих-кода на Артикул_Постфикс:

• Включите для автоматической замены кода продукта
• Код будет заменён на формат "Артикул_Постфикс"
• По умолчанию включено

Характеристика для Постфикса:

• Выберите характеристику из списка
• Значение этой характеристики будет использоваться как постфикс к артикулу
• Оставьте пустым, если постфикс не нужен

Загружать артикул в поле Артикул поставщика:

• Включите для импорта артикула в поле поставщика
• Требует установленного модуля rf_stock_parser
• По умолчанию включено

1. Сохраните настройки

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

Автоматическая работа при импорте

После настройки модуля при обмене данными через CommerceML:

1. Обработка товаров без штрих-кода:

• Если включена опция "Не создавать товары без штрих-кода":
• Товары без штрих-кода не будут созданы
• Товары с кодом, начинающимся с "2", не будут созданы

1. Замена кода продукта:

• Если включена опция "Заменять код продукта":
• Код продукта будет заменён на "Артикул_Постфикс"
• Постфикс берётся из выбранной характеристики
• Если постфикс отсутствует, используется только артикул

1. Удаление вариаций:

• Если включена опция "Удалять вариацию товара, если её нет в наличии":
• Вариации с количеством 0 и помеченные как удалённые будут удалены

1. Импорт артикула поставщика:

• Если включена опция и установлен модуль rf_stock_parser:
• Артикул из CommerceML будет импортирован в поле manufacturer_code

Проверка результатов

1. После импорта проверьте товары:

• Убедитесь, что товары без штрих-кода обработаны согласно настройкам
• Проверьте коды продуктов (должны быть заменены при необходимости)
• Проверьте вариации (должны быть удалены при отсутствии в наличии)

1. Проверьте артикул поставщика:

• Откройте товар в админ-панели
• Проверьте поле "Артикул поставщика" (если используется модуль rf_stock_parser)

Импорт/Экспорт

Модуль не поддерживает импорт/экспорт данных. Работает только при обмене данными через CommerceML.

Тестирование

1. Настройте модуль согласно требованиям
2. Подготовьте тестовые данные в 1С:

• Товары без штрих-кода
• Товары с кодом, начинающимся с "2"
• Вариации с количеством 0

1. Выполните обмен данными через CommerceML
2. Проверьте результаты:

• Убедитесь, что товары обработаны согласно настройкам
• Проверьте коды продуктов
• Проверьте вариации
• Проверьте артикул поставщика

Обслуживание

Обновление модуля

Обновление модуля выполняется стандартным способом через раздел Модули → Скачанные модули.

Удаление модуля

При удалении модуля:

• Все настройки модуля удаляются
• Модификации при импорте прекращаются
• Импорт возвращается к стандартному поведению CommerceML
• Изменённые коды продуктов и удалённые вариации остаются (не откатываются)

Ключевые файлы

• func.php - функции модуля (выбор характеристики для постфикса)
• hooks.func.php - хуки для обработки товаров и вариаций при импорте
• schemas/cml/mappable.post.php - схема сопоставления данных CommerceML
• schemas/product_variations/product_types.post.php - схема типов вариаций
• addon.xml - конфигурация модуля
• var/langs/ru/addons/ms_commerceml_modification.po - языковые файлы