К статье
Практический материал

Документы и Печать · 12 мин

Как интегрировать Диадок в 1С: настройка электронного документооборота

Как интегрировать Диадок в 1С: выбор модуля, установка внешней обработки, настройка API, обмен УПД и актами. Пошаговая инструкция, ошибки и проверка результата.

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

Существует три основных способа связки: готовый модуль Диадок для 1С (внешняя обработка), типовой механизм ЭДО в современных конфигурациях с подключением оператора и самостоятельная разработка через API Диадок. Выбор зависит от конфигурации, её доработанности и требований к автоматизации. Ниже разобраны все три варианта, порядок подключения, настройка и типичные проблемы.

Что нужно подготовить до начала интеграции

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

В-третьих, проверьте совместимость: модуль Диадок поддерживает большинство популярных конфигураций (1С:Бухгалтерия 8, Управление торговлей 11, ERP, Комплексная автоматизация), но для сильно доработанных или старых конфигураций на обычных формах может потребоваться адаптация. Уточните список поддерживаемых версий в документации к модулю перед установкой.

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

Конфигурация 1СТиповая или доработанная

Сильно доработанные конфигурации могут потребовать адаптации модуля программистом

Электронная подписьКЭП на подписанта

Срок действия сертификата и наличие МЧД, если подписывает не руководитель

Ящик в ДиадокеАктивен и оплачен

Тариф и лимиты на количество документов

Права пользователя 1СДоступ к внешним обработкам

Возможность подключать внешние обработки и работать с документами

Способ 1. Установка готового модуля Диадок для 1С

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

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

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

Порядок подключения модуля Диадок
  1. 1
    Зарегистрируйте организацию в Диадоке и активируйте ящик
  2. 2
    Скачайте актуальный модуль для 1С с официального сайта оператора
  3. 3
    Откройте обработку в 1С или подключите через «Дополнительные отчеты и обработки»
  4. 4
    Авторизуйтесь по логину/паролю или сертификату КЭП
  5. 5
    Сопоставьте организации 1С с ящиками Диадок
  6. 6
    Синхронизируйте контрагентов по ИНН/КПП
  7. 7
    Отправьте тестовый документ контрагенту и проверьте получение

Способ 2. Штатный ЭДО в типовых конфигурациях 1С

В современных конфигурациях (1С:Бухгалтерия 8 ред. 3.0, УТ 11, ERP) есть встроенный подсистема обмена электронными документами — 1С-ЭДО. Она позволяет работать с операторами ЭДО, включая Диадок, через механизм роуминга или прямое подключение, если оператор поддерживает интеграцию с 1С-ЭДО.

Настройка выполняется в разделе «Администрирование → Обмен электронными документами». Нужно включить использование ЭДО, создать учётную запись у оператора, указать сертификат подписи и настроить соглашения с контрагентами. Документы отправляются прямо из форм «Реализация», «Счет-фактура», «Поступление» кнопкой «Отправить по ЭДО».

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

Сравнение способов интеграции

Модуль Диадок (внешняя обработка)

Максимум функций Диадока, не трогает конфигурацию; минус — отдельное окно обработки и зависимость от обновлений модуля

Штатный ЭДО 1С

Встроен в интерфейс типовых конфигураций, удобен для стандартного документооборота; минус — ограниченная функциональность оператора

Разработка через API Диадок

Полная свобода автоматизации и нестандартных сценариев; минус — нужны разработчики и поддержка кода

Способ 3. Интеграция через API Диадок

Для нестандартных задач — массовой автоматической отправки, интеграции с самописными конфигурациями, обмена специфическими документами — используется открытый API Диадок (HTTP API и COM-компонента). Из 1С удобно работать через COM-компоненту DiadocComApi, которая регистрируется на компьютере или сервере 1С.

Типовая схема работы через API: аутентификация по логину/паролю или сертификату, получение списка организаций, формирование документа (XML по утверждённому ФНС формату), упаковка в задание на отправку, подписание сертификатом и отправка. Входящие документы получают через события (events) ящика с последующей постраничной выборкой.

Пример инициализации COM-объекта в коде 1С:

bsl
DiadocApi = Новый COMОбъект("Diadoc.DiadocClient");
DiadocApi.ApiClientId = "ваш_ключ_разработчика";
Соединение = DiadocApi.CreateConnectionByCertificate(ОтпечатокСертификата, "https://diadoc-api.kontur.ru");
Организация = Соединение.GetOrganizationById(ИдентификаторЯщика);

