Диадок и 1С: модуль, роуминг или API — настраиваем обмен без ошибок

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

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

Какой способ интеграции Диадок и 1С выбрать

Выбор зависит от того, где у вас уже открыт ящик и сколько документов идёт через ЭДО.

💡 Если у вас БП 3.0, УТ 11, КА или ERP и ящик уже в Диадоке — берите модуль. Это самый короткий путь: от установки до первой отправки обычно хватает часа.

Роуминг уместен, когда компания исторически работает через 1С-ЭДО (Калуга Астрал) или Такском, а Диадок нужен только для обмена с несколькими крупными покупателями. Тогда второй ящик не обязателен.

Что подготовить до подключения Диадок к 1С

Половина проблем при настройке — это не 1С, а неготовая подпись или ящик. Проверьте заранее:

• 🔑 Сертификат КЭП. Для руководителя — от УЦ ФНС, для сотрудников — сертификат физлица плюс машиночитаемая доверенность (МЧД). Срок действия — не меньше пары месяцев.
• 🧩 Криптопровайдер. КриптоПро CSP или другой, с которым работает ваш сертификат. Лицензия CSP должна быть действующей, а не пробной на исходе.
• 📦 Ящик в Диадоке. Организация зарегистрирована, ИНН и КПП в ящике совпадают с карточкой организации в 1С. Для обособленных подразделений — свои подразделения или ящики.
• 💳 Тариф. Интеграция с 1С входит не во все тарифы. Уточните у менеджера Контура, включён ли модуль.
• 🖥️ Права в 1С. Для установки обработки или расширения нужны полные права. Для работы — роль, разрешающая ЭДО.
• 🌐 Доступ в интернет. Прокси и межсетевой экран не должны резать HTTPS до серверов Контура.

Ещё один шаг, который часто пропускают, — обновить конфигурацию . Модуль Контура поддерживает определённые релизы. Если база отстала на год-полтора, модуль может не встать или работать с ошибками.

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

Шаг 1. Скачайте модуль

Модуль берут на сайте Диадока, в разделе интеграций с 1С, или запрашивают у менеджера Контура. Выбирайте версию под свою конфигурацию: для БП 3.0 и УТ 11 файлы разные.

По расширению файла понятно, как его ставить:

• .epf — внешняя обработка;
• .cfe — расширение конфигурации .

Шаг 2. Подключите файл к базе

Для внешней обработки в БП 3.0:

1. Откройте Администрирование → Печатные формы, отчеты и обработки.
2. Включите флажок «Дополнительные отчеты и обработки», если он снят.
3. Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Добавить из файла».
4. Выберите .epf, подтвердите предупреждение безопасности.
5. Запишите элемент и проверьте, что в нём заданы разделы размещения.

Для расширения:

1. Откройте Администрирование → Печатные формы, отчеты и обработки → Расширения.
2. Нажмите «Добавить из файла» и выберите .cfe.
3. Проверьте, что расширение активно, и перезапустите 1С.

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

Шаг 3. Авторизуйтесь в Диадоке

При первом запуске модуль попросит войти. Варианты:

• по сертификату — выбирайте КЭП, привязанную к ящику;
• по логину и паролю от Диадока, если вход по паролю у вас разрешён.

После входа модуль покажет ящики, доступные пользователю. Выберите тот, который соответствует организации в 1С.

Шаг 4. Свяжите организацию 1С с ящиком

Модуль сравнивает ИНН и КПП. Если в базе несколько организаций, сопоставьте каждую со своим ящиком. Ошибка на этом шаге даёт неприятный эффект: документы одной фирмы уходят из ящика другой.

Работа в модуле: контрагенты, номенклатура, входящие

Установить модуль — полдела. Чтобы обмен шёл без ручной правки, нужно настроить три вещи.

Контрагенты и приглашения

Отправлять документы можно только тем, с кем есть связь в Диадоке. Модуль ищет контрагента по ИНН и КПП из карточки в 1С.

• ✅ Контрагент найден и связь установлена — можно отправлять.
• 📨 Контрагент есть в Диадоке, но связи нет — отправьте приглашение и дождитесь, пока его примут.
• 🔁 Контрагент у другого оператора — нужен роуминг, его настраивают через Контур.
• ❓ Не найден совсем — проверьте ИНН и КПП в карточке: лишний пробел или старый КПП после переезда ломает поиск.

Отправка исходящих

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

Загрузка входящих и сопоставление номенклатуры

Входящий УПД модуль может превратить в документ поступления. Для этого строки поставщика надо связать с вашей номенклатурой.

