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