Как связать 1С:Документооборот с БП, ЗУП и ERP и не сломать обмен

Интеграция с 1С:Документооборотом в типовых конфигурациях работает онлайн: учётная база (Бухгалтерия, ЗУП, УТ, ERP, КА) обращается к опубликованному веб-сервису или HTTP-сервису Документооборота и прямо из своей формы создаёт документ в ДО, прикладывает файлы и запускает согласование. Включается она флажком в разделе администрирования учётной базы, а логику задают правила интеграции — кто, когда и с какими полями создаёт документ.

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

Две архитектуры связки ДО и учётной базы

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

В типовых решениях за онлайн-режим отвечает встроенная Библиотека интеграции с 1С:Документооборотом (БИД). Её не нужно ставить отдельно: она уже есть в БП 3.0, ЗУП 3.1, УТ 11, КА 2 и ERP 2. Обновляется она вместе с конфигурацией.

Что даёт глубокая интеграция пользователю учётной базы:

• 📎 файлы документа ДО видны и редактируются из карточки документа учётной базы;
• 📝 по документу учётной базы создаётся связанный документ ДО (входящий, исходящий, внутренний) с заполненными реквизитами;
• ✅ задачи согласования приходят пользователю, и он может выполнить их без входа в ДО;
• 🔁 результат согласования возвращается в учётную базу и виден в карточке.

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

Чем подключаться: веб-сервис, HTTP-сервис или COM

У ДО есть несколько входов. Выбор зависит от версии ДО и от того, пишете вы своё или используете типовую библиотеку.

Веб-сервис (SOAP). Классический канал интеграции. ДО публикует веб-сервис, учётная база получает его описание WSDL и вызывает операции. Проверить публикацию просто: откройте в браузере адрес публикации с суффиксом ?wsdl — должен вернуться XML с описанием.

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

COM-соединение. Внешнее соединение через V83.COMConnector открывает базу ДО как объект и даёт доступ к её модулям. Это путь для разовых обработок и старых самописных схем. Минусы ощутимые:

• 🪟 работает только на Windows и только при совпадении разрядности;
• 🔐 нужен пользователь ДО с правом внешнего соединения;
• 🐢 каждое подключение стартует сеанс, это медленно;
• 🔧 любое изменение структуры ДО может сломать ваш код.

Публикация ДО на веб-сервере

Без публикации онлайн-интеграция не заработает. Порядок такой:

1. Установите веб-сервер (Apache или IIS) на сервер, откуда доступна база ДО.
2. Запустите Конфигуратор ДО от имени администратора Windows.
3. Откройте Администрирование → Публикация на веб-сервере.
4. Задайте имя публикации, например docmng, и каталог.
5. Включите публикацию веб-сервисов и HTTP-сервисов, отметьте сервисы Документооборота.
6. Нажмите «Опубликовать» и перезапустите веб-сервер.
7. Проверьте в браузере адрес вида http://server/docmng/ws/...?wsdl — точный путь виден в списке сервисов окна публикации.

Для внешнего доступа сразу ставьте HTTPS. Пароли пользователей ДО идут в каждом запросе, и открытый HTTP их выдаёт.

Настройка интеграции с 1С:Документооборотом в учётной базе

Где включается интеграция в типовых конфигурациях:

В зависимости от релиза ссылка может стоять в другой группе панели администрирования, но название у неё узнаваемое.

Дальше по шагам:

1. Установите флажок «Использовать 1С:Документооборот».
2. Укажите адрес публикации ДО — тот, что проверяли в браузере, но без суффикса ?wsdl и имени сервиса.
3. Нажмите «Проверить подключение» и введите логин и пароль пользователя ДО.
4. Откройте правила интеграции и создайте правила для нужных видов документов.
5. Выдайте пользователям учётной базы роли или профили групп доступа, связанные с Документооборотом.
6. У каждого пользователя один раз пропишите его учётную запись ДО — при первом обращении программа спросит её сама.

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

Совместимость версий

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

Правила интеграции и регистрации объектов

Правило интеграции — это связь «объект учётной базы → объект ДО». В нём задаётся:

• 📄 какой документ учётной базы участвует (например, «Поступление (акты, накладные)» или договор контрагента);
• 🗂 какой вид документа ДО создаётся — входящий, исходящий или внутренний, и с каким видом;
• 🔍 условие отбора, например только по одной организации или по сумме выше порога;
• ✍️ как заполняются реквизиты ДО: из реквизита, константой или выражением на встроенном языке.

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

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

Регистрация изменений при пакетном обмене

При обмене через план обмена работают другие механизмы. Изменённый объект попадает в очередь, только если проходит правила регистрации плана обмена. Типичные настройки:

• 📅 дата начала обмена — старые документы не уходят;
• 🏢 отбор по организациям — филиал получает только свои данные;
• 📚 состав справочников — например, только контрагенты и договоры, без номенклатуры.

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

Согласование учётных документов через маршруты ДО

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

Как это устроено:

1. В правиле интеграции включают автоматическое создание документа ДО при записи объекта учётной базы.
2. В ДО для этого вида документа настраивают шаблон процесса: согласование, утверждение, ознакомление.
3. Процесс стартует вручную из карточки учётного документа или автоматически, если так задано в шаблоне.
4. Участники выполняют задачи в ДО или прямо из учётной базы — в списке задач Документооборота.
5. Результат (согласовано, не согласовано, с замечаниями) возвращается и виден в карточке.

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

Ошибки интеграции с ДО и как их ловить

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

Где смотреть подробности

• 📓 Журнал регистрации учётной базы. Отберите события с уровнем «Ошибка» за нужный интервал — там видна причина отказа и текст исключения.
• 📓 Журнал регистрации ДО. Покажет, дошёл ли вызов до ДО и под каким пользователем он выполнялся.
• 🌐 Логи веб-сервера. Если в ДО записи нет, запрос отсёк веб-сервер: коды 401, 403, 404, 500 здесь видны сразу.
• 📦 Монитор обмена (для пакетного обмена). В форме «Синхронизация данных» видно дату последнего успешного обмена и предупреждения по объектам.

Для онлайн-интеграции полезно раз в день автоматически опрашивать сервис ДО простым запросом и писать результат в мониторинг. Тогда упавшая публикация обнаружится до того, как бухгалтер начнёт закрывать месяц.

Права доступа и защита данных при интеграции

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

Отсюда практические выводы:

• 👤 не заводите одного общего пользователя ДО на всех — пропадёт разграничение и история «кто что сделал»;
• 🔑 доменная аутентификация лучше паролей, сохранённых в учётной базе;
• 🧾 служебного пользователя для пакетного обмена или регламентных заданий делайте с минимальными правами, только на нужные виды документов;
• 🌐 публикацию ДО наружу закрывайте HTTPS и ограничением по адресам на веб-сервере.

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

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

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