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