К статье
Практический материал

Администрирование · 12 мин

Как обновить модуль Диадок в 1С 8.3

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

Модуль Диадок для 1С — это внешняя обработка (обычно файл вида DiadocCom.epf), которая обеспечивает обмен электронными документами между базой 1С и сервисом Контур.Диадок. Разработчик регулярно выпускает новые версии модуля: в них исправляются ошибки, добавляется поддержка новых форматов документов и требований ФНС, обновляются компоненты криптографии и API. Работа на устаревшей версии рано или поздно приводит к сбоям при отправке документов, отказам в подписании или невозможности получить входящие файлы.

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

Когда обновление действительно необходимо

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

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

Ошибки при отправке или подписанииВероятно, устарел формат или компонент API

Сравните текст ошибки с описанием изменений в новых версиях модуля

Сообщение о новой версии в модулеДоступно обновление

Проверьте номер текущей версии в окне «О программе» модуля

После обновления конфигурации модуль не открываетсяНесовместимость версий

Скачайте сборку модуля под вашу конфигурацию и режим совместимости

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

Номер установленной версии отображается в самом модуле: откройте обработку Диадок и перейдите в раздел «Настройки» — «О программе» (в некоторых сборках — иконка со знаком вопроса или пункт «Информация о версии» на стартовой странице). Запишите номер полностью, включая сборку — он понадобится, чтобы понять, насколько вы отстали от актуальной версии и какие промежуточные изменения вас коснутся.

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

Подготовка: резервная копия и фиксация настроек

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

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

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

Пошаговое обновление внешней обработки

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

Порядок действий
  1. 1
    Скачайте архив с новой версией модуля с официального сайта Контура и распакуйте его
  2. 2
    Завершите сеансы пользователей, работающих с модулем, или договоритесь об окне обновления
  3. 3
    Откройте 1С в режиме «Предприятие» под учётной записью с полными правами
  4. 4
    Если модуль подключён в «Дополнительные отчеты и обработки» — откройте этот справочник, найдите обработку Диадок и замените файл на новый через «Загрузить из файла»
  5. 5
    Если модуль запускается вручную — просто замените старый .epf новым в каталоге хранения и откройте его через «Файл — Открыть»
  6. 6
    При первом запуске дождитесь инициализации: модуль может обновить внутренние компоненты и предложить миграцию настроек
  7. 7
    Проверьте номер версии в разделе «О программе» — он должен совпасть со скачанной версией

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

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

Обновление веб-компонентов и криптографии

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

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

Формальное завершение установки не гарантирует, что обмен работает. Выполните контрольную проверку по всем критичным операциям, которые использует ваша организация.

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

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

Подключение к сервису
Норма

Модуль авторизуется, список организаций загружается без ошибок

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

Ошибка авторизации, пустой список организаций, тайм-аут соединения

Получение входящих
Норма

Новые входящие документы появляются в списке

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

Список не обновляется или выдаёт ошибку загрузки

Подписание и отправка
Норма

Тестовый документ подписывается сертификатом и уходит контрагенту

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

Ошибка криптографии, сертификат не найден, документ зависает в статусе

Печатные формы и сопоставления
Норма

Документы формируются по прежним правилам сопоставления

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

Вид документа не сопоставлен, формируется не тот формат

Для полноценной проверки отправьте тестовый документ контрагенту, с которым есть договорённость о тестовом обмене, либо используйте возможность отправки «самому себе» между своими ящиками, если она доступна. Убедитесь, что документ прошёл весь цикл: сформирован, подписан, отправлен, получен ответный статус. Только после этого обновление можно считать завершённым.

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

Большинство проблем после обновления связано не с самим модулем, а с окружением: правами доступа, кэшем, устаревшими компонентами. Ниже — самые частые ситуации.

Типичные ошибки
01
Обновление без резервной копии — при несовместимости версии откат занимает часы вместо минут
02
Замена обработки во время работы пользователей — у части сеансов модуль падает с ошибкой, документы могут остаться в промежуточном статусе
03
Игнорирование обновления криптокомпонентов — модуль новый, но подписание не работает из-за старого плагина или криптопровайдера
04
Очистка настроек вручную «для чистоты» — приходится заново настраивать сопоставления видов документов и подразделения
05
Скачивание модуля не под свою конфигурацию — обработка не открывается или не видит документы базы

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

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

Маршрут решения

Как выбрать действие

Модуль работает, но предлагает обновиться, а критичных изменений в changelog нетЗапланируйте обновление на ближайшее окно обслуживания, срочности нет
Документы не отправляются из-за смены формата ФНСОбновляйте немедленно, предварительно сделав копию базы и сохранив старую обработку
После обновления модуль не открываетсяОткатитесь на сохранённую версию .epf и проверьте требования к платформе в описании новой версии
Модуль встроен в конфигурацию поставщикомНе заменяйте файл вручную — привлеките специалиста для обновления через механизм поставки

Откат на предыдущую версию

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

Именно поэтому резервная копия до обновления — обязательный, а не рекомендательный шаг. Срок хранения копии — минимум до тех пор, пока новая версия не проработает полный цикл документооборота (отправка, получение, подписание, аннулирование) без сбоев.

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

Что важно запомнить

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

Частые вопросы

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

Нет. Документы и их статусы хранятся на серверах Диадока и в вашей информационной базе, а не в файле обработки. Замена .epf не затрагивает историю обмена — после обновления вы увидите все документы за прошлые периоды.

Можно ли обновлять модуль, пока пользователи работают в 1С?

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

Модуль предлагает обновиться автоматически — можно ли доверять такому обновлению?

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

После обновления пропала кнопка «Диадок» в документах. Что делать?

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

Нужно ли обновлять модуль на каждом компьютере бухгалтеров?

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

Как узнать, совместима ли новая версия модуля с моей конфигурацией?

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