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

Когда наступает сезон отпусков, кадровику нужно провести единый приказ на нескольких сотрудников сразу. Документ «Отпуск сотрудников» (ОтпускаСотрудников) — это именно такой групповой приказ об отпуске: он хранит список сотрудников, период каждого отпуска, его вид и рабочий год, за который предоставляется отдых.

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

Казахстанский контекст: трудовой отпуск в РК предоставляется по нормам ТК РК; период, за который предоставляется отпуск — рабочий год сотрудника (не календарный). Начисление отпускных облагается ИПН, ОПВ, ОПВР, СО, ВОСМС, расчёт которых происходит в связанном документе «Отпуск». Единый платёж на уровне самого «Отпуска сотрудников» не исчисляется — это организационный объект.

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

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

Проходим по шагам: от пустого документа до оформленного приказа на нескольких сотрудников.

Урок 1. Массовое оформление ежегодных трудовых отпусков

Когда: по графику отпусков нескольким сотрудникам нужно оформить ежегодный трудовой отпуск одним приказом. Это основной сценарий.

1. Создаём новый документ «Отпуск сотрудников». Заполняем Организацию — единственное обязательное поле шапки.
2. При необходимости указываем Период принадлежности (месяц, к которому относится документ) и Комментарий.
3. В табличной части «Сотрудники» добавляем строки: для каждого сотрудника указываем Сотрудник, Дата начала и Дата окончания отпуска. Физлицо подтягивается автоматически.
4. В табличной части «Отпуска» по каждому сотруднику (строки привязываются автоматически через ИдентификаторСтрокиСотрудника) заполняем: Вид отпуска, Дата начала / Дата окончания, Начало периода за который предоставляется отпуск / Конец периода за который предоставляется отпуск (рабочий год по ТК РК), Количество дней, Основание (заявление / график отпусков).
5. Записываем / проводим документ.
6. Проверяем колонку Отпуск в ТЧ «Сотрудники»: в ней должны появиться ссылки на созданные индивидуальные документы «Отпуск». Именно они будут источником расчёта отпускных.

Урок 2. Отпуск с материальной помощью или единовременной выплатой

Когда: вместе с отпуском сотруднику положена материальная помощь или единовременная выплата к отпуску (например, по коллективному договору или внутреннему положению об оплате труда).

1. Создаём документ и заполняем базовые поля, как в Уроке 1.
2. В строке ТЧ «Сотрудники» для нужного сотрудника устанавливаем флаг «Предоставить материальную помощь при отпуске» (ПредоставитьМатериальнуюПомощьПриОтпуске) и/или «Предоставить единовременную выплату к отпуску» (ПредоставитьЕдиновременнуюВыплатуКОтпуску).
3. Записываем / проводим.
4. Расчёт сумм допвыплат выполняется в связанном индивидуальном документе «Отпуск» — проверяем его.

Урок 3. Неоплачиваемый отпуск и компенсация дней

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

1. Неоплачиваемый отпуск. В строке ТЧ «Сотрудники» устанавливаем флаг «Отпуск без оплаты» (ОтпускБезОплаты = Истина). Заполняем даты. Записываем / проводим. По строке ожидается ссылка на связанный документ «Отпуск без сохранения оплаты» (колонка Отпуск составного типа).
2. Компенсация за неиспользованный отпуск. В ТЧ «Отпуска» для нужной строки заполняем «Количество дней компенсации» (КоличествоДнейКомпенсации). Остальные поля — вид отпуска, рабочий период, основание — как обычно. Записываем / проводим.
3. Освобождение ставки. Если на время длительного отпуска нужно освободить позицию штатного расписания для замещающего, в строке ТЧ «Сотрудники» устанавливаем флаг «Освобождать ставку» (ОсвобождатьСтавку = Истина).

🛠 Часть 2. Для программиста

Состав объекта, регистры-приёмники движений и логика проведения. Конфигурация ЗУП для Казахстана 3.1, релиз 3.1.2.24.

Структура объекта

Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year (в пределах года). В шапке 11 реквизитов; три табличные части: две содержательные (Сотрудники и Отпуска, связанные ключом ИдентификаторСтрокиСотрудника) и стандартный механизм доп. реквизитов БСП (ДополнительныеРеквизиты). Значительная часть полей несёт наследие российской типовой — помечено ниже.

Реквизиты шапки

Табличные части

ТЧ Сотрудники — кому оформляется отпуск и параметры по каждому сотруднику:

ТЧ Отпуска — детализация отпусков по видам и рабочим периодам:

ТЧ ДополнительныеРеквизиты — стандартный механизм доп. реквизитов БСП:

Движения по регистрам

Поле metadata.register_records в выгрузке объекта пусто — документ «Отпуск сотрудников» не является регистратором ни по одному регистру. Все регистровые следы трудового отпуска — учёт времени, средний заработок, начисление отпускных, ИПН, ОПВ, ОПВР, СО, ВОСМС/ООСМС, взаиморасчёты — формируются связанными документами Document.Отпуск / Document.ОтпускБезСохраненияОплаты, ссылки на которые хранятся в колонке Отпуск ТЧ «Сотрудники».

Как формируется проведение — реальный код (3.1.2.24)

Структура обязательности (из fill_value_required: ShowError) — единственная автоматическая проверка платформы:

// Реконструкция по metadata: только один реквизит с проверкой заполнения (ShowError).
// Платформа проверит его автоматически перед записью.
ПроверяемыеРеквизиты = "Организация";
// Содержательные проверки строк ТЧ (сотрудник, даты, вид отпуска) —
// (не определено): ОбработкаПроверкиЗаполнения в выгрузке отсутствует.

Схема проведения (реконструкция): документ-«организатор» без собственных движений — его «проведение» сводится к созданию или обновлению ссылок на связанные индивидуальные документы.

// Реконструкция по metadata.register_records (пуст). Не дословный код модуля.
Процедура ОбработкаПроведения(Отказ, РежимПроведения)

    // 1. Собственных движений по регистрам НЕТ (register_records = []).
    //    Документ является организационной оболочкой, а не расчётным объектом.

    // 2. Ожидаемая логика (по реквизитному составу):
    //    По каждой строке ТЧ Сотрудники система создаёт или обновляет
    //    связанный индивидуальный документ и сохраняет ссылку в колонке Отпуск.
    //    Тип связанного документа определяется флагом ОтпускБезОплаты:
    //      ОтпускБезОплаты = Ложь  → Document.Отпуск
    //      ОтпускБезОплаты = Истина → Document.ОтпускБезСохраненияОплаты

    // 3. Флаги допвыплат по строке:
    //    ПредоставитьМатериальнуюПомощьПриОтпуске,
    //    ПредоставитьЕдиновременнуюВыплатуКОтпуску — передаются в связанный документ.

    // 4. При ОсвобождатьСтавку = Истина — эффект реализуется через связанный
    //    документ «Отпуск» (механизм освобождения ставки ШР вне карты этого объекта).

    // 5. ДокументРассчитан и КраткийСоставДокумента — заполняются системно.

    // Движения.Записать() — не вызывается (регистров нет).

КонецПроцедуры

Зависимости

Дословный список общих модулей в выгрузке отсутствует. Структурно документ опирается на:

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

• Отпуск — индивидуальный расчётный документ, который создаётся по каждой строке «Отпуска сотрудников»; именно он начисляет отпускные, ИПН, ОПВ, ОПВР, СО, ВОСМС.
• Приём на работу — кадровый документ, задающий рабочий год сотрудника, от которого отсчитываются периоды предоставления отпуска по ТК РК.