Как загрузить документ из Контур.Диадок в 1С

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

Наиболее распространённый вариант — модуль «Контур.ЭДО» для 1С, который устанавливается как расширение или внешняя обработка и напрямую связывается с вашим ящиком Диадока. Для типовых конфигураций «1С:Бухгалтерия 8», «Управление торговлей», «ERP» и «Комплексная автоматизация» также доступен штатный механизм обмена электронными документами (подсистема БЭД), который может работать с оператором Контур через роуминг.

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

Подготовка: что нужно проверить перед настройкой

Первое условие — совместимость конфигурации. Модуль Контур.ЭДО поддерживает основные типовые конфигурации на управляемых формах (Бухгалтерия 3.0, УТ 11, ERP 2, КА 2). Если у вас старая конфигурация на обычных формах или сильно доработанная система, модуль может не встать — тогда рассматривайте внешнюю обработку или API.

Второе условие — сертификат электронной подписи должен быть установлен на компьютере пользователя и доступен в 1С. Проверьте, что в разделе администрирования «Обмен электронными документами» сертификат виден и проходит проверку. Для серверной работы (когда подписание выполняется на сервере 1С) потребуется настройка криптопровайдера на сервере.

Третье — учётные данные Диадока. Понадобится логин и пароль от личного кабинета Контур.Диадок либо API-ключ, если планируется интеграция через API. Убедитесь, что у пользователя есть доступ к нужному ящику организации, а не только к личному кабинету.

Способ 1. Модуль «Контур.ЭДО» для 1С

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

Порядок установки: скачайте актуальную версию модуля из личного кабинета Контур.Диадок (раздел «Интеграция» или «Модули для 1С»), затем в 1С откройте «Администрирование» → «Печатные формы, отчёты и обработки» → «Расширения» и добавьте файл расширения, либо подключите его как внешнюю обработку — это зависит от формата поставки вашей версии модуля. После подключения перезапустите сеанс 1С.

Далее выполните первичную настройку: укажите логин и пароль от Диадока, выберите организацию и ящик, настройте соответствие типов документов (какой тип документа Диадока в какой документ 1С преобразуется). Обычно настраивается автоматическое создание «Поступления товаров и услуг» из УПД или акта и счёта-фактуры из электронного счёта-фактуры.

1. 1
   Установите модуль как расширение или внешнюю обработку и перезапустите 1С
2. 2
   Введите логин и пароль Диадока, выберите организацию и ящик
3. 3
   Выполните синхронизацию — модуль загрузит список входящих документов
4. 4
   Откройте нужный документ и нажмите «Создать документ в 1С»
5. 5
   Проверьте сопоставление контрагента, номенклатуры и договора
6. 6
   Проведите созданный документ и при необходимости подпишите титул покупателя

Способ 2. Типовой обмен ЭДО в 1С с роумингом

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

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

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

Способ 3. Ручная загрузка файлов из Диадока

Для разовых задач документ можно выгрузить из веб-версии Диадока вручную и загрузить в 1С. В карточке документа в Диадоке доступно скачивание файла документа (XML) и печатной формы (PDF). Именно XML-файл формализованного документа (УПД, счёт-фактура, акт в формате ФНС) можно загрузить в 1С.

В типовой «1С:Бухгалтерии 8» для этого откройте раздел «Покупки» → «Поступления (акты, накладные, УПД)», создайте новый документ и используйте кнопку «Загрузить из файла» (в некоторых версиях — «Ещё» → «Загрузить из XML»). Программа распознает структуру XML, подставит контрагента, суммы и табличную часть. После загрузки обязательно сверьте номенклатуру: чужие коды товаров автоматически не совпадут с вашими карточками.

Учтите: PDF-файл в 1С как учётный документ не загружается — это только визуальное представление. Для автоматического распознавания нужен именно XML установленного формата. Неформализованные документы (сканы, свободные формы) придётся вводить вручную, используя PDF как источник данных.

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

Для нетиповых конфигураций, самописных учётных систем или сложных сценариев (массовая загрузка, своя логика согласования) используется HTTP API Диадока. Интеграция строится на запросах к методам API: получение списка событий ящика, скачивание документов, формирование титулов и подписание.

Типовая схема: 1С периодически (по регламентному заданию) запрашивает новые события через метод GetNewEvents, по каждому входящему документу вызывает GetDocument и GetEntityContent для получения содержимого, затем создаёт учётный документ и сохраняет связь по идентификатору документа в Диадоке (DocumentId). Для аутентификации используется логин/пароль или API-ключ разработчика.

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

POST https://diadoc-api.kontur.ru/V3/Authenticate  (логин и пароль -> токен)
GET  https://diadoc-api.kontur.ru/V2/GetNewEvents?boxId=<ID_ящика>
GET  https://diadoc-api.kontur.ru/V3/GetDocument?boxId=<ID>&messageId=<ID>&entityId=<ID>

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

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

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

Проверка результата и автоматизация обмена

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

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

Частые вопросы