Документ «Ввод остатков отпусков»

Фиксирует начальные остатки неиспользованных дней ежегодного отпуска для каждого сотрудника на момент начала ведения учёта в базе: именно от этих данных программа рассчитывает остатки и начисляет отпускные в дальнейшем.

ЗУП для Казахстана, ред. 3.1 · v3.1.2.24 · обновлено 2026-06

🎯 Что это и зачем

При переходе компании на ЗУП КЗ 3.1 с другой программы или с ведения учёта в Excel у сотрудников, как правило, уже накоплены неиспользованные дни ежегодного отпуска. Чтобы программа корректно рассчитывала остатки отпусков и начисляла отпускные (в том числе компенсацию при увольнении), эти остатки нужно «загрузить» в базу — именно это и делает документ «Ввод остатков отпусков».

Документ сугубо кадровый: он не касается налогов и взносов РК (ИПН, ОПВ, ОПВР, СО, ВОСМС, ООСМС, единый платёж) — это только учёт дней отпуска. Оформляется персонально: один документ — один сотрудник. Заполняет его кадровик или расчётчик на этапе первоначального ввода данных, как правило, один раз по каждому сотруднику с ненулевым остатком.

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

🧭 Где найти в программе

Раздел «Кадры» → пункт «Ввод остатков отпусков». Откроется журнал документов; новый создаём кнопкой «Создать».

📌 Заметка. Точное расположение пункта в меню зависит от настроек интерфейса и ролей пользователя. Если пункта нет в разделе «Кадры» — ищите через «Все функции» → Документы → «Ввод остатков отпусков».

👤 Часть 1. Для пользователя

Три основных сценария: от первоначального ввода данных до детализации по рабочим годам.

Урок 1. Ввод остатков при старте учёта в базе

Когда: организация начинает вести учёт в ЗУП КЗ 3.1; нужно ввести накопленные неиспользованные дни ежегодного отпуска для конкретного сотрудника.

  1. Создаём новый документ «Ввод остатков отпусков» кнопкой «Создать».
  2. Указываем Организацию — это обязательное поле; без него документ не проведётся.
  3. Выбираем Сотрудника. После выбора сотрудника автоматически подставится поле Физическое лицо (служебная связка, руками не трогать).
  4. Указываем Дату остатков — дату, по состоянию на которую посчитаны остатки (обычно дата начала ведения учёта, например 01.01.2026). Все суммы в табличных частях трактуются «по состоянию на эту дату».
  5. В табличной части «Ежегодные отпуска» добавляем строку по каждому положенному виду отпуска:
    • выбираем Вид ежегодного отпуска (основной, дополнительный и т.п.);
    • выбираем Действие (значение перечисления «Действия с ежегодными отпусками»);
    • вводим Количество дней в год — годовую норму по этому виду;
    • вводим Остаток (ОстатокНаДатуОстатков) — суммарный неиспользованный остаток на дату остатков.
  6. Нажимаем «Провести».
📷 Скриншот: шапка документа «Ввод остатков отпусков»
Шапка: Организация, Сотрудник, Дата остатков — все три обязательны.
⚠️ Важно. Обязательны три реквизита шапки: Организация, Сотрудник, Дата остатков. Без любого из них документ выдаст ошибку при проведении (тип проверки — ShowError). Убедитесь, что Дата остатков совпадает с той датой, на которую вы считали остатки в старой системе.
💡 Подсказка. Документ персональный — один документ на одного сотрудника. Для ввода остатков по большому штату удобнее создавать документы последовательно «на основании» карточек сотрудников (Урок 2), а не вводить каждый вручную.

Урок 2. Создание из карточки сотрудника

Когда: остатки вводятся по конкретному сотруднику прямо из его карточки — быстрее и без риска ошибиться с выбором сотрудника.

  1. Открываем нужный элемент справочника «Сотрудники».
  2. Используем команду «Создать на основании» → «Ввод остатков отпусков». Документ объявлен вводимым на основании Catalog.Сотрудники, поэтому эта команда доступна в карточке.
  3. В созданном документе Сотрудник, Организация и Физическое лицо уже подставлены из основания — проверяем их корректность.
  4. Заполняем Дату остатков и табличную часть «Ежегодные отпуска», как в Уроке 1.
  5. Проводим документ.
💡 Подсказка. Если у сотрудника только основной ежегодный отпуск 24 рабочих дня, достаточно одной строки в ТЧ «Ежегодные отпуска». Дополнительные строки добавляют только при наличии дополнительных видов отпуска (за вредность, по коллективному договору и т.п.).

Урок 3. Детализация по рабочим годам и учёт сдвигающих отсутствий

Когда: нужно зафиксировать, за какие именно рабочие годы накоплен остаток, и/или у сотрудника были периоды отсутствий до начала учёта, которые сдвигают его рабочий год.

  1. Создаём или открываем документ «Ввод остатков отпусков» и заполняем шапку и ТЧ «Ежегодные отпуска», как описано выше.
  2. Детализация по рабочим годам. Переходим на вкладку «Остатки отпусков по рабочим годам». Для каждого рабочего года добавляем строку: выбираем Вид ежегодного отпуска, указываем Рабочий год начало и Рабочий год окончание, вводим Остаток дней. Следим, чтобы сумма строк по каждому виду отпуска совпадала с остатком в ТЧ «Ежегодные отпуска».
  3. Отсутствия, сдвигающие рабочий год. Переходим на вкладку «Отсутствия сдвигающие рабочий год». Добавляем строку: выбираем Вид ежегодного отпуска, выбираем Состояние (вид отсутствия из перечисления «Состояния сотрудника») и вводим Остаток (КоличествоДней) — число дней отсутствия, не входящих в стаж.
  4. Проводим документ.
⚠️ Ловушка UI. В ТЧ «Отсутствия сдвигающие рабочий год» колонка КоличествоДней отображается с заголовком «Остаток» — не путайте с аналогичным заголовком в ТЧ «Ежегодные отпуска». Ищите именно колонку «Остаток» на этой вкладке.
📌 Заметка. Детализация по рабочим годам не обязательна для проведения, но критически важна для корректного списания накопленных дней при последующих отпусках и при расчёте компенсации за неиспользованный отпуск при увольнении. Рекомендуем заполнять её всегда.
💡 Корректировка ошибок. Если после проведения обнаружена ошибка — откройте документ, исправьте нужные значения (шапку или строки ТЧ) и перепроведите. Движения в трёх регистрах сведений будут переформированы по новым данным. История расчёта остатков отпусков сотрудника изменится начиная с даты остатков.

🛠 Часть 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)

⚠️ Важно об источнике. В использованной XML-выгрузке конфигурации модули объекта и форм отсутствуют (секции 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: []) — влияние полей друг на друга описано по структуре метаданных.

🔗 Связанные разделы