Инструкция по настройке доп. функционала "Обмен с 1С (CommerceML PRO)"

1. Подготовка и расположение настроек

CommerceML ПРО расширяет обмен Shop-Script с 1С. Базовое подключение, типы цен, валюты, склады и контакты описаны в официальной инструкции Webasyst. Здесь разобраны дополнительные возможности предоставленной сборки плагина.

• Параметры: Shop-Script → Плагины → «1С (CommerceML) PRO».
• Обмен и сопоставление: Shop-Script → Импорт/экспорт → «1С (CommerceML) PRO». Здесь расположены вкладки «Автоматический обмен», «Ручной обмен», «Синхронизированные параметры», «Сопоставление товаров» и «Сопоставление категорий».

Для настройки соответствий складов, характеристик, свойств и реквизитов выполните анализ файла CommerceML на вкладке «Ручной обмен». Вкладка «Синхронизированные параметры» показывает сохранённые связи.

Перед связыванием и массовыми изменениями каталога сохраните резервную копию базы и файлов магазина. На время сопоставления приостановите автоматический обмен, чтобы состав каталога не менялся во время проверки.

2. Переход со штатного CommerceML

В настройках PRO блок переноса появляется, если включён штатный плагин «1С (CommerceML)».

1. Откройте настройки CommerceML ПРО и нажмите «Перенести настройки».
2. Подтвердите перенос. Значения настроек штатного плагина копируются в PRO и перезаписывают одноимённые параметры. Служебное время обновления не переносится.
3. После перезагрузки страницы проверьте цены, склады, поля товаров и параметры заказов.
4. Отключите штатный плагин. На вкладке «Автоматический обмен» PRO получите адрес из поля «Скрипт синхронизации» и сохраните его в настройках обмена с сайтом в 1С.
5. Выполните контрольный обмен и проверьте товары и заказ.

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

Перенос настроек из штатного плагина «1С (CommerceML)». Открыть в полном размере

3. Сопоставление товаров

Где: Импорт/экспорт → «1С (CommerceML) PRO» → «Сопоставление товаров». Слева показаны товары с идентификаторами 1С, справа — кандидаты из каталога магазина.

1. Сначала загрузите данные из 1С, чтобы в магазине появились импортированные карточки для сопоставления. Для первичной настройки можно включить «Скрывать новые товары при импорте».
2. Укажите «Поле штрихкода» и «Поле кода „1С“», если эти данные хранятся в полях или характеристиках каталога.
3. Найдите исходный товар по названию, артикулу или идентификатору. Проверьте кандидата и соответствия его артикулов.
4. Если подходящих товаров не видно, проверьте переключатель «искать среди всех товаров, а не только без идентификатора». Экспорт в 1С также может назначать идентификаторы карточкам.
5. Нажмите «Связать» для выбранной пары и прочитайте подтверждение.

Что меняется: идентификаторы 1С исходного товара и сопоставленных артикулов передаются выбранному товару магазина. Импортированная карточка удаляется. Её описания и галерея не объединяются с целевой карточкой. Если исходный товар встречался в заказах, позиции в этих заказах остаются без ссылки на удалённую карточку. Уже существующий идентификатор целевого товара может быть заменён.

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

Массово: нажмите «Проанализировать весь каталог». Анализ не изменяет товары. Плагин отбирает однозначные пары по артикулу, штрихкоду или коду 1С; совпадения только по названию не являются основанием для массового связывания. Изучите отчёт и подтвердите отдельное действие «Связать …». Фильтр «только те, для которых есть предложения» использует результат анализа.

4. Закрепление отдельных артикулов

Закрепление связывает предложение 1С с конкретным артикулом магазина независимо от карточки, в которой он находится. Это позволяет сохранить структуру товаров магазина, даже если группировка номенклатуры в 1С отличается.

1. На вкладке «Сопоставление товаров» откройте список артикулов импортированного товара.
2. Выберите исходный артикул и найдите подходящий артикул магазина. Сверьте код, название и товар, которому он принадлежит.
3. Нажмите «Закрепить» и подтвердите операцию.
4. Запустите обмен и проверьте обновление выбранного артикула.

Импортированный артикул удаляется. Если он был единственным в исходной карточке, удаляется и сама карточка. Целевой артикул остаётся в своём товаре магазина. Проверьте предупреждение о замене существующей связи, если она уже есть.

Массовое закрепление: кнопка «Проанализировать артикулы» подбирает однозначные совпадения по артикулу, штрихкоду или коду 1С. Анализ не меняет каталог; закрепление запускается отдельно после проверки отчёта.

В блоке «Закреплённых артикулов» нажмите «показать», чтобы просмотреть связи. «Снять закрепление» очищает связь артикула с предложением, но не восстанавливает удалённый исходный артикул.

5. Сопоставление категорий

Где: вкладка «Сопоставление категорий» в разделе обмена.

1. Найдите импортированную категорию по названию, пути или идентификатору.
2. Выберите соответствующую категорию магазина. При необходимости включите поиск среди всех категорий.
3. Проверьте полные пути категорий и подтвердите «Связать».

