Как подключить это в 1С: разбираем все типовые сценарии

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

Общий принцип один: сначала определите, что именно вы подключаете и в каком режиме работает ваша 1С — файловом или клиент-серверном, тонкий клиент или веб-клиент. От этого зависят и инструменты, и ограничения. Например, внешняя обработка через «Файл → Открыть» доступна почти везде, а веб-сервис на файловой базе публикуется иначе, чем на серверной.

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

Определите, что именно нужно подключить

Прежде чем искать инструкцию, классифицируйте объект. В экосистеме 1С подключаемые элементы делятся на несколько групп: внешние обработки и отчеты (файлы .epf и .erf), внешние печатные формы, расширения конфигурации (.cfe), внешние компоненты (.dll по технологии Native API или COM), подключаемое оборудование (сканеры, ККТ, терминалы) и внешние источники данных (веб-сервисы, базы SQL, HTTP-API).

Узнать тип несложно по расширению файла и по контексту задачи. Если вам прислали файл с просьбой «подключить эту печатную форму» — это внешняя обработка. Если задача звучит как «подключить сканер» — речь о драйвере оборудования. Если нужно «чтобы 1С забирала заказы с сайта» — это интеграция через веб-сервис или HTTP-запросы.

Подключение внешней обработки или отчета

Самый простой способ — открыть файл напрямую: меню «Файл → Открыть» (или Ctrl+O) и выбрать .epf-файл. Обработка запустится в текущем сеансе. Этот вариант подходит для разовых задач: загрузки данных, тестирования, разовой выгрузки. Минус очевиден — при следующем входе в базу обработку придется открывать заново, и другие пользователи ее не увидят.

Для постоянного использования обработку регистрируют в справочнике «Дополнительные отчеты и обработки». Путь в типовых конфигурациях на БСП: «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». Предварительно включите сам механизм — в том же разделе установите флажок «Дополнительные отчеты и обработки».

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

Если при добавлении файла появляется сообщение «Невозможно подключить дополнительный отчет из файла», причина обычно в том, что обработка не содержит функции СведенияОВнешнейОбработке() — она написана без учета требований БСП. Такую обработку можно открывать только вручную через «Файл → Открыть» либо доработать, добавив нужную экспортную функцию в модуль объекта.

Безопасный режим

Дополнительные обработки по умолчанию выполняются в безопасном режиме: им запрещены операции с файловой системой, COM-объектами и внешними компонентами. Если обработка должна, например, сохранять файлы на диск, безопасный режим придется отключить для конкретного элемента — но делайте это только для обработок из доверенных источников.

Подключение расширения конфигурации

Расширение — это способ добавить или изменить функциональность конфигурации, не снимая ее с поддержки. Файл расширения (.cfe) подключается через меню «Все функции → Стандартные → Расширения конфигурации» (в режиме предприятия) либо через конфигуратор: «Конфигурация → Расширения конфигурации». Нажмите «Добавить», укажите файл, задайте имя и снимите флажок «Безопасный режим» только при необходимости.

После добавления расширение требует перезапуска сеанса — пользователи увидят изменения только после повторного входа. В клиент-серверном варианте учтите, что расширение применяется ко всей базе, а не к отдельному пользователю. Если расширение конфликтует с конфигурацией (например, заимствует объект, который был переименован при обновлении), оно будет отключено с сообщением об ошибке — проверяйте применимость после каждого обновления конфигурации.

Подключение торгового оборудования

Сканеры штрихкодов, ККТ, терминалы сбора данных и эквайринговые терминалы подключаются через механизм «Подключаемое оборудование» (в типовых конфигурациях: «Администрирование → Подключаемое оборудование» или аналогичный раздел). Общая схема: установить драйвер производителя или драйвер из поставки 1С, добавить устройство в справочник, выбрать тип оборудования и драйвер, настроить параметры (COM-порт, скорость, IP-адрес) и выполнить «Тест устройства».

