Бесшовная интеграция 1С:Документооборот 3.0

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

// 01Что такое бесшовная интеграция и чем она отличается от обмена

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

	Обмен данными	Бесшовная интеграция
Что происходит с документом	Копируется в Документооборот как отдельный объект	Остаётся в учётной системе, в Документообороте появляется связь с ним
Где работает пользователь	Переключается между программами	В своей учётной системе
Риск расхождения данных	Есть: две копии живут своей жизнью	Ниже: источник один
Что видит согласующий	Карточку в Документообороте	Карточку в Документообороте со ссылкой на оригинал

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

// 02С какими конфигурациями интегрируется из коробки

В поставке 1С:Документооборот 3.0 есть готовые механизмы обмена для линейки типовых решений:

• 1С:ERP Управление предприятием 2 и 1С:Комплексная автоматизация — общий механизм на двоих;
• 1С:Бухгалтерия предприятия;
• 1С:Управление торговлей 11;
• 1С:Управление производственным предприятием 1.3;
• 1С:Управление холдингом 3.

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

// 03Библиотека интеграции с 1С:Документооборотом

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

Отсюда два следствия, которые влияют на план проекта:

• Работ всегда две стороны. Обновление, тестирование и регламент выпуска релизов нужно планировать и для Документооборота, и для учётной системы. Проект, где в план заложена только одна база, почти гарантированно поедет по срокам.
• Версии должны быть совместимы. Возможности интеграции ограничены той стороной, которая отстала. Обновили Документооборот, но не тронули ERP — часть сценариев может не заработать, и выглядеть это будет как ошибка Документооборота.

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

// 04Настройка бесшовной интеграции: что задаётся при подключении

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

Параметр	Зачем нужен
Адрес сервиса	Точка подключения к внешней системе — её опубликованный веб-сервис
Способ аутентификации и логин	От чьего имени Документооборот обращается к внешней системе
Пользователь	Учётная запись, под которой отрабатывают операции интеграции
Использование сертификата	Подключение по сертификату вместо или в дополнение к паролю
Подписание данных	Передаваемые данные подписываются — актуально для юридически значимых сценариев
Оповещение об изменениях	Уведомлять ли внешнюю систему об изменениях на стороне Документооборота

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

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

// 05Как хранится связь документа с внешней системой

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

Из того, что внешний объект адресуется строкой, а не ссылкой, следуют три вещи:

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

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

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

// 06Сопоставление сотрудников: где ломается чаще всего

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

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

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

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

// 071С:Кабинет сотрудника и согласование вне системы

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

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

Когда это уместно:

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

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

// 08Диагностика: документ не доехал

Самая частая заявка по интеграции звучит одинаково: «запустили согласование из ERP, в Документообороте ничего нет». Разбирать её нужно по слоям, а не гадать.

Главное, что стоит знать про механику: обмен асинхронный. Сообщение сначала попадает в очередь и только затем отправляется, а в истории отправки хранятся две разные даты — создания и отправки. Это даёт точную развилку:

Что видно	Что это значит	Куда смотреть
Записи нет вообще	Сообщение не сформировалось	Сторона учётной системы: настройки, права, библиотека интеграции
Есть дата создания, нет даты отправки	Сформировалось, но не ушло	Доставка: адрес сервиса, сеть, аутентификация, фоновые задания
Есть обе даты, результата нет	Ушло, но не принято или не обработано	Приём: сопоставление сотрудников, вид документа, настройки процесса

Этот порядок экономит часы: он отделяет проблемы доставки от проблем бизнес-логики до того, как в разбор втянут разработчиков обеих сторон. Смежные симптомы — зависшие задачи, непрошедшие уведомления — удобно проходить по дереву диагностики 1С:Документооборот.

// 09Типовые ошибки интеграционных проектов

Ошибка	Последствие	Как правильно
В плане проекта только Документооборот	Работы на стороне учётной системы всплывают в середине проекта	Планировать обе стороны с самого начала
Сопоставление сотрудников как разовая настройка	Через полгода регулярные сбои после кадровых событий	Регламент и ответственный за актуальность
Обратная связь подразумевается, но не включена	Заказчик не видит статус согласования в своей системе	Явно проговорить и настроить оповещение об изменениях
Интеграция «на все документы сразу»	Долгий запуск, сложная отладка, размытая ответственность	Пилот на одном виде документа, затем расширение
Обновление одной стороны без проверки второй	Часть сценариев отваливается после планового релиза	Совместное тестирование версий перед обновлением
Нет ответственного за интеграцию со стороны заказчика	Инциденты бесконечно перекидываются между командами	Один владелец процесса на обе системы

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

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

Что такое бесшовная интеграция с 1С:Документооборот?

Это режим, при котором пользователь работает в своей учётной системе — ERP, Бухгалтерии, Управлении торговлей — и запускает согласование документа оттуда, не открывая 1С:Документооборот. Процесс исполняется в Документообороте, а результат возвращается в карточку исходного документа. В отличие от обычного обмена данными, документ не копируется, а связывается ссылкой.

С какими конфигурациями 1С:Документооборот 3.0 интегрируется из коробки?

В поставке есть готовые механизмы обмена с 1С:ERP Управление предприятием 2 и Комплексной автоматизацией, 1С:Бухгалтерией предприятия, 1С:Управлением торговлей 11, 1С:Управлением производственным предприятием 1.3 и 1С:Управлением холдингом 3. Кроме них есть универсальный механизм интегрированных систем и синхронизация через универсальный формат — через них подключаются остальные конфигурации, в том числе не относящиеся к 1С.

Что такое библиотека интеграции с 1С:Документооборотом?

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

Как интегрировать 1С:ЗУП с 1С:Документооборот 3.0?

Отдельного готового механизма обмена с ЗУП в поставке нет — в отличие от ERP, Бухгалтерии, УТ, УПП и Управления холдингом. Интеграция строится через универсальный механизм интегрированных систем, синхронизацию через универсальный формат или через 1С:Кабинет сотрудника. Это влияет на оценку: там, где для ERP речь идёт о настройке, для ЗУП закладывайте отдельную разработку.

Почему документ не доехал из учётной системы в 1С:Документооборот?

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