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

Не каждое удержание из зарплаты — постоянное. Алименты или ОПВ считаются каждый месяц автоматически, а вот разовые удержания нужно зарегистрировать руками: сотрудник вернул часть займа, бухгалтерия удержала стоимость спецодежды, по исполнительному листу прошла единичная сумма, нужно вернуть переплату прошлого месяца. Для всего этого и служит документ «Регистрация разовых удержаний работников организаций».

Что он делает: - фиксирует, у кого, какой вид удержания и на какую сумму применяется в выбранном месяце; - уменьшает сумму к выплате — удержание подхватывается ведомостью на выплату зарплаты; - ведёт взаиморасчёты с работником (например, остаток непогашенного займа) в специальном регистре; - отражает удержанные суммы в данных для налоговой отчётности по зарплате (ИПН, формы по зарплате).

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

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

Раздел «Зарплата» → группа «Удержания» → пункт «Регистрация разовых удержаний работников организаций». Откроется журнал документов; новый создаём кнопкой «Создать».

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

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

Урок 1. Разовое удержание у нескольких сотрудников

Когда: нужно зарегистрировать удержание у 1–5 человек — например, разовое погашение займа или возврат переплаты.

Шаг 1. Создаём документ

«Создать» в журнале. Откроется пустая форма документа.

Шаг 2. Заполняем шапку

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

Шаг 3. Добавляем сотрудников и виды удержаний

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

Шаг 4. Рассчитываем

Нажимаем кнопку «Рассчитать» на командной панели. Система пройдёт по строкам, применит алгоритм каждого вида удержания к Размеру и заполнит колонку «Результат» — итоговую сумму удержания в тенге.

Шаг 5. Проводим

«Провести» или «Записать и закрыть».

Урок 2. Заполнение по списку сотрудников подразделения

Когда: одно и то же удержание нужно применить ко всем сотрудникам подразделения (классика — удержание за спецодежду).

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

Урок 3. Заполнение по другому документу

Когда: нужно повторить состав удержаний из прошлого месяца — например, продолжаем погашать заём теми же людьми.

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

Урок 4. Ручная корректировка результата

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

1. Открываем документ.
2. В шапке ставим флаг «Ручная корректировка».
3. Колонка «Результат» становится доступной для ручного ввода — вписываем нужные суммы.
4. «Записать» → «Провести».

Урок 5. Пересчёт проведённого документа

Проведённый документ пересчитать «на месте» нельзя. Если изменили Размер или добавили строки:

1. Открываем документ.
2. Жмём «Рассчитать» — программа сама предложит отменить проведение (расчёт по проведённому документу заблокирован). Соглашаемся.
3. Документ распроводится, расчёт выполнится, колонка «Результат» обновится.
4. Снова «Провести».

Урок 6. Печать ведомости удержаний

1. Открываем записанный документ.
2. «Печать» → «Ведомость удержаний» (единственная печатная форма документа).
3. Проверяем табличный документ, печатаем или сохраняем в файл.

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

Источник: реальный код релиза 3.0.72.1 (Documents/РегистрацияРазовыхУдержанийРаботниковОрганизаций/Ext/ObjectModule.bsl и …/Ext/ManagerModule.bsl), метаданные документа из конфигурации, плюс разбор objects/ и business-logic/.

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

Реквизиты шапки (имена — точно из метаданных):

Табличная часть Удержания:

Формы: ФормаДокумента (основная), ФормаСписка (с групповым изменением), ФормаВыбора. Печатная форма (макет): ПФ_MXL_ВедомостьУдержаний («Ведомость удержаний»).

Приоритет способа отражения (3 уровня, по убыванию): 1) колонка Удержания.СпособОтраженияВБухучете → 2) шапка СпособОтраженияВБухучете → 3) способ из вида расчёта (ВидРасчета).

Жизненный цикл обработчиков (ObjectModule)

Отдельно, в ManagerModule:

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

Главное: документ не делает проводок Дт/Кт. ОбработкаПроведения пишет в два регистра накопления по зарплате через серверный модуль РасчетЗарплатыСервер. Бухгалтерское отражение — задача отдельного документа «Отражение зарплаты в бухучёте».

Источник — ObjectModule.bsl, процедура ОбработкаПроведения (реальный код, без сокращений):

Процедура ОбработкаПроведения(Отказ, РежимПроведения)

    // ПОДГОТОВКА ПРОВЕДЕНИЯ ПО ДАННЫМ ДОКУМЕНТА

    ПроведениеСервер.ПодготовитьНаборыЗаписейКПроведению(ЭтотОбъект);
    Если РучнаяКорректировка Тогда
        Возврат;
    КонецЕсли;

    ПараметрыПроведения = Документы.РегистрацияРазовыхУдержанийРаботниковОрганизаций.ПодготовитьПараметрыПроведения(Ссылка, Отказ);
    Если Отказ Тогда
        Возврат;
    КонецЕсли;

    Реквизиты = ПараметрыПроведения.Реквизиты[0];

    ТаблицаВыплаченныеДоходы = РасчетЗарплатыСервер.ПодготовитьТаблицуВыплаченныеДоходыНУ(Реквизиты,
                                                                                    ПараметрыПроведения.Удержания,
                                                                                    Движения.ВыплаченныеДоходыРаботникамОрганизацийНУ.ВыгрузитьКолонки(),
                                                                                    ВидДвиженияНакопления.Приход,
                                                                                    Отказ);

    РасчетЗарплатыСервер.СформироватьДвижения(ТаблицаВыплаченныеДоходы,      "ВыплаченныеДоходыРаботникамОрганизацийНУ", Движения, Отказ);

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

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

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

