1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВзаимозачетЗадолженностиПрисоединенныеФайлы |
| Полное имя | Справочник.ВзаимозачетЗадолженностиПрисоединенныеФайлы |
| Синоним | «Присоединённые файлы (Взаимозачёт задолженности)» |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4.5.21 |
| Подсистема-владелец | «Работа с файлами» (из состава Библиотеки стандартных подсистем, БСП) |
| Подчинён | справочник является служебным хранилищем присоединённых файлов документа Документ.ВзаимозачетЗадолженности |
Назначение. Справочник хранит метаданные и (опционально) двоичное содержимое файлов, присоединённых пользователем к документу «Взаимозачёт задолженности» (скан-копии актов сверки, соглашений о зачёте, писем контрагентов, подтверждающих первичных документов и т. п.). Это типовой объект механизма присоединённых файлов БСП: на каждый объект-владелец, к которому разрешено присоединять файлы, конфигуратор создаёт отдельный подчинённый справочник вида <ИмяВладельца>ПрисоединенныеФайлы. Сам по себе справочник не участвует в учёте и не формирует проводок — он обслуживает загрузку, версионирование, шифрование, электронную подпись и просмотр файлов.
Навигационная ссылка для открытия списка:
e1cib/list/Справочник.ВзаимозачетЗадолженностиПрисоединенныеФайлы
В штатной работе список не открывают напрямую — файлы просматриваются через команду «Присоединённые файлы» в форме документа «Взаимозачёт задолженности». Прямая навигационная ссылка используется преимущественно администратором/разработчиком для диагностики.
2. Реквизиты и табличные части
Структура соответствует шаблону присоединённых файлов БСП. Ключевой служебный признак — Владелец (Владелец, тип ДокументСсылка.ВзаимозачетЗадолженности): подчинённость реализована стандартным механизмом владельца справочника, поэтому в дереве реквизитов «Владелец» отдельным реквизитом не отображается, но доступен в запросах и коде.
2.1. Реквизиты шапки
| Реквизит | Тип | Назначение |
|---|---|---|
Наименование |
Строка | Имя файла без расширения (наименование элемента справочника) |
Расширение |
Строка | Расширение файла без точки (pdf, xlsx, png …) |
Автор |
СправочникСсылка.Пользователи | Пользователь, загрузивший файл |
ДатаСоздания |
Дата | Момент присоединения файла в базе |
ДатаМодификацииУниверсальная |
Дата | Дата последнего изменения содержимого (UTC) |
Размер |
Число | Размер актуального содержимого, байт |
ХранилищеФайла |
ХранилищеЗначения | Двоичные данные файла при хранении в базе данных (пусто при хранении в томе) |
ТомХранилищаФайлов |
СправочникСсылка.ТомаХранилищаФайлов | Том, в котором лежит файл при хранении на диске |
ПутьКФайлуВТоме |
Строка | Относительный путь к файлу внутри тома |
ТекстовоеСодержимое / ХранилищеТекста |
ХранилищеЗначения | Извлечённый текст файла для полнотекстового поиска |
Подписан |
Булево | Файл имеет хотя бы одну присоединённую электронную подпись |
Зашифрован |
Булево | Содержимое зашифровано средствами криптографии |
Редактирует |
СправочникСсылка.Пользователи | Пользователь, захвативший файл на редактирование (блокировка «занято») |
ИндексКартинки |
Число | Индекс пиктограммы по типу файла для отображения в списках |
КодЛокализации |
Строка | Код локали содержимого |
ВерсияВладельца |
Строка | Служебная отметка версии объекта-владельца на момент правки |
НомерВерсииБСП |
Число | Технический номер формата хранения файла (используется при миграциях БСП) |
2.2. Табличные части
| Табличная часть | Ключевые колонки | Назначение |
|---|---|---|
ЭлектронныеПодписи |
Подпись (ХранилищеЗначения), Сертификат, КомуВыдан, ДатаПодписания, Комментарий |
Хранит присоединённые ЭП файла и данные сертификатов |
ДанныеШифрования (при использовании шифрования) |
Сертификат, Представление, Отпечаток |
Сведения о сертификатах, которыми зашифрован файл |
Версионирование. Если в конфигурации включено хранение версий файлов, содержимое хранится не в самом элементе, а в подчинённом справочнике версий
ВзаимозачетЗадолженностиПрисоединенныеФайлыВерсии(или в связанном регистре версий), а реквизитТекущаяВерсия/ЗаписьВерсииэлемента ссылается на актуальную версию. Наличие и точное имя объекта версий — версионно-специфично, требует проверки в конкретной сборке.
3. Формы
Присоединённые файлы работают преимущественно на общих формах подсистемы «Работа с файлами», поэтому у самого справочника собственных форм минимум.
| Форма | Тип | Назначение |
|---|---|---|
Форма элемента (ФормаЭлемента или общая ПрисоединенныйФайл) |
Форма элемента | Карточка файла: имя, автор, размер, даты, кнопки «Открыть», «Редактировать», «Сохранить как», работа с ЭП и шифрованием |
Общая форма ПрисоединенныеФайлы |
Общая форма (список) | Список всех файлов, присоединённых к конкретному документу-владельцу; вызывается командой из формы документа |
| Общая форма выбора кодировки / загрузки | Служебные | Загрузка нового файла, выбор кодировки текста, импорт папки |
Основная точка входа для пользователя — команда «Присоединённые файлы», добавленная в командный интерфейс формы документа «Взаимозачёт задолженности». Она открывает общую форму списка, отфильтрованную по владельцу.
4. Ключевые процедуры модулей
В приложенном evidence программного кода (BSL) нет — ниже приведены типовые обработчики и обслуживающие процедуры, характерные для присоединённых файлов БСП. Точные имена/сигнатуры в сборке 3.4.5.21 требуют сверки с конфигуратором.
Модуль объекта справочника:
ПередЗаписью(Отказ)— контроль корректности имени файла и расширения, обновлениеДатаМодификацииУниверсальная, проверка блокировки редактирования (Редактирует).ПриКопировании(ОбъектКопирования)— очистка признаков блокировки/подписи у копии.- Обработка проверки заполнения — контроль заполненности владельца и способа хранения (том либо база).
Модуль менеджера: как правило, содержит служебные функции получения данных файла и обычно тонкий — основная логика вынесена в общие модули.
Общие модули, реально обслуживающие объект:
РаботаСФайлами/РаботаСФайламиКлиент— открытие, редактирование, сохранение, печать файлов.РаботаСФайламиСлужебный/…СлужебныйВызовСервера— создание элемента справочника при загрузке, запись содержимого в том или вХранилищеФайла, извлечение текста для поиска, обновление размера/дат.РаботаСФайламиВТомахСлужебный— размещение и удаление двоичных данных в томахТомаХранилищаФайлов.- Модули подсистемы ЭЦП/шифрования — наложение и проверка подписей, шифрование/расшифровка содержимого.
5. Проведение и движения
Справочник не проводится и не формирует бухгалтерских проводок и движений по регистрам учёта — это хранилище файлов, а не учётный документ. «Движение» данных ограничено записью двоичного содержимого:
- при хранении в информационной базе — данные пишутся в реквизит
ХранилищеФайла(и в подчинённый справочник/регистр версий при версионировании); - при хранении в томах — файл физически кладётся на диск, а в элементе заполняются
ТомХранилищаФайловиПутьКФайлуВТоме.
Все хозяйственные движения формирует объект-владелец — документ «Взаимозачёт задолженности», к которому присоединён файл. По типовой логике РК взаимозачёт закрывает встречные задолженности без движения денег и обычно без НДС (зачёт — не реализация): в разрезе плана счетов РК это отражается как закрытие дебиторской задолженности покупателя (1210 «Краткосрочная дебиторская задолженность покупателей и заказчиков») против кредиторской задолженности поставщику (3310 «Краткосрочная кредиторская задолженность поставщикам и подрядчикам») на сумму зачёта в тенге (₸), с соответствующими движениями по регистрам взаиморасчётов. Присоединённый файл лишь документирует основание зачёта (акт сверки, соглашение) и на эти проводки не влияет.
Справочные значения РК на 2026 год (для контекста учётных операций владельца, не для данного справочника): ставка НДС 16 %, МРП 4 325 ₸, МЗП 85 000 ₸; счета движения денег и товаров при иных операциях — 1030, 1330, доход/себестоимость — 6010/7010, НДС к уплате — 3130. К механизму присоединённых файлов эти величины прямого отношения не имеют.
6. Связанные объекты и ввод на основании
| Связь | Объект | Характер связи |
|---|---|---|
| Владелец | Документ.ВзаимозачетЗадолженности |
Каждый элемент справочника подчинён одному документу зачёта |
| Тома хранения | Справочник.ТомаХранилищаФайлов |
Физическое размещение файлов на диске |
| Автор / блокировка | Справочник.Пользователи |
Реквизиты Автор, Редактирует |
| Версии | подчинённый справочник версий присоединённых файлов | Хранение истории версий содержимого (если включено) |
| Электронная подпись | подсистема ЭЦП БСП | Подписи хранятся в ТЧ ЭлектронныеПодписи |
Ввод на основании. Для справочника присоединённых файлов ввод на основании не применяется. Элементы не создаются вручную через «Создать» — они порождаются автоматически при загрузке файла к документу-владельцу (команда «Присоединённые файлы» → «Добавить»/перетаскивание/из сканера).
7. Точки расширения
- Хранилище файлов. Переключение хранения «в ИБ ↔ в томах» настраивается в подсистеме «Работа с файлами» (константы и справочник
ТомаХранилищаФайлов) без доработки метаданных справочника. - Расширение конфигурации. Через расширение можно добавить реквизиты (например, тип/категорию документа зачёта, признак «подлинник получен») и вывести их на общую форму присоединённого файла, а также подписаться на события записи объекта.
- Подписки на события. Обработчики
ПередЗаписью/ПриЗаписиобъекта позволяют логировать загрузку скан-копий, проверять обязательность вложений при проведении документа-владельца. - Работа с ЭП и шифрованием. Настраивается штатными механизмами БСП; кастомная проверка сертификатов и требований к подписи актов зачёта реализуется в обработчиках подсистемы ЭЦП.
- Ограничение доступа (RLS). Права на файлы наследуют логику доступа к владельцу; при кастомной модели доступа настраиваются шаблоны RLS для справочника присоединённых файлов синхронно с документом «Взаимозачёт задолженности».
- Ограничения по типам/размеру. Допустимые расширения и максимальный размер файла задаются настройками подсистемы «Работа с файлами» и проверяются при загрузке.