1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | СчетНаОплатуПоставщикаПрисоединенныеФайлы |
| Полное имя | Справочник.СчетНаОплатуПоставщикаПрисоединенныеФайлы |
| Синоним | «Присоединенные файлы (Счета на оплату от поставщика)» |
| Конфигурация | Бухгалтерия для Казахстана, ред. 3.0 (версия 3.0.74.2) |
| Владелец файлов | Документ.СчетНаОплатуПоставщика |
Назначение. Справочник хранит файлы, присоединённые к документам «Счет на оплату поставщика» (скан-копии счетов, PDF, изображения, договоры). Это один из типовых объектов подсистемы БСП «Работа с файлами» (РаботаСФайлами), реализующий паттерн «Присоединённые файлы» для конкретного документа-владельца. Пользователь взаимодействует с ним косвенно — через команды «Присоединённые файлы», «Присоединить файл», «Открыть» в форме документа-владельца. В командном интерфейсе разделов справочник напрямую не выводится; служебный список доступен разработчику по навигационной ссылке.
Где найти (для разработки/отладки):
e1cib/list/Справочник.СчетНаОплатуПоставщикаПрисоединенныеФайлы
2. Реквизиты и табличные части
2.1 Реквизиты шапки (из evidence)
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи | Обязательный (ShowError) | Пользователь, впервые загрузивший файл. Аудит и разграничение прав |
| ВладелецФайла | ДокументСсылка.СчетНаОплатуПоставщика | Необязательный | Ссылка на документ-владелец. Основной реквизит связи файла с бизнес-объектом |
| ДатаМодификацииУниверсальная | Дата и время | Необязательный | Дата/время последнего изменения файла (UTC). Синхронизация и отслеживание изменений |
| ДатаСоздания | Дата и время | Обязательный (ShowError) | Дата/время первичной загрузки файла. Хронология документооборота |
| Зашифрован | Булево | Необязательный | Признак шифрования файла сертификатами. Работа с конфиденциальными документами |
| Изменил | СправочникСсылка.Пользователи | Необязательный | Последний изменивший файл/его свойства. Аудит изменений |
| ИндексКартинки | Число | Необязательный | Индекс иконки для отображения в интерфейсе по расширению. Техническое поле UI |
| Описание | Строка | Необязательный | Текстовое описание файла, задаваемое пользователем |
| ПодписанЭП | Булево | Необязательный | Признак наличия электронной подписи. Юридически значимый документооборот |
| ПутьКФайлу | Строка | Необязательный | Путь при хранении на томе (в файловой системе). Заполняется при типе хранения «В томе на диске» |
| Размер | Число | Необязательный | Размер файла в байтах. Контроль объёма и ограничений на загрузку |
| Расширение | Строка | Необязательный | Расширение файла (pdf, jpg, docx…). Иконка и доступные операции |
| Редактирует | СправочникСсылка.Пользователи | Необязательный | Пользователь, взявший файл на редактирование («заблокировал») |
| СтатусИзвлеченияТекста | Перечисление.СтатусыИзвлеченияТекстаФайлов | Необязательный | Статус извлечения текста для полнотекстового поиска (не извлечён / извлекается / извлечён / ошибка) |
Типовые реквизиты подсистемы работы с файлами (присутствуют в объектах этого вида, дополняют список выше): ТомХранения (СправочникСсылка.ТомаХранилищаФайлов), ЗапретитьРедактирование/ЗапретитьИзменениеФайла, ХэшСуммаФайла, ТекстХранилище/ПолныйТекст (извлечённый текст для поиска), а также стандартные реквизиты Наименование, Код, ПометкаУдаления, Предопределённый.
2.2 Хранилища (реквизиты-ХранилищеЗначения)
| Реквизит | Назначение |
|---|---|
ХранилищеФайла / ФайлХранилище |
Двоичные данные файла при хранении в ИБ (тип хранения «В информационной базе»). Пусто при хранении на томе — тогда используется ПутьКФайлу + ТомХранения |
2.3 Табличные части
Собственных табличных частей объект не имеет — это плоский справочник-хранилище. Множественность обеспечивается тем, что к одному ВладельцуФайла относится множество элементов справочника (много файлов на один счёт).
3. Формы
| Форма | Назначение |
|---|---|
ФормаЭлемента (ФормаФайла) |
Карточка присоединённого файла: описание, автор, даты, размер, признаки ЭП/шифрования, команды «Открыть», «Сохранить как», «Редактировать», «Закончить редактирование», «Подписать ЭП», «Зашифровать» |
| ФормаСписка | Служебный список всех файлов справочника (для администрирования/отладки; доступен по навигационной ссылке) |
| ФормаВыбора | Выбор файла из числа присоединённых (используется во вспомогательных сценариях) |
Основной пользовательский сценарий работы идёт не через собственные формы справочника, а через общую форму БСП ПрисоединённыеФайлы (список файлов документа-владельца), открываемую командой «Присоединённые файлы» в форме Документ.СчетНаОплатуПоставщика.
4. Ключевые процедуры модулей
Специфического прикладного кода evidence по модулям не содержит — логика типовая и наследуется от подсистемы БСП «Работа с файлами». Характерные обработчики объектов этого вида:
Модуль объекта:
ПриЗаписи/ПередЗаписью— фиксация автора первой загрузки, актуализацияИзменил,ДатаМодификацииУниверсальная, пересчётРазмер,Расширение,ИндексКартинки.ПередУдалением— очистка данных на томе хранения (удаление физического файла при типе хранения «В томе на диске»).ОбработкаПроверкиЗаполнения— контроль обязательныхАвториДатаСоздания(режим ShowError).
Общие модули БСП, обслуживающие объект (вызываются вместо кода в самом справочнике):
РаботаСФайлами/РаботаСФайламиСлужебный— добавление, открытие, сохранение, блокировка/разблокировка на редактирование.РаботаСФайламиВРабочемКаталоге— выгрузка во временный/рабочий каталог для просмотра и правки.ОбновлениеИндексаВПоиске/ извлечение текста — заполнениеСтатусИзвлеченияТекстаи полнотекстового индекса.ЭлектроннаяПодпись— обработкаПодписанЭП,Зашифрован(подпись/шифрование сертификатами).
Требует проверки (версионно-специфично): точный состав внутренних процедур и имена общих модулей зависят от версии встроенной БСП в 3.0.74.2.
5. Проведение и движения
Объект — справочник, поэтому он не проводится и не формирует движений по регистрам накопления/сведений и бухгалтерских проводок. Хозяйственных операций и влияния на учёт по НДС/налогам сам файл не создаёт.
Учётные движения формирует документ-владелец СчетНаОплатуПоставщика, к которому присоединён файл (счёт на оплату в РК — в общем случае документ управленческого/оперативного назначения, движения формируют уже документы поступления и оплаты). Для справки — типовые счета Рабочего плана счетов РК, задействуемые в цепочке «счёт → поступление → оплата поставщику»:
| Счёт | Наименование |
|---|---|
| 3310 | Краткосрочная кредиторская задолженность поставщикам и подрядчикам |
| 1330 | Товары |
| 1030 | Денежные средства на текущих банковских счетах |
| 1210 | Краткосрочная дебиторская задолженность покупателей |
| 3130 | НДС к уплате (ставка НДС РК 2026 — 16%) |
| 6010 | Доход от реализации |
| 7010 | Себестоимость реализации |
Электронный документооборот по цепочке (ЭСФ в ИС ЭСФ, СНТ) также ведётся на уровне документов-владельцев и первичных документов, а не на уровне присоединённого файла.
6. Связанные объекты и ввод на основании
- Владелец:
Документ.СчетНаОплатуПоставщика— единственный документ-владелец файлов данного справочника. - Пользователи:
Справочник.Пользователи— реквизитыАвтор,Изменил,Редактирует. - Тома хранилища:
Справочник.ТомаХранилищаФайлов— при типе хранения «В томе на диске». - Перечисление:
Перечисление.СтатусыИзвлеченияТекстаФайлов. - Подсистема: БСП «Работа с файлами» (общие формы, команды, регистры служебных данных).
Ввод на основании для этого объекта не применяется — элементы создаются исключительно механизмом присоединения файлов из формы документа-владельца, а не командами «Создать на основании».
7. Точки расширения
- Расширение конфигурации: добавление реквизитов (например, категория/тип вложения, срок хранения) и переопределение обработчиков
ПриЗаписи/ПередУдалениемчерез аннотации&Вместо/&После. - Программное присоединение файлов: API подсистемы
РаботаСФайлами(ДобавитьФайл, работа сХранилищеФайла/ томами) — для загрузки скан-копий счетов из внешних источников (почта, обмен, интеграции). - Полнотекстовый поиск: подписка на извлечение текста и заполнение
СтатусИзвлеченияТекста— для поиска по содержимому счетов. - ЭДО и ЭЦП: обработчики подсистемы «Электронная подпись» (
ПодписанЭП,Зашифрован) — для юридически значимого хранения счетов и увязки с ЭСФ/СНТ. - Права доступа: разграничение через RLS по
Автор/ВладелецФайлаи роли работы с файлами. - Регламент хранения: обработка тома хранения, перенос «ИБ ↔ том», очистка устаревших вложений.