# 1С:Зарплата и управление персоналом

Считайте ФОТ и кадровые движения без выгрузок в Excel

Кадровый учёт и расчёт зарплаты через OData

## Как агент работает с 1С:Зарплата и управление персоналом

Агент подключается к базе ЗУП по адресу публикации и работает через стандартный интерфейс OData: обычный HTTP с базовой авторизацией, без обработок и внешних компонент внутри базы. Данные он только запрашивает, а разбор и расчёты делает у себя, поэтому нагружает базу примерно как ещё один тонкий клиент. Тяжёлые выборки — начисления за месяц, движение кадров за год — он дробит на страницы и фильтрует на стороне 1С, а не тянет справочник целиком.

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

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

Второй рубеж по персональным данным — роль пользователя 1С: агент видит ровно то, что разрешено этой учётной записи, и при желании можно оставить только агрегаты по подразделениям, закрыв карточки физических лиц. Проводить кадровые документы OData позволяет лишь при праве на запись; для кадрового контура обычно подключают пользователя на чтение — агент считает ФОТ и собирает сводку, а приказы оформляет человек.

## Сценарии интеграции

### Штатная расстановка одним запросом
Агент соберёт сотрудников с подразделениями, должностями и датами приёма прямо из базы, без ручной выгрузки отчёта в Excel.

### Фонд оплаты труда по подразделениям
Агент посчитает начисления за месяц в разрезе подразделений и видов расчёта и покажет, где выплаты выросли сильнее всего.

### Кадровые движения и текучесть
Агент сведёт приёмы, переводы и увольнения за период, посчитает текучесть по подразделениям и покажет, откуда уходят люди.

### Отпуска и накопленные дни
Агент покажет, у кого накопились неиспользованные дни отпуска и чьи запланированные отпуска пересекаются внутри одного отдела.

### Что удержали за месяц
Агент разложит удержания за месяц по видам и подразделениям и покажет, насколько сумма к выдаче разошлась с начисленной.

### Что видно агенту в базе
Агент прочитает /$metadata публикации и назовёт, какие справочники, документы и регистры ему открыты, а что закрыто составом публикации или ролью пользователя.

## Как подключить

**Перед подключением**

- Права администратора в базе ЗУП
- Веб-сервер IIS или Apache рядом с базой 1С
- Сетевой доступ к адресу публикации базы снаружи
- Права на запись, если агент проводит кадровые документы

### Опубликуйте базу на веб-сервере
Конфигуратор → «Публикация на веб-сервере»: имя латиницей и галочка «Публиковать стандартный интерфейс OData». Адрес публикации и есть адрес базы.

### Отметьте объекты в составе OData
«Синхронизация данных» → «Настройка стандартного интерфейса OData» → вкладка «Состав»: отметьте сотрудников, кадровые документы и начисления.

### Заведите отдельного пользователя
Новый пользователь: логин латиницей, свой пароль, роль «Удаленный доступ OData». Двухфакторную аутентификацию на нём не включайте — с OData она несовместима.

### Проверьте адрес /$metadata в браузере
Откройте https://сервер/имя-базы/odata/standard.odata/$metadata и войдите этим логином. XML со списком сущностей значит, что адрес и пароль верные.

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

### Как подключить 1С:Зарплату и управление персоналом?
Адресом публикации базы, логином и паролем отдельного пользователя. Логин задаётся латиницей, роль удалённого доступа OData обязательна, а двухфакторную аутентификацию на этом пользователе включать нельзя — с OData она несовместима.

### Что агент видит в базе зарплаты и кадров?
Сотрудников и физических лиц, кадровые документы, подразделения и должности, регистры начислений и удержаний — в пределах объектов, отмеченных в составе публикации OData, и прав роли пользователя.

### Как ограничить доступ к персональным данным?
Ролью пользователя 1С и составом публикации: агент видит ровно то, что разрешено этой учётной записи. Можно оставить только агрегаты по подразделениям и закрыть карточки физических лиц.

### Может ли агент проводить кадровые документы?
Только если роль разрешает запись. Для кадрового контура обычно подключают пользователя на чтение: агент считает ФОТ и соберёт сводку, но приказы оформляет человек.

[Открыть 1С:Зарплата и управление персоналом](https://v8.1c.ru/platforma/rest-interfeys/)