1. Object Identification
| Parameter | Value |
|---|---|
| Object Type | Catalog |
| Name | ВозвратТоваровОтКлиентаПрисоединенныеФайлы |
| Full Name | Справочник.ВозвратТоваровОтКлиентаПрисоединенныеФайлы |
| Synonym | "Attached Files (Customer Goods Return)" |
| Configuration | Trade Management for Kazakhstan, ed. 3.4 (version 3.4.5.21) |
| Subsystem | "File Operations" / "Attached Files" of the Standard Subsystems Library (SSL) |
| Owner(s) | Документ.ВозвратТоваровОтКлиента |
| Hierarchy | No |
| Purpose | Storage of metadata and content of files attached by the user to the "Customer Goods Return" document (scans of return acts, photos of defects, claims, correspondence, ESF/SNT files, etc.). This is a service catalog automatically generated by the SSL attached files mechanism for a specific owner object. |
Where to find it: navigation link e1cib/list/Справочник.ВозвратТоваровОтКлиентаПрисоединенныеФайлы.
In normal operation, the user does not open this catalog directly — files are added and viewed from the "Customer Goods Return" document form via the "Attached Files" command (hyperlink/form navigation panel). Direct navigation is used by the administrator for service control.
2. Header Attributes and Tabular Sections
The catalog is subordinate: each of its items is a single attached file linked to a specific owner document via the standard Owner field. The main representation (Наименование) stores the file's name/description without an extension.
Attributes (header)
| Attribute | Type | Purpose |
|---|---|---|
Наименование (Description) |
String | Name (description) of the file displayed to the user, without extension |
Владелец (Owner) |
ДокументСсылка.ВозвратТоваровОтКлиента |
Document to which the file is attached |
ХранилищеФайла |
ValueStorage | Binary file data when stored in the infobase |
Том |
СправочникСсылка.ТомаХраненияФайлов |
Storage volume when files are stored on disk (in volumes) |
ПутьКФайлуТома |
String | Relative path to the file within the volume |
ИмяФайла |
String | Original file name |
Расширение |
String | File extension (pdf, jpg, xml, etc.) |
Размер |
Number | File size in bytes |
Автор |
Composite (СправочникСсылка.Пользователи / ВнешниеПользователи) |
User who added the file |
ДатаСоздания |
Date | Date and time the file was created in the database |
ДатаМодификацииУниверсальная |
Date | Date of last modification (UTC) |
Редактирует |
СправочникСсылка.Пользователи |
User who has checked out the file for editing (lock/checkout mechanism) |
ПодписанЭП |
Boolean | Flag indicating the presence of a digital signature |
Зашифрован |
Boolean | Flag indicating that the content is encrypted |
ТекстХранилище |
ValueStorage | Extracted file text for full-text search |
СтатусИзвлеченияТекста |
EnumRef | Text extraction status (Not extracted / Extracted / Failed) |
Tabular sections
| Tabular Section | Key Columns | Purpose |
|---|---|---|
ЭлектронныеПодписи |
Подпись (ValueStorage), ДатаПодписания, Сертификат, ОтпечатокСертификата, ИмяСертификата, Комментарий |
Storage of all digital signatures applied to the file |
СертификатыШифрования |
Сертификат (ValueStorage), ОтпечатокСертификата, Представление |
Certificates used to encrypt the file content |
Requires verification on the specific release: the exact set of attributes (presence of versioning fields
ВерсияВладелец/working copy, localization) depends on the SSL version embedded in 3.4.5.21. The basic set above corresponds to a standard attached files catalog without a separate version catalog.
3. Forms
| Form | Purpose |
|---|---|
ФормаЭлемента |
Attached file card: name, author, dates, size, "Open", "Save as", "Edit/Finish editing" buttons, digital signature and encryption operations |
| Common form of the attached files list (from the SSL subsystem) | List of all files of the owner document; called from the "Customer Goods Return" form. The catalog's own ФормаСписка is usually not overridden — the common form of the "File Operations" mechanism is used instead |
Additionally, the SSL mechanism uses common forms of the "File Operations" subsystem (file selection, version comparison, digital signature operations, encryption) that do not belong to this catalog but serve its items.
4. Key Module Procedures
No BSL code evidence is attached for the object, so below are the typical handlers for this type of object. A feature of attached files catalogs: the object's own modules (object/manager) are minimal, and the main logic is placed in SSL common modules.
Object module (typical handlers)
ПередЗаписью(Отказ)— checks the editing lock (Редактирует), synchronizes theПодписанЭП/Зашифрованflags, updatesДатаМодификацииУниверсальнаяandРазмер.ПередУдалением(Отказ)— when stored in volumes, initiates deletion of the file from disk (via service methods) to avoid leaving "orphaned" files in the volume.
SSL common modules implementing operations with the object
ПрисоединенныеФайлы— server-side application API:ДобавитьФайл(...), retrieval of the owner's file list, content updates.ПрисоединенныеФайлыКлиент/ПрисоединенныеФайлыСлужебныйВызовСервера— client scenarios for adding, opening, editing, and saving files.РаботаСФайлами,РаботаСФайламиВызовСервера,РаботаСФайламиКлиент— low-level operations: reading/writing binary data, placement in volumes or in the infobase, text extraction.ЭлектронныеПодписи/ЭлектронныеПодписиКлиент— applying, verifying, and storing digital signatures; encryption/decryption of content.ПрисоединенныеФайлыПереопределяемый— customization point for the mechanism's behavior for the owner.
5. Posting and Ledger Entries
The object does not generate its own ledger entries. This is a catalog, not a document: it is not posted and does not create records in accumulation/information registers, nor does it generate accounting entries. Attached files are auxiliary data that only affect the file storage subsystem.
Accounting entries and electronic documents are generated by the owner document ВозвратТоваровОтКлиента. Below is the accounting context based on the standard logic of returns for Kazakhstan (amounts and accounts — RK, 2026).
UT operational accounting for RK (accumulation registers, sales reversal):
ВыручкаИСебестоимостьПродаж,ДоходыИРасходы— reversal of revenue and cost of sales;ТоварыНаСкладах,ТоварыОрганизаций,СвободныеОстатки— receipt of returned goods;РасчетыСКлиентами/ВзаиморасчётыСКлиентами— reduction of customer debt;- RK VAT registers — VAT adjustment at the rate of 16%.
Equivalent accounting entries under the standard RK chart of accounts (when transferred to accounting/exchanged with an accounting configuration). Example: return of a batch worth 116,000 KZT with 16% VAT (VAT = 16,000 KZT, cost excluding VAT = 100,000 KZT), cost 70,000 KZT:
| Operation | Dr | Cr | Amount, KZT |
|---|---|---|---|
| Reversal/reduction of sales revenue | 6010 | 1210 | 100,000 |
| Reversal/reduction of VAT payable | 3130 | 1210 | 16,000 |
| Restoration of goods in warehouse | 1330 | 7010 | 70,000 |
| Refund of payment to customer (when returning money) | 1210 | 1030 | 116,000 |
Accounts: 1210 — short-term accounts receivable, 1030 — cash on current accounts, 1330 — inventory, 3130 — VAT payable, 6010 — sales revenue, 7010 — cost of sales.
Electronic documents: the return is processed by issuing a corrective/additional ESF in the ESF IS and, in case of physical movement of goods, by issuing an SNT. The XML of these documents is often what ends up in this catalog as an attached file, but they are generated by the return document itself, not by the file catalog.
6. Related Objects and Entry Based On
- Owner document:
Документ.ВозвратТоваровОтКлиента— the sole source of catalog items. - Storage volumes:
Справочник.ТомаХраненияФайлов— for file storage on disk. - Users:
Справочник.Пользователи/Справочник.ВнешниеПользователи— authors and editors of files. - Digital signature mechanism: SSL digital signature certificate and cryptography catalogs.
- Entry based on: not applicable for a service catalog of attached files. Items are created only via the "Attached Files" command from the return document form (upload from disk, clipboard, scanning, save from email).
7. Extension Points
- Overridable common modules:
ПрисоединенныеФайлыПереопределяемый,РаботаСФайламиПереопределяемый— configuration of allowed extensions, maximum size, storage behavior. - Roles and rights:
ЧтениеПрисоединенныхФайлов,ДобавлениеИзменениеПрисоединенныхФайлов— access control for return files. - Configuration extensions: customization of
ФормаЭлемента, adding custom attributes/commands without losing support status. - Storage settings: switching "infobase ↔ volumes", size limits, full-text search configuration for extracted text.
- Event subscriptions / digital signatures: additional validation when signing and encrypting return files (e.g., mandatory digital signature for scans of return acts).
- Exchange and integration: including files in exchange/synchronization rules when transferring returns and ESF to external systems.