# 1С

> Справочники и документы 1С через стандартный интерфейс OData.

## Возможности

**Документы**

- Контрагент из 1С: в настройках переменной выберите «Откуда → Внешняя система → 1С» и найдите контрагента. Реквизиты стороны заполнятся из справочника, «Обновить» подтягивает свежие данные.
- Наши организации: реквизиты своей компании из справочника организаций 1С.

**Формы**

- Форма по объекту 1С: «Интерфейсы → форма → Структура → Из чего собираем форму? → 1С». Поля формы строятся из выбранного объекта OData.
- Запись в 1С при отправке формы: каждая заполненная форма создаёт запись в 1С. Управляется переключателем «Синхронизация с 1С» в правилах формы.

**Агенты** ищут контрагентов, номенклатуру, договоры и организации, создают контрагентов и реализации, читают и изменяют любые объекты, доступные через OData. Инструменты перечислены ниже.

## Подключение

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

Адрес базы указывается без окончания OData, например `https://1c.company.ru/base`. LegalStack сам обращается к `/odata/standard.odata`. Принимаются только публичные адреса по https: локальные адреса, частные IP и http не подходят.

Подключение личное: у каждого участника команды своё. Автоматизации, которые работают от имени команды, используют подключение одного из её участников.

## Где взять ключи

1. Опубликуйте базу на веб-сервере с включённым стандартным интерфейсом OData: в конфигураторе «Администрирование → Публикация на веб-сервере», флажок «Публиковать стандартный интерфейс OData». Адрес публикации и есть адрес базы.
2. Добавьте в состав стандартного интерфейса OData объекты, с которыми будет работать LegalStack: как минимум справочники «Контрагенты» и «Организации».
3. Создайте в 1С отдельного пользователя для LegalStack с правами на эти объекты. Его логин и пароль введите в форме подключения.
4. Убедитесь, что адрес публикации открывается из интернета по https.

## Отключение

Удерживайте «Отключить» в карточке интеграции, пока не загорятся все точки. LegalStack удалит сохранённые адрес, логин и пароль.

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

REST-операции: раздел [«1С»](https://docs.legalstack.ru/api/integrations/integration-1c) в справочнике API.

Инструменты раздела [1С](https://docs.legalstack.ru/mcp/onec) (13):

- `create_onec_counterparty` — Создать контрагента в 1С
- `create_onec_record` — Создать запись в 1С
- `create_onec_sale` — Создать реализацию в 1С
- `delete_onec_record` — Пометить запись 1С на удаление
- `describe_onec_resource` — Структура раздела 1С
- `find_onec_contracts` — Договоры в 1С
- `find_onec_counterparties` — Контрагенты 1С
- `find_onec_items` — Номенклатура 1С
- `get_onec_record` — Запись 1С
- `list_onec_organizations` — Организации в 1С
- `list_onec_resources` — Разделы базы 1С
- `query_onec_records` — Выборка записей 1С
- `update_onec_record` — Изменить запись в 1С