Администрирование · 11 мин
Как подключить Астрал к 1С
Как подключить Астрал к 1С: выбор модуля, установка внешней обработки, настройка сертификата и учётных данных, проверка обмена и решение типичных ошибок.
Подключение Астрала к 1С обычно означает одну из двух задач: интеграцию сервиса электронного документооборота (Астрал-ЭДО) с учётной системой или настройку сдачи отчётности через «Астрал Отчёт» прямо из программы 1С. В обоих случаях принцип одинаков: в 1С устанавливается модуль или внешняя обработка оператора, указываются учётные данные личного кабинета и сертификат электронной подписи, после чего документы начинают уходить и приходить без выгрузки файлов вручную.
Точный порядок действий зависит от конфигурации 1С: в типовых решениях на базе БСП (Бухгалтерия предприятия, Управление торговлей, ERP) часть механизмов ЭДО уже встроена, и модуль Астрала лишь дополняет их транспортом. В старых или самописных конфигурациях интеграция выполняется через внешнюю обработку, которую предоставляет оператор. Ниже разобраны оба сценария, подготовка, типовые ошибки и способы проверить, что обмен действительно работает.
Что понадобится перед началом подключения
До установки модуля проверьте три обязательных условия. Первое — оформленный договор с оператором (Калуга Астрал) и активный личный кабинет в Астрал-ЭДО или Астрал Отчёте: без учётной записи модулю не с чем синхронизироваться. Второе — действующий сертификат квалифицированной электронной подписи на руководителя или уполномоченного сотрудника, установленный на рабочем месте, где работает 1С. Третье — доступ в интернет с компьютера или сервера 1С, поскольку обмен идёт через серверы оператора.
Дополнительно уточните версию вашей конфигурации и платформы 1С. Модули интеграции выпускаются под конкретные версии, и обработка для Бухгалтерии 3.0 может не заработать в самописной конфигурации или устаревшем релизе. Если 1С работает в клиент-серверном режиме, заранее договоритесь с администратором: установка расширений и внешних обработок в таком режиме требует прав администратора кластера.
Войдите в веб-кабинет Астрала и убедитесь, что тариф не заблокирован
Откройте КриптоПро или хранилище сертификатов и проверьте срок действия
Уточните у оператора версию модуля под ваш релиз конфигурации
Проверьте, что файрвол не блокирует исходящие соединения 1С
Выбор способа интеграции: встроенный ЭДО или внешний модуль
В типовых конфигурациях на библиотеке стандартных подсистем есть штатная подсистема «Обмен электронными документами». Она поддерживает работу через операторов ЭДО, и для Астрала может потребоваться только настроить учётную запись обмена, указав оператора и данные сертификата. Это самый чистый вариант: документы создаются, подписываются и отправляются штатными механизмами, а обновления конфигурации не ломают интеграцию.
Если штатной связки с Астралом в вашей версии нет, используется модуль интеграции оператора — внешняя обработка (.epf) или расширение конфигурации (.cfe). Обработка добавляет в интерфейс свои команды отправки и загрузки документов, а также фоновое задание синхронизации. Такой вариант гибче, но требует ручного обновления модуля при смене релиза 1С.
Сравнение вариантов подключения
Подходит для типовых БП, УТ, ERP свежих релизов; не требует внешних файлов, но зависит от поддержки оператора в конкретной версии
Подходит для старых и нетиповых конфигураций; быстрый старт, но обновлять модуль нужно вручную
Подходит, когда нужны дополнительные кнопки и формы без снятия конфигурации с поддержки; требует проверки совместимости при обновлениях
Установка модуля Астрал в 1С
Загрузите актуальную версию модуля из личного кабинета оператора или получите её у менеджера — сторонние источники использовать не стоит, поскольку обработка получит доступ к подписанию документов вашей подписью. Перед установкой сделайте резервную копию информационной базы: даже безопасная на вид обработка может конфликтовать с доработками конфигурации.
Для внешней обработки порядок такой: откройте 1С в режиме предприятия, перейдите в «Файл → Открыть» и укажите файл модуля, либо подключите его через «Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки», предварительно включив сам механизм дополнительных обработок. Для расширения используйте «Настройки → Расширения конфигурации», добавьте файл .cfe и перезапустите сеанс. Если конфигурация находится на поддержке, расширение предпочтительнее — оно не нарушает режим поддержки.
Настройка учётной записи и сертификата
После установки откройте настройки модуля и укажите параметры подключения: логин и пароль личного кабинета Астрал-ЭДО либо API-ключ, если оператор выдал его для интеграции. Затем выберите сертификат электронной подписи из установленных в системе — модуль обычно показывает список доступных сертификатов с указанием владельца и срока действия. Убедитесь, что выбран сертификат именно той организации, которая указана в договоре с оператором.
Если в 1С работают несколько организаций, настройте отдельную учётную запись обмена для каждой: у каждой компании свой сертификат и свой идентификатор участника ЭДО. Смешивание учётных записей — частая причина ситуации, когда документы одной организации уходят с подписью другой, что делает их юридически недействительными.
- 1Проверьте договор, личный кабинет и срок действия сертификата ЭП
- 2Сделайте резервную копию информационной базы
- 3Скачайте модуль интеграции из личного кабинета оператора
- 4Подключите модуль как внешнюю обработку или расширение
- 5Укажите учётные данные и выберите сертификат в настройках
- 6Настройте расписание автоматической синхронизации
- 7Отправьте тестовый документ и проверьте его статус в личном кабинете
Проверка работы обмена
Не ограничивайтесь сообщением «подключение успешно» — выполните сквозную проверку. Создайте тестовый счёт-фактуру или акт на контрагента, с которым уже настроен обмен, подпишите и отправьте. Документ должен пройти цепочку статусов: «подписан», «отправлен», «доставлен», затем дождаться входящего ответа контрагента. Параллельно проверьте, что тот же документ виден в веб-кабинете Астрала — это подтверждает, что синхронизация идёт в обе стороны.
Проверьте и обратное направление: попросите контрагента отправить вам документ и убедитесь, что он появился в списке входящих в 1С, а не только в веб-кабинете. Если входящие не приходят, чаще всего не настроено или не запущено регламентное задание синхронизации — проверьте его расписание и журнал выполнения.
Как проверить результат
Дошёл до статуса «доставлен» или «завершён»
Завис на «отправке» или появилась ошибка транспорта
Документ есть и в 1С, и в кабинете Астрала
Документ существует только в одной из систем
Новые документы появляются в 1С по расписанию
Входящие видны только в веб-кабинете
Подпись накладывается без запроса внешних программ
Ошибка «сертификат не найден» или запрос PIN-кода вне 1С
Типичные ошибки и их устранение
Самая распространённая проблема — ошибка доступа к сертификату: модуль «не видит» подпись, хотя она установлена. Причины обычно в том, что сертификат установлен в хранилище другого пользователя Windows, истёк его срок или на сервере 1С (при клиент-серверном режиме) не установлен криптопровайдер. Проверьте, что сертификат доступен именно той учётной записи, под которой выполняется обмен.
Вторая группа ошибок — сетевые: «не удалось соединиться с сервером», таймауты синхронизации. Здесь проверяйте файрвол, прокси и антивирус, которые могут блокировать обращения 1С к серверам оператора. Третья группа — рассинхронизация статусов после обновления конфигурации: модуль старой версии перестаёт корректно обрабатывать ответы сервиса. Лечится установкой актуальной версии модуля.
Ограничения и когда привлекать специалиста
Самостоятельное подключение оправдано для типовой конфигурации, одной организации и стандартного сценария обмена. Если база сильно доработана, документооборот нестандартный (например, нужны произвольные форматы документов или маршруты согласования), а обмен должен работать на сервере в фоновом режиме — привлеките специалиста по 1С. Ошибка в настройке транспорта ЭДО может привести к тому, что юридически значимые документы не будут доставлены, а компания пропустит сроки ответа на требования или счета-фактуры.
Отдельно учитывайте лицензионные ограничения: часть функций модулей ЭДО доступна только на определённых тарифах оператора, а отправка отчётности в контролирующие органы требует, чтобы сертификат был зарегистрирован в соответствующем ведомстве. Эти условия уточняйте в договоре и тарифном плане до начала настройки.
Что важно запомнить
Подключение Астрала к 1С сводится к четырём шагам: проверка договора и сертификата, установка совместимого модуля, настройка учётной записи и обязательный тестовый обмен в обе стороны. Резервная копия перед установкой и актуальная версия модуля после каждого обновления 1С — два условия, которые чаще всего игнорируют и из-за которых обмен ломается.
Частые вопросы
Можно ли подключить Астрал к 1С без изменения конфигурации?
Да. Внешняя обработка и расширение конфигурации подключаются без снятия с поддержки и без изменения типовых объектов. Это рекомендуемые способы: они сохраняют возможность штатного обновления 1С.
Модуль не видит сертификат электронной подписи, что делать?
Проверьте, что сертификат установлен в хранилище того пользователя Windows, под которым работает 1С или серверный процесс, что срок его действия не истёк и что на компьютере установлен криптопровайдер, с которым выдавался сертификат. После установки сертификата перезапустите сеанс 1С.
Документы отправляются, но входящие не приходят в 1С. В чём причина?
Чаще всего не запущено регламентное задание синхронизации модуля или в его расписании слишком редкий интервал. Проверьте расписание, журнал выполнения задания и заодно убедитесь, что в личном кабинете Астрала входящие документы вообще есть.
Нужно ли обновлять модуль Астрала после обновления 1С?
Да, желательно проверять совместимость после каждого значимого обновления конфигурации. Модуль, написанный под старый релиз, может перестать корректно обрабатывать статусы или форматы документов. Актуальную версию берите в личном кабинете оператора.
Можно ли работать с несколькими организациями через один модуль?
Можно, но для каждой организации настраивается отдельная учётная запись обмена со своим сертификатом и идентификатором участника ЭДО. Использовать один сертификат на все компании нельзя — подписанные так документы не будут иметь юридической силы для чужой организации.
Чем подключение Астрал-ЭДО отличается от подключения Астрал Отчёта?
Астрал-ЭДО — это обмен документами с контрагентами, а Астрал Отчёт — сдача отчётности в ФНС, ПФР и другие ведомства. Это разные сервисы с разными модулями и договорами, хотя учётная запись оператора может быть общей. Подключать их в 1С нужно по отдельности.