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

Сотрудник подал заявление о добровольном перечислении пенсионных взносов из своей зарплаты в пенсионный фонд — это нужно зарегистрировать как плановое удержание и указать, что вычет по ИПН применяется (или нет). В казахстанском учёте получатель ДПВ — ЕНПФ (Единый накопительный пенсионный фонд); реквизит документа называется «НПФ» исторически — выбирается из справочника Контрагенты.

Документ списковый: в одном документе можно охватить сразу несколько сотрудников организации — они перечисляются в табличной части «Удержания». Режим работы документа задаётся реквизитом Действие (назначить / изменить / прекратить); при изменении или прекращении документ ссылается на исходное назначение через ДокументОснование.

Важная особенность РК: сумма ДПВ уменьшает облагаемый доход по ИПН как социальный налоговый вычет у работодателя. Флаг НеПредоставлятьСоциальныйВычетУРаботодателя блокирует вычет — его ставят, если сотрудник заявит вычет самостоятельно (двойное применение недопустимо). Кто работает: расчётчик зарплаты — по заявлениям сотрудников, обычно несколько раз в месяц при поступлении новых заявлений.

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

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

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

Проходим по шагам: от пустого документа до зарегистрированного планового удержания ДПВ.

Урок 1. Назначить удержание ДПВ группе сотрудников

Когда: один или несколько сотрудников подали заявления о перечислении добровольных пенсионных взносов из зарплаты в ЕНПФ. Это основной сценарий — первое назначение.

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

Урок 2. Изменить размер или прекратить удержание

Когда: сотрудник изменил заявленный размер ДПВ, либо отозвал заявление (уволился).

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

Урок 3. Управление социальным вычетом по ИПН

Когда: нужно решить, уменьшает ли сумма ДПВ налоговую базу по ИПН у этого работодателя.

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

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

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

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

Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year (в пределах года). В шапке 16 реквизитов, 3 табличные части. Формы и BSL-модули в выгрузке отсутствуют (forms: [], bsl_static: [], bsl_summaries: []) — соответствующие разделы помечены как реконструкция по метаданным.

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

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

Колоночный состав ТЧ Удержания: ФизическоеЛицо (UI: «Сотрудник», тип CatalogRef.ФизическиеЛица), РабочееМесто (CatalogRef.Сотрудники), Размер (xs:decimal), ИдентификаторСтрокиВидаРасчета (xs:decimal — технический ключ связи с ТЧ «Показатели»).

Колоночный состав ТЧ Показатели: Показатель (CatalogRef.ПоказателиРасчетаЗарплаты), Значение (составной тип), ИдентификаторСтрокиВидаРасчета (xs:decimal).

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

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

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

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

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

Схема проведения (реконструкция): документ записывает назначение планового удержания в 5 регистров сведений — никаких движений по регистрам расчёта зарплаты.

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

    // 0. Контроль заполнения: Организация, Удержание, ДатаНачала, Действие,
    //    ДокументОснование, НПФ, СтатьяФинансирования, СтатьяРасходов.

    // 1. Плановое удержание: для каждой строки ТЧ «Удержания» —
    //    физлицо, рабочее место, размер, период действия (ДатаНачала/ДатаОкончания),
    //    вид удержания. Режим записи определяет Действие (назначение/изм./прекращение).
    Движения.ПлановыеУдержания;

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

    // 3. Привязка к рабочему месту (колонка РабочееМесто из ТЧ «Удержания»).
    Движения.РабочиеМестаУдержаний;

    // 4. Бухучёт: статьи финансирования и расходов, способ отражения.
    Движения.БухучетПлановыхУдержаний;

    // 5. Вычет ИПН: признак предоставления/непредоставления социального вычета.
    //    Зависит от НеПредоставлятьСоциальныйВычетУРаботодателя.
    Движения.ПредоставлениеСоциальныхВычетовУРаботодателя;

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

    // ВАЖНО: денежных проводок нет. Фактические суммы ДПВ появятся
    // в документе «Начисление зарплаты» за соответствующий месяц.

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

Зависимости

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

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

• Исполнительный лист — другое плановое удержание из зарплаты: сравните механику назначения и регистры.
• Начисление зарплаты и взносов — здесь плановые удержания ДПВ превращаются в фактические суммы; ИПН исчисляется с учётом вычета из ПредоставлениеСоциальныхВычетовУРаботодателя.