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