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