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