1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ЗаявлениеНаПредоставлениеВычетовИПНПрисоединенныеФайлы |
| Полное имя | Справочник.ЗаявлениеНаПредоставлениеВычетовИПНПрисоединенныеФайлы |
| Синоним | — (не задан; для служебных справочников файлов синоним обычно пуст) |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0, версия 3.0.74.2 |
| Владелец файлов | Документ.ЗаявлениеНаПредоставлениеВычетовИПН |
| Подсистема-механизм | «Работа с файлами» (БСП, РаботаСФайлами) |
Назначение. Служебный справочник — хранилище файлов, присоединённых к документам «Заявление на предоставление вычетов ИПН». Реализует типовой механизм файловых приложений: к заявлению работника прикрепляются сканы, PDF, изображения и иные документы, подтверждающие право на налоговый вычет по ИПН (заявление, подтверждающие справки, документы на стандартные и прочие вычеты). Пользователь не работает со справочником напрямую — записи создаются и открываются автоматически из карточки документа-владельца командами «Присоединить файл», «Открыть», «Сохранить как», «Подписать ЭП». Целевая аудитория — бухгалтер по расчёту зарплаты и кадровик, оформляющие первичные документы для отчётности по ИПН.
Контекст 2026 (РК). Документ-владелец обеспечивает применение базового налогового вычета по ИПН 30 МРП в месяц (не более 360 МРП в год), где 1 МРП = 4 325 ₸. ИПН исчисляется по ставке 10 % до годового дохода 8 500 МРП и 15 % сверх. МЗП = 85 000 ₸. Сам справочник расчётов не выполняет — он лишь хранит приложенные к заявлению файлы-основания.
Где найти. Прямой список (служебный, обычно скрыт из командного интерфейса):
e1cib/list/Справочник.ЗаявлениеНаПредоставлениеВычетовИПНПрисоединенныеФайлы
Штатный доступ — из формы документа «Заявление на предоставление вычетов ИПН» → панель/команда «Присоединённые файлы».
2. Реквизиты шапки и табличные части
2.1 Реквизиты (из evidence + типовой состав подсистемы «Работа с файлами»)
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи | Обязательный (ShowError) | Пользователь, первоначально загрузивший файл. Заполняется автоматически при создании. |
| ВладелецФайла | ДокументСсылка.ЗаявлениеНаПредоставлениеВычетовИПН | Необязательный | Ссылка на документ-владелец, к которому присоединён файл. |
| ДатаМодификацииУниверсальная | Дата (xs:dateTime, UTC) | Необязательный | Универсальная дата/время последнего изменения файла. Синхронизация и контроль версий. |
| ДатаСоздания | Дата (xs:dateTime, UTC) | Обязательный (ShowError) | Дата/время создания записи о файле в ИБ. |
| Зашифрован | Булево | Необязательный | Признак зашифрованного файла (работа с конфиденциальными данными). |
| Изменил | СправочникСсылка.Пользователи | Необязательный | Пользователь, последним изменивший запись/файл. |
| ИндексКартинки | Число | Необязательный | Индекс иконки типа файла в коллекции изображений интерфейса. |
| Описание | Строка | Необязательный | Комментарий пользователя к содержимому файла. |
| ПодписанЭП | Булево | Необязательный | Признак наличия электронной подписи (юридически значимый документооборот). |
| ПутьКФайлу | Строка | Необязательный | Путь к файлу на томе (при хранении «В томах на диске»). |
| Размер | Число | Необязательный | Размер файла в байтах. |
| Расширение | Строка | Необязательный | Расширение файла (pdf, docx, jpg …). |
| Редактирует | СправочникСсылка.Пользователи | Необязательный | Пользователь, редактирующий файл сейчас (блокировка от конфликтов). |
| СтатусИзвлеченияТекста | ПеречислениеСсылка.СтатусыИзвлеченияТекстаФайлов | Необязательный | Статус извлечения текста для полнотекстового поиска. |
| ТекстХранилище | Хранилище значения | Необязательный | Извлечённый текст файла для полнотекстового индекса. (типовой реквизит подсистемы) |
| ТипХранилищаФайла | Перечисление | Необязательный | Способ хранения: в ИБ / в томах на диске. (типовой реквизит подсистемы) |
| ТомХранения | СправочникСсылка.ТомаХраненияФайлов | Необязательный | Том, где физически лежит файл (при хранении на диске). (типовой реквизит подсистемы) |
| Наименование (стандартный) | Строка | — | Имя файла без расширения; отображаемое имя записи справочника. |
Реквизиты Автор, Изменил, Редактирует образуют стандартную для БСП тройку контроля владения и блокировки версии.
2.2 Табличные части
Табличные части отсутствуют — это типично для справочника присоединённых файлов. Двоичные данные файла хранятся не в реквизите-строке, а либо в реквизите типа «Хранилище значения» (хранение в ИБ), либо в томе на диске (реквизиты ТипХранилищаФайла/ТомХранения/ПутьКФайлу), либо в отдельной таблице версий (при включённом версионировании).
3. Формы
Справочник использует минимальный набор форм; вся интерактивная работа проходит через универсальные формы подсистемы «Работа с файлами».
| Форма | Назначение |
|---|---|
Форма элемента (ФормаЭлемента) |
Карточка файла: имя, описание, автор, даты, размер, признаки «Подписан ЭП» / «Зашифрован». Как правило используется общая форма БСП. |
Форма списка (ФормаСписка) |
Список файлов, присоединённых к конкретному заявлению. Обычно замещается общей формой РаботаСФайламиКлиент / панелью присоединённых файлов. |
Форма выбора (ФормаВыбора) |
Выбор файла из уже присоединённых (при вставке ссылки на файл в другие объекты). |
На практике формы прикрепления, просмотра и подписания предоставляет БСП (общие формы ПрисоединенныеФайлы, РаботаСФайлами), поэтому собственные формы справочника могут быть не заданы либо переопределять оформление.
4. Ключевые процедуры модулей
BSL-код в evidence не приложен, поэтому ниже — типовой для справочника присоединённых файлов набор обработчиков (реализуется в модуле объекта, модуле менеджера и через общие модули подсистемы «Работа с файлами»).
Модуль объекта:
ПередЗаписью(Отказ)— фиксируетИзменилиДатаМодификацииУниверсальная, пересчитываетРазмер, при необходимости сбрасываетСтатусИзвлеченияТекстав «ТребуетсяИзвлечение».ПриКопировании(ОбъектКопирования)— очищает признаки подписи/шифрования и владения (ПодписанЭП,Зашифрован,Редактирует), чтобы копия не наследовала блокировки.ОбработкаЗаполнения(ДанныеЗаполнения, …)— установкаАвтор,ДатаСоздания,ВладелецФайлапри создании из документа.
Модуль менеджера:
- Обработчики выгрузки/загрузки данных обмена, регистрация в подписках подсистемы файлов.
Общие модули подсистемы (вызываются вместо собственного кода объекта):
РаботаСФайламиСлужебный.ДобавитьФайл(...)— создание записи справочника, помещение двоичных данных в хранилище/том.РаботаСФайлами.ОткрытьФайл(...)/.СохранитьФайлКак(...)— получение и открытие данных файла.ЭлектроннаяПодписьКлиент/Сервер— установка признакаПодписанЭП, добавление подписей.ИзвлечениеТекстаСервер— фоновое заполнениеТекстХранилищеиСтатусИзвлеченияТекстадля полнотекстового поиска.
Требует проверки (версионно): конкретный состав переопределённых процедур модуля объекта в сборке 3.0.74.2 — определяется по Конфигуратору, так как БСП периодически переносит логику из объектов в общие модули.
5. Проведение и движения
Справочник не проводится и не формирует движений по регистрам — у объекта типа «Справочник» отсутствует механизм проведения. Соответственно:
- бухгалтерских проводок по счетам РК (1210, 1030, 1330, 3310, 3130, 6010, 7010) объект не создаёт;
- в регистры расчёта ИПН/налоговых вычетов не пишет;
- электронные документы (ЭСФ в ИС ЭСФ, СНТ) не формирует — эти механизмы к присоединённым файлам не относятся.
Единственные записи, которые порождает объект, — строка самого справочника и, опционально:
- запись двоичных данных в хранилище (в ИБ) либо файл в томе хранения (регистр/справочник
ТомаХраненияФайлов); - запись версии файла (если для владельца включено версионирование);
- обновление данных полнотекстового поиска.
Экономический результат (применение вычета 30 МРП/мес, но не более 360 МРП/год, исчисление ИПН 10 %/15 %, удержания ОПВ 10 %, ОПВР 3,5 %, ВОСМС 2 %, ОСМС 3 %, взносы СО 5 % и соцналог 6 %) формирует документ-владелец «Заявление на предоставление вычетов ИПН» и последующий расчёт зарплаты, а не данный справочник. Присоединённый файл выступает лишь документальным основанием.
6. Связанные объекты и ввод на основании
| Связь | Объект | Характер |
|---|---|---|
| Владелец файлов | Документ.ЗаявлениеНаПредоставлениеВычетовИПН |
Каждая запись справочника принадлежит одному заявлению (ВладелецФайла). |
| Пользователи | Справочник.Пользователи |
Реквизиты Автор, Изменил, Редактирует. |
| Тома хранения | Справочник.ТомаХраненияФайлов |
Физическое размещение файла при хранении на диске. |
| Статусы | Перечисление.СтатусыИзвлеченияТекстаФайлов |
Состояние индексации текста. |
| Электронная подпись | Подсистема ЭП/криптографии БСП | Признак ПодписанЭП, хранение подписей. |
Ввод на основании. Классический механизм «Ввод на основании» для справочника не применяется. Записи создаются командами прикрепления файлов из формы документа-владельца; отдельного ввода других документов на основании файла нет.
7. Точки расширения
- Расширение конфигурации (Adopt/Extend). Заимствование формы элемента/списка для добавления собственных реквизитов отображения или кнопок. Изменять состав хранимых полей файла не рекомендуется — нарушится совместимость с БСП.
- Дополнительные реквизиты и сведения. Подключение объекта к подсистеме «Свойства» (
ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения) для метки типа документа-основания (например, «Заявление», «Подтверждающая справка»). - Подписки на события.
ПередЗаписью/ПриЗаписисправочника — для аудита загрузки/изменения файлов и контроля обязательного наличия ЭП на юридически значимых сканах. - Правила обмена (КД 2/3, EnterpriseData). Настройка выгрузки присоединённых файлов вместе с документом-владельцем в синхронизации.
- Полнотекстовый поиск. Использование
ТекстХранилище/СтатусИзвлеченияТекстадля поиска по содержимому приложенных PDF/сканов. - Ограничение прав (RLS). Настройка доступа к файлам по владельцу — актуально для персональных данных работников в заявлениях по ИПН.