Документ «Ввод остатков отпусков»
Фиксирует начальные остатки неиспользованных дней ежегодного отпуска для каждого сотрудника на момент начала ведения учёта в базе: именно от этих данных программа рассчитывает остатки и начисляет отпускные в дальнейшем.
🎯 Что это и зачем
При переходе компании на ЗУП КЗ 3.1 с другой программы или с ведения учёта в Excel у сотрудников, как правило, уже накоплены неиспользованные дни ежегодного отпуска. Чтобы программа корректно рассчитывала остатки отпусков и начисляла отпускные (в том числе компенсацию при увольнении), эти остатки нужно «загрузить» в базу — именно это и делает документ «Ввод остатков отпусков».
Документ сугубо кадровый: он не касается налогов и взносов РК (ИПН, ОПВ, ОПВР, СО, ВОСМС, ООСМС, единый платёж) — это только учёт дней отпуска. Оформляется персонально: один документ — один сотрудник. Заполняет его кадровик или расчётчик на этапе первоначального ввода данных, как правило, один раз по каждому сотруднику с ненулевым остатком.
При проведении документ формирует записи в трёх регистрах сведений: НачальныеОстаткиОтпусков, ПоложенныеВидыЕжегодныхОтпусков и ОтсутствияСдвигающиеРабочийГод — дальнейший расчёт остатков и начисление отпускных опирается именно на эти данные.
🧭 Где найти в программе
Раздел «Кадры» → пункт «Ввод остатков отпусков». Откроется журнал документов; новый создаём кнопкой «Создать».
👤 Часть 1. Для пользователя
Три основных сценария: от первоначального ввода данных до детализации по рабочим годам.
Урок 1. Ввод остатков при старте учёта в базе
Когда: организация начинает вести учёт в ЗУП КЗ 3.1; нужно ввести накопленные неиспользованные дни ежегодного отпуска для конкретного сотрудника.
- Создаём новый документ «Ввод остатков отпусков» кнопкой «Создать».
- Указываем Организацию — это обязательное поле; без него документ не проведётся.
- Выбираем Сотрудника. После выбора сотрудника автоматически подставится поле Физическое лицо (служебная связка, руками не трогать).
- Указываем Дату остатков — дату, по состоянию на которую посчитаны остатки (обычно дата начала ведения учёта, например 01.01.2026). Все суммы в табличных частях трактуются «по состоянию на эту дату».
- В табличной части «Ежегодные отпуска» добавляем строку по каждому положенному виду отпуска:
- выбираем Вид ежегодного отпуска (основной, дополнительный и т.п.);
- выбираем Действие (значение перечисления «Действия с ежегодными отпусками»);
- вводим Количество дней в год — годовую норму по этому виду;
- вводим Остаток (
ОстатокНаДатуОстатков) — суммарный неиспользованный остаток на дату остатков.
- Нажимаем «Провести».
Урок 2. Создание из карточки сотрудника
Когда: остатки вводятся по конкретному сотруднику прямо из его карточки — быстрее и без риска ошибиться с выбором сотрудника.
- Открываем нужный элемент справочника «Сотрудники».
- Используем команду «Создать на основании» → «Ввод остатков отпусков». Документ объявлен вводимым на основании
Catalog.Сотрудники, поэтому эта команда доступна в карточке. - В созданном документе Сотрудник, Организация и Физическое лицо уже подставлены из основания — проверяем их корректность.
- Заполняем Дату остатков и табличную часть «Ежегодные отпуска», как в Уроке 1.
- Проводим документ.
Урок 3. Детализация по рабочим годам и учёт сдвигающих отсутствий
Когда: нужно зафиксировать, за какие именно рабочие годы накоплен остаток, и/или у сотрудника были периоды отсутствий до начала учёта, которые сдвигают его рабочий год.
- Создаём или открываем документ «Ввод остатков отпусков» и заполняем шапку и ТЧ «Ежегодные отпуска», как описано выше.
- Детализация по рабочим годам. Переходим на вкладку «Остатки отпусков по рабочим годам». Для каждого рабочего года добавляем строку: выбираем Вид ежегодного отпуска, указываем Рабочий год начало и Рабочий год окончание, вводим Остаток дней. Следим, чтобы сумма строк по каждому виду отпуска совпадала с остатком в ТЧ «Ежегодные отпуска».
- Отсутствия, сдвигающие рабочий год. Переходим на вкладку «Отсутствия сдвигающие рабочий год». Добавляем строку: выбираем Вид ежегодного отпуска, выбираем Состояние (вид отсутствия из перечисления «Состояния сотрудника») и вводим Остаток (
КоличествоДней) — число дней отсутствия, не входящих в стаж. - Проводим документ.
КоличествоДней отображается с заголовком «Остаток» — не путайте с аналогичным заголовком в ТЧ «Ежегодные отпуска». Ищите именно колонку «Остаток» на этой вкладке.🛠 Часть 2. Для программиста
Состав объекта, регистры-приёмники движений и логика проведения. Конфигурация ЗУП для Казахстана 3.1, релиз 3.1.2.24.
Структура объекта
Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year (в пределах года). В шапке 6 реквизитов, 4 табличных части (3 отпускных + стандартная БСП «Дополнительные реквизиты»). Документ персональный: один сотрудник — один документ.
Реквизиты шапки
| Имя | Тип | Обяз. | Назначение |
|---|---|---|---|
Организация | CatalogRef.Организации | Да (ShowError) | Организация-работодатель; задаёт разрез хранения записей в регистрах |
Сотрудник | CatalogRef.Сотрудники | Да (ShowError) | Сотрудник, по которому вводятся остатки; от него автоматически подтягивается ФизическоеЛицо |
ДатаОстатков | xs:dateTime | Да (ShowError) | Дата фиксации остатков; все значения ТЧ трактуются «по состоянию на эту дату» |
ФизическоеЛицо | CatalogRef.ФизическиеЛица | Нет (DontCheck) | Физлицо сотрудника; служебная связка, вручную не редактируется |
Ответственный | CatalogRef.Пользователи | Нет (DontCheck) | Пользователь, ответственный за ввод документа; обычно текущий пользователь |
Комментарий | xs:string | Нет (DontCheck) | Произвольный комментарий к документу |
Табличные части
ТЧ ЕжегодныеОтпуска («Ежегодные отпуска») — главная таблица: какие виды ежегодного отпуска положены сотруднику, норма дней в год и суммарный остаток на дату остатков.
| Имя | Тип | Назначение |
|---|---|---|
ВидЕжегодногоОтпуска | CatalogRef.ВидыОтпусков | Вид ежегодного отпуска (основной, дополнительный и т.п.) |
Действие | EnumRef.ДействияСЕжегоднымиОтпусками | Действие с данным видом отпуска (значение перечисления) |
КоличествоДнейВГод | xs:decimal | Положенное количество дней этого вида отпуска за рабочий год |
ОстатокНаДатуОстатков | xs:decimal (в UI — «Остаток») | Суммарный неиспользованный остаток на ДатаОстатков |
ТЧ ОстаткиОтпусковПоРабочимГодам («Остатки отпусков по рабочим годам») — детализация остатка по рабочим годам (за какой рабочий год сколько дней не отгуляно).
| Имя | Тип | Назначение |
|---|---|---|
ВидЕжегодногоОтпуска | CatalogRef.ВидыОтпусков | Вид ежегодного отпуска, к которому относится остаток |
РабочийГодНачало | xs:dateTime | Дата начала рабочего года |
РабочийГодОкончание | xs:dateTime | Дата окончания рабочего года |
Остаток | xs:decimal | Остаток дней отпуска за этот рабочий год |
ТЧ ОтсутствияСдвигающиеРабочийГод («Отсутствия сдвигающие рабочий год») — периоды отсутствий, которые не входят в отпускной стаж и сдвигают границы рабочего года.
| Имя | Тип | Назначение |
|---|---|---|
ВидЕжегодногоОтпуска | CatalogRef.ВидыОтпусков | Вид отпуска, для которого учитывается сдвиг рабочего года |
Состояние | EnumRef.СостоянияСотрудника | Вид отсутствия (значение перечисления «Состояния сотрудника») |
КоличествоДней | xs:decimal (в UI — «Остаток») | Количество дней отсутствия, сдвигающих рабочий год |
ТЧ ДополнительныеРеквизиты — стандартная подсистема дополнительных реквизитов БСП; заполняется автоматически, если администратор добавил допреквизиты к документу.
| Имя | Тип | Назначение |
|---|---|---|
Свойство | ChartOfCharacteristicTypesRef.ДополнительныеРеквизитыИСведения | Дополнительный реквизит (характеристика) |
Значение | (составной тип) | Значение дополнительного реквизита |
ТекстоваяСтрока | xs:string | Текстовое представление значения |
Движения по регистрам
Документ объявлен регистратором по 3 регистрам сведений. Бухгалтерских проводок не формирует; налоги и взносы РК (ИПН/ОПВ/ОПВР/СО/ВОСМС/ООСМС) не затрагивает.
| Регистр | Тип | Назначение |
|---|---|---|
НачальныеОстаткиОтпусков | Сведений | Собственно начальные остатки дней отпуска по видам; от этих данных отталкивается механизм расчёта остатков |
ПоложенныеВидыЕжегодныхОтпусков | Сведений | Какие виды ежегодного отпуска и в каком годовом объёме положены сотруднику |
ОтсутствияСдвигающиеРабочийГод | Сведений | Периоды отсутствий, сдвигающие рабочий год сотрудника (программа сдвигает рабочий год на указанное число дней) |
Как формируется проведение — реальный код (3.1.2.24)
bsl_static / bsl_summaries пусты), поэтому дословный текст процедур ОбработкаПроведения / ОбработкаПроверкиЗаполнения / обработчиков ПриИзменении привести нельзя. Ниже — реконструкция по метаданным (состав регистров-приёмников и обязательность реквизитов): это не цитата исходного кода, а корректная по структуре схема того, как типовая ЗУП проводит документ.Структура обязательности (из fill_value_required: ShowError) — то, что проверяет типовая ОбработкаПроверкиЗаполнения на уровне платформы:
// Реконструкция по metadata: 3 реквизита с проверкой заполнения (ShowError).
// Платформа проверяет их автоматически перед записью; имена — дословно из метаданных.
ПроверяемыеРеквизиты = "Организация, Сотрудник, ДатаОстатков";
// Дополнительные прикладные проверки задаёт ОбработкаПроверкиЗаполнения (в выгрузке нет).
Схема проведения (реконструкция): набор движений распределяется по трём регистрам сведений.
// Реконструкция по metadata.register_records (3 регистра сведений). Не дословный код модуля.
Процедура ОбработкаПроведения(Отказ, РежимПроведения)
// 1. Положенные виды ежегодных отпусков (из ТЧ ЕжегодныеОтпуска).
// Для каждой строки: Вид, Действие, КоличествоДнейВГод.
Движения.ПоложенныеВидыЕжегодныхОтпусков;
// 2. Начальные остатки отпусков (из ТЧ ЕжегодныеОтпуска и
// при наличии — ОстаткиОтпусковПоРабочимГодам).
// Ключевой реквизит — ДатаОстатков: остатки фиксируются именно на эту дату.
Движения.НачальныеОстаткиОтпусков;
// 3. Отсутствия, сдвигающие рабочий год (из ТЧ ОтсутствияСдвигающиеРабочийГод).
// Программа сдвигает рабочий год сотрудника на КоличествоДней по каждому
// виду отсутствия и виду ежегодного отпуска.
Движения.ОтсутствияСдвигающиеРабочийГод;
// 4. Запись наборов записей всех трёх регистров.
Движения.Записать();
КонецПроцедуры
Зависимости
Дословный список общих модулей в выгрузке отсутствует. Структурно документ опирается на:
| Зависимость | Что используется |
|---|---|
| Справочники | Организации, Сотрудники, ФизическиеЛица, Пользователи, ВидыОтпусков |
| Перечисления | ДействияСЕжегоднымиОтпусками, СостоянияСотрудника |
| Регистры сведений | НачальныеОстаткиОтпусков, ПоложенныеВидыЕжегодныхОтпусков, ОтсутствияСдвигающиеРабочийГод |
| Документы-основания | Catalog.Сотрудники — создание из карточки сотрудника командой «Создать на основании» |
| Подсистема БСП | Дополнительные реквизиты и сведения (ТЧ ДополнительныеРеквизиты) |
inverse_based_on пуст). Обработчики ПриИзменении в выгрузке отсутствуют (bsl_static: []) — влияние полей друг на друга описано по структуре метаданных.🔗 Связанные разделы
- Отпуск — оформление ежегодного отпуска: именно здесь программа использует данные, введённые документом «Ввод остатков отпусков».
- Приём на работу — кадровый документ того же раздела; как правило, вводится до «Ввода остатков отпусков».