Урок 2. Изменить размер действующего удержания

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

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

Урок 3. Прекратить удержание

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

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

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

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

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

Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year (в пределах года). В шапке 15 реквизитов; три табличных части. Документ является исключительно «плановым»: регистров накопления и бухгалтерских регистров нет — только регистры сведений.

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

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

ТЧ «Удержания» — список сотрудников, которым назначается удержание, и размер по каждому.

ТЧ «Показатели» — значения показателей расчёта для формулы вида удержания.

ТЧ «ДополнительныеРеквизиты» — стандартный механизм дополнительных реквизитов (подсистема «Свойства»).

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

Документ пишет исключительно в 4 регистра сведений. Регистров накопления и бухгалтерских регистров нет — сам документ не формирует начислений и проводок; фактическое удержание возникнет при расчёте зарплаты.

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

Обязательность реквизитов из fill_value_required: ShowError — то, что платформа проверяет автоматически перед записью:

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

Схема проведения (реконструкция по metadata.register_records): документ пишет только в регистры сведений — никаких записей в регистры накопления или бухгалтерии.

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

    // 1. Основная запись планового удержания.
    //    Что удерживать, кому, с какой даты, размер — из ТЧ «Удержания».
    Движения.ПлановыеУдержания;

    // 2. Привязка к рабочим местам (для физлиц с несколькими местами работы).
    //    Из пары ФизическоеЛицо + РабочееМесто каждой строки ТЧ «Удержания».
    Движения.РабочиеМестаУдержаний;

    // 3. Периодические значения показателей расчётной формулы.
    //    Из ТЧ «Показатели»; строки связаны с ТЧ «Удержания» через
    //    ИдентификаторСтрокиВидаРасчета.
    Движения.ЗначенияПериодическихПоказателейРасчетаЗарплатыСотрудников;

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

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

    // Фактическое удержание суммы произойдёт ПОЗЖЕ — при расчёте
    // документа «Начисление зарплаты» за период начиная с ДатаНачала.

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

Зависимости

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

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

• Исполнительный лист — аналогичный механизм удержания; отличие в периодичности и основании (исполнительный документ vs. плановое заявление).
• Начисление зарплаты и взносов — именно здесь плановые удержания из регистра ПлановыеУдержания превращаются в фактически удержанные суммы с расчётом ИПН, ОПВ и других платежей.