Автоматизация · 13 мин
Интеграция с 1С:Документооборот: что это и как работает
Что такое интеграция с 1С:Документооборот: способы обмена данными, типовые механизмы, web-сервисы, этапы настройки, риски и типичные ошибки при внедрении.
Интеграция с 1С:Документооборот — это настройка обмена данными между системой электронного документооборота (СЭД) от фирмы «1С» и другими программами: учётными системами (1С:ERP, 1С:Бухгалтерия, 1С:ЗУП), почтовыми клиентами, сайтами, CRM и сторонними решениями. Цель такой интеграции — исключить двойной ввод информации: документ, созданный в учётной системе, автоматически появляется в документообороте, проходит согласование, а его статус возвращается обратно.
На практике интеграция решает три типовые задачи. Первая — передача документов и файлов между системами: например, договор из 1С:ERP уходит на согласование в Документооборот вместе с печатной формой. Вторая — синхронизация справочников: контрагенты, сотрудники, подразделения и номенклатура должны совпадать во всех системах, иначе обмен превратится в источник ошибок. Третья — передача статусов и результатов: после подписания договора в СЭД учётная система получает отметку «Согласован» и может продолжить процесс (оплату, отгрузку).
Способ интеграции выбирают исходя из того, какие системы нужно связать, какой объём данных передаётся и есть ли в штате разработчик. Ниже разобраны основные варианты — от типовых механизмов, которые настраиваются без программирования, до собственных API-решений.
Что именно передаётся между системами
Перед настройкой важно определить состав обмена, потому что от него зависит выбор инструмента и трудоёмкость. В типовом сценарии между учётной системой и Документооборотом передаются четыре группы данных.
Первая группа — нормативно-справочная информация: контрагенты, организации, сотрудники, подразделения, валюты, статьи ДДС. Справочники синхронизируются первыми, поскольку документы ссылаются на них. Вторая группа — сами документы: внутренние, входящие, исходящие, а также ссылки на объекты учётной системы (счета, заказы, акты). Третья группа — файлы: скан-копии, печатные формы, подписанные версии. Четвёртая — процессы и их статусы: кто согласует, на каком этапе документ, каково решение.
Частая ошибка на старте — попытка синхронизировать «всё сразу». Это резко увеличивает объём тестирования. Практичнее начать с одного процесса, например согласования договоров, и расширять обмен после стабильной работы первого контура.
Основные способы интеграции
Существует несколько технических подходов, и у каждого есть область применения. Выбор зависит от того, что стоит «на другой стороне» обмена.
Типовая бесшовная интеграция с конфигурациями 1С
Для связки с 1С:ERP, 1С:Комплексная автоматизация, 1С:Бухгалтерия и 1С:ЗУП в Документообороте предусмотрен встроенный механизм интеграции. Учётная система подключается к Документообороту через web-сервисы, публикуемые на веб-сервере, после чего пользователи видят задачи согласования и связанные документы прямо в привычном интерфейсе. Настройка выполняется через мастер и не требует программирования, но требует аккуратного сопоставления справочников и правил заполнения.
HTTP-интерфейс и web-сервисы
Для интеграции с не-1С системами (сайт, CRM, самописный учёт) используется публикуемый HTTP-интерфейс или стандартные web-сервисы Документооборота. Сторонняя система обращается к ним по протоколу HTTP(S), создаёт документы, запускает процессы, получает статусы. Этот путь требует разработки на стороне внешней системы, зато не привязан к платформе 1С.
Файловый обмен и промежуточные шины
Простейший вариант — обмен файлами (XML, CSV) через каталог или SFTP: одна система выгружает, другая загружает по расписанию. Более надёжная альтернатива для высоких нагрузок — брокеры сообщений (например, RabbitMQ или Kafka), когда Документооборот и внешняя система обмениваются через очередь. Такой подход устойчив к временной недоступности одной из сторон.
Сравнение вариантов
Подходит для связки с типовыми конфигурациями 1С. Настраивается без кода, но ограничена предусмотренными сценариями.
Подходит для сторонних систем и нестандартных сценариев. Требует разработки и сопровождения кода.
Подходит для простых разовых выгрузок и систем без API. Минус — задержки и ручной контроль ошибок.
Подходит для высоконагруженных обменов. Требует инфраструктуры брокера и квалифицированного администрирования.
Как настроить типовую интеграцию с учётной системой
Рассмотрим общий порядок настройки бесшовной интеграции на примере связки Документооборота с учётной конфигурацией. Конкретные названия пунктов меню зависят от версии, но логика одинакова.
Сначала проверьте совместимость версий: механизм интеграции требует поддерживаемых релизов обеих конфигураций. Затем опубликуйте web-сервисы Документооборота на веб-сервере (IIS или Apache) — без этого учётная система не сможет подключиться. Публикация выполняется из конфигуратора или вручную через файл настроек публикации.
Далее в учётной системе запускается настройка интеграции: указывается адрес опубликованного web-сервиса, пользователь для подключения, выбираются правила интеграции — какие виды документов учётной системы с какими видами документов СЭД связаны. После этого настраивается синхронизация справочников и права пользователей. Финальный этап — тестирование на копии: создайте тестовый договор, отправьте на согласование, проверьте передачу статуса обратно.
- 1Проверьте совместимость версий обеих конфигураций и сделайте резервные копии баз
- 2Опубликуйте web-сервисы Документооборота на веб-сервере (IIS или Apache)
- 3В учётной системе укажите адрес подключения и пользователя интеграции
- 4Настройте правила интеграции: соответствие видов документов и реквизитов
- 5Выполните первичную синхронизацию справочников и проверьте сопоставление
- 6Протестируйте полный цикл на копии: создание документа, согласование, возврат статуса
- 7Перенесите настройки в рабочую базу и проведите пробный запуск с пользователями
Синхронизация справочников: на что обратить внимание
Справочники — самое уязвимое место любой интеграции. Если контрагент в учётной системе и в Документообороте — это два разных элемента, документы будут «терять» связи, а отчёты — расходиться. Поэтому сопоставление выполняется по ключевым реквизитам: для контрагентов обычно по ИНН и КПП, для сотрудников — по физическому лицу, для организаций — по ИНН.
Перед первой синхронизацией приведите данные в порядок: закройте дубли контрагентов, заполните ИНН у всех активных записей, пометьте неиспользуемые элементы на удаление. Автоматическое сопоставление при «грязных» данных создаст десятки дублей, которые потом придётся разбирать вручную.
Определите «мастер-систему» для каждого справочника — ту, где данные создаются и редактируются. Обычно контрагенты ведутся в учётной системе, а оргструктура и сотрудники — в Документообороте или ЗУП. Двустороннее редактирование одного справочника в двух системах почти гарантированно приведёт к конфликтам.
Интеграция со сторонними системами через HTTP-интерфейс
Когда «вторая сторона» — не 1С, типовой механизм не поможет, и обмен строится на публикуемых HTTP-сервисах. Документооборот предоставляет web-сервисы для основных операций: получение списка документов, создание документа, запуск процесса, получение статуса, работа с файлами. Разработчик внешней системы вызывает эти методы, передавая данные в JSON или XML.
Типовой сценарий: заявка с сайта или из CRM должна регистрироваться во входящих документах. Внешняя система вызывает метод создания документа, передаёт реквизиты и файл, получает в ответ идентификатор. Дальше документ обрабатывается в СЭД штатно, а внешняя система периодически опрашивает статус по идентификатору либо получает уведомление, если реализован обратный вызов.
Ключевые моменты безопасности: публикуйте сервисы только по HTTPS, используйте отдельную учётную запись с минимально необходимыми правами, ограничьте доступ по IP там, где это возможно. Учётная запись интеграции с полными правами — частая причина инцидентов.
Проверка результата и типичные ошибки
После запуска интеграции результат проверяется не по факту «настройка сохранена», а по прохождению полного бизнес-цикла. Минимальный контроль: документ создан в одной системе, появился в другой, прошёл согласование, статус вернулся, файл доступен с обеих сторон.
Как проверить результат
Документ появляется во второй системе в течение заданного интервала с корректными реквизитами
Документ отсутствует, создан с пустыми полями или задвоен
Контрагенты и сотрудники сопоставлены, новых дублей нет
Появились дубли по ИНН или элементы без связей
После согласования в СЭД учётная система показывает актуальный статус
Статус не меняется или застревает в промежуточном значении
Печатная форма и сканы открываются из обеих систем
Файл отсутствует, пустой или недоступен по правам
Если обмен ведёт себя нестабильно, первым делом смотрите журнал регистрации обеих баз и логи веб-сервера: большинство причин — недоступность web-сервиса, истёкший пароль учётной записи интеграции, ошибки сопоставления справочников или превышение таймаутов при передаче больших файлов.
Ограничения и когда нужен разработчик
Типовая интеграция покрывает стандартные сценарии: согласование договоров, счетов, заявок, ознакомление с документами. Но у неё есть границы. Нестандартные виды документов, сложные маршруты согласования с условиями, интеграция с самописными системами, требования к мгновенной (а не по расписанию) передаче данных — всё это выходит за рамки настройки и требует доработки.
Самостоятельно, без привлечения разработчика, безопасно выполнять: настройку типовой интеграции по инструкции, сопоставление справочников, настройку правил интеграции, проверку обмена на тестовой базе. К специалисту стоит обращаться при необходимости доработки web-сервисов, интеграции с внешними по отношению к 1С системами, а также при сбоях репликации в распределённых базах — некорректные действия там могут привести к потере данных.
Как выбрать действие
Частые вопросы об интеграции с 1С:Документооборот
Чем интеграция отличается от простого переноса данных?
Перенос — разовая операция: данные выгружаются из старой системы и загружаются в новую, после чего обмен прекращается. Интеграция — постоянно действующий обмен: системы работают параллельно и регулярно синхронизируют документы, справочники и статусы. Интеграция требует сопровождения: мониторинга ошибок, поддержки учётных записей, контроля при обновлениях.
Можно ли настроить интеграцию без программиста?
Да, если речь о типовой бесшовной интеграции с поддерживаемыми конфигурациями 1С: настройка выполняется через мастер, публикацию web-сервисов и правила интеграции. Понадобятся права администратора и доступ к веб-серверу. Для связи со сторонними системами без разработчика не обойтись — там нужен код, вызывающий API Документооборота.
Что будет с обменом при обновлении конфигурации?
Если использовались только типовые механизмы и расширения, обновление обычно проходит штатно, но правила интеграции нужно перепроверить после каждого крупного обновления — состав реквизитов может измениться. Если дорабатывались типовые web-сервисы, обновление потребует ручного сравнения и переноса изменений, поэтому таких доработок лучше избегать.
Как передавать большие файлы между системами?
Крупные файлы (десятки мегабайт и больше) часто упираются в таймауты web-сервисов и ограничения веб-сервера. Практические меры: увеличить лимиты на стороне IIS/Apache, передавать файлы частями, сжимать вложения, а при регулярных больших объёмах — выносить файлообмен в отдельный механизм (общее файловое хранилище или очередь), передавая через API только ссылки.
Что делать, если в обмене появились дубли контрагентов?
Сначала остановите синхронизацию, чтобы дубли не множились. Затем найдите причину: обычно это незаполненный ИНН или изменённые правила поиска. Дубли объединяются штатной обработкой поиска и удаления дублей с заменой ссылок, после чего правила сопоставления корректируются и синхронизация запускается снова — сначала на тестовой копии.
Безопасно ли публиковать web-сервисы Документооборота в интернет?
Прямая публикация в открытый интернет нежелательна. Минимальный набор мер: только HTTPS, отдельная учётная запись с ограниченными правами, сложный пароль или сертификатная аутентификация, ограничение доступа по IP-адресам, VPN или обратный прокси с фильтрацией. Регулярно проверяйте журналы доступа на предмет посторонних обращений.
Что важно запомнить
Интеграция с 1С:Документооборот — это постоянный обмен документами, справочниками и статусами между СЭД и другими системами. Для типовых конфигураций 1С используйте бесшовную интеграцию без программирования, для сторонних систем — HTTP-интерфейс с привлечением разработчика. Успех определяется чистотой справочников, тестированием на копии и мониторингом обмена после запуска.