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

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

Ключевой механизм — регистр накопления ДниЧасыОтгулов: в нём ведётся баланс накопленных дней и часов по сотруднику. Документ умеет списывать расход из этого баланса (реквизиты РасходДнейОтгула / РасходЧасовОтгула). Вид расчёта — произвольный: можно выбрать как оплачиваемое начисление, так и только учёт времени без сумм.

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

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

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

Три типовых сценария: от пустого документа до проведённого отгула.

Урок 1. Отгул на целый день или несколько дней

Когда: сотруднику предоставляется отгул на один или несколько полных рабочих дней. Это самый распространённый случай.

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

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

Когда: сотрудник отсутствует не целый день, а несколько часов внутри смены.

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

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

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

1. Оформляем документ по сценарию Урока 1 или Урока 2 (в зависимости от продолжительности).
2. Заполняем поле «В счет отработанных ранее дней» (РасходДнейОтгула) — сколько дней списать из накопленного остатка. Если часть баланса — в часах, заполняем и «и часов» (РасходЧасовОтгула).
3. Проводим документ.

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

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

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

Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year. Шапка содержит 34 реквизита; в документе 7 табличных частей. Расчётные ТЧ (Начисления, НачисленияПерерасчет, Показатели, распределительные) заполняются механизмом расчёта — не редактируйте их вручную без необходимости.

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

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

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

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

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

Платформенная проверка заполнения (fill_value_required = ShowError) — 8 реквизитов:

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

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

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

    // 1. Регистры учёта рабочего времени: отражение отсутствия в табеле и оперативном учёте.
    Движения.ДанныеТабельногоУчетаРабочегоВремениСотрудников;
    Движения.ДанныеОперативногоУчетаРабочегоВремениСотрудников;
    Движения.ОтработанноеВремяПоСотрудникам;          // + Корректировка при перерасчёте
    Движения.ВытесняемоеПлановоеВремяСотрудников;

    // 2. Регистр расчёта начислений (если ВидРасчета оплачиваемый).
    Движения.Начисления;   // CalculationRegister — периоды действия/регистрации

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

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

    // 5. Налоги: доходы физлиц (ИПН исчисляется механизмом ВидРасчета).
    Движения.СведенияОДоходахФизическихЛиц;

    // 6. Ключевой регистр: баланс дней/часов отгулов (накопление ← поступление; расход ← РасходДнейОтгула/РасходЧасовОтгула).
    Движения.ДниЧасыОтгулов;

    // 7. Состояния и штатное расписание.
    Движения.ДанныеСостоянийСотрудников;
    Движения.ЗанятостьПозицийШтатногоРасписания;      // при ОсвобождатьСтавку = Истина

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

    Движения.Записать();

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

Зависимости

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

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

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