Товары и подкатегории импортированной категории перемещаются в выбранную категорию магазина. Исходная категория удаляется, её идентификатор 1С получает целевая категория. Это не автоматическое объединение описаний и других полей.

Для массового режима нажмите «Проанализировать дерево категорий». Плагин ищет совпадения по названию, подтверждённые положением в дереве или составом товаров. Анализ не меняет каталог; связывание подтверждается отдельно.

Перед следующим обменом проверьте «Категории товаров при импорте» и «Обновлять свойства категорий при импорте». Они определяют дальнейшее изменение принадлежности товаров, названия, описания и родительской категории.

6. Каждое предложение — отдельный товар

Настройка: «Импортировать каждое торговое предложение отдельным товаром» в блоке «Товары». По умолчанию выключена.

1. Включите настройку перед импортом новых товаров.
2. Выберите «Наименование товаров, созданных из торговых предложений»: исходное наименование предложения либо наименование товара и значения характеристик, например «Футболка, Белый, S».
3. Сохраните настройки и импортируйте каталог и предложения.

Первое предложение занимает карточку, созданную из информации о товаре. Для следующих создаются копии: переносятся категории, описание, характеристики, изображения, услуги и связанные товары. Служебная характеристика «GUID номенклатуры 1С» хранит общий идентификатор исходной номенклатуры; другие плагины могут использовать его для группировки.

Режим действует только на товары, импортированные после его включения. Существующие карточки продолжают получать предложения артикулами и автоматически не разделяются. Для их преобразования требуется отдельный повторный импорт с удалением прежних карточек; заранее учтите ссылки, заказы и вручную подготовленный контент.

Если у предложения нет наименования, в первом режиме оно собирается из названия товара и характеристик. Если во втором режиме нет характеристик, используется название предложения.

7. Характеристики артикулов любого формата

Настройка: «Импорт значений характеристик артикулов» → «Импортировать все характеристики, доступные для артикулов».

1. В настройках характеристики Shop-Script включите «Возможность задать значения характеристики для артикулов товаров».
2. В CommerceML ПРО выберите указанный режим и сохраните настройки.
3. Проверьте соответствия характеристик через анализ файла и параметры их обновления у существующих товаров.
4. Выполните импорт предложений и проверьте значения в артикулах.

Поддерживаются характеристики любого формата, доступные для артикулов. Если предложение содержит несколько значений, сохраняется первое. Характеристики, которые плагин создаёт при импорте торговых предложений, получают доступность для артикулов автоматически.

При обновлении такой характеристики значение на уровне товара удаляется. Исключение — формат «Выбор нескольких значений из списка»: значения на уровне товара собирает Shop-Script. Если значение должно оставаться общим для товара, проверьте модель характеристик до включения режима.

8. Наименования и коды артикулов

«Импорт наименования артикула» предлагает три варианта:

• «Наименование предложения» — берётся название из 1С.
• «Значения характеристик (для „МойСклад“)» — название формируется из характеристик.
• «Содержимое скобок в конце наименования предложения» — из «Футболка (Белый, S)» получается «Белый, S».

Варианты импорта наименования артикула. Открыть в полном размере

Флажок «Добавлять наименование артикула к его коду» дописывает наименование через пробел: «TS-01» + «Белый, S» → «TS-01 Белый, S». Сохраните настройку и выполните импорт предложений.

Это правило формирования кода, а не генератор уникальных значений: результат зависит от исходных кодов и наименований. Если коды используются для сопоставления, сначала проверьте результат на нескольких артикулах.

Добавление наименования артикула к его коду. Открыть в полном размере

9. Импорт и обновление изображений

Для фотографий вариаций включите «Импортировать изображения артикулов». При импорте предложений изображения из элемента <Картинка> в <Предложение> загружаются в товар и привязываются к соответствующему артикулу.

Импорт изображений артикулов. Открыть в полном размере

В настройке «Обновлять при импорте свойства товаров» есть отдельный пункт «Изображения». Снимите его, чтобы импорт не обновлял галереи уже существующих товаров. Для новых товаров импортируются все данные. В предоставленной сборке изображения включены по умолчанию; обновление плагина добавляет этот пункт в ранее сохранённый набор свойств.

Флажок «Удалять изображения, отсутствующие в файле обмена» включает удаление отсутствующих фотографий у товаров текущего обмена и, если включён импорт изображений артикулов, у участвующих артикулов. По умолчанию выключен.

Включайте удаление только при корректном составе изображений в выгрузке. Частичная выгрузка может не содержать фотографий, которые нужно сохранить. Если обновление «Изображения» для существующих товаров отключено, их галереи не затрагиваются и этим удалением.

10. Удаление служебного пустого артикула

При импорте предложений плагин проверяет лишний артикул, связанный с идентификатором исходной номенклатуры. Для удаления должны выполняться условия служебного пустого артикула: пустое наименование, пустой или служебный код, отсутствие остатка и нулевые цены, а также наличие других артикулов в соответствующем сценарии импорта.

