Администрирование · 12 мин
Как обновить модуль обмена 1С с Битрикс
Пошаговая инструкция по обновлению модуля обмена 1С с Битрикс: подготовка, резервная копия, установка новой версии, проверка обмена и решение типичных ошибок.
Модуль обмена с сайтом (интеграция с «1С-Битрикс: Управление сайтом») — это дополнение к типовой конфигурации 1С, которое отвечает за выгрузку товаров, цен, остатков и загрузку заказов. Его обновление отличается от обычного обновления конфигурации: модуль устанавливается отдельно, имеет собственную нумерацию версий и собственный механизм установки через обработку.
Обновлять модуль стоит, когда текущая версия перестаёт корректно работать с новым релизом конфигурации 1С или с обновлённым сайтом на Битриксе, когда нужны новые возможности (например, обмен характеристиками, документами в реальном времени) или когда вендор исправил ошибки, мешающие обмену. Обновление без необходимости, «на всякий случай», несёт риски: меняются форматы выгрузки, настройки и поведение типовых процедур.
Ниже описан безопасный порядок: как определить текущую версию, подготовить резервную копию, установить новую версию модуля, проверить обмен и откатиться при проблемах. Инструкция ориентирована на типовые конфигурации «Управление торговлей», «Комплексная автоматизация» и «ERP», где обмен с сайтом реализован через подсистему «Обмен с сайтами».
Как определить текущую версию модуля и нужно ли обновление
Перед любыми действиями зафиксируйте, что установлено сейчас. Версия модуля обмена отображается в настройках обмена с сайтом: откройте раздел «Администрирование» → «Обмен с сайтами» (в некоторых конфигурациях — «CRM и продажи» → «Обмен с сайтом») и откройте настройку обмена. Версия обычно указана в форме настройки или в окне «О программе» / служебной информации обмена.
Также проверьте версию модуля на стороне сайта: в административном разделе Битрикса откройте «Marketplace» → «Установленные решения» и найдите модуль интеграции с 1С. Обмен работает корректно только при совместимых версиях с обеих сторон — обновление модуля в 1С без обновления на сайте (или наоборот) часто приводит к ошибкам формата CommerceML.
Запишите номер до обновления — он понадобится для отката
Сравните требования совместимости в описании новой версии
Проверьте, поддерживается ли ваш релиз новой версией модуля
Частые ошибки формата — признак несовместимости версий
Обновление оправдано, если: вендор объявил о прекращении поддержки вашей версии, после обновления конфигурации 1С обмен начал выдавать ошибки, на сайте установлена более новая версия модуля, либо вам нужна функция, которой нет в текущей версии. Если обмен работает стабильно и новых требований нет — обновление можно отложить.
Подготовка: резервная копия и проверка совместимости
Обязательный первый шаг — резервная копия информационной базы. Для файловой базы достаточно выгрузки в файл .dt через конфигуратор («Администрирование» → «Выгрузить информационную базу»). Для клиент-серверной базы используйте штатные средства СУБД (MS SQL, PostgreSQL) или выгрузку .dt. Копия нужна именно перед обновлением, а не «вчерашняя регламентная»: откат должен вернуть базу в состояние на момент старта работ.
Параллельно сделайте копию настроек обмена: снимите скриншоты или выгрузите настройки узлов обмена с сайтом. При обновлении настройки обычно сохраняются, но при ошибках установки их проще восстановить из зафиксированных значений, чем вспоминать по памяти.
Скачивайте дистрибутив модуля только из официальных источников — с портала 1С или с сайта вендора модуля, по доступу вашей подписки. В описании релиза проверьте: поддерживаемые конфигурации и их минимальные релизы, требования к версии платформы 1С, требования к версии модуля на стороне Битрикса. Если ваш релиз конфигурации ниже минимально поддерживаемого — сначала обновите конфигурацию.
Пошаговая установка новой версии модуля
В типовых конфигурациях модуль обмена с сайтом обновляется встроенным механизмом установки дополнительных модулей. Общий порядок выглядит так: распакуйте комплект поставки, найдите в нём файл установки (обработку установщика или файл обновления модуля), запустите его в режиме 1С:Предприятие под пользователем с полными правами и следуйте шагам мастера.
- 1Отключите регламентные задания обмена с сайтом и дождитесь завершения текущих сеансов обмена
- 2Сделайте резервную копию базы (.dt или средствами СУБД) и зафиксируйте настройки обмена
- 3Запустите базу в режиме 1С:Предприятие под пользователем с полными правами
- 4Откройте раздел «Администрирование — Обмен с сайтами» и запустите механизм обновления модуля (или откройте обработку установки из комплекта поставки через «Файл — Открыть»)
- 5Укажите файл новой версии модуля и подтвердите установку, дождитесь завершения обработчиков обновления
- 6Проверьте, что версия модуля в настройках обмена изменилась на новую
- 7Выполните тестовую выгрузку товаров на копию сайта или в тестовый каталог и проверьте результат
- 8Включите регламентные задания обмена обратно
Во время установки модуль выполняет обработчики обновления: переносит настройки, обновляет служебные регистры, регистрирует изменения в планах обмена. Не прерывайте этот процесс — на больших базах он может занимать заметное время. Если установка «зависла», проверьте активные сеансы и блокировки, прежде чем принудительно завершать сеанс.
После завершения установки перезапустите сеанс 1С и убедитесь, что версия модуля обновилась. Если конфигурация находится на поддержке с изменениями (доработки в объектах обмена), проверьте, что обновление модуля не затронуло ваши доработки — типовые процедуры могли быть перезаписаны.
Проверка обмена после обновления
Обновление считается завершённым только после успешного тестового обмена. Начните с выгрузки товаров: выполните обмен вручную в режиме «выгрузка изменений» на тестовую среду сайта или в тестовый инфоблок. Проверьте, что товары, цены и остатки обновились, картинки и характеристики не потерялись, а новые товары создаются корректно.
Затем проверьте загрузку заказов: создайте тестовый заказ на сайте и убедитесь, что он попал в 1С с корректными контрагентом, товарами, суммами и статусом. Отдельно проверьте обратную выгрузку статусов заказа на сайт, если она используется.
Как проверить результат
Отображается новая версия
Осталась старая версия — установка не завершилась
Завершается без ошибок, на сайте актуальные цены и остатки
Ошибки формата XML, таймауты, товары с нулевыми остатками
Тестовый заказ создан в 1С с верными данными
Заказ не приходит, дублируется или создаётся с пустым контрагентом
Нет новых ошибок после обновления
Появились ошибки, которых не было до обновления
Если тестовая среда отсутствует, выполняйте первую выгрузку в ручном режиме в часы минимальной нагрузки и будьте готовы быстро отключить обмен при некорректном результате. Полную выгрузку большого каталога лучше не запускать сразу — начните с выгрузки изменений.
Типичные ошибки при обновлении и их решение
Наиболее частая проблема — несовместимость версий модуля в 1С и на сайте. Симптомы: ошибки разбора XML, отсутствие части данных после выгрузки, ошибки авторизации при обмене. Решение — привести версии с обеих сторон к совместимой паре согласно документации вендора.
Если после обновления обмен выдаёт ошибку «неверный формат» или пустой ответ сайта, проверьте логи на стороне Битрикса и журнал регистрации в 1С. Часто причина — не в модуле, а в изменившихся настройках веб-сервера, таймаутах или правах пользователя, под которым выполняется обмен.
Откат на предыдущую версию
Если после обновления обмен работает некорректно и быстро устранить причину не удаётся, безопаснее откатиться. Способ отката зависит от объёма изменений: если после обновления в базу не записывались новые данные (заказы, товары), проще всего восстановить базу из резервной копии, сделанной перед обновлением.
Если после обновления уже прошли реальные обмены и в базе появились нужные документы, полный откат из копии потеряет эти данные. В этом случае варианты такие: установить предыдущую версию модуля поверх (если вендор это поддерживает), либо восстановить копию в отдельную базу и перенести из неё настройки, а проблемные данные обработать вручную. Заранее уточните в документации к модулю, поддерживается ли установка предыдущей версии поверх новой — не все обработчики обновления обратимы.
Удобно вести простой журнал версий: дата, версия модуля до и после, релиз конфигурации, кто выполнял обновление, результат тестового обмена. При следующем обновлении или при обращении в поддержку вендора эта информация экономит значительное время на диагностике.
Когда лучше привлечь специалиста
Самостоятельное обновление оправдано для типовой конфигурации без доработок, при наличии тестовой среды и опыта восстановления базы из копии. Привлеките специалиста по 1С, если конфигурация существенно доработана (особенно объекты обмена), если используется несколько обменов с разными сайтами, если база клиент-серверная с высокой нагрузкой, или если предыдущие попытки обновления уже завершались ошибками.
Как выбрать действие
Что важно запомнить
Обновление модуля обмена 1С с Битрикс безопасно при соблюдении трёх условий: резервная копия базы перед началом, проверка совместимости версий модуля с конфигурацией и сайтом, обязательный тестовый обмен до включения регламентных заданий. При сбое быстрее и дешевле откатиться из копии, чем чинить рассинхронизированные данные между базой и сайтом.
Частые вопросы
Обновится ли модуль автоматически вместе с конфигурацией 1С?
Нет. Модуль обмена с сайтом имеет собственный цикл обновления и не входит в состав типового релиза конфигурации. Обновление конфигурации не меняет версию модуля, а обновление модуля не меняет конфигурацию — эти процессы выполняются раздельно, но их нужно согласовывать по совместимости.
Можно ли обновить модуль, не останавливая работу пользователей?
Теоретически установка возможна при работающих пользователях, но на практике это рискованно: обработчики обновления могут требовать монопольного доступа к служебным данным, а активные сеансы обмена могут конфликтовать с установкой. Рекомендуется выполнять обновление в нерабочее время с завершёнными сеансами обмена.
Что делать, если после обновления пропали настройки обмена?
Сначала проверьте, не завершилась ли установка с ошибкой — посмотрите журнал регистрации. Если настройки действительно утрачены, восстановите их из зафиксированных перед обновлением значений (скриншотов, выгрузок) либо восстановите базу из резервной копии и повторите обновление, зафиксировав ошибку для обращения к вендору модуля.
Нужно ли обновлять модуль на сайте одновременно с модулем в 1С?
Не обязательно в ту же минуту, но версии должны оставаться совместимыми. Проверьте в документации к новой версии модуля, какие версии на стороне Битрикса поддерживаются. Если требуется обновление с обеих сторон, согласуйте порядок с администратором сайта и проводите работы в одно окно обслуживания.
Как проверить обмен, если нет тестового сайта?
Можно создать на боевом сайте скрытый тестовый инфоблок и направить выгрузку в него, либо выполнить выгрузку в файл (режим выгрузки в каталог на диск вместо сайта) и проверить состав XML-файлов. Заказы проверяйте тестовой покупкой с последующей отменой. Полную выгрузку большого каталога на боевой сайт после обновления запускайте только после успешной проверки на малом объёме.
Где смотреть ошибки обмена после обновления?
В 1С — журнал регистрации (отбор по событию обмена с сайтом) и сообщения в форме выполнения обмена. На стороне Битрикса — логи модуля интеграции и логи веб-сервера. Сопоставление времени ошибки с обеих сторон обычно позволяет быстро определить, на какой стороне проблема.