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