Как отправить документ из 1С в Диадок без стандартного модуля: 3 рабочих способа

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

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

Важно: все описанные методы предполагают, что у вас уже есть зарегистрированный аккаунт в Диадоке и настроены права доступа для API. Если этого нет — сначала пройдите регистрацию на сайте сервиса и получите ClientId и ClientSecret для аутентификации.

1. Подготовка 1С к интеграции с Диадоком

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

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

• 🔹 Откройте конфигуратор 1С:Предприятия и проверьте наличие объекта HTTPСоединение в глобальном контексте. Если его нет — обновите платформу до версии 8.3.10+.
• 🔹 Проверьте, что у пользователя, от имени которого будет выполняться обмен, есть права на чтение документов и запись во временные файлы. Для этого перейдите в Администрирование → Пользователи и настройте роль Полные права или создайте кастомную.
• 🔹 Подготовьте справочники Контрагенты и Договоры — в Диадоке они должны совпадать с данными в 1С. Особое внимание уделите полям ИНН, КПП и Электронная почта.

Если вы планируете использовать внешние обработки, скачайте их заранее. Например, популярные решения можно найти на портале Infostart или в каталоге 1С:ИТС. Обратите внимание на версии обработок — они должны соответствовать вашей конфигурации.

⚠️ Внимание: Если вы работаете с 1С:Бухгалтерией 3.0 или 1С:ERP, проверьте наличие обновлений для объекта ИнтернетПоддержкаФайлов. В старых релизах он может отсутствовать, что блокирует загрузку файлов через HTTP.

2. Способ 1: Отправка через HTTP-запросы к API Диадока

Самый прямой метод — отправка документов через REST API Диадока. Для этого потребуется сформировать запрос с авторизацией, подготовить тело документа в формате XML или JSON, и отправить его на сервер Диадока.

Алгоритм действий:

1. Получите access_token для авторизации. Для этого отправьте POST-запрос на https://diadoc-api.kontur.ru/OAuth/Token с параметрами:

   grant_type=client_credentials
   client_id=ВАШ_ClientId
   client_secret=ВАШ_ClientSecret
   scope=DiadocApi

2. Сформируйте тело документа. Например, для счета-фактуры используйте шаблон:

   <DocumentPacket>
   <Documents>
   <Invoice>
   <Function>СчетФактура</Function>
   <InvoiceDate>2026-05-20</InvoiceDate>
   <InvoiceNumber>123</InvoiceNumber>
   <Seller>
   <Inn>1234567890</Inn>
   <Kpp>123456789</Kpp>
   </Seller>
   </Invoice>
   </Documents>
   </DocumentPacket>

3. Отправьте документ POST-запросом на https://diadoc-api.kontur.ru/V3/GenerateDocumentPacket с заголовком Authorization: Bearer {access_token}.

Пример кода на встроенном языке 1С:

Запрос = Новый HTTPЗапрос("https://diadoc-api.kontur.ru/V3/GenerateDocumentPacket");
Запрос.УстановитьЗаголовок("Authorization", "Bearer " + ТокенДоступа);
Запрос.УстановитьТекст(ТелоДокумента);
Ответ = Новый HTTPСоединение();
Ответ.ОтправитьДляПолученияДанных(Запрос);

⚠️ Внимание: Токен доступа действует ограниченное время (обычно 1 час). Храните его в реквизите сеанса или обновляйте перед каждой отправкой. Не сохраняйте ClientSecret в открытом виде в базе!

3. Способ 2: Использование внешних обработок

Если работа с HTTP-запросами кажется сложной, альтернатива — готовые внешние обработки. Они уже содержат логику обмена с Диадоком и требуют только минимальной настройки.

Популярные обработки:

• 📄 "Диадок: Обмен документами" от 1С-Софт — поддерживает счета-фактуры, УПД, акты.
• 📄 "Интеграция с Диадоком" от Infostart — гибкая настройка шаблонов и логов.
• 📄 "Диадок для 1С:Бухгалтерии 3.0" — специализированное решение для бухгалтерских документов.

Как подключить обработку:

1. Скачайте файл обработки (.epf) и сохраните его на сервере или локальном компьютере.
2. В 1С перейдите в Файл → Открыть и выберите скачанный файл.
3. Заполните параметры подключения:

   Сервер: diadoc-api.kontur.ru
   Порт: 443 (HTTPS)
   ClientId: Ваш идентификатор
   ClientSecret: Ваш секретный ключ

4. Выберите документ для отправки и нажмите Отправить в Диадок.

Внешние обработки часто содержат встроенные механизмы логгирования, что упрощает отладку. Например, в обработке от Infostart все ошибки записываются в регистр сведений ЛогиОбменаДиадок, где можно увидеть детали последней отправки.

⚠️ Внимание: Перед использованием обработки проверьте её совместимость с вашей версией 1С. Некоторые решения требуют доработок для 1С:ERP или 1С:УТ 11.

4. Способ 3: Обмен через промежуточные файлы (XML/JSON)

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

