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

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

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

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

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

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

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

- **В Коворке** — в правой колонке есть карточка «Интеграция с 1С». Кнопка «Подключить 1С» на ней открывает окно настройки. Это же окно открывается из «Настроек», пункт «Интеграция с 1С».
- **В кабинете Вайбкод** — раздел [«Интеграция 1С»](/admin/onec) в разделе администрирования.

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

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

Модуль не меняет конфигурацию 1С. Установить его можно через обработку или через конфигуратор — порядок описан в статье [Как установить модуль интеграции 1С](https://helpdesk.bitrix24.ru/open/28789974/). Публикация 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С портала](/docs/onec/instances).

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

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

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

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

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

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

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

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

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

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

- [Интеграция 1С](/docs/onec)
- [Список баз 1С портала](/docs/onec/instances)
- [Каталог инструментов 1С](/docs/onec/tools)
- [Сводка из 1С в чат Битрикс24](/docs/recipes/onec-report-to-chat)
- [Контрагенты из 1С в компании CRM](/docs/recipes/onec-counterparties-to-crm)
- [Ключи и авторизация](/docs/keys-auth)