Кто что формирует (вызов → смысл):

А вот функция сбора параметров — ManagerModule.ПодготовитьПараметрыПроведения (фрагмент реального кода, начало):

Функция ПодготовитьПараметрыПроведения(Ссылка, Отказ) Экспорт

    ПараметрыПроведения = Новый Структура;

    Запрос = Новый Запрос;
    Запрос.МенеджерВременныхТаблиц = Новый МенеджерВременныхТаблиц;
    Запрос.УстановитьПараметр("Ссылка", Ссылка);
    Запрос.УстановитьПараметр("Период", КонецМесяца(Ссылка.ПериодРегистрации));
    // … ТекстЗапросаРеквизитыДокумента → ПараметрыПроведения.Реквизиты …
    // … учёт функциональной опции "ПоддержкаРаботыСоСтруктурнымиПодразделениями" …
    // … определение Налогоплательщика по структурному подразделению …
    // … ТекстЗапросаУдержания → ПараметрыПроведения.Удержания …

    Возврат ПараметрыПроведения;

КонецФункции

Важные детали из кода: - Период = КонецМесяца(Ссылка.ПериодРегистрации) — внутри проведения период всегда приводится к концу месяца. Подтверждает: ПериодРегистрации — это месяц, а не день. - Учитывается функциональная опция ПоддержкаРаботыСоСтруктурнымиПодразделениями: от неё зависит, как определяется налогоплательщик (по структурной единице или по организации) — важно для корректного НУ при обособленных подразделениях. - В структуру ПараметрыПроведения кладутся как минимум Реквизиты (шапка) и Удержания (нормализованная ТЧ) — именно их потребляет ОбработкаПроведения.

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

Бухгалтерских проводок (Хозрасчетный/Типовой, Налоговый по счетам) документ НЕ формирует. Это типовая для зарплатного контура схема: расчётные документы пишут в зарплатные регистры, а проводки в план счетов делает документ «Отражение зарплаты в бухучёте» (Документ.ОтражениеЗарплатыВБухучете) / «Отражение зарплаты в регламентированном учёте» (Документ.ОтражениеЗарплатыВРеглУчете). Оба объекта присутствуют в конфигурации 3.0.72.1.

Валидации

Явных проверок в ObjectModule нет. Фактически обязательность обеспечивается так: - Свойства метаданных «Заполнять проверку = ВыдаватьОшибку» для Организация и ПериодРегистрации (ShowError) → срабатывают при стандартной ПроверитьЗаполнение(). - ManagerModule.Рассчитать перед расчётом вызывает ДокументОбъект.ПроверитьЗаполнение() и при провале — выходит (расчёт не выполняется). - Проведение без расчёта: с пустой колонкой Результат движения соберутся некорректно/пусто — поэтому на практике обязателен предварительный «Рассчитать» (кроме режима ручной корректировки, где Результат вводится руками). - RLS: ЗаполнитьНаборыЗначенийДоступа ограничивает доступ по организации, подразделению и списку физлиц — пользователь без прав на физлицо/организацию документ не увидит/не проведёт.

Зависимости (общие модули)

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

1. Два этапа — расчёт и проведение разделены. Рассчитать (ManagerModule) лишь заполняет Результат; движения пишутся в ОбработкаПроведения. При автоматизации: сначала Документы.…Рассчитать(Объект) (или через форму), затем Записать(РежимЗаписиДокумента.Проведение).
2. РучнаяКорректировка = Истина → ранний Возврат в ОбработкаПроведения сразу после ПодготовитьНаборыЗаписейКПроведению. Авто-движения не формируются — отвечает пользователь.
3. Пересчёт проведённого заблокирован: цепочка из формы — отмена проведения → расчёт → проведение (ПослеЗакрытияВопросаПередРассчетом). В коде: ОтменитьПроведение() → Рассчитать() → Провести().
4. Имя колонки физлица: метаданное Физлицо, строковый литерал в типовом коде — "ФизЛицо" (см. [KZ30-RRU-01]). Для надёжности обращайтесь к Удержания[i].Физлицо как к свойству объекта.
5. Период всегда к месяцу: КонецМесяца(ПериодРегистрации) в проведении. Фильтры сотрудников и движения завязаны на месяц, не на день.
6. Функциональная опция ПоддержкаРаботыСоСтруктурнымиПодразделениями меняет определение налогоплательщика — учитывайте при тестах с обособленными подразделениями.

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

• nachislenie-zarplaty — начисление зарплаты: формирует доход, на фоне которого считаются удержания.
• otrazhenie-zarplaty-v-buhuchete — документ, который делает бухгалтерские проводки по зарплате и удержаниям (Дт/Кт по плану счетов КЗ).
• vedomost-na-vyplatu-zarplaty — ведомость на выплату: подхватывает разовые удержания и уменьшает сумму к выдаче.

🆕 Что нового