Подключение КЭДО к 1С: полная инструкция с примерами настроек

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

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

⚠️ Важно: Процесс подключения зависит от версии КЭДО (2.0 или 3.0) и типа лицензии вашей 1С. Уточните эти данные перед началом работ — некоторые настройки (например, адреса серверов или форматы запросов) могут отличаться.

1. Подготовка к подключению: регистрация в КЭДО и требования к 1С

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

Требования к 1С:Предприятие:

• 🔹 Версия платформы не ниже 8.3.18 (для полноценной работы с REST API).
• 🔹 Наличие модуля "Обмен данными с КЭДО" (входит в стандартные поставки 1С:Бухгалтерии 3.0 и 1С:ERP, для других конфигураций может потребоваться доработка).
• 🔹 Подключение к интернету (обмен идёт через HTTPS).
• 🔹 Наличие сертификата ЭП (для подписи документов).

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

2. Настройка обмена в 1С: шаг за шагом

Основной обмен данными между 1С и КЭДО осуществляется через HTTP-сервисы или REST API. Рассмотрим оба варианта.

2.1. Настройка через HTTP-сервис (рекомендуемый способ)

Этот метод проще в реализации и поддерживается большинством конфигураций. Инструкция для 1С:Бухгалтерии 3.0:

1. Откройте раздел Администрирование → Обмен данными → Настройки обмена с КЭДО.
2. Укажите адрес сервера КЭДО (например, https://api.kedo.gov.ru/v3 — актуально для версии 3.0).
3. Введите идентификатор организации и токен доступа (выдаются при регистрации).
4. Настройте расписание обмена (рекомендуется ежедневный автоматический обмен в нерабочее время).

Для других конфигураций путь может отличаться. Например, в 1С:ERP настройки находятся в НСИ и администрирование → Интеграции → КЭДО.

Установлена последняя версия платформы 1С|Есть доступ к личному кабинету КЭДО|Получены идентификатор и токен|Сертификат ЭП установлен на компьютере-->

2.2. Настройка через REST API (для опытных пользователей)

Этот способ гибче, но требует знания 1С:Программирования. Пример кода для отправки документа:

Запрос = Новый HTTPЗапрос("https://api.kedo.gov.ru/v3/documents");
Запрос.Заголовки.Добавить("Authorization", "Bearer " + ТокенДоступа);
Запрос.Заголовки.Добавить("Content-Type", "application/json");

ТелоЗапроса = Новый Структура();
ТелоЗапроса.Вставить("documentType", "Invoice");
ТелоЗапроса.Вставить("documentData", База64Строка(ДанныеДокумента));

Ответ = Новый HTTPСоединение().Получить(Запрос);

⚠️ Внимание: При использовании REST API обязательно проверяйте коды ответов сервера (например, 200 — успех, 401 — ошибка авторизации). Логи ошибок сохраняйте для отладки.

3. Настройка обмена документами: какие данные передаются

Система КЭДО поддерживает обмен следующими типами документов:

Тип документа	Направление обмена	Формат	Обязательность ЭП
Счёт на оплату	1С → КЭДО	XML (УПД)	Да
Акт выполненных работ	Двусторонний	XML (УПД)	Да
Договор	1С → КЭДО	PDF + XML	Да
Уведомление о получении	КЭДО → 1С	XML	Нет

Для каждого типа документа в 1С необходимо настроить правила обмена. Это делается в разделе Администрирование → Обмен данными → Правила обмена с КЭДО. Здесь указываются:

• 📌 Соответствие реквизитов (например, поле НомерДокумента в 1С → DocumentNumber в КЭДО).
• 📌 Формат файла (XML, PDF).
• 📌 Требования к подписи (какая ЭП используется — квалифицированная или простая).

Критическая деталь: Если в документе отсутствует обязательный реквизит (например, ИНН контрагента), КЭДО отклонит его с ошибкой VALIDATION_ERROR. Проверяйте заполненность всех полей перед отправкой!

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

Даже при правильной настройке обмена могут возникать ошибки. Рассмотрим самые распространённые:

• ❌ Ошибка 401: Unauthorized — неверный токен или истёк срок его действия. Решение: запросите новый токен в личном кабинете КЭДО.
• ❌ Ошибка 400: Bad Request — некорректный формат данных. Решение: проверьте структуру XML/JSON по документации КЭДО.
• ❌ Ошибка 500: Internal Server Error — проблемы на стороне КЭДО. Решение: повторите запрос позже или обратитесь в поддержку.
• ❌ Документ не подписан — отсутствует ЭП. Решение: проверьте настройки сертификата в Сервис → Настройки ЭП.

Если ошибка повторяется, включите режим отладки в 1С:

ПараметрыСеанса.ОтладкаHTTP = Истина;

Это позволит увидеть полный лог запросов и ответов сервера.

Что делать, если КЭДО не принимает документ?

Чаще всего проблема в несоответствии форматов. Например, КЭДО требует, чтобы дата в документе была в формате YYYY-MM-DD, а 1С отправляет DD.MM.YYYY. В этом случае необходимо доработать правило обмена или использовать обработку для преобразования данных. Также проверьте, не превышен ли лимит по количеству документов в день (это ограничение зависит от тарифа КЭДО).

5. Тестирование обмена: как проверить работу интеграции

После настройки обязательно протестируйте обмен. Для этого:

1. Создайте тестовый документ в 1С (например, счёт на оплату).
2. Отправьте его в КЭДО через раздел Обмен данными → Отправить в КЭДО.
3. Проверьте статус документа в личном кабинете КЭДО (должен быть "Принят" или "В обработке").
4. Запросите уведомление о получении из КЭДО в 1С (должно прийти автоматически, если настройка верна).

Если документ не дошёл или вернулся с ошибкой, проверьте:

• 🔍 Логи обмена в 1С (Администрирование → Обмен данными → Журнал обмена).
• 🔍 Настройки брандмауэра (порт 443 должен быть открыт).
• 🔍 Актуальность сертификата ЭП (просроченные сертификаты блокируются).

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

Чтобы сократить ручную работу, настройте:

• 🤖 Автоматическую отправку документов по расписанию (например, все акты за день отправляются в 18:00).
• 🤖 Автоподпись документов ЭП (если сертификат установлен на сервере 1С).
• 🤖 Уведомления о новых документах из КЭДО (на email или в мессенджер через 1С:Connect).

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

⚠️ Внимание: При автоматическом обмене следите за лимитами КЭДО на количество запросов в минуту. Превышение может привести к временной блокировке доступа.

7. Обновление и поддержка интеграции

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

• 🔄 Обновляйте конфигурацию 1С до последней версии (особенно модули обмена).
• 🔄 Следите за анонсами изменений на портале КЭДО (например, переход с API v2 на v3).
• 🔄 Проверяйте актуальность сертификатов ЭП (срок действия — не менее 6 месяцев).

Если интеграция перестала работать после обновления КЭДО, выполните:

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

Что делать, если КЭДО изменил формат документов?

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

FAQ: Частые вопросы по подключению КЭДО к 1С

Можно ли подключить КЭДО к 1С:УТ 10.3?

Да, но потребуется доработка конфигурации или установка дополнительного расширения. В стандартной поставке 1С:УТ 10.3 нет встроенного модуля для КЭДО. Обратитесь к партнёру 1С для разработки решения.

Как часто нужно обновлять токен доступа в КЭДО?

Срок действия токена зависит от настроек вашей организации в КЭДО. Обычно это 1 год, но может быть и меньше. За месяц до истечения срока система пришлёт уведомление на email администратора.

Что делать, если документ завис в статусе "Ожидает обработки"?

Это может происходить из-за:

• Проблем на стороне КЭДО (повторите запрос позже).
• Некорректных данных в документе (проверьте логи обмена).
• Превышения лимитов (уточните тарифный план).

Если документ не обрабатывается более суток, обратитесь в поддержку КЭДО с указанием ID документа.

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

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

Как настроить обмен, если у нас несколько организаций в 1С?

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

1. Администрирование → Обмен данными → Профили обмена.
2. Укажите уникальные идентификаторы организаций и токены для каждой.
3. Настройте правила маршрутизации (какие документы какой организации принадлежат).