Библиотека интеграции с 1С:Документооборот 8: что это и как её использовать

Библиотека интеграции с 1С:Документооборот 8 (сокращённо БИД) — это программная подсистема от фирмы «1С», которая встраивается в прикладные решения на платформе «1С:Предприятие 8» и обеспечивает бесшовный обмен данными между учётной системой (например, «1С:ERP», «1С:Комплексная автоматизация», «1С:Управление торговлей») и «1С:Документооборот». Проще говоря, это готовый «мост», который позволяет пользователю работать с документами, задачами и процессами документооборота прямо из привычной учётной программы, не переключаясь между двумя приложениями.

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

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

Какие задачи решает библиотека интеграции

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

Ключевые возможности библиотеки:

• запуск бизнес-процессов документооборота (согласование, утверждение, регистрация, рассмотрение) из учётной системы по любому объекту — счёту, договору, заказу, накладной;
• отображение текущего состояния процесса и истории согласования прямо в карточке документа учётной системы;
• обмен присоединёнными файлами между конфигурациями, включая передачу сканов подписанных документов;
• синхронизация ссылочных данных: контрагентов, организаций, сотрудников, валют, номенклатуры;
• работа с задачами документооборота в интерфейсе учётной системы — пользователь видит и выполняет свои задачи, не открывая вторую программу;
• электронная подпись документов при совместном использовании с механизмами ЭП платформы.

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

Как устроена библиотека: архитектура и принцип работы

Технически обмен между учётной системой и документооборотом построен на веб-сервисах. На стороне «1С:Документооборота» публикуется специальный веб-сервис (DMIL — Document Management Integration Library), который принимает запросы от учётной системы. Библиотека, встроенная в учётную конфигурацию, формирует эти запросы, обрабатывает ответы и отображает результат пользователю.

Данные между системами передаются в формате XDTO-пакетов — структурированных XML-сообщений, описывающих объекты документооборота: внутренние документы, входящие и исходящие письма, задачи, процессы. Библиотека содержит готовые описания этих объектов, правила их преобразования и обработчики событий.

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

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

Что нужно для работы: системные требования и подготовка

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

Необходимые компоненты:

• развёрнутая и работающая база «1С:Документооборот» поддерживаемой версии — конкретные требования указаны в документации к поставке БИД;
• опубликованный на веб-сервере (Apache или IIS) веб-сервис интеграции документооборота;
• учётная конфигурация со встроенной библиотекой — типовая, где БИД уже есть, или доработанная внедренцем;
• пользователь в документообороте с правами на работу через веб-сервис и доступ к нужным видам документов;
• сетевая доступность между серверами двух систем и актуальные версии платформы «1С:Предприятие».

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

Как настроить интеграцию: порядок действий

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

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

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

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

Типовые сценарии использования

Согласование договоров и счетов

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

Централизованная обработка входящей корреспонденции

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

Задачи документооборота в учётной системе

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

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

Ограничения и типичные ошибки

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

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

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

Как проверить, что интеграция работает

Подключение к веб-сервису

Норма

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

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

Ошибка соединения, таймаут или сообщение о неверной версии

Запуск процесса

Норма

Из карточки документа процесс стартует, в документообороте появляется документ и задача исполнителю

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

Команда недоступна, возникает ошибка, документ в документообороте не создаётся

Обратный статус

Норма

После выполнения задачи в документообороте состояние в учётной системе обновляется на «Согласован»

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

Статус зависает в промежуточном состоянии и не меняется

Передача файлов

Норма

Присоединённые файлы видны и открываются в обеих системах

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

Файлы пустые, не открываются или отсутствуют на одной из сторон

Альтернативы библиотеке интеграции

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

Сравнение подходов к интеграции

Библиотека интеграции (БИД)

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

Самописный обмен через веб-сервисы или файлы

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

Планы обмена / EnterpriseData

Хороши для регулярной синхронизации справочников и документов по расписанию. Не дают бесшовного запуска процессов из интерфейса — обычно используются как дополнение к БИД.

Внешние СЭД и шины данных

Оправданы, если документооборот ведётся не в 1С. Требуют отдельного проекта интеграции и сопровождения.

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

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

Библиотека интеграции платная или бесплатная?

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

Нужно ли встраивать БИД в типовую «1С:ERP» или «1С:Управление торговлей»?

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

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

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

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

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

Передаются ли по интеграции электронные подписи и подписанные файлы?

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

Сколько пользователей могут работать через интеграцию одновременно?

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