1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ПеремещениеТоваровПрисоединенныеФайлы |
| Полный путь | Справочник.ПеремещениеТоваровПрисоединенныеФайлы |
| Синоним | «Присоединённые файлы (Перемещения ТМЗ)» |
| Навигационная ссылка | e1cib/list/Справочник.ПеремещениеТоваровПрисоединенныеФайлы |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) |
| Подсистема | Работа с файлами (БСП — «Присоединённые файлы») |
Назначение. Служебный (технический) справочник для хранения метаданных о файлах, присоединённых к документам «Перемещение товаров»: сканы накладных, фотографии, ЭСФ/СНТ, сопроводительные документы по перемещению ТМЗ между складами. Справочник создаётся и заполняется автоматически механизмом присоединённых файлов БСП и не предназначен для прямого ручного редактирования пользователем. Работа с ним ведётся через команду «Присоединённые файлы» в форме документа «Перемещение товаров». Каждая запись справочника — это один присоединённый файл; двоичное содержимое файла хранится отдельно (в информационной базе либо в томах на диске), а сам справочник хранит атрибуты.
Это справочник-владелец подчинён документу-владельцу через реквизит
ВладелецФайла. Он не является документом, не проводится и самостоятельно движений в регистрах/на счетах не формирует.
2. Реквизиты
2.1 Реквизиты шапки (из evidence)
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи | Обязательное (ShowError) | Пользователь, первоначально присоединивший файл. Аудит и контроль авторства. |
| ВладелецФайла | ДокументСсылка.ПеремещениеТоваров | Необязательное | Ссылка на документ перемещения товаров, к которому присоединён файл. Обеспечивает связь файла с объектом учёта. |
| ДатаМодификацииУниверсальная | Дата (ДатаВремя) | Необязательное | Универсальное время (UTC) последнего изменения файла. Синхронизация, отслеживание актуальности версий. |
| ДатаСоздания | Дата (ДатаВремя) | Обязательное (ShowError) | Дата и время создания записи о файле. Хронология работы с документом. |
| Зашифрован | Булево | Необязательное | Признак шифрования файла. Управляет логикой доступа/расшифровки перед открытием. |
| Изменил | СправочникСсылка.Пользователи | Необязательное | Пользователь, последним изменивший файл или его свойства. Аудит изменений. |
| ИндексКартинки | Число | Необязательное | Индекс иконки файла в коллекции изображений. Визуальное представление типа файла в списках/формах. |
| Описание | Строка | Необязательное | Произвольный комментарий пользователя к файлу. |
| ПодписанЭП | Булево | Необязательное | Признак наличия электронной подписи. Важен для юридически значимого документооборота (ЭСФ, СНТ). |
| ПутьКФайлу | Строка | Необязательное | Путь к файлу в томе на диске (для режима хранения «В томах на диске»). |
| Размер | Число | Необязательное | Размер файла в байтах. Контроль дискового пространства. |
| Расширение | Строка | Необязательное | Расширение файла (pdf, jpg, xlsx и т. п.). Определяет тип и программу открытия. |
| Редактирует | СправочникСсылка.Пользователи | Необязательное | Пользователь, редактирующий файл в данный момент («файл занят»). Блокировка от конфликтов одновременного редактирования. |
2.2 Стандартные реквизиты и служебные поля БСП
Помимо перечисленных, объект использует стандартные поля справочника присоединённых файлов БСП (могут присутствовать как реквизиты объекта):
- Наименование (стандартный) — имя файла без расширения.
- ХранениеФайла / ТомХранения / ФайлХранилище — способ и место хранения двоичного содержимого (в ИБ или в томе на диске).
- ТекстХранилище / ТекстИзвлечён — извлечённый текст для полнотекстового поиска.
- ПометкаУдаления, Ссылка, Код — стандартные реквизиты справочника.
2.3 Табличные части
Табличные части у данного справочника отсутствуют — это плоский объект метаданных «один файл = одна запись». Версии файла (история изменений двоичного содержимого) при включённом версионировании хранятся в отдельном регистре сведений «ВерсииПрисоединённыхФайлов», а не в табличной части.
3. Формы
Для служебного справочника присоединённых файлов конфигурация использует общие (типовые) формы БСП, а не индивидуальные формы объекта:
| Форма | Назначение |
|---|---|
Форма элемента (ФормаЭлемента / общая ПрисоединённыйФайл) |
Просмотр и редактирование карточки файла: наименование, описание, автор, даты, признаки подписи/шифрования, команды «Открыть», «Редактировать», «Закончить редактирование», «Сохранить как…». |
Форма списка (ФормаСписка / общая ПрисоединённыеФайлы) |
Список всех файлов, присоединённых к документу-владельцу. Вызывается командой «Присоединённые файлы» из формы «Перемещение товаров». Команды добавления, просмотра, редактирования, ЭП, удаления. |
| Форма выбора | Служебный выбор файла (используется механизмами БСП). |
Открытие списка возможно и напрямую по навигационной ссылке e1cib/list/Справочник.ПеремещениеТоваровПрисоединенныеФайлы, но штатный сценарий — через панель присоединённых файлов документа.
4. Ключевые процедуры модулей
В приложенном evidence отсутствуют выгрузки BSL по строкам, поэтому ниже — типовые обработчики этого вида объекта (реализуются в общих модулях подсистемы «РаботаСФайлами» / «РаботаСФайламиСлужебный» БСП; сам модуль справочника, как правило, минимален):
- МодульОбъекта → ПередЗаписью — фиксация служебных полей: заполнение
ДатаМодификацииУниверсальная,Изменил, контроль обязательностиАвториДатаСоздания(ShowError). - МодульОбъекта → ПередУдалением — очистка двоичного содержимого в хранилище/томе, удаление версий и записей об извлечённом тексте.
- РаботаСФайламиСлужебный.ДобавитьФайл / ЗаписатьФайлВИнформационнуюБазу — создание записи справочника при присоединении файла к документу «Перемещение товаров», расчёт
Размер,Расширение,ИндексКартинки. - РаботаСФайламиСлужебный.ЗанятьФайлДляРедактирования / ОсвободитьФайл — установка/снятие реквизита
Редактирует(блокировка от одновременного редактирования). - РаботаСФайламиСлужебный.ДобавитьВерсию — при включённом версионировании запись новой версии двоичного содержимого.
- Обработчики ЭП — установка признака
ПодписанЭП, проверка подписи; при шифровании — установкаЗашифрован. - ИзвлечениеТекстаСервер — фоновое извлечение текста для полнотекстового поиска.
Конкретные имена и сигнатуры процедур версионно-зависимы (редакция БСП внутри 3.0.74.2) — это единственное место, где содержимое стоит сверять с модулем конкретной поставки.
5. Проведение и движения
Справочник не проводится и движений не формирует. Как объект метаданных о файлах он не участвует в бухгалтерском и налоговом учёте, не создаёт записей в регистрах накопления/сведений учётного контура и не формирует бухгалтерских проводок.
Учётные движения формирует документ-владелец «Перемещение товаров», к которому присоединяются файлы. Для контекста (это движения документа, а не справочника) в плане счетов РК перемещение ТМЗ между складами/МОЛ отражается внутренним оборотом по счёту учёта запасов:
- Дт 1330 «Товары» (склад-получатель) — Кт 1330 «Товары» (склад-отправитель) — на себестоимость перемещаемых ТМЗ.
- Регистры накопления: «ТоварыНаСкладах», «ТоварыОрганизаций» (расход по складу-отправителю, приход по складу-получателю).
Перемещение между собственными складами — оборот внутри одного счёта, поэтому:
- дохода (6010), себестоимости реализации (7010), расчётов с покупателем (1210) или поставщиком (3310) не возникает;
- НДС по внутреннему перемещению не начисляется (счёт 3130 «НДС к уплате» не задействуется); в РК-контексте актуальная ставка НДС на 2026 год — 16 % — применяется в документах реализации/поступления, а не в перемещении.
Присоединённые файлы (сканы СНТ/ЭСФ, накладной) выступают лишь документальным приложением к этому движению и на проводки не влияют.
6. Связанные объекты и ввод на основании
- Документ-владелец:
Документ.ПеремещениеТоваров(реквизитВладелецФайла). Ключевая связь «файл → документ». - Справочник.Пользователи: реквизиты
Автор,Изменил,Редактирует. - Хранилище содержимого: тома хранения файлов (
Справочник.ТомаХраненияФайлов) при режиме «В томах на диске» либо хранилище в ИБ. - Версии: регистр сведений версий присоединённых файлов (при включённом версионировании).
- ЭП: механизм электронной подписи и шифрования БСП (
ПодписанЭП,Зашифрован).
Ввод на основании: для служебного справочника присоединённых файлов не предусмотрен и не имеет смысла — записи создаются исключительно механизмом присоединения файлов из формы документа «Перемещение товаров». Сам файл может, в свою очередь, быть результатом печати/выгрузки электронных документов (ЭСФ из ИС ЭСФ, СНТ), присоединяемых к документу.
7. Точки расширения
- Расширения конфигурации: добавление реквизитов (например, категория/тип вложения), дополнительных команд в общую форму списка присоединённых файлов; переопределение обработчиков через
&Вместо/&Послев модуле объекта или общих модулях БСП. - Дополнительные реквизиты и сведения (подсистема «Свойства») — при необходимости расширить классификацию файлов без изменения метаданных.
- Программное API БСП:
РаботаСФайлами,РаботаСФайламиКлиент,РаботаСФайламиСлужебный— штатные точки для программного добавления, получения и обработки файлов. - Подписки на события
ПередЗаписью/ПередУдалениемобъекта — для интеграций (внешние хранилища, антивирусная проверка, журналирование). - Обработчик заполнения ЭСФ/СНТ — автоматическое присоединение выгруженных электронных документов к перемещению.
Версионно-специфично: точный состав общих модулей и имён экспортных процедур БСП зависит от версии библиотеки внутри поставки 3.0.74.2 — при разработке расширения имена методов следует брать из конкретной конфигурации.