1. Откройте входящий документ в модуле.
2. Для каждой строки выберите позицию номенклатуры из справочника 1С.
3. Модуль запомнит соответствие, и в следующий раз строки этого поставщика встанут сами.

💡 Первую сотню строк от постоянных поставщиков сопоставьте за один подход. Дальше поступления будут создаваться почти без ручной работы.

Что автоматизировать

Ручные действия съедают больше всего времени на входящих. Что можно отдать программе:

• ⏱️ Регулярную загрузку входящих. Настройте получение документов по расписанию, чтобы бухгалтер утром видел готовый список, а не нажимал «Обновить».
• 📑 Пакетную отправку. Выделите в списке реализаций десяток документов и отправьте разом, подписав одним действием.
• 🧾 Автосоздание поступлений. После сопоставления номенклатуры модуль создаёт документ поступления из входящего УПД.
• 🔔 Контроль статусов. Отбор в списке «отправлено, но не подписано контрагентом» вместо обзвона.

В файловой базе расписание срабатывает, только пока открыт хотя бы один сеанс 1С. Если документы нужны к началу рабочего дня, держите базу на сервере или запускайте отдельный сеанс для фоновых задач.

Встроенный ЭДО 1С и роуминг с Диадоком

Типовые конфигурации 1С умеют обмениваться документами без сторонних модулей — через сервис 1С-ЭДО и встроенную библиотеку электронных документов. Настройка находится в Администрирование → Обмен электронными документами.

Как это связано с Диадоком:

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

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

Интеграция Диадок с 1С через API

Прямая интеграция нужна в трёх случаях: нетиповая конфигурация, своя логика маршрутизации документов или поток в тысячи документов в сутки, где важна каждая секунда.

Что потребуется:

• Ключ разработчика API. Его выдаёт Контур по запросу, без него сервер не примет запросы.
• Документация API. Контур публикует её на портале для разработчиков, там же — SDK для C# и Java.
• Работа с криптографией. Подпись документов выполняется на стороне клиента через криптопровайдер. В 1С это делают средствами криптографии платформы (МенеджерКриптографии).

Общая схема обмена:

1. Авторизация: сертификатом или логином и паролем, сервер возвращает токен.
2. Получение списка ящиков организации.
3. Формирование файла документа в формате ФНС, подпись, отправка.
4. Периодический опрос событий: новые входящие, подписи контрагента, отказы.

Каркас HTTP-вызова из 1С выглядит так. Адрес метода и тело берите строго из документации API — здесь только обвязка:

Соединение = Новый HTTPСоединение("diadoc-api.kontur.ru", 443, , , , 60,
    Новый ЗащищенноеСоединениеOpenSSL);

Запрос = Новый HTTPЗапрос(АдресМетода); // путь метода из документации API
Запрос.Заголовки.Вставить("Authorization", ЗаголовокАвторизации);
Запрос.Заголовки.Вставить("Accept", "application/json");

Ответ = Соединение.Получить(Запрос);
Если Ответ.КодСостояния <> 200 Тогда
    ВызватьИсключение СтрШаблон("Диадок вернул код %1: %2",
        Формат(Ответ.КодСостояния, "ЧГ=0"), Ответ.ПолучитьТелоКакСтроку());
КонецЕсли;

⚠️ Не храните ключ разработчика и пароль в коде модуля. Вынесите их в константы или безопасное хранилище с ограниченными правами — иначе их увидит любой, кто откроет конфигуратор.

Своя интеграция требует сопровождения: формат УПД меняется по решению ФНС, и каждое такое изменение придётся вносить самим.

Права доступа, подписи и МЧД

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

В Диадоке

Администратор ящика назначает сотрудникам права:

• 👀 просмотр документов — для тех, кто только сверяет;
• ✍️ подписание — для ответственных лиц;
• 🏢 доступ к подразделениям — если у компании несколько складов или филиалов, сотрудник видит только своё.

В 1С

• Работать с модулем или встроенным ЭДО дают только тем пользователям, кому это нужно.
• Права на установку обработок и расширений — только администратору.
• Подписывать из 1С может только пользователь с установленным на компьютере сертификатом, который допущен к подписи в Диадоке.

Подпись и доверенность

С 1 сентября 2023 года УЦ ФНС выдаёт КЭП юрлица только руководителю. Сотрудник подписывает своей КЭП физлица и прикладывает МЧД. Формат доверенности установлен ФНС, а не оператором, поэтому МЧД, оформленная по правилам, принимается и в Диадоке, и в 1С.

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

Ошибки при подключении Диадок к 1С и что делать

Ниже — симптомы, с которыми чаще всего приходят после установки. Найдите свой.

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

Частые вопросы по интеграции Диадок и 1С