# Реестры

> Структурированные каталоги данных — договоры, контрагенты, лицензии.

Реестр — таблица бизнес-данных с типизированными колонками: договоры, контрагенты, доверенности, лицензии, судебные дела. Реестры связываются с документами и задачами, а контрольные даты (окончание договора, срок доверенности) автоматически создают уведомления и события для [автоматизаций](https://docs.legalstack.ru/guide/ai-agents).

## Создание

«Создать → Реестр» открывает пустую таблицу колонок и рядом мастер «Что создаём?». Колонки можно добавлять сразу или взять основу: готовый реестр из библиотеки (при наведении его колонки появляются в таблице, есть поиск по названию), поля шаблона документа или таблицу XLSX/CSV с компьютера, из Google Таблиц, Dropbox или Яндекс Диска. Колонки, добавленные вручную, при смене основы сохраняются. На последнем шаге задайте название, выберите папку или создайте новую — реестр появится только после нажатия «Создать реестр».

## Наполнение

- Вручную или импортом из таблицы (XLSX/CSV).
- Из облачных таблиц: Google Таблицы, файлы Dropbox и Яндекс Диска.
- Из документов: значения переменных документов выбранной папки становятся записями реестра.
- Через формы: ответы публичной формы создают записи реестра, формы настраиваются в разделе «Интерфейсы».
- По API и агентами — реестры полностью доступны через [REST](https://docs.legalstack.ru/api/registry) и [MCP](https://docs.legalstack.ru/mcp/registry).

## Синхронизация с источниками

Реестр остаётся связан с источником. Синхронизировать его можно кнопкой в настройках реестра, в разделе «Источники» или по расписанию: каждый час, раз в сутки или раз в неделю.

- **Правила.** Можно добавлять новые строки, обновлять изменённые и удалять записи, которых больше нет в источнике. Правила задаются у источника и действуют и для кнопки, и для расписания.
- **Свои поля сохраняются.** Синхронизация меняет только поля, которые приходят из источника. Поля, которые заполняют в самом реестре, остаются как есть. Если поле из источника поправили в реестре, следующая синхронизация вернёт значение источника.
- **Сопоставление строк.** Запись связана со строкой по ключу, например по первой колонке таблицы или документу. Повторяющиеся ключи получают номера по порядку строк, поэтому одинаковые значения не склеиваются в одну запись. Записи каждого источника сопоставляются отдельно, источники одного реестра не мешают друг другу.
- **Пустой источник.** Если источник не вернул ни одной строки, записи не удаляются, даже когда удаление включено.
- **Целостность.** Синхронизация применяется целиком или не применяется вовсе, а две синхронизации одного источника не идут одновременно. Новые записи получают те же права, что и созданные вручную, а добавление, изменение и удаление запускают автоматизации.
- **От чьего имени.** По расписанию синхронизация идёт от имени того, кто сохранил расписание, и с его подключением к облаку.
- **Остановка расписания.** Если этот человек потеряет право изменять реестр, отключит облако или покинет команду, расписание остановится, а в карточке источника появится причина. Чтобы возобновить синхронизацию, сохраните расписание заново.
- **Временные сбои.** Недоступность облака расписание не останавливает: платформа повторяет попытку, в карточке источника видна ошибка, а следующая синхронизация пройдёт в срок.
- **Пропущенный запуск.** Если платформа была недоступна в момент синхронизации, она выполняется один раз после восстановления.

## Организация

Реестры группируются в папки с наследуемыми доступами. Экспорт — в XLSX одним действием или по API.