Пошаговая схема:

1. В 1С экспортируйте документ в файл XML или JSON. Например, для счета-фактуры:

   ДокументОбъект.ЗаписатьXML(КаталогВременныхФайлов() + "СчетФактура_123.xml");

2. Создайте bat-файл или PowerShell-скрипт, который будет отправлять файл на сервер Диадока через curl:

   curl -X POST "https://diadoc-api.kontur.ru/V3/GenerateDocumentPacket"
   -H "Authorization: Bearer ТОКЕН"
   -H "Content-Type: application/xml"
   --data-binary "@СчетФактура_123.xml"

3. Настройте планировщик задач Windows или cron в Linux для автоматического запуска скрипта.

Преимущества метода:

• 🔄 Возможность предварительной проверки файлов перед отправкой.
• 🛡️ Более высокий уровень безопасности — данные не передаются напрямую из 1С.
• 📊 Удобно для массовой отправки документов (например, ночью).

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

5. Типичные ошибки и их решение

При интеграции без стандартного модуля часто возникают ошибки. Рассмотрим самые распространённые и способы их устранения.

Другие проблемы:

• 🔴 Документ не появляется в Диадоке: проверьте, что в XML корректно указаны ИНН и КПП получателя. Часто ошибка кроется в несовпадении реквизитов.
• 🔴 Ошибка подписи: если документ требует ЭЦП, убедитесь, что сертификат загружен в 1С и действителен. Для проверки используйте ПроверкаПодписи().
• 🔴 Долгая отправка: если документы "зависают", проверьте лимиты API в личном кабинете Диадока. Возможно, превышен лимит запросов (обычно 1000 в час).

Для отладки используйте логгирование. В 1С можно выводить отладочную информацию в файл:

ЗаписьЖурналаРегистрации("Диадок", УровеньЖурналаРегистрации.Ошибка, , , ОписаниеОшибки());

6. Автоматизация и оптимизация обмена

Чтобы минимизировать ручной труд, настройте автоматическую отправку документов. Для этого:

• 🤖 Создайте регламентное задание в 1С, которое будет запускать процедуру обмена по расписанию (например, каждый час).
• 📊 Используйте механизм событий: при проведении документа автоматически формируйте файл для Диадока. Для этого добавьте обработчик события ПриЗаписи:
• 🔄 Настройте обратную выгрузку: чтобы статусы документов из Диадока автоматически обновлялись в 1С, используйте вебхуки или периодический опрос API.

Пример кода для регламентного задания:

Процедура ОтправитьДокументыВДиадок() Экспорт
Документы = Документы.СчетФактураВыданный.НайтиПоРеквизиту("СтатусДиадок", "НеОтправлен");
Для Каждого Док Из Документы Цикл
Попытка
ОтправитьДокументВДиадок(Док);
Док.СтатусДиадок = "Отправлен";
Док.Записать();
Исключение
ЗаписьЖурналаРегистрации("Диадок", УровеньЖурналаРегистрации.Ошибка, , , ОписаниеОшибки());
КонецПопытки;
КонецЦикла;
КонецПроцедуры

Для крупных компаний рекомендуется использовать промежуточную базу данных (например, PostgreSQL), куда 1С будет складывать документы для отправки, а внешний сервис — забирать их и передавать в Диадок. Это снижает нагрузку на 1С и повышает надёжность.

⚠️ Внимание: При автоматической отправке настройте уведомления об ошибках. Например, отправляйте письмо администратору, если документ не удалось отправить с трёх попыток.

7. Безопасность и контроль доступа

При интеграции без стандартного модуля особое внимание уделите безопасности:

• 🔐 Храните ClientSecret в зашифрованном виде. В 1С для этого используйте объект ЗащищенноеХранилище или внешние системы типа Hashicorp Vault.
• 🛡️ Ограничьте права пользователя, от имени которого выполняется обмен. Он должен иметь доступ только к необходимым документам и справочникам.
• 📜 Ведите журнал операций. Фиксируйте дату, время, тип документа и результат отправки. Это поможет при аудите или разборе инцидентов.

Пример шифрования ClientSecret:

ЗащищенноеХранилище = Новый ЗащищенноеХранилище();
ЗащищенноеХранилище.Установить("Diadoc_ClientSecret", "ВашСекретныйКлюч");
...
Секрет = ЗащищенноеХранилище.Получить("Diadoc_ClientSecret");

Если обмен идёт через промежуточные файлы, настройте контроль целостности:

• 🔒 Используйте хэш-суммы (MD5 или SHA-1) для проверки, что файл не был изменён при передаче.
• 📋 Создавайте лог-файлы с подписью, где будет указано, кто и когда отправил документ.

Для дополнительной защиты можно использовать VPN или прокси-сервер, чтобы трафик между 1С и Диадоком шёл по защищённому каналу.

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

<DocumentPacket>
<Documents>
<Invoice>...</Invoice>
<UniversalTransferDocument>...</UniversalTransferDocument>
</Documents>
</DocumentPacket>