Документы и Печать · 12 мин
Как интегрировать Диадок в 1С: настройка электронного документооборота
Как интегрировать Диадок в 1С: выбор модуля, установка внешней обработки, настройка API, обмен УПД и актами. Пошаговая инструкция, ошибки и проверка результата.
Интеграция Диадок с 1С позволяет отправлять и получать юридически значимые документы — УПД, акты, счета-фактуры, накладные — прямо из учётной системы, без выгрузки файлов и работы в веб-интерфейсе. Документ формируется на основании первички в 1С, подписывается электронной подписью и уходит контрагенту, а входящие документы автоматически попадают в базу и могут создавать учётные документы без ручного ввода.
Существует три основных способа связки: готовый модуль Диадок для 1С (внешняя обработка), типовой механизм ЭДО в современных конфигурациях с подключением оператора и самостоятельная разработка через API Диадок. Выбор зависит от конфигурации, её доработанности и требований к автоматизации. Ниже разобраны все три варианта, порядок подключения, настройка и типичные проблемы.
Что нужно подготовить до начала интеграции
Прежде чем подключать модуль, убедитесь, что выполнены базовые условия. Во-первых, организация должна быть зарегистрирована в Диадоке, а ящик — активирован и оплачен по выбранному тарифу. Во-вторых, нужна действующая квалифицированная электронная подпись (КЭП) на руководителя или доверенное лицо с машиночитаемой доверенностью, если подписывает не директор.
В-третьих, проверьте совместимость: модуль Диадок поддерживает большинство популярных конфигураций (1С:Бухгалтерия 8, Управление торговлей 11, ERP, Комплексная автоматизация), но для сильно доработанных или старых конфигураций на обычных формах может потребоваться адаптация. Уточните список поддерживаемых версий в документации к модулю перед установкой.
Также заранее решите организационные вопросы: кто будет подписывать документы, кто отвечает за обработку входящих, нужен ли роуминг с другими операторами ЭДО, если ваши контрагенты работают не в Диадоке.
Сильно доработанные конфигурации могут потребовать адаптации модуля программистом
Срок действия сертификата и наличие МЧД, если подписывает не руководитель
Тариф и лимиты на количество документов
Возможность подключать внешние обработки и работать с документами
Способ 1. Установка готового модуля Диадок для 1С
Это самый распространённый вариант. Модуль распространяется как внешняя обработка (.epf), которую не нужно встраивать в конфигурацию — она работает поверх типовой и не нарушает поддержку обновлений. Это важное преимущество: при обновлении конфигурации модуль не слетает.
Порядок установки: скачайте актуальную версию модуля с официального сайта Диадока, откройте её в 1С через «Файл → Открыть» или подключите через механизм «Дополнительные отчеты и обработки» в разделе администрирования. При первом запуске модуль попросит указать логин и пароль от учётной записи Диадок или выполнить авторизацию по сертификату.
После авторизации выберите организацию (ящик Диадок), с которой будет работать база. Если в 1С ведётся учёт по нескольким организациям, модуль позволяет сопоставить каждой организации 1С свой ящик Диадок. Затем выполните начальную синхронизацию: модуль загрузит список контрагентов из Диадока и предложит связать их с контрагентами в 1С по ИНН и КПП.
- 1Зарегистрируйте организацию в Диадоке и активируйте ящик
- 2Скачайте актуальный модуль для 1С с официального сайта оператора
- 3Откройте обработку в 1С или подключите через «Дополнительные отчеты и обработки»
- 4Авторизуйтесь по логину/паролю или сертификату КЭП
- 5Сопоставьте организации 1С с ящиками Диадок
- 6Синхронизируйте контрагентов по ИНН/КПП
- 7Отправьте тестовый документ контрагенту и проверьте получение
Способ 2. Штатный ЭДО в типовых конфигурациях 1С
В современных конфигурациях (1С:Бухгалтерия 8 ред. 3.0, УТ 11, ERP) есть встроенный подсистема обмена электронными документами — 1С-ЭДО. Она позволяет работать с операторами ЭДО, включая Диадок, через механизм роуминга или прямое подключение, если оператор поддерживает интеграцию с 1С-ЭДО.
Настройка выполняется в разделе «Администрирование → Обмен электронными документами». Нужно включить использование ЭДО, создать учётную запись у оператора, указать сертификат подписи и настроить соглашения с контрагентами. Документы отправляются прямо из форм «Реализация», «Счет-фактура», «Поступление» кнопкой «Отправить по ЭДО».
Этот вариант удобен тем, что не требует сторонних обработок и полностью встроен в интерфейс. Ограничение: функциональность штатного ЭДО обычно уже, чем у фирменного модуля Диадок — например, могут быть недоступны некоторые неформализованные документы, маршруты согласования или специфические сценарии работы с УПД.
Сравнение способов интеграции
Максимум функций Диадока, не трогает конфигурацию; минус — отдельное окно обработки и зависимость от обновлений модуля
Встроен в интерфейс типовых конфигураций, удобен для стандартного документооборота; минус — ограниченная функциональность оператора
Полная свобода автоматизации и нестандартных сценариев; минус — нужны разработчики и поддержка кода
Способ 3. Интеграция через API Диадок
Для нестандартных задач — массовой автоматической отправки, интеграции с самописными конфигурациями, обмена специфическими документами — используется открытый API Диадок (HTTP API и COM-компонента). Из 1С удобно работать через COM-компоненту DiadocComApi, которая регистрируется на компьютере или сервере 1С.
Типовая схема работы через API: аутентификация по логину/паролю или сертификату, получение списка организаций, формирование документа (XML по утверждённому ФНС формату), упаковка в задание на отправку, подписание сертификатом и отправка. Входящие документы получают через события (events) ящика с последующей постраничной выборкой.
Пример инициализации COM-объекта в коде 1С:
DiadocApi = Новый COMОбъект("Diadoc.DiadocClient");
DiadocApi.ApiClientId = "ваш_ключ_разработчика";
Соединение = DiadocApi.CreateConnectionByCertificate(ОтпечатокСертификата, "https://diadoc-api.kontur.ru");
Организация = Соединение.GetOrganizationById(ИдентификаторЯщика);Для работы через API нужно получить ключ разработчика (ApiClientId) у Диадока. Учтите, что поддержку собственной разработки придётся вести самостоятельно: при смене форматов документов ФНС потребуется обновлять код формирования XML.
Настройка обмена документами после подключения
После установки модуля настройте правила работы с документами. Определите, какие виды документов будут уходить через Диадок: обычно это УПД (универсальный передаточный документ), акты, накладные ТОРГ-12, счета-фактуры и неформализованные документы (договоры, письма). Для каждого вида задайте шаблон формирования и подписанта по умолчанию.
Настройте сопоставление контрагентов: модуль ищет контрагентов в Диадоке по ИНН и КПП, поэтому критично, чтобы эти реквизиты в 1С были заполнены корректно. Контрагенты, не подключённые к ЭДО, будут получать приглашения; документы им можно отправлять после их подключения или через роуминг.
Для входящих документов настройте правила создания учётных документов: модуль может автоматически создавать «Поступление товаров и услуг» на основании входящего УПД с заполнением номенклатуры по сопоставлению. Проверьте это на нескольких документах вручную, прежде чем включать массовую автозагрузку.
Проверка результата и типичные ошибки
После настройки выполните контрольный обмен: отправьте тестовый УПД реальному контрагенту, который уже работает в Диадоке, и убедитесь, что документ подписан, доставлен и контрагент видит его корректно. Затем попросите контрагента отправить вам встречный документ и проверьте создание поступления в 1С.
Как проверить результат
«Подписан и отправлен», у контрагента документ отображается
Завис в статусе «Ожидает подписи» или ошибка отправки
Контрагент найден по ИНН/КПП, ящик привязан
Дубли контрагентов или «контрагент не найден»
Поступление создано с корректными суммами и номенклатурой
Пустые строки, неверные суммы, незаполненный НДС
Документ подписывается сертификатом без ошибок
«Сертификат не найден» или ошибка проверки МЧД
Ограничения и когда нужна помощь специалиста
Самостоятельная настройка оправдана для типовых конфигураций и стандартного документооборота: отправка УПД и актов, получение входящих, работа одного-двух подписантов. Этот сценарий обычно занимает один-два дня с учётом тестирования.
Привлекайте программиста 1С или интегратора, если: конфигурация сильно доработана, нужны нестандартные маршруты согласования, требуется автоматическая отправка по расписанию, обмен специфическими документами (например, для маркировки или прослеживаемости) или интеграция через API с собственной логикой. Также специалист нужен при миграции большого архива документов из другого оператора ЭДО.
Перед массовым переходом на ЭДО проведите инвентаризацию контрагентов: выясните, кто уже работает в Диадоке или у других операторов с роумингом. Обычно 60–80% активных контрагентов уже подключены к ЭДО, и с ними можно начать обмен сразу, а остальным отправить приглашения.
Часто задаваемые вопросы
Работает ли модуль Диадок с файловой базой 1С?
Да, внешняя обработка работает и в файловом, и в клиент-серверном варианте. Однако при файловом режиме и нескольких пользователях возможны блокировки при одновременной работе с модулем. Для нескольких операторов ЭДО предпочтителен клиент-серверный вариант.
Можно ли использовать Диадок, если контрагент работает с другим оператором ЭДО?
Да, через роуминг — обмен документами между разными операторами. Диадок поддерживает роуминг с основными операторами ЭДО. В настройках укажите оператора контрагента, и документы будут доставляться через межоператорский обмен. Учтите, что роуминг может тарифицироваться отдельно.
Что делать, если после обновления 1С модуль перестал работать?
Обновите модуль Диадок до актуальной версии — разработчики оператора выпускают обновления под новые релизы конфигураций. Если ошибка сохраняется, проверьте журнал ошибок модуля: часто проблема в изменённых объектах конфигурации или устаревшем формате данных.
Нужна ли отдельная электронная подпись для каждого пользователя?
Подписывать документы может только обладатель сертификата КЭП. Если подписант один — достаточно одного сертификата, к которому могут иметь доступ несколько пользователей модуля. Если подписывают несколько сотрудников, каждому нужен свой сертификат и, при необходимости, МЧД.
Как перенести архив документов из другого оператора ЭДО в Диадок?
Прямой автоматической миграции архивов между операторами обычно нет: юридически значимые документы хранятся у оператора, через которого были подписаны. Рекомендуется выгрузить архив из старого оператора в файлы с подписями и хранить его отдельно, а в Диадоке начать новый документооборот.
Можно ли автоматически отправлять документы по расписанию?
В стандартном модуле отправка выполняется вручную или пакетно по команде пользователя. Автоматическую отправку по расписанию реализуют через регламентные задания 1С с доработкой или через API Диадок — это задача для программиста, так как требует обработки ошибок и контроля статусов.
Что важно запомнить
Для типовой конфигурации используйте готовый модуль Диадок — он не затрагивает конфигурацию и ставится за один день. Обязательно проверьте сертификат КЭП, МЧД подписанта и корректность ИНН/КПП контрагентов. Тестируйте обмен на копии базы и тестовом ящике, а нестандартную автоматизацию делайте через API с привлечением разработчика.