Как работает интеграция с 1С:Документооборот

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

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

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

Какие задачи решает интеграция с документооборотом

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

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

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

Механизмы обмена: веб-сервисы, REST и файловый обмен

Основной канал интеграции — веб-сервисы, которые поставляются в составе конфигурации. Для связи с типовыми решениями 1С используется сервис бесшовной интеграции: учётная система подключается к опубликованной базе Документооборота по HTTP/HTTPS и вызывает его методы. Транспорт — SOAP поверх HTTP, данные передаются в XML.

Для произвольных внешних систем удобнее REST-интерфейс (HTTP-сервисы), если он включён в вашей версии конфигурации, либо самописные HTTP-сервисы, которые разработчик добавляет под конкретную задачу. REST проще отлаживать: запрос можно проверить обычным curl или Postman, не поднимая клиентское приложение 1С.

Файловый обмен — резервный вариант для систем, которые не умеют работать с веб-сервисами: выгрузка XML/CSV в общий каталог и загрузка регламентным заданием по расписанию. Он проще в запуске, но не даёт мгновенной реакции и требует контроля целостности файлов.

Настройка бесшовной интеграции с 1С:ERP, УТ и КА

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

Критичный этап — сопоставление нормативно-справочной информации. Если контрагент «ООО Ромашка» в ERP и в Документообороте — это два разных элемента справочника, документы будут создаваться с пустыми или дублирующими реквизитами. Сопоставление выполняется по ключевым полям (ИНН, наименование) и вручную для неоднозначных записей.

1. 1
   Опубликуйте базу Документооборота на веб-сервере (IIS или Apache) и проверьте доступность из браузера.
2. 2
   Создайте в Документообороте отдельного пользователя интеграции и назначьте ему только необходимые права.
3. 3
   Включите в Документообороте функциональную опцию интеграции и укажите публикуемые сервисы.
4. 4
   В учётной системе укажите адрес публикации, логин и пароль пользователя интеграции, проверьте соединение.
5. 5
   Настройте правила интеграции: виды документов, соответствие справочников, направление обмена.
6. 6
   Проведите тест: создайте документ в ERP, запустите согласование, убедитесь, что статус вернулся обратно.

Интеграция с внешними системами через HTTP-сервисы

Когда источник данных — не 1С (сайт, CRM, личный кабинет, система ЭДО), обмен строится на HTTP-сервисах. Внешняя система отправляет запрос с данными документа в формате JSON или XML, сервис создаёт внутренний документ, регистрирует входящий или запускает бизнес-процесс. Ответ содержит идентификатор созданного объекта, который внешняя система сохраняет для дальнейших запросов статуса.

Безопасность здесь — зона особого внимания. HTTP-сервисы, открытые наружу, должны работать только по HTTPS, с отдельной учётной записью, ограниченными правами и, желательно, с фильтрацией по IP или через шлюз. Публикация сервиса с анонимным доступом и полными правами — прямой путь к компрометации базы с документами.

curl -u integration_user:password -X POST https://server/docs/hs/api/createDocument -H "Content-Type: application/json" -d "{\"type\":\"ВнутреннийДокумент\",\"title\":\"Договор поставки\",\"correspondent\":\"ООО Ромашка\"}"

Синхронизация справочников и правила соответствия

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

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

Проверка результата и диагностика сбоев

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

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

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

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

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

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