1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | СчетФактураПолученныйПрисоединенныеФайлы |
| Полное имя | Справочник.СчетФактураПолученныйПрисоединенныеФайлы |
| Синоним | «Присоединённые файлы (Счёт-фактура полученный)» |
| Конфигурация | Управление торговлей для Казахстана, 3.4.5.21 |
| Подсистема БСП | «Работа с файлами» (СтандартныеПодсистемы.РаботаСФайлами) |
| Навигационная ссылка | e1cib/list/Справочник.СчетФактураПолученныйПрисоединенныеФайлы |
Назначение. Служебный справочник-хранилище присоединённых файлов, порождённый механизмом «Работа с файлами» Библиотеки стандартных подсистем (БСП) для документа-владельца «Счёт-фактура полученный». Каждый элемент справочника — это метаданные одного присоединённого файла (имя, расширение, размер, автор, версия), тогда как само содержимое (двоичные данные) хранится либо в связанном справочнике версий, либо в томах на диске. Справочник не ведётся пользователем вручную: элементы создаются автоматически при присоединении файла к конкретному документу «Счёт-фактура полученный» через команды «Присоединённые файлы».
Типовой сценарий использования в РК: к полученному счёту-фактуре прикладывают скан-копию бумажного оригинала, XML-выгрузку ЭСФ из ИС ЭСФ, PDF-печатную форму, сопроводительную накладную на товары (СНТ) или переписку с поставщиком. Это обеспечивает хранение первичных и электронных документов рядом с учётной записью о поступлении.
2. Реквизиты шапки и табличные части
Структура типовая для справочников «ПрисоединённыеФайлы», формируемых БСП. Табличных частей нет — все данные хранятся в реквизитах шапки.
Основные реквизиты
| Реквизит | Тип | Назначение |
|---|---|---|
ВладелецФайла |
ДокументСсылка.СчетФактураПолученный | Документ-владелец, к которому присоединён файл (реквизит-владелец справочника) |
Наименование |
Строка(150) | Имя файла без расширения |
Расширение |
Строка(20) | Расширение файла (pdf, xml, jpg, docx и т. п.) |
Размер |
Число(15,0) | Размер файла в байтах |
ХранилищеФайла |
ХранилищеЗначения | Двоичные данные файла (при хранении в ИБ); пусто при хранении в томах |
ПутьКФайлуВТомеНаДиске |
Строка | Относительный путь к файлу при хранении в томах на диске |
Том |
СправочникСсылка.ТомаХраненияФайлов | Том хранения (при варианте хранения «в томах») |
ТекстХранилище |
Хранилище�значения | Извлечённый текст файла для полнотекстового поиска |
ИндексКартинки |
Число | Индекс пиктограммы по типу файла |
Реквизиты версионирования и подписи
| Реквизит | Тип | Назначение |
|---|---|---|
ТекущаяВерсия |
СправочникСсылка.…ПрисоединенныеФайлыВерсии | Ссылка на актуальную версию файла |
ВерсионированиеИспользуется |
Булево | Признак включённого хранения версий |
ПодписанЭП |
Булево | Файл подписан электронной подписью |
Зашифрован |
Булево | Файл зашифрован |
ЭлектроннаяПодпись / Шифрование |
ХранилищеЗначения | Данные ЭП / сертификатов шифрования |
Служебные реквизиты аудита
| Реквизит | Тип | Назначение |
|---|---|---|
Автор |
СправочникСсылка.Пользователи | Пользователь, присоединивший файл |
ДатаСоздания |
Дата | Дата и время присоединения |
ДатаМодификации |
Дата | Дата последнего изменения |
ЗанятВыполнениемРедактирование |
СправочникСсылка.Пользователи | Пользователь, занявший файл для редактирования (блокировка) |
ПометкаУдаления |
Булево | Стандартный реквизит |
Реквизит
ВладелецФайлав конфигурациях на актуальной БСП технически реализован как реквизит справочника, а не как стандартный «Владелец», что позволяет одному механизму обслуживать разнотипных владельцев файлов.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаЭлемента | Карточка присоединённого файла: имя, расширение, размер, автор, даты, признаки ЭП/шифрования; команды «Открыть», «Сохранить как…», «Редактировать», «Закончить редактирование», «Отменить редактирование» |
| ФормаСписка | Список файлов справочника (используется преимущественно в служебных/административных целях) |
| Форма выбора | Стандартный выбор элемента справочника |
На практике конечный пользователь работает не с этими формами напрямую, а с универсальной формой «ПрисоединённыеФайлы» из общей подсистемы БСП, которая вызывается командой панели навигации документа «Счёт-фактура полученный» и отображает список файлов данного владельца с командами присоединения, просмотра и версионирования.
4. Ключевые процедуры модулей
Evidence по модулям (путь:строка) в исходных данных не приложен — ниже перечислены типовые обработчики, которые механизм «Работа с файлами» БСП разворачивает для справочника такого вида. Логика вынесена в общие модули подсистемы, а не в модуль самого справочника.
Модуль менеджера справочника / общие модули БСП:
РаботаСФайламиСлужебный.ДобавитьФайл(...)— создаёт элемент справочника, заполняетНаименование,Расширение,Размер,Автор,ДатаСоздания, помещает данные вХранилищеФайлаили в том.РаботаСФайламиСлужебный.ОбновитьВерсиюФайла(...)— фиксирует новую версию, переключаетТекущаяВерсия.ФайловыеФункцииСлужебныйКлиент.ОткрытьФайл(...)— открывает файл во внешнем приложении.- Обработчики блокировки: занять/освободить файл для редактирования (
ЗанятВыполнениемРедактирование).
Модуль формы элемента (типовые обработчики):
ПриСозданииНаСервере— инициализация видимости команд, признаков ЭП/шифрования, доступности редактирования.ПриОткрытии— проверка блокировки редактирования файла другим пользователем.- Команды
Открыть,СохранитьКак,Редактировать,ЗакончитьРедактирование,ОтменитьРедактирование.
Требует проверки (версионно-специфично): точные имена общих модулей БСП и сигнатуры процедур зависят от версии Библиотеки стандартных подсистем, встроенной в сборку 3.4.5.21.
5. Проведение и движения
Справочник не проводится и не формирует движений по регистрам накопления/сведений и не порождает бухгалтерских проводок — это объект типа «Справочник», предназначенный только для хранения файлов. Учётные движения по счетам формирует документ-владелец «Счёт-фактура полученный» (и связанное с ним поступление товаров/услуг), а не хранилище файлов.
Для справки — движения формируются документами поступления, к которым может относиться данный счёт-фактура. По типовому плану счетов РК и ставке НДС 16 % (Казахстан, 2026):
| Операция | Дебет | Кредит | Комментарий |
|---|---|---|---|
| Поступление товаров | 1330 «Товары» | 3310 «КЗ поставщикам» | На стоимость без НДС |
| Входной НДС | 1420 «НДС к возмещению» | 3310 «КЗ поставщикам» | НДС 16 % |
| Оплата поставщику | 3310 «КЗ поставщикам» | 1030 «Деньги на текущих счетах» | Погашение задолженности |
Пример расчёта НДС. Поступление товара на 1 000 000 ₸ без НДС: НДС = 1 000 000 × 16 % = 160 000 ₸; к оплате поставщику = 1 160 000 ₸ (Дт 1330 = 1 000 000, Дт 1420 = 160 000, Кт 3310 = 1 160 000).
Электронный документооборот: полученному счёту-фактуре в РК соответствует ЭСФ из информационной системы ИС ЭСФ, а движению товаров — СНТ. XML-файлы этих электронных документов как раз и являются типичным содержимым присоединённых файлов данного справочника.
6. Связанные объекты и ввод на основании
| Объект | Связь |
|---|---|
Документ СчетФактураПолученный |
Владелец файлов (ВладелецФайла); источник команды «Присоединённые файлы» |
Справочник …ПрисоединенныеФайлыВерсии (парный) |
Хранит версии файлов, ТекущаяВерсия ссылается на него |
Справочник ТомаХраненияФайлов |
Тома дискового хранения содержимого файлов |
Справочник Пользователи |
Реквизиты Автор, ЗанятВыполнениемРедактирование |
| Подсистема «Работа с файлами» (БСП) | Управляющий механизм присоединения/версионирования/подписи |
| Документы поступления (поступление товаров, услуг) | Формируют учётные движения; счёт-фактура — их первичный документ |
Ввод на основании. Для служебного справочника присоединённых файлов ввод на основании не предусмотрен: элементы создаются исключительно механизмом присоединения файла к документу-владельцу. Сам документ «Счёт-фактура полученный» в типовой логике вводится на основании документов поступления и связан с электронными документами ЭСФ/СНТ.
7. Точки расширения
- Расширение конфигурации (BSP-friendly): добавление реквизитов справочнику, доработка форм элемента/списка через расширение без снятия с поддержки.
- Программные интерфейсы БСП: переопределяемые модули подсистемы «Работа с файлами» (
РаботаСФайламиПереопределяемый,РаботаСФайламиКлиентСервер) — настройка вариантов хранения (в ИБ / в томах), ограничений размера и типов файлов, политики антивирусной проверки. - Версионирование и ЭП: включение/отключение хранения версий и электронной подписи файлов через настройки подсистемы.
- Подписки на события / дополнительные обработчики: реакция на добавление файла к счёту-фактуре (например, автоматическая привязка XML ЭСФ к учётной записи документа).
- Тома хранения файлов: вынесение содержимого из ИБ в тома на диске для контроля размера базы.
Требует проверки (версионно-специфично): конкретный состав переопределяемых процедур и настроек хранения определяется версией БСП внутри сборки «Управление торговлей для Казахстана» 3.4.5.21.