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