--- title: "Справочник «РеализацияТоваровУслугПрисоединенныеФайлы» — техническое описание" country: KZ lang: ru author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-23 canonical: https://buhgpt.kz/suraqtar/spravochnik-realizaciyatovarovuslugprisoedinennyefayly-tehnicheskoe-op source: BuhGPT --- # Справочник «РеализацияТоваровУслугПрисоединенныеФайлы» — техническое описание > **TL;DR:** 1. Идентификация Параметр Значение Тип объекта Справочник (Catalog) Имя РеализацияТоваровУслугПрисоединенныеФайлы Полное имя Справочник.РеализацияТоваровУслугПрисоединенныеФайлы Синоним Присоединённые файлы (Реализация товаров услуг) Владелец (подчинение) Документ.РеализацияТо --- 1. Идентификация Параметр Значение Тип объекта Справочник (Catalog) Имя РеализацияТоваровУслугПрисоединенныеФайлы Полное имя Справочник.РеализацияТоваровУслугПрисоединенныеФайлы Синоним Присоединённые файлы (Реализация товаров услуг) Владелец (подчинение) Документ.РеализацияТоваровУслуг Конфигурация Управление торговлей для Казахстана 3.4.5.21 Подсистема Работа с файлами / Присоединённые файлы (БСП) Навигация «Где найти» e1cib/list/Справочник.РеализацияТоваровУслугПрисоединенныеФайлы Назначение. Служебный подчинённый справочник, реализующий механизм присоединённых файлов Библиотеки стандартных подсистем (БСП) для документа «Реализация товаров и услуг». Каждый элемент справочника — это карточка одного файла (скан договора, доверенности, изображение печати, PDF-копия ЭСФ/СНТ, скан-подтверждение отгрузки и т. п.), присоединённого к конкретному документу реализации. Справочник хранит метаданные файла (имя, расширение, размер, автор, даты, признаки подписи/шифрования), а само двоичное содержимое хранится отдельно — в регистре сведений хранилища либо в томах на диске. Справочник не участвует в учёте, не проводится и движений не формирует. Пользователь работает с этим справочником не напрямую, а через команду «Присоединённые файлы» в форме документа реализации. Прямой список (навигационная ссылка выше) используется администратором/разработчиком для диагностики. 2. Реквизиты шапки и табличные части Табличных частей объект не содержит (типовой признак справочника присоединённых файлов). Данные версий файла и его двоичное содержимое вынесены во внешние объекты (см. раздел 5). Реквизиты шапки (метаданные файла): Реквизит Тип Назначение Владелец ДокументСсылка.РеализацияТоваровУслуг Документ-владелец, к которому присоединён файл Наименование Строка Имя файла без расширения (отображается пользователю) Расширение Строка Расширение файла (pdf, xml, jpg, docx …) без точки Размер Число Размер файла в байтах Автор СправочникСсылка.Пользователи Пользователь, добавивший файл ДатаСоздания Дата Момент создания карточки файла в базе ДатаМодификацииУниверсальная Дата Дата последнего изменения содержимого (UTC) ИзменившийПользователь СправочникСсылка.Пользователи Кто последним изменил файл/версию ПодписанЭП Булево Файл подписан электронной подписью Зашифрован Булево Содержимое файла зашифровано Редактирует СправочникСсылка.Пользователи Пользователь, занявший файл для редактирования (блокировка) Том СправочникСсылка.ТомаХраненияФайлов Том хранения (если файлы хранятся на диске, а не в ИБ) ПутьКФайлуТома Строка Относительный путь к файлу внутри тома ВерсияВладельца / ТекущаяВерсия СправочникСсылка.*ВерсииФайлов Ссылка на активную версию (при включённом версионировании) ТекстХранилище ХранилищеЗначения Извлечённый текст файла для полнотекстового поиска ХранилищеФайла ХранилищеЗначения Двоичные данные файла (в вариантах хранения «в информационной базе»; в актуальных релизах чаще пусто — данные в регистре сведений) ИндексКартинки / ИдентификаторПиктограммы Число/Строка Пиктограмма по типу файла в интерфейсе Описание Строка Произвольный комментарий к файлу Точный состав реквизитов версионно-зависим (зависит от версии БСП внутри 3.4.5.21) — набор атрибутов «Том/ПутьКФайлуТома/ХранилищеФайла» присутствует всегда, а признаки подписи/шифрования и ссылки на версии могут отличаться флагами. Требует проверки при разработке под конкретный релиз только этот нюанс. 3. Формы Форма Назначение ФормаЭлемента Карточка файла: имя, расширение, размер, автор, даты, признаки ЭП/шифрования; команды «Открыть», «Сохранить как…», «Редактировать/Закончить редактирование», «Подписать ЭП», «Зашифровать» ФормаСписка Список всех файлов; используется в служебном/административном режиме и в подчинённых списках ФормаВыбора Выбор файла из списка присоединённых (в диалогах прикрепления/замены) На практике интерфейс присоединения реализуется общими формами подсистемы БСП (ОбщаяФорма.ПрисоединенныеФайлы, формы работы с версиями и подписями), которые вызываются из формы документа-владельца. Собственные формы справочника при этом могут не переопределяться. 4. Ключевые процедуры модулей В приложенном evidence присутствует только фасет назначения (BSL-фрагменты не приложены), поэтому ниже — типовые обработчики и точки логики данного вида объекта в БСП. При наличии выгрузки модулей сверяйте по путь:строка. Модуль объекта (ОбработкаЗаписи, ПередЗаписью, ПередУдалением): - контроль заполнения Владелец, Наименование, Расширение; - запрет изменения занятого на редактирование файла сторонним пользователем; - каскадное удаление версий и записей хранилища при удалении карточки файла. Модуль менеджера: - переопределяемые процедуры получения представления и формы по умолчанию; - обработчики программного добавления файла (ДобавитьФайл), используемые серверными вызовами подсистемы. Основная логика вынесена в общие модули БСП (вызываются извне, а не из модуля справочника): - РаботаСФайлами / РаботаСФайламиКлиент — открытие, сохранение, редактирование, помещение и получение данных файла; - ПрисоединенныеФайлы / ПрисоединенныеФайлыСервер / ПрисоединенныеФайлыСлужебный — CRUD карточек, подсчёт количества присоединённых файлов у объекта, работа с блокировкой; - работа с версиями, электронной подписью (ЭлектроннаяПодпись…) и шифрованием. 5. Проведение и движения Справочник не проводится и движений по регистрам не формирует — это подчинённый справочник, а не документ. Учёт выполняет документ-владелец, а присоединённые файлы лишь хранят прикреплённые к нему данные. Как хранится содержимое файла: - при хранении «в информационной базе» — в регистре сведений хранилища присоединённых файлов (РегистрСведений.ХранилищеПрисоединенныхФайлов / двоичные данные версий), реквизит-«ключ» — ссылка на элемент этого справочника; - при хранении «в томах на диске» — файл лежит в каталоге тома (Справочник.ТомаХраненияФайлов), а в карточке заполняются Том и ПутьКФайлуТома; - версии файла (при включённом версионировании) хранятся в отдельном справочнике версий, подчинённом карточке файла. Контекст учёта у документа-владельца (для справки, числа по РК на 2026 г.). Сама реализация формирует движения по регистрам продаж, взаиморасчётов, себестоимости, НДС и, при отражении в регламентированном учёте, проводки по типовому плану счетов РК со ставкой НДС 16 %: Проводка Дт Кт Комментарий Выручка от реализации 1210 (ДЗ покупателей) 6010 (доход от реализации) сумма без НДС НДС с реализации 1210 3130 (НДС к уплате) 16 % от базы Списание себестоимости 7010 (себестоимость) 1330 (товары) по методу оценки Поступление оплаты 1030 (текущие счета) 1210 закрытие ДЗ Пример: продажа на 1 000 000 ₸ без НДС → НДС 160 000 ₸ (16 %), к получению 1 160 000 ₸. Присоединённый скан ЭСФ/СНТ к этому документу на суммы и проводки не влияет — он информационный. 6. Связанные объекты и ввод на основании - Владелец: Документ.РеализацияТоваровУслуг — единственный владелец элементов справочника. - Хранилище данных: регистр сведений хранилища присоединённых файлов; Справочник.ТомаХраненияФайлов. - Версии: подчинённый справочник версий файлов (при версионировании). - Пользователи: Справочник.Пользователи — автор, изменивший, редактирующий. - Электронные документы: к документу реализации в РК привязаны ЭСФ (ИС ЭСФ) и СНТ; их печатные/xml-копии могут храниться как присоединённые файлы данного справочника. Ввод на основании. Не применяется: элементы справочника создаются исключительно через механизм присоединения файлов (команда «Присоединённые файлы» формы документа, drag-and-drop, сканирование, помещение из хранилища) и не являются самостоятельной точкой ввода на основании. 7. Точки расширения - Переопределяемые модули БСП: ПрисоединенныеФайлыПереопределяемый, РаботаСФайламиПереопределяемый — настройка сценариев работы с файлами, разрешённых расширений, максимального размера. - Расширение конфигурации: добавление реквизитов в справочник (например, «Тип документа-скана», «Категория»), доработка ФормаЭлемента/ФормаСписка через расширение без снятия с поддержки. - Подписки на события: ПередЗаписью/ПриЗаписи объекта для аудита прикрепления/удаления файлов, авто-присвоения категорий, интеграции с внешним архивом. - Ограничения доступа (RLS): права на файлы наследуются от прав на документ-владельца; при необходимости профили доступа настраиваются через подсистему прав. - Хранение: переключение «в ИБ ↔ в томах» и настройка версионирования — штатные параметры подсистемы, влияющие на заполнение реквизитов Том/ПутьКФайлуТома/ХранилищеФайла. --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_