Для AI-агентов: markdown этой страницы — /docs-content/onec/connect.md индекс документации — /llms.txt

Подключение 1С к Битрикс24

1С подключается к Битрикс24 один раз: администратор устанавливает модуль, подключает базу и выдаёт сотрудникам доступ. После этого сотрудники задают вопросы по данным 1С в чате Коворка — настольного приложения Битрикс24. Приложения и скрипты получают те же данные через API.

Коворк и API только читают данные 1С и ничего не меняют в базе. Запросы выполняются от имени пользователя 1С, назначенного сотруднику, поэтому сотрудник видит только то, что этому пользователю разрешено в 1С. Описание API — в разделе Интеграция 1С.

Кто что делает

Кто Что делает
Администратор Битрикс24 Устанавливает модуль интеграции в 1С, выпускает ключ подключения, подключает базу и выдаёт доступ сотрудникам и отделам
Сотрудник Работает с данными 1С в Коворке или через свои приложения. Если доступа нет, отправляет просьбу администратору

Где настраивается подключение

Подключение настраивается в двух местах — в Коворке и в кабинете Вайбкод. Изменения в одном месте видны в другом.

  • В Коворке — в правой колонке есть карточка «Интеграция с 1С». Кнопка «Подключить 1С» на ней открывает окно настройки. Это же окно открывается из «Настроек», пункт «Интеграция с 1С».
  • В кабинете Вайбкод — раздел «Интеграция 1С» в разделе администрирования.

Оба места доступны только администратору Битрикс24. Если платформа ещё не включила интеграцию с 1С для вашего Битрикс24, раздела в кабинете нет, а карточка в Коворке сообщает об этом. После включения обновлять Коворк не нужно.

Шаг 1. Установите модуль интеграции в 1С

Модуль не меняет конфигурацию 1С. Установить его можно через обработку или через конфигуратор — порядок описан в статье Как установить модуль интеграции 1С. Публикация HTTP-сервисов из той же статьи нужна только для режима HTTP — см. шаг 3.

Шаг 2. Выпустите ключ подключения

  1. Откройте окно «Интеграция с 1С» в Коворке или раздел «Интеграция 1С» в кабинете.
  2. Нажмите «Выпустить ключ».
  3. Скопируйте строку подключения.

Строка подключения показывается один раз. Если вы её не сохранили, перевыпустите ключ — см. Перевыпуск ключа и отключение.

Шаг 3. Создайте подключение в 1С

  1. В 1С откройте раздел «Битрикс24», в группе «Интеграция VibeCode» выберите «Настройки» и нажмите «Создать».
  2. В поле «Наименование» укажите название базы — под этим названием база будет видна в Битрикс24.
  3. В блоке «Подключение» выберите режим — Push-Pull или HTTP — и нажмите «Подключить». Что вводить дальше, зависит от режима.

Push-Pull. 1С сама обращается к платформе за запросами. Публиковать базу в интернете не нужно: внешний адрес, проброс портов и постоянный IP-адрес не требуются. После нажатия «Подключить» 1С откроет окно — вставьте в него строку подключения из шага 2 целиком. Новые запросы 1С проверяет регламентным заданием обмена. Задание работает по расписанию, поэтому ответ может прийти через одну-две минуты. Если после подключения в окне видна надпись «Нет обмена», проверьте, что регламентное задание обмена запущено и в нём указан текущий ключ.

HTTP. Платформа сама обращается к базе через HTTP-сервис. Режим подходит, если база уже опубликована на веб-сервере. Заполните поля «Адрес 1С публикации» и «Пользователь 1С». После нажатия «Подключить» введите пароль этого пользователя и строку подключения из шага 2. Через строку подключения модуль передаёт платформе адрес публикации, имя пользователя и пароль.

Когда 1С подключится, в окне подключения появится надпись «1С на связи».

Шаг 4. Пройдите шаги «Что дальше»

Остальные шаги настройки собраны в окне подключения, в блоке «Что дальше». Шаги выполняются по порядку и становятся доступны, когда 1С на связи.

  1. Подключить 1С — шаги 1–3 выше.
  2. Загрузить пользователей 1С — Битрикс24 получает из 1С список пользователей, которым затем назначают сотрудников.
  3. Выдать доступ сотрудникам — см. раздел ниже.
  4. Загрузить каталог команд — каталог показывает, какие данные Коворк и приложения смогут получать из этой базы 1С.

