1C Import Queue for CS-Cart

При каждой выгрузке из 1С CS-Cart может не узнать уже существующие товары и создать дубликаты вместо обновления. Это происходит потому что 1С иногда генерирует новые идентификаторы для тех же самых товаров. Модуль автоматически сопоставляет товары по артикулу и устраняет эту проблему без ручной правки.

Этот модуль нужен если:

• после выгрузки из 1С появляются дубликаты товаров
• импорт создаёт новые товары вместо обновления существующих
• часть товаров при импорте молча пропускается и непонятно почему
• вы хотите видеть все ошибки CommerceML в одном месте

Что умеет модуль:

• Товары обновляются, а не задваиваются — даже если 1С сменила их идентификаторы
• Предпросмотр перед применением — видите все изменения до того как они произойдут
• Откат одним кликом — если что-то пошло не так, мгновенный возврат к предыдущему состоянию
• Поиск дубликатов артикулов — и в базе сайта, и внутри XML-файла из 1С
• Пропущенные записи — показывает какие товары пропустил импорт и почему
• Журнал ошибок CommerceML — все ошибки из лог-файлов в одной таблице с привязкой к товарам
• Безопасный режим — проверяет совпадение названия товара перед заменой идентификатора

1. Установка и настройка

Установка производится стандартным способом через панель управления CS-Cart:

• Распакуйте архив модуля и скопируйте содержимое в корневую директорию сайта, сохранив структуру папок
• Перейдите в Модули → Управление модулями
• Найдите «IP5 Fixed UUID» и нажмите «Установить»
• Откройте настройки модуля, нажав на его название

После установки откройте страницу настроек. Доступны следующие параметры:

• Проверять название товара — если включено, идентификатор заменяется только при совпадении названия товара в XML и в базе данных. Повышает точность, снижает риск ошибочных замен.
• Путь к XML-файлу — относительный путь от корня сайта до XML-файла CommerceML. Пример: var/files/1/exim/1C/import0_1.xml. Ниже поля модуль автоматически показывает список найденных XML-файлов в директории экспорта.

Рис. 0 — Страница настроек с параметрами конфигурации и кнопками быстрого доступа

2. Предпросмотр и применение замен

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

• Нажмите кнопку «Запустить сейчас» на странице настроек
• Модуль прочитает XML-файл и сформирует список замен — для каждого товара показаны артикул, название, текущий и новый идентификатор из файла 1С
• Проверьте таблицу: строки, где название товара в XML и на сайте не совпадает, выделены отдельно
• Нажмите «Применить» для обновления записей
• После применения появится уведомление с количеством замен, кнопка «Откат» станет активной

Рис. 1 — Страница предпросмотра: таблица товаров с предстоящими заменами

Рис. 2 — Детальный вид: артикулы, названия и пары идентификаторов

3. Проверка дублирующихся артикулов

Нажмите «Проверить дублирующиеся артикулы» на странице настроек. Страница содержит два раздела:

• Дубли на сайте — товары с одинаковым артикулом в базе данных. Показываются ID товара, название, внешний идентификатор и дата последнего обновления.
• Дубли в XML-файле — артикулы, встречающиеся более одного раза в файле выгрузки из 1С. Это сигнал о проблеме на стороне 1С: при импорте невозможно однозначно определить, какую из записей использовать.

Рис. 3 — Таблица товаров с одинаковыми артикулами в базе данных

Рис. 4 — Полный файл логов

Рис. 5 — Дублирующиеся артикулы внутри XML-файла из 1С

4. Пропущенные записи при импорте

Нажмите «Пропущенные записи» на странице настроек — отображаются до 150 последних пропущенных записей, отсортированных по дате. Для каждой записи модуль автоматически ищет причину пропуска в файлах commerceml.log.

В таблице отображается:

• UUID — внешний идентификатор записи в CommerceML
• Тип — тип сущности (product, category и т.д.)
• Название — название из файла маппинга
• Причина — текст причины пропуска из commerceml.log
• Лог-файл — имя файла, в котором найдена причина
• Дата — временная метка записи

Рис. 6 — Таблица пропущенных записей с причиной из лога и ссылкой на товар

5. Журнал ошибок CommerceML

Доступен через ссылку в меню администратора. Модуль сканирует все файлы commerceml.log*, извлекает строки с тегом [error] и группирует их по файлам лога, начиная с самого нового. Одинаковые строки показываются только один раз — дубликаты фильтруются автоматически. Если для идентификатора из ошибки найден товар на сайте — показывается прямая ссылка на его редактирование.

6. Откат изменений

После применения замен кнопка «Откат (N)» появляется на странице настроек. В скобках указано количество изменённых записей.

• Модуль проверяет, что старые идентификаторы не заняты другими записями. Если занят — такая запись пропускается и логируется
• Для каждой пары выполняется обратная замена
• Отображается уведомление с количеством обработанных пар и фактически восстановленных записей

Важно: кнопка «Откат» доступна только в течение текущей сессии браузера. После выхода из системы возможность отката теряется. Рекомендуем проверять результат сразу после применения.