# Zup Hr API Reference

> Справочник API конфигурации 1С:ЗУП 3.1 (Зарплата и управление персоналом) по кадровому учету. Используй при разработке/доработке на ЗУП 3.1, когда нужны методы КадровыйУчет, КадровыйУчетРасширенный, ЗарплатаКадры, ФизическиеЛицаЗарплатаКадры - получение кадровых данных сотрудников и физлиц, стажи, даты приема/увольнения, договоры ГПХ, совместители, штатное расписание, остатки отпусков, паспортные данные, склонение ФИО, представления СКД ЗУП. Также расчетная часть: средний заработок и его перерасчет, начисления (план видов расчета, регистр расчета), пособия и обмен с СФР (СЭДО), страховые взносы, регламентированная и статистическая отчетность, корректировка движений через ПереносДанных. НЕ использовать для БП, ERP, УТ, УНФ - только ЗУП

- Skill: `desko77/zup-hr-api-reference` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add desko77/zup-hr-api-reference`
- Raw SKILL.md: https://api.skillmd.com/api/skills/desko77/zup-hr-api-reference/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Desko77 (https://skillmd.com/u/desko77)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/desko77/zup-hr-api-reference

---


# ЗУП 3.1 HR API reference

Полный справочник API 1С:ЗУП 3.1 для работы с кадровыми данными хранится в отдельном файле `references/zup-hr-api.md`, чтобы не раздувать контекст постоянно.

**Действие:** прочитай файл `references/zup-hr-api.md` (относительно папки скила) и используй его как справочник при решении задачи.

Файл покрывает:
- Архитектуру Сотрудник vs ФизическоеЛицо
- Иерархию модулей (КадровыйУчет, КадровыйУчетРасширенный, ЗарплатаКадры и др.)
- `КадровыеДанныеСотрудников` / `КадровыеДанныеФизическихЛиц` - основные методы и все поля
- Периоды работы, даты приема/увольнения
- Стажи (виды, расчет, представление)
- Связи Сотрудник <-> ФизическоеЛицо (основной, совместители, подработки)
- Получение списков сотрудников организации
- Временные таблицы (ВТ) для пакетных запросов
- Рабочие места, архив сотрудников
- Создание физлиц и сотрудников
- ФИО: инициалы, склонение, пол
- Текущие/плановые начисления и удержания
- Остатки отпусков
- Графики работы и производственный календарь
- Паспортные данные, штатное расписание
- Проверки кадрового учета, формирование движений
- Договоры ГПХ, совместительство
- Механизм представлений СКД (виртуальные таблицы для отчетов)
- Настройки кадрового учета, права, ответственные лица
- Средний заработок: данные, регистры, перерасчет (§36-37)
- Начисления: план видов расчета и регистр расчета (§38)
- Корректировка движений через документ ПереносДанных (§39)
- Регламентированная и статистическая отчетность (§40)
- Пособия и обмен с СФР/СЭДО (§41)
- Регистры расчетов с сотрудниками и страховых взносов (§42)
- Частые ошибки обращения к API - несуществующие методы и поля (§43)