Документ «Приз, подарок»

1. Назначение и место в учёте

«Приз, подарок» — документ конфигурации «Зарплата и управление персоналом для Казахстана 3.1», которым регистрируется выдача сотрудникам (а по структуре ТЧ — и иным физическим лицам) призов и подарков: вид выплаты, стоимость (доход), налог с дохода и применённые вычеты. Используется расчётчиком зарплаты эпизодически — к праздникам, юбилеям, конкурсам; в шапке предусмотрены мотив поощрения, признак «предусмотрено коллективным договором» и реквизиты первичного документа (приказа). Казахстанская специфика: призы и подарки облагаются ИПН сверх необлагаемого предела; при этом налоговый блок документа использует терминологию НДФЛ (коды дохода/вычетов НДФЛ, регистры НДФЛ) — это наследие российской типовой ЗУП, на котором построена конфигурация. При проведении документ пишет в 14 регистров расчётного контура: доходы, налог, вычеты, взаиморасчёты с сотрудниками и зарплату к выплате. Нумерация строковая (11 символов) с годовой периодичностью; размещение в меню в карте не зафиксировано (forms и commands пусты).

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

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

Все реквизиты из metadata.attributes. Обязательность — по fill_value_required (ShowError = обязательное поле).

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

Объект имеет 6 табличных частей. Связи: ТЧ «НДФЛ» детализирует налог по физлицам; ТЧ «ПримененныеВычетыНаДетейИИмущественные» привязана к строкам ТЧ «НДФЛ» через ИдентификаторСтрокиНДФЛ.

ТЧ «Начисления» (синоним: Начисления)

Назначение: основной список получателей-сотрудников с суммой дохода, вычетом и налогом по каждому.

ТЧ «ФизическиеЛица» (синоним: Физические лица)

Назначение: список физических лиц — получателей (структура позволяет регистрировать получателей по физлицу, а не только по сотруднику).

ТЧ «НачисленияПерерасчет» (синоним: Начисления перерасчет)

Назначение: строки перерасчёта/сторнирования ранее зарегистрированных начислений; повторяет структуру ТЧ Начисления плюс служебные поля сторно.

ТЧ «ДополнительныеРеквизиты» (синоним: Дополнительные реквизиты)

Назначение: стандартный механизм дополнительных реквизитов БСП.

ТЧ «НДФЛ» (синоним: НДФЛ)

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

ТЧ «ПримененныеВычетыНаДетейИИмущественные» (синоним: Примененные вычеты на детей и имущественные)

Назначение: детальные применённые вычеты (на детей, имущественные) к строкам налога; механизм стандартных/имущественных вычетов — наследие российской типовой.

2.3 Формы

(не определено) — в JSON-карте списки metadata.forms и forms пусты; UI-структура форм не выгружена, ключевую форму по карте определить нельзя.

3. Сценарии работы

Карта не содержит форм, команд и BSL-модулей; сценарии синтезированы из метаданных (реквизиты, ТЧ, based_on, регистры движения). Достоверно известные проверки — обязательность пяти полей шапки (ShowError).

3.1 Сценарий: «Регистрация подарков сотрудникам к празднику» (Create)

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

3.2 Сценарий: «Ввод на основании сотрудника»

• Когда применяется: подарок одному сотруднику — быстрый ввод из его карточки.
• Шаги пользователя: 1. В справочнике Сотрудники выбрать сотрудника и выполнить «Создать на основании» → «Приз, подарок» (metadata.based_on = Catalog.Сотрудники). 2. Документ создаётся с подставленным получателем; заполнить обязательные поля шапки и Результат в строке. 3. Провести.
• На что обратить внимание: какие именно поля автозаполняются при вводе на основании — в карте не зафиксировано (BSL отсутствует); проверить строку ТЧ Начисления после создания.
• Проверки: те же пять обязательных полей.

3.3 Сценарий: «Приз физическому лицу (не сотруднику)»

• Когда применяется: получатель приза — физлицо, не оформленное сотрудником (например, участник конкурса). Структурно поддерживается отдельной ТЧ ФизическиеЛица (единственная колонка ФизическоеЛицо) и колонкой ФизическоеЛицо в ТЧ НДФЛ.
• Шаги пользователя: 1. Заполнить шапку (включая обязательные поля). 2. В ТЧ ФизическиеЛица указать получателей-физлиц. 3. Проконтролировать налоговый блок в ТЧ НДФЛ (ФизическоеЛицо, МесяцНалоговогоПериода, Налог, КатегорияДохода). 4. Провести.
• На что обратить внимание: точная логика взаимодействия ТЧ ФизическиеЛица с расчётом в карте не зафиксирована (BSL пуст); по метаданным это отдельный список получателей без сумм — суммы и налог живут в ТЧ Начисления/НДФЛ.

