1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Справочник.РеализацияТоваровУслугПрисоединенныеФайлы) |
| Имя | РеализацияТоваровУслугПрисоединенныеФайлы |
| Синоним | Присоединённые файлы (Реализации ТМЗ и услуг) |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) |
| Подсистема | Работа с файлами (механизм присоединённых файлов БСП) |
| Владелец | Документ.РеализацияТоваровУслуг (через реквизит ВладелецФайла) |
Назначение. Справочник хранит файлы, присоединённые к документам «Реализация товаров и услуг», и управляет их жизненным циклом: загрузкой, хранением (в информационной базе или на внешних томах), версионированием, шифрованием и электронным подписанием. Используется бухгалтерами и менеджерами для прикрепления к операциям реализации сканов накладных, актов выполненных работ, ЭСФ/СНТ и прочей первичной документации. Работает в связке с подсистемой «Работа с файлами»: поддерживает хранение как в базе (ХранилищеЗначения), так и на томах хранения. Доступ к файлам — из карточки документа реализации через панель присоединённых файлов.
Где найти: e1cib/list/Справочник.РеализацияТоваровУслугПрисоединенныеФайлы
Это служебный (технический) справочник механизма присоединённых файлов. Пользователь работает не со списком напрямую, а с файлами через панель на форме документа-владельца. Прямое открытие списка — сценарий администрирования/отладки.
2. Реквизиты и структура
2.1 Реквизиты шапки (из evidence)
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи | Обязательное (ShowError) | Пользователь, создавший файл. Заполняется автоматически при создании. |
| ВладелецФайла | ДокументСсылка.РеализацияТоваровУслуг | Необязательное | Ссылка на документ реализации, к которому присоединён файл. Определяет контекст хранения. |
| ДатаМодификацииУниверсальная | Дата и время | Необязательное | Дата последнего изменения файла в формате UTC. Синхронизация и контроль версий. |
| ДатаСоздания | Дата и время | Обязательное (ShowError) | Дата и время создания файла в системе. Заполняется автоматически при загрузке. |
| Зашифрован | Булево | Необязательное | Флаг шифрования файла (работа с конфиденциальной информацией). |
| Изменил | СправочникСсылка.Пользователи | Необязательное | Пользователь, последним изменивший файл или его реквизиты. |
| ИндексКартинки | Число | Необязательное | Индекс иконки типа файла в коллекции изображений для отображения в интерфейсе. |
| Описание | Строка | Необязательное | Текстовое описание файла для поиска и идентификации. |
| ПодписанЭП | Булево | Необязательное | Флаг наличия электронной подписи (юридическая значимость файла). |
| ПутьКФайлу | Строка | Необязательное | Полный путь к файлу при хранении на томе. Пусто, если файл хранится в базе. |
| Размер | Число | Необязательное | Размер файла в байтах. Заполняется автоматически. |
| Расширение | Строка | Необязательное | Расширение файла (pdf, xlsx и т. п.). Определяет тип и доступные действия. |
| Редактирует | СправочникСсылка.Пользователи | Необязательное | Пользователь, заблокировавший файл на редактирование. |
| СтатусИзвлеченияТекста | Перечисление.СтатусыИзвлеченияТекстаФайлов | Необязательное | Статус извлечения текста для полнотекстового поиска (не извлечён / извлекается / извлечён / ошибка). |
| ТекстХранилище | ХранилищеЗначения | Необязательное | Хранилище извлечённого текстового содержимого для полнотекстового поиска. |
2.2 Типовые реквизиты механизма БСП (дополняют шапку)
Помимо приведённых, справочник присоединённых файлов БСП обычно содержит:
- Том (СправочникСсылка.ТомаХранилищаФайлов) — том, на котором лежит файл при хранении вне базы;
- ВерсияИспользуемая / ТекущаяВерсия — ссылка на действующую версию (при включённом версионировании);
- ТипХранилищаФайлов — признак хранения: в информационной базе или на томе;
- ЗагрузкаЗавершена — признак корректного завершения загрузки;
- содержимое файла — в регистре сведений двоичных данных либо в
ХранилищеЗначенияверсии.
Точный состав служебных реквизитов версионно-зависим (реализация подсистемы «Работа с файлами» БСП). Требует проверки по конкретной сборке 3.0.74.2, если ведётся программная работа с хранилищем.
2.3 Табличные части
Собственных табличных частей справочник не имеет — это плоская карточка файла. Версии (история) хранятся отдельным механизмом версионирования, а не табличной частью.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаЭлемента | Карточка файла: описание, автор, даты, признаки подписи/шифрования, кнопки открытия/сохранения/редактирования. Как правило, вызывается через общие формы БСП. |
| ФормаСписка | Служебный список всех присоединённых файлов справочника. Используется администратором/для отладки. |
| ФормаВыбора | Выбор файла из списка в служебных сценариях. |
На практике работа с файлами ведётся через общие формы подсистемы «Работа с файлами» (панель присоединённых файлов на форме документа-владельца, формы просмотра и выбора файлов), а не через собственные формы этого справочника. Поэтому набор собственных форм минимален.
4. Ключевые процедуры модулей
BSL-модули в evidence не приложены. Ниже — типовые обработчики для справочника присоединённых файлов БСП.
Модуль объекта (МодульОбъекта):
ОбработкаЗаполнения(ДанныеЗаполнения, СтандартнаяОбработка)— заполнениеАвтор,ДатаСозданияпри создании элемента.ПередЗаписью(Отказ)— фиксацияИзменил,ДатаМодификацииУниверсальная; контроль занятости файла на редактирование.ПередУдалением(Отказ)— очистка данных на томе хранения и связанных версий.ПриКопировании(ОбъектКопирования)— сброс служебных признаков (Редактирует,ПодписанЭП, ссылок на версии) у копии.
Модуль менеджера (МодульМенеджера):
- процедуры интеграции с общими модулями
РаботаСФайлами/РаботаСФайламиСлужебный: добавление файла, обновление версии, перенос между базой и томом, извлечение текста, наложение/проверка ЭП.
Конкретные пути
путь:строкане приводятся, так как BSL-evidence не предоставлен. Реализация делегирована общим модулям подсистемы «Работа с файлами» БСП.
5. Проведение и движения
Справочник не проводится и не формирует движений по регистрам — это объект типа «Справочник», у него нет механизма проведения, регистраторов и бухгалтерских проводок. Присоединённый файл не влияет на учётные итоги; он лишь хранит вложение и метаданные.
Учётные движения формирует документ-владелец Документ.РеализацияТоваровУслуг. Для контекста — стандартная логика проведения реализации в РК (типовой план счетов РК, ставка НДС 16 %, валюта — тенге ₸):
| Операция | Дебет | Кредит |
|---|---|---|
| Признание дохода от реализации (с НДС) | 1210 «Краткосрочная ДЗ покупателей» | 6010 «Доход от реализации» |
| Начисление НДС к уплате (16 %) | 1210 | 3130 «НДС к уплате» |
| Списание себестоимости товаров | 7010 «Себестоимость реализации» | 1330 «Товары» |
Пример: продажа на сумму 116 000 ₸ с НДС → доход без НДС 100 000 ₸ (Дт 1210 Кт 6010), НДС 16 000 ₸ (Дт 1210 Кт 3130). При поступлении оплаты на счёт — Дт 1030 Кт 1210. Электронное сопровождение реализации — выписка ЭСФ (ИС ЭСФ) и при необходимости СНТ; их печатные/xml-формы и являются типичными кандидатами на присоединение к документу в виде файлов данного справочника.
Прочие ставки/лимиты РК-2026, применимые в смежных расчётах конфигурации (для справки, к данному справочнику прямого отношения не имеют): МРП 4 325 ₸, МЗП 85 000 ₸; базовый вычет по ИПН — 30 МРП/мес (не более 360 МРП/год); ИПН 10 % до 8 500 МРП годового дохода и 15 % сверх; ОПВ 10 % (потолок базы 50 МЗП), ОПВР 3,5 %, ВОСМС 2 %, ОСМС 3 %, СО 5 %, соцналог 6 %.
6. Связанные объекты и ввод на основании
- Документ.РеализацияТоваровУслуг — владелец файлов (реквизит
ВладелецФайла). Файлы присоединяются с формы этого документа. - Справочник.Пользователи — источник значений для
Автор,Изменил,Редактирует. - Справочник.ТомаХранилищаФайлов — тома внешнего хранения (при хранении вне базы).
- Перечисление.СтатусыИзвлеченияТекстаФайлов — статусы полнотекстового индексирования.
- Общие модули/формы подсистемы «Работа с файлами» (БСП) — весь UI и логика загрузки/выгрузки/подписи/версий.
Ввод на основании: не применяется. Присоединённые файлы не участвуют в схеме ввода на основании и не порождают документы; элементы создаются только через механизм присоединения файлов к документу-владельцу.
7. Точки расширения
- Расширение конфигурации для перехвата
ПередЗаписью/ОбработкаЗаполнениямодуля объекта — например, доп. проверки типов/размеров файлов, автозаполнениеОписание. - Подписки на события (
ПередЗаписью,ПередУдалением) справочника — аудит операций с файлами, интеграция с внешним архивом. - Переопределяемые общие модули БСП «Работа с файлами» (
РаботаСФайламиПереопределяемыйи аналоги) — настройка правил хранения, шифрования, извлечения текста, наложения ЭП. - Дополнительные реквизиты/сведения (подсистема «Свойства») — при необходимости классификации файлов (тип документа, статус согласования).
- Настройка томов хранения и правил переноса файлов из базы на тома — регламентными заданиями.
При доработках не изменяйте служебные реквизиты хранилища напрямую — используйте API подсистемы «Работа с файлами», иначе нарушится целостность связки «карточка файла ↔ версия ↔ том».