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

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

• Регистрирует отсутствие в учёте рабочего времени (вытесняет плановое время видом времени из реквизита ВидВремениЗамещаемый).
• Списывает накопленные дни и/или часы из регистра накопления «ДниЧасыОтгулов» (колонки «В счет отработанных ранее дней» и «часов» в строке сотрудника).
• Формирует начисления через расчётный регистр «Начисления» с полным набором служебных табличных частей.

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

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

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

Три основных сценария: массовый отгул, отгул с расходом баланса и внутрисменное отсутствие.

Урок 1. Отгул для группы сотрудников

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

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

Урок 2. Отгул в счёт ранее отработанных дней/часов

Когда: сотрудник использует накопленный баланс отгулов (регистр накопления «ДниЧасыОтгулов»). Сценарий дополняет Урок 1 — к базовым шагам добавляется расход баланса.

1. Выполняем шаги 1–4 из Урока 1 (шапка документа).
2. В строке ТЧ «Сотрудники» заполняем КоличествоДнейОтгула («Дней отгула»).
3. В колонке РасходДнейОтгула («В счет отработанных ранее дней») указываем, сколько дней списать из баланса.
4. Если отгул измеряется в часах — заполняем РасходЧасовОтгула («часов»).
5. Проводим документ. После проведения в регистре «ДниЧасыОтгулов» по сотруднику появляется запись расхода (уменьшение остатка).

Урок 3. Внутрисменный отгул (часть смены)

Когда: сотрудник отсутствует не целый рабочий день, а только часть смены (например, уходит на 2 часа раньше в счёт отработанного).

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

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

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

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

Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year. В шапке 20 реквизитов; 8 табличных частей: одна пользовательская («Сотрудники»), шесть расчётных/служебных («Начисления», «НачисленияПерерасчет», «Показатели», «РаспределениеРезультатовНачислений», «РаспределениеПоТерриториямУсловиямТруда», «НачисленияПерерасчетНулевыеСторно») и одна механизмная («ДополнительныеРеквизиты»). Формы в карте объекта не определены (forms = []).

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

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

ТЧ «Сотрудники» — единственная пользовательская. Заполняется вручную.

Расчётные и служебные ТЧ — заполняются механизмом расчёта, вручную не вводятся.

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

Документ объявлен регистратором по 26 регистрам. Ниже — назначение ключевых приёмников движений.

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

Обязательные реквизиты (из fill_value_required: ShowError) — то, что проверяет ОбработкаПроверкиЗаполнения:

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

Схема проведения (реконструкция по metadata.register_records):

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

    // 1. Основной регистр расчёта начислений.
    //    Строки из ТЧ Начисления (и НачисленияПерерасчет при исправлении) записываются
    //    в CalculationRegister.Начисления с периодами действия и регистрации.
    Движения.Начисления; // CalculationRegister.Начисления

    // 2. Целевой регистр баланса отгулов.
    //    РасходДнейОтгула / РасходЧасовОтгула из ТЧ Сотрудники → расход по каждому сотруднику.
    Движения.ДниЧасыОтгулов; // AccumulationRegister.ДниЧасыОтгулов

    // 3. Учёт рабочего времени: оперативный, табельный, вытесняемое плановое время,
    //    корректировка отработанного, состояния сотрудников.
    Движения.ДанныеОперативногоУчетаРабочегоВремениСотрудников;
    Движения.ДанныеТабельногоУчетаРабочегоВремениСотрудников;
    Движения.ВытесняемоеПлановоеВремяСотрудников; // вид из ВидВремениЗамещаемый
    Движения.ОтработанноеВремяПоСотрудникам;
    Движения.ОтработанноеВремяПоСотрудникамКорректировка;
    Движения.ДанныеСостоянийСотрудников; // состояние «отгул»

    // 4. Взаиморасчёты, суммы к выплате, бухучёт начислений.
    Движения.ВзаиморасчетыССотрудниками;
    Движения.БухгалтерскиеВзаиморасчетыССотрудниками;
    Движения.НачисленияУдержанияПоСотрудникам;
    Движения.БухучетНачисленияУдержанияПоСотрудникам;
    Движения.ЗарплатаКВыплате;
    Движения.СведенияОДоходахФизическихЛиц;

    // 5. Средний заработок (общая методика КЗ).
    Движения.ДанныеОВремениДляРасчетаСреднегоОбщий;
    Движения.ДанныеОНачисленияхДляРасчетаСреднегоЗаработкаОбщий;

    // 6. Распределение по аналитикам, показатели, перерасчёты.
    Движения.РаспределениеРезультатовНачислений;
    Движения.РаспределениеПоТерриториямУсловиямТруда;
    Движения.ЗначенияПоказателейНачислений;
    Движения.ИсходныеДанныеПерерасчетов; // при ИсправленныйДокумент ≠ Пусто

    // 7. Запись наборов записей всех регистров.
    Движения.Записать();

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

Зависимости

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

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

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