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