Для работы через API нужно получить ключ разработчика (ApiClientId) у Диадока. Учтите, что поддержку собственной разработки придётся вести самостоятельно: при смене форматов документов ФНС потребуется обновлять код формирования XML.

Настройка обмена документами после подключения

После установки модуля настройте правила работы с документами. Определите, какие виды документов будут уходить через Диадок: обычно это УПД (универсальный передаточный документ), акты, накладные ТОРГ-12, счета-фактуры и неформализованные документы (договоры, письма). Для каждого вида задайте шаблон формирования и подписанта по умолчанию.

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

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

Проверка результата и типичные ошибки

После настройки выполните контрольный обмен: отправьте тестовый УПД реальному контрагенту, который уже работает в Диадоке, и убедитесь, что документ подписан, доставлен и контрагент видит его корректно. Затем попросите контрагента отправить вам встречный документ и проверьте создание поступления в 1С.

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

Как проверить результат

Статус отправленного документа
Норма

«Подписан и отправлен», у контрагента документ отображается

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

Завис в статусе «Ожидает подписи» или ошибка отправки

Сопоставление контрагентов
Норма

Контрагент найден по ИНН/КПП, ящик привязан

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

Дубли контрагентов или «контрагент не найден»

Создание входящих документов
Норма

Поступление создано с корректными суммами и номенклатурой

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

Пустые строки, неверные суммы, незаполненный НДС

Подписание
Норма

Документ подписывается сертификатом без ошибок

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

«Сертификат не найден» или ошибка проверки МЧД

Типичные ошибки при интеграции
01
Незаполненный КПП у контрагента — модуль не может сопоставить его с ящиком Диадок, документы уходят «в никуда»
02
Просроченный сертификат КЭП — подписание блокируется в самый неподходящий момент, обычно при закрытии месяца
03
Отсутствие МЧД у подписанта — контрагенты отклоняют документы, подписанные без доверенности
04
Тестирование на боевой базе — ошибочно отправленный УПД приходится исправлять корректировками
05
Устаревшая версия модуля — ошибки при смене форматов ФНС, модуль нужно регулярно обновлять
06
Автозагрузка входящих без проверки — в учёт попадают документы с неверным сопоставлением номенклатуры

Ограничения и когда нужна помощь специалиста

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

Привлекайте программиста 1С или интегратора, если: конфигурация сильно доработана, нужны нестандартные маршруты согласования, требуется автоматическая отправка по расписанию, обмен специфическими документами (например, для маркировки или прослеживаемости) или интеграция через API с собственной логикой. Также специалист нужен при миграции большого архива документов из другого оператора ЭДО.

Перед массовым переходом на ЭДО проведите инвентаризацию контрагентов: выясните, кто уже работает в Диадоке или у других операторов с роумингом. Обычно 60–80% активных контрагентов уже подключены к ЭДО, и с ними можно начать обмен сразу, а остальным отправить приглашения.
ПЗ
Практическое замечание

Часто задаваемые вопросы

Работает ли модуль Диадок с файловой базой 1С?

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

Можно ли использовать Диадок, если контрагент работает с другим оператором ЭДО?

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

Что делать, если после обновления 1С модуль перестал работать?

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

Нужна ли отдельная электронная подпись для каждого пользователя?

Подписывать документы может только обладатель сертификата КЭП. Если подписант один — достаточно одного сертификата, к которому могут иметь доступ несколько пользователей модуля. Если подписывают несколько сотрудников, каждому нужен свой сертификат и, при необходимости, МЧД.

Как перенести архив документов из другого оператора ЭДО в Диадок?

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

Можно ли автоматически отправлять документы по расписанию?

В стандартном модуле отправка выполняется вручную или пакетно по команде пользователя. Автоматическую отправку по расписанию реализуют через регламентные задания 1С с доработкой или через API Диадок — это задача для программиста, так как требует обработки ошибок и контроля статусов.

Итог

Что важно запомнить

Для типовой конфигурации используйте готовый модуль Диадок — он не затрагивает конфигурацию и ставится за один день. Обязательно проверьте сертификат КЭП, МЧД подписанта и корректность ИНН/КПП контрагентов. Тестируйте обмен на копии базы и тестовом ящике, а нестандартную автоматизацию делайте через API с привлечением разработчика.