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