Для сканеров штрихкодов есть два режима: эмуляция клавиатуры (сканер «печатает» код как с клавиатуры — настройка в 1С почти не нужна, но требуется фокус в нужном поле) и режим COM-порта или эмуляции COM через USB (сканер работает как полноценное устройство с событием в 1С). Для рабочих мест кассира предпочтителен второй вариант — он не зависит от того, где стоит курсор.

Для фискальных регистраторов и ККТ обязательно проверьте соответствие версии драйвера требованиям конфигурации и формату фискальных данных, с которым работает ваша касса. Несовместимость драйвера — самая частая причина ситуации «касса подключена, но чек не печатается».

Контрольные точки

Как проверить подключение оборудования

Тест устройства в настройках драйвера

Норма

Драйвер сообщает об успешном подключении и видит устройство

Тревожный признак

Ошибка «устройство не найдено» — проверяйте порт, кабель и права

Работа в реальном документе

Норма

Сканирование добавляет товар в чек, касса печатает чек

Тревожный признак

Устройство работает в тесте, но не в документе — проверьте привязку к рабочему месту

Привязка к рабочему месту

Норма

Устройство назначено текущему рабочему месту пользователя

Тревожный признак

Устройство привязано к другому компьютеру или не привязано вовсе

Подключение внешних компонент и интеграций

Внешние компоненты (библиотеки .dll, написанные по технологии Native API или COM) используются для задач, которые нельзя решить встроенным языком: работа с криптографией, специфическое оборудование, генерация штрихкодов. В конфигурациях на БСП компоненты подключаются программно методом ПодключитьВнешнююКомпоненту() с указанием макета, в котором хранится архив компоненты. Для ручного подключения COM-компоненты в файловой базе достаточно зарегистрировать библиотеку в системе (regsvr32) и создать COM-объект в коде.

Интеграции с внешними системами — сайтом, CRM, банком — обычно строятся на HTTP-запросах или веб-сервисах. Для публикации веб-сервиса 1С на серверной базе нужен веб-сервер (IIS или Apache), файл публикации и настройка прав доступа. Для исходящих вызовов из 1С используется объект HTTPСоединение — никакого «подключения» в интерфейсе здесь нет, вся логика реализуется в коде или в готовых модулях обмена.

Маршрут решения

Как выбрать способ интеграции

Нужно, чтобы внешняя система вызывала 1СПубликуйте веб-сервис или HTTP-сервис 1С через веб-сервер

Нужно, чтобы 1С запрашивала данные у внешней системыИспользуйте HTTPСоединение в коде или готовый модуль обмена

Нужен обмен файлами без программированияНастройте обмен через каталог или универсальный обмен данными XML

Нужен доступ к данным другой базы 1СРассмотрите COM-соединение или веб-сервисы между базами

Типичные ошибки и как их избежать

Большинство проблем при подключении связано не с самим механизмом, а с окружением: недостатком прав, несовместимостью версий, безопасным режимом. Пользователь без прав администратора не зарегистрирует дополнительную обработку, а обработка в безопасном режиме не сможет записать файл на диск. Перед диагностикой «не работает» проверьте: есть ли у пользователя нужные роли, не включен ли безопасный режим, совместима ли версия объекта с версией платформы.

Отдельно отметим разрядность: если клиент 1С 64-разрядный, а драйвер оборудования или COM-компонента скомпилированы только под 32 бита, подключение завершится ошибкой «Класс не зарегистрирован». Решение — использовать 32-битный клиент, искать 64-битную версию драйвера или подключать компоненту на стороне сервера, если он 32-битный.

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

Почему внешняя обработка открывается через «Файл → Открыть», но не добавляется в справочник дополнительных обработок?

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

Можно ли подключить расширение только для одного пользователя?

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

Сканер штрихкодов «печатает» код, но товар в чек не добавляется. Что не так?

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

Нужна ли резервная копия перед подключением внешней обработки?

Если обработка только читает данные и формирует отчет — риск минимален, достаточно проверить источник файла. Если обработка изменяет данные (групповая обработка документов, загрузка, исправление движений), резервная копия обязательна: отменить пакетное изменение данных штатными средствами часто невозможно.

После обновления конфигурации расширение перестало работать. Что делать?

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