Списки загружаются в фоне — в это время можно продолжать работу. Когда все шаги выполнены, блок исчезает.

Выдача доступа сотрудникам

Доступ выдаётся в блоке «Пользователи 1С». Каждому пользователю 1С назначаются сотрудники Битрикс24, и их запросы к 1С выполняются от имени этого пользователя. Вид блока зависит от того, включены ли на вашем Битрикс24 назначения по отделам.

С назначениями по отделам. Нажмите на пользователя 1С — откроется окно «Доступ к аккаунту». В нём выбирают отделы целиком и отдельных сотрудников. Правила назначения:

  • Отдел включает все свои подразделения.
  • Личное назначение сотрудника имеет приоритет над назначением через отдел.
  • Если сотрудник состоит в двух отделах, назначенных разным пользователям 1С, доступ у него блокируется. Снять конфликт можно личным назначением.

Перед сохранением нажмите «Проверить доступ» — окно покажет, что изменится для каждого затронутого сотрудника. Если сотрудник уже назначен другому пользователю 1С, перенос нужно подтвердить отдельно. Сохранить изменения можно только после проверки. Действовать они начинают после сохранения.

Без назначений по отделам. Каждому пользователю 1С можно назначить одного сотрудника — кнопкой «Выбрать сотрудника». Изменения вступают в силу после нажатия «Сохранить». Если назначение снять или передать другому сотруднику, незавершённые запросы прежнего сотрудника к 1С отменяются.

Назначения ведутся отдельно для каждой базы 1С: доступ к одной базе не открывает другую.

Несколько баз 1С

К одному Битрикс24 можно подключить несколько баз 1С — кнопкой «Добавить базу». У каждой базы свой ключ подключения, свои пользователи 1С, свой каталог команд и свои назначения.

В списке баз видны название и статус каждой:

Статус Что означает
Ожидает настройки Ключ выпущен, но 1С ещё не подключилась или не передала свои настройки
В сети 1С на связи
Не в сети 1С не отвечает. Проверьте, что 1С и модуль интеграции запущены на сервере. Когда связь восстановится, статус обновится автоматически
Нет обмена 1С на связи, но не забирает запросы или обращается со старым ключом

Нужные базы можно закрепить — они будут показываться первыми. В «Технических сведениях» выбранной базы есть «Сведения о 1С»: конфигурация и её версия, версия платформы 1С, версия модуля и тип базы.

Если сотруднику доступно несколько баз, нужную он называет в вопросе. Если не назовёт, Коворк переспросит. Приложения выбирают базу параметром instanceId — см. Список баз 1С портала.

Перевыпуск ключа и отключение

Обе команды находятся в меню действий рядом со статусом подключения.

  • «Перевыпустить ключ» — старый ключ сразу перестаёт работать, настройки модуля сбрасываются, незавершённые запросы отменяются. Вставьте новую строку подключения в модуль и снова нажмите «Подключить». Идентификатор базы при этом не меняется.
  • «Отключить» — ключ отзывается, настройки модуля удаляются, незавершённые запросы отменяются. Чтобы снова подключить базу, понадобится новый ключ.

Что видит сотрудник в Коворке

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

Если доступа нет, нажмите на карточку — откроется окно «Доступ к 1С»:

  1. Нажмите «Скопировать просьбу» и отправьте текст администратору Битрикс24 в чат или письмом. В просьбе уже указаны ваш Битрикс24, ваше имя и где администратору выдать доступ.
  2. Когда администратор ответит, нажмите «Проверить ещё раз».

Доступ из своих приложений и скриптов

Приложения, скрипты и AI-агенты, например Claude или Cursor, получают данные 1С через API интеграции 1С. Для этого нужен личный ключ vibe_api_… с правом «Интеграция 1С» — vibe:onec. Право доступно при выпуске ключа, если администратор уже выдал вам доступ к 1С. Запросы выполняются от имени того же пользователя 1С, что и в Коворке.

Смотрите также