Как обновить модуль обмена 1С с 1С-Битрикс

Модуль обмена с сайтом (1С-Битрикс) отвечает за выгрузку товаров, цен, остатков и загрузку заказов между 1С и интернет-магазином. Разработчик регулярно выпускает новые версии: исправляются ошибки, добавляется поддержка свежих релизов конфигураций и расширяются возможности обмена. Если модуль давно не обновлялся, вы рискуете столкнуться с рассинхронизацией данных, ошибками выгрузки или несовместимостью после обновления самой конфигурации 1С.

Обновление модуля — не то же самое, что обновление конфигурации. Модуль устанавливается поверх типовой конфигурации (Управление торговлей, Комплексная автоматизация, ERP) и имеет собственный номер версии. Поэтому порядок действий отличается: нужно скачать дистрибутив модуля, установить его через конфигуратор и проверить, что обмен работает корректно.

Ниже разобран полный цикл работ: от подготовки и резервного копирования до проверки результата и устранения типичных проблем. Материал подходит для модулей обмена с сайтом, распространяемых компанией «1С-Битрикс» для управляемых форм.

Когда нужно обновлять модуль обмена

Обновление необходимо в нескольких типовых ситуациях. Первая — вы обновили конфигурацию 1С до нового релиза, и старая версия модуля выдаёт ошибки при выгрузке или загрузке. Вторая — на сайте появились новые требования к формату обмена (например, изменилась структура каталога или добавлены новые свойства товаров). Третья — в используемой версии обнаружена ошибка, исправленная в свежем релизе модуля.

Узнать текущую версию модуля можно в самой 1С: откройте раздел «Администрирование» → «Обмен с сайтами» и посмотрите информацию о версии в панели настройки, либо откройте «Конфигурация → Поддержка → Настройка поддержки» в конфигураторе — там отображается список подключённых поставщиков и версий. Сверьте её с актуальной версией на странице загрузки модуля.

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

Перед любыми действиями сделайте полную резервную копию базы. Для файловой базы достаточно скопировать каталог базы или выгрузить её через «Конфигуратор → Администрирование → Выгрузить информационную базу». Для клиент-серверной базы используйте штатные средства СУБД (MS SQL, PostgreSQL) — это надёжнее, чем выгрузка в dt при больших объёмах.

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

Где взять актуальную версию модуля

Дистрибутив модуля обмена с сайтом распространяется через официальные каналы «1С-Битрикс». Для загрузки потребуется учётная запись на сайте разработчика и, как правило, активная лицензия на продукт «1С-Битрикс: Управление сайтом», к которому привязан модуль. Скачивайте дистрибутив, соответствующий вашей конфигурации: для УТ, КА и ERP поставляются отдельные варианты.

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

Порядок установки обновления в конфигураторе

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

1. 1
   Сделайте резервную копию базы и отключите регламентные задания обмена
2. 2
   Откройте базу в конфигураторе, завершите все остальные сеансы пользователей
3. 3
   Выполните «Конфигурация → Поддержка → Обновить конфигурацию» и выберите файл дистрибутива модуля
4. 4
   В окне сравнения и объединения проверьте список изменяемых объектов, снимите флажки с объектов, которые доработаны под ваши задачи (при необходимости)
5. 5
   Примите изменения и выполните «Обновить конфигурацию базы данных» (F7)
6. 6
   Запустите 1С в режиме предприятия и дождитесь выполнения отложенных обработчиков обновления
7. 7
   Включите регламентные задания обмена и выполните тестовый сеанс обмена

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

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

Проверка настроек обмена после обновления

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

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

Контрольные точки

Как проверить результат

Тестовое соединение с сайтом

Норма

Соединение установлено без ошибок авторизации

Тревожный признак

Ошибка 401/404 или таймаут — проверьте URL и учётные данные

Выгрузка товаров

Норма

Файлы выгрузки формируются, на сайте обновляются товары и цены

Тревожный признак

Ошибка в журнале обмена, товары не обновляются

Загрузка заказов

Норма

Заказы с сайта создаются в 1С с корректными контрагентами и статусами

Тревожный признак

Заказы не загружаются или создаются с пустыми полями

Тестовый обмен и контроль результата

Не ограничивайтесь проверкой соединения — выполните полный цикл обмена. Запустите выгрузку товаров вручную и дождитесь завершения. Проверьте на сайте, что изменения применились: обновились цены, остатки, новые позиции появились в каталоге. Затем создайте тестовый заказ на сайте и убедитесь, что он загрузился в 1С с правильными товарами, контрагентом и статусом.

Параллельно изучите журнал обмена: в нём не должно быть ошибок уровня «Ошибка» и повторяющихся предупреждений. Небольшие предупреждения о пропущенных объектах допустимы, если вы понимаете их причину (например, товар без картинки). Если обмен работает в режиме реального времени, проверьте также инициацию обмена со стороны сайта.

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

Типичные ошибки и способы их устранения

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

Если после обновления обмен полностью не работает и быстро найти причину не удаётся, безопасный вариант — восстановить базу из резервной копии и повторить процедуру на тестовой копии. Не пытайтесь «допиливать» обмен на рабочей базе в режиме реального времени: каждая неудачная выгрузка может изменить данные на сайте.

FAQ: частые вопросы об обновлении модуля обмена

Можно ли обновить модуль обмена без остановки работы пользователей?

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

Что делать, если после обновления перестала выгружаться часть товаров?

Проверьте настройки отборов в узле обмена — после обновления они могли сброситься или измениться. Также изучите журнал обмена: там указаны причины пропуска объектов, например отсутствие обязательного свойства или картинки.

Нужно ли что-то обновлять на стороне сайта?

Обычно модуль обмена обновляется только в 1С. Но если вы давно не обновляли «1С-Битрикс: Управление сайтом», проверьте совместимость версий: в редких случаях новые возможности обмена требуют актуальной версии платформы сайта.

Как откатиться на предыдущую версию модуля?

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

Обновление модуля удалит историю обменов и настройки?

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

Можно ли обновлять модуль, если конфигурация сильно доработана?

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