Внешний код для нового обмена CommerceML

MS: Внешний код для нового обмена CommerceML

Описание

Модуль ms_fix_external_id выводит внешний код (external id) в карточку товара, включая вариации. Модуль поддерживает экспорт и импорт внешних кодов через CommerceML и обеспечивает корректную работу с внешними кодами товаров из систем 1С или МойСклад.

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

• Отображение внешнего кода: Вывод внешнего кода товара в карточке товара
• Поддержка вариаций: Отображение внешнего кода для вариаций товаров
• Редактирование внешнего кода: Возможность редактирования внешнего кода в карточке товара (настраивается)
• Проверка уникальности: Проверка уникальности внешнего кода перед сохранением
• Экспорт и импорт: Поддержка экспорта и импорта внешних кодов через CommerceML
• Уведомления: Уведомления о проблемах с внешними кодами при импорте

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

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

1. Хуки товаров (func.php):

• fn_ms_fix_external_id_get_product_data_post() - добавляет внешний код в данные товара:
• Получает внешний код из таблицы commerceml_import_entity_map
• Для вариаций проверяет, совпадает ли внешний код с основным товаром
• Если совпадает, очищает внешний код вариации
• fn_ms_fix_external_id_update_product_post() - сохраняет внешний код при обновлении товара:
• Проверяет уникальность внешнего кода
• Сохраняет внешний код в таблицу commerceml_import_entity_map
• Для вариаций проверяет, что внешний код начинается с внешнего кода основного товара + "#"

1. Схема импорта/экспорта (schemas/exim/products.post.php):

• Расширяет схему импорта/экспорта для работы с внешними кодами

1. Шаблоны:

• design/backend/templates/addons/ms_fix_external_id/hooks/products/update_product_name.post.tpl - добавляет поле внешнего кода в форму редактирования товара
• design/backend/templates/addons/ms_fix_external_id/hooks/products/categories_section.pre.tpl - добавляет поле внешнего кода в раздел категорий

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

• Административная панель:
• Карточка товара с полем "MS: Внешний код товара"
• Настройки модуля для управления редактированием и уведомлениями
• Импорт/Экспорт:
• Поддержка внешних кодов при импорте/экспорте через CommerceML

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

• Разрешить редактирование внешнего кода в карточке товара (edit_on): Включить/выключить возможность редактирования внешнего кода
• Включить уведомления о не записанных external id при импорте (show_notice): Показывать уведомления о проблемах с внешними кодами при импорте

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

1. Просмотр внешнего кода:

• Откройте карточку товара
• Найдите поле "MS: Внешний код товара"
• Внешний код отображается, если он был установлен при импорте или вручную

1. Редактирование внешнего кода:

• Если включена опция редактирования, можно изменить внешний код в карточке товара
• При сохранении проверяется уникальность внешнего кода
• Для вариаций внешний код должен начинаться с внешнего кода основного товара + "#"

1. Импорт/Экспорт:

• При импорте через CommerceML внешние коды автоматически сохраняются
• При экспорте внешние коды включаются в файл экспорта

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

• Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
• Требует наличия модуля commerceml для работы
• Работает с таблицей commerceml_import_entity_map для хранения внешних кодов
• Поддерживает проверку уникальности внешних кодов
• Для вариаций внешний код должен иметь формат: {parent_external_id}#{variation_code}