Отдельного переключателя для этой очистки нет. Нулевой остаток сам по себе не означает, что рабочий артикул будет удалён. Проверяйте настройки «Получать код артикула из информации о товарах» и «Создавать новые артикулы с нулевыми остатками», если после обмена появляются лишние строки.

11. Статусы заказов из 1С

Где: настройки плагина → «Сопоставление статусов заказов».

1. Нажмите «Добавить соответствие».
2. В колонке «Целевой статус» выберите статус Shop-Script. Список показывает его название и код.
3. В колонке «Действие в Shop-Script» выберите действие, которое нужно запустить при получении соответствующего кода. Например, для целевого статуса «Отправлен» выберите подходящее действие отправки из вашего процесса обработки заказов.
4. Сохраните настройки и проверьте переход на контрольном заказе.

Плагин читает реквизит CommerceML Статуса заказа ИД. Его значение должно совпадать с кодом выбранного статуса Shop-Script. Произвольное текстовое название статуса 1С не сопоставляется автоматически. Убедитесь, что модуль обмена 1С возвращает нужный реквизит и код.

В списке доступны публичные действия процесса обработки заказов; внутренние действия скрыты. Плагин запускает выбранное действие, поэтому учитывайте его эффекты и уведомления. Повторно полученный неизменившийся идентификатор статуса пропускается.

Настройка сопоставления статусов заказов. Открыть в полном размере

12. Обновление состава заказа

Настройка: «Обновление состава заказов». По умолчанию выбран вариант «Не обновлять». Для работы выберите «Полная синхронизация: позиции, отсутствующие в файле обмена „1С“, удаляются из заказа».

Источником служит элемент <Товары> документа заказа. Обновляются позиции, количество, цены, скидки по позициям и стоимость доставки. Не найденный в каталоге товар добавляется строкой без привязки к товару магазина. Дополнительные услуги обновляются, но не удаляются отдельно: услуга удаляется вместе с товаром, к которому она добавлена.

1. Проверьте, что 1С возвращает полный состав заказа, и включите полную синхронизацию.
2. Сохраните настройки, измените контрольный заказ в 1С и выполните обмен.
3. Сверьте позиции, количество, цены, скидки, доставку и итоговую сумму заказа.

Полная синхронизация удаляет из заказа позиции, которых нет в документе 1С. Она применяется к заказам в любом статусе. Если валюта документа распознана и отличается от валюты заказа, состав не обновляется, а причина записывается в сообщения обмена.

При ручном обмене для обновления состава отключите опцию «Настроить синхронизацию характеристик, свойств, реквизитов и остатков товаров».

13. Доставка и уведомления об изменении заказа

«Наименование позиции доставки в файле обмена „1С“». По умолчанию — «Доставка заказа». При экспорте доставка получает идентификатор ORDER_DELIVERY. Если 1С возвращает собственный идентификатор, плагин распознаёт доставку по настроенному наименованию. Пустое поле оставляет распознавание только по идентификатору.

«Уведомления покупателям об изменении состава заказов». По умолчанию выключены. При включении используется уведомление покупателю, настроенное в Shop-Script для действия «Редактирование заказа». Проверьте настройку самого уведомления и его текст.

Эта опция относится к изменению состава заказа. Уведомления, вызываемые действиями смены статуса, настраиваются отдельно.

14. Начальная дата выгрузки заказов

Настройка: «Начальная дата выгрузки заказов». Укажите дату в формате ГГГГ-ММ-ДД, например 2026-09-01, и сохраните настройки.

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

Фильтр используется вместе с настройками «Статусы заказов» и «Выгрузка заказов» («Все» либо «Новые и измененные»). Период для выборки новых и изменённых заказов задаётся в секундах; значение по умолчанию — 3600.

15. Интеграция с «Цены PRO»

Установите и включите отдельный плагин «Цены PRO». Создайте хотя бы один статичный тип цены. Для каждого такого типа в настройках CommerceML ПРО появятся дополнительные поля названия и идентификатора типа цены в 1С.

1. В поле «Тип цены … в „1С“» укажите точное название из вашей учётной системы.
2. Сохраните настройки и выполните импорт типов цен и предложений.
3. Проверьте значения в «Цены PRO». Идентификаторы соответствующих типов цен обновляются при импорте.

Если поля не появились, проверьте, что «Цены PRO» включён и нужный тип цены является статичным. Ручная замена файлов штатного CommerceML для этой интеграции не требуется.

16. Проверка после настройки

• Каталог: обмен обновляет нужные карточки, связи артикулов и категории.
• Вариации: названия, коды, характеристики и фотографии соответствуют предложениям 1С.
• Контент: обновляются только выбранные свойства существующих товаров.
• Заказы: соблюдается начальная дата выгрузки, возвращается реквизит статуса и корректный состав заказа.
• Доставка и уведомления: доставка распознана отдельной стоимостью, покупатель получает только настроенные уведомления.

При диагностике включите «Сохранять файлы с данными обмена», повторите проблемный обмен и скачайте архив из настроек плагина. После отключения этой опции накопленные файлы доступны только до следующего обмена.

Если нужна помощь, обратитесь в поддержку Bodysite и опишите сценарий, выбранные настройки и результат обмена.