3.4 Сценарий: «Перерасчёт / сторнирование ранее выданного приза»

• Когда применяется: нужно сторнировать или пересчитать начисление прошлого периода (ошибочная сумма, отмена выдачи).
• Шаги пользователя: 1. В новом документе заполнить ТЧ НачисленияПерерасчет: Сотрудник, Результат, Сторно=Истина для сторнирующих строк, СторнируемыйДокумент и ПериодДействия — ссылка на исходное начисление и его период; служебные поля РегистраторРазовогоНачисления / ИсходныйДокумент идентифицируют источник. 2. Провести.
• На что обратить внимание: сторно-строки уменьшают ранее зарегистрированные доход и налог; механика заполнения (вручную или автоматически при перерасчёте) в карте не зафиксирована.
• Проверки: (в карте не определено).

3.5 Сценарий: «Исправление проведённого документа»

• Когда применяется: проведённый документ содержит ошибку, правка напрямую нежелательна (закрытый период).
• Шаги пользователя: 1. Создать новый документ «Приз, подарок» с заполненным реквизитом ИсправленныйДокумент (ссылка на ошибочный документ этого же вида). 2. Указать корректные данные, провести.
• На что обратить внимание: тип реквизита — cfg:DocumentRef.ПризПодарок, т.е. исправление строго документом того же вида.

3.6 Сценарий: «Проверка и ручная корректировка налога» (Read/Update)

• Когда применяется: расчётчик проверяет автоматический расчёт налога и вычетов перед выплатой.
• Шаги пользователя: 1. Открыть документ, проверить в ТЧ Начисления: Результат, СуммаВычета, НДФЛ, НДФЛСПревышения. 2. При ручной правке значений выставляются фикс-флаги (ФиксРасчет, ФиксЗаполнение, ФиксСуммаВычета, ФиксНДФЛ; в ТЧ НДФЛ — ФиксСтрока, ФиксРасчет) — фиксируют ручные значения от перезаполнения. 3. Детальный налог смотреть в ТЧ НДФЛ, применённые вычеты на детей/имущественные — в ТЧ ПримененныеВычетыНаДетейИИмущественные (связь по ИдентификаторСтрокиНДФЛ). 4. Перепровести документ.
• На что обратить внимание: при изменении сумм пересчёт зафиксированных (Фикс*) строк не выполняется — это смысл фикс-флагов по их синонимам; точная логика в карте не выгружена.

4. Per-field reference

BSL-модули в карте отсутствуют (bsl_static и bsl_summaries пусты) — обработчики ПриИзменении не зафиксированы; влияние полей указано только там, где оно следует из структуры метаданных. Валидация достоверна только для полей ShowError.

• ПериодРегистрации (xs:dateTime): месяц отражения начисления в учёте; обязателен (ShowError); типичное значение — первое число месяца выплаты.
• Организация (cfg:CatalogRef.Организации): организация-даритель; обязателен (ShowError); разрез всех движений.
• ВидПризаПодарка (cfg:EnumRef.ВидыПризовПодарков): «Вид выплаты» — приз или подарок; обязателен (ShowError); ключевой классификатор, определяющий квалификацию выплаты; выбирать сразу после организации.
• ДатаПолученияДохода (xs:dateTime): дата фактического получения дохода; обязателен (ShowError); определяет, к какому налоговому периоду относится доход (колонка МесяцНалоговогоПериода в ТЧ НДФЛ).
• КодДоходаНДФЛ (cfg:CatalogRef.ВидыДоходовНДФЛ): код дохода налогового учёта; обязателен (ShowError); терминология НДФЛ — наследие типовой, в КЗ-учёте определяет классификацию дохода для ИПН.
• КодВычетаНДФЛ (cfg:CatalogRef.ВидыВычетовНДФЛ): код вычета — необлагаемой части стоимости подарка/приза (казахстанская специфика: ИПН берётся сверх необлагаемого предела); необязателен; парный показатель в строках — СуммаВычета.
• ВидДоходаСтраховыеВзносы (cfg:CatalogRef.ВидыДоходовПоСтраховымВзносам): классификация дохода для взносов; необязателен; терминология «страховые взносы» — наследие российской типовой.
• Начислено / Удержано (xs:decimal): итоговые суммы документа (начислено дохода / удержано налога); необязательны; заполняются по данным ТЧ.
• ПредусмотреноКолдоговором (xs:boolean): подарок предусмотрен коллективным договором; необязателен; влияет на квалификацию выплаты в учёте.
• ИсключаетсяИзРасчетнойБазыИсполнительныхЛистов (xs:boolean): исключение из базы исполнительных листов; необязателен; связан с регистром ДополнениеРасчетнойБазыУдержаний.
• СпособОтраженияЗарплатыВБухучете / СтатьяРасходов / СтатьяФинансирования: учётная аналитика отражения (счёт-субконто, статья расходов, финансирование); необязательны; питают бухгалтерские регистры (БухучетНачисленияУдержанияПоСотрудникам, БухгалтерскиеВзаиморасчетыССотрудниками).
• МотивПоощрения (xs:string): текст мотива для приказа; необязателен.
• НаименованиеПервичногоДокумента / ДатаПервичногоДокумента / НомерПервичногоДокумента: реквизиты первичного документа-основания (приказа о поощрении); необязательны.
• ИсправленныйДокумент (cfg:DocumentRef.ПризПодарок): ссылка на исправляемый документ; необязателен; заполняется только в исправлениях.
• ОтношениеКЕНВД (cfg:EnumRef.ОтношениеКЕНВДЗатратНаЗарплату): наследие российской типовой, в РК не используется — оставлять пустым.
• УдалитьВидДоходаСтраховыеВзносы, УдалитьКодВычетаНДФЛ, УдалитьКодДоходаНДФЛ, УдалитьСотрудник, УдалитьФизическоеЛицо: устаревшие реквизиты с префиксом «Удалить» (и справочники-типы с тем же префиксом) — не заполнять.
• Начисления.Результат (xs:decimal): стоимость приза/подарка по сотруднику — главное числовое поле строки.
• Начисления.НДФЛ / НДФЛСПревышения (xs:decimal): исчисленный налог и налог с превышения (превышение — механизм прогрессии НДФЛ РФ, наследие типовой).
• Фикс-флаги (ФиксРасчет, ФиксЗаполнение, ФиксСуммаВычета, ФиксНДФЛ, ФиксСтрока): признаки ручной фиксации значений — зафиксированные строки/суммы не перезаполняются автоматическим расчётом.
• НДФЛ.КатегорияДохода (cfg:EnumRef.КатегорииДоходовНДФЛ): категория дохода («Вид дохода») в детализации налога.
• НДФЛ.ИдентификаторСтрокиНДФЛ (xs:decimal): ключ, по которому к строке налога привязываются вычеты из ТЧ ПримененныеВычетыНаДетейИИмущественные.

5. Бизнес-логика

• Обработчики событий: (не определено) — bsl_static и bsl_summaries в карте пусты, модули объекта и форм не выгружены.
• Проводки/движения: код ОбработкаПроведения в карте отсутствует; состав движений известен из metadata.register_records — 13 регистров накопления и 1 регистр сведений (полный список в 6.3). Логика по составу регистров: документ регистрирует доход (СведенияОДоходахНДФЛ, СведенияОДоходахСтраховыеВзносы), исчисленный налог и расчёты с бюджетом (РасчетыНалогоплательщиковСБюджетомПоНДФЛ, ДокументыУчтенныеПриРасчетеНДФЛ), применённые вычеты (ПредоставленныеСтандартныеИСоциальныеВычетыНДФЛ, ИмущественныеВычетыНДФЛ), начисление/взаиморасчёты и суммы к выплате (НачисленияУдержанияПоСотрудникам, ВзаиморасчетыССотрудниками, БухгалтерскиеВзаиморасчетыССотрудниками, БухучетНачисленияУдержанияПоСотрудникам, ЗарплатаКВыплате), вспомогательные базы (ДополнениеРасчетнойБазыУдержаний, ДанныеОНачисленияхДляРасчетаСреднегоЗаработкаФСС, АвансовыеПлатежиИностранцевПоНДФЛ).
• Валидации: по метаданным обязательны ПериодРегистрации, Организация, ВидПризаПодарка, ДатаПолученияДохода, КодДоходаНДФЛ (все ShowError). Содержимое ОбработкаПроверкиЗаполнения — (не определено).
• Зависимости от других модулей: (не определено) — связи по коду в карте не выгружены.

6. Связи с другими объектами

6.1 Документы-основания

Из metadata.based_on:

• Catalog.Сотрудники — документ можно ввести на основании элемента справочника «Сотрудники» (быстрая регистрация подарка конкретному сотруднику из его карточки).

6.2 Кто создаётся на основании этого

metadata.inverse_based_on пуст — в карте не зафиксировано документов, вводимых на основании «Приза, подарка».

6.3 Регистры движения

Полный список из metadata.register_records (14 регистров):

7. Заметки для ИИ-агента

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