1. Object Identification
| Parameter | Value |
|---|---|
| Object type | Catalog |
| Name | ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы |
| Full name | Catalog.ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы |
| Synonym | "Attached Files (Client Buyback of Returnable Packaging)" |
| Configuration | Trade Management for Kazakhstan, edition 3.4 (version 3.4.5.21) |
| Owner | Document.ВыкупВозвратнойТарыКлиентом |
| Hierarchy | None (simple linear list) |
| Where to find | e1cib/list/Catalog.ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы |
Purpose. A service catalog implementing the "Attached Files" subsystem (SSL, StandardSubsystems.AttachedFiles) for the "Client Buyback of Returnable Packaging" document. Each catalog item is a card for one file (a scanned act, contract, photo of packaging, PDF of a primary document, an ESF/SNT as an attachment, etc.) attached to a specific owner document. The user works with it not directly, but through the "Attached Files" command in the document form. The catalog stores file metadata and (depending on settings) the binary data of the file itself or a reference to the storage volume.
This is a typical "satellite" object of the file-handling subsystem. It does not participate in goods/monetary or tax accounting, does not generate postings, and does not affect the calculation of VAT (16% in Kazakhstan since 2026), individual income tax, mandatory pension contributions, etc. The corresponding numeric norms are given in section 5 for the context of the owner document's accounting, but apply to this catalog only indirectly (through the primary documents stored in the files).
2. Header Attributes and Tabular Sections
The object contains no tabular sections. Below is the standard set of attributes of the SSL attached files catalog.
Standard (system) attributes
| Attribute | Type | Purpose |
|---|---|---|
Ref |
CatalogRef | Unique identifier of the file card |
Code |
String/Number | Internal item code (usually not shown to the user) |
Description |
String (150) | File name without extension — shown to the user |
Owner |
DocumentRef.ВыкупВозвратнойТарыКлиентом | The document to which the file is attached |
DeletionMark |
Boolean | Marked-for-deletion flag |
Predefined |
Boolean | Not used (no predefined items) |
Attributes of the "Attached Files" subsystem
| Attribute | Type | Purpose |
|---|---|---|
FileStorage |
ValueStorage | Binary file data when stored in the infobase (empty when stored in volumes) |
PathToFile |
String | Relative path to the file in the volume (when stored on disk/in volumes) |
Volume |
CatalogRef.FileStorageVolumes | Storage volume, if the file is stored outside the infobase |
Extension |
String | File extension (pdf, jpg, xml, docx, etc.) |
Size |
Number | File size in bytes |
FileDescription |
String | Free-form text description/comment about the file |
CreationDate |
Date | File creation date (from the source file's attributes) |
ModificationDate |
Date | File modification date |
UniversalModificationDate |
Date | Date the card was last modified (UTC), for synchronization |
EditProhibition |
Boolean | "Read only" flag |
BeingEditedBy |
CatalogRef.Users | User who has checked out the file for editing (lock) |
SignedWithES |
Boolean | File is signed with an electronic signature |
Encrypted |
Boolean | File is encrypted |
TextExtraction / TextStorage |
ValueStorage | Extracted file text for full-text search |
TextExtractionStatus |
String/Enumeration | Text indexing state (Not extracted / Extracted / Error / Extraction unavailable) |
AutomaticCleanup |
Boolean | Participation in scheduled cleanup of outdated versions |
Version tabular section (if the versioning mechanism is enabled)
Storage of file versions is usually implemented via a separate subordinate catalog ...AttachedFilesFileVersions or a tabular section with fields: VersionNumber, FileStorage/PathToFile, Size, Author, CreationDate, Comment. In the base delivery, versioning for document attached files is usually disabled.
3. Forms
| Form | Purpose |
|---|---|
ItemForm (ObjectForm) |
File card: name, description, size, author, dates, "Open," "Save as…," "Edit"/"Finish editing," "Sign with ES," "Encrypt" buttons. Main interface for working with a single file |
| ListForm | Full list of attached files (opened via a navigation link). Generally a service form — a regular user does not typically open the whole list |
| Selection form | Select a file from those already attached (used by related mechanisms) |
The user's main working environment is not the catalog's own forms, but the common subsystem form CommonForm.AttachedFiles (or the managed attached-files form), invoked via the "Attached Files" command from the ВыкупВозвратнойТарыКлиентом document form. It displays the list of files for the given document and provides commands to add (from disk, from scanner, from clipboard), open, delete, and print the list.
4. Key Module Procedures
The attached evidence contains only the
naznachenie(purpose) facet; the BSL sources and exactpath:lineaddresses were not provided. Below is a typical set of handlers for the SSL attached-files catalog. The specific procedure names are version-stable within the SSL supplied with Trade Management for Kazakhstan 3.4.
Object module (ObjectModule)
BeforeWrite(Cancel)— records the universal modification date, checks whether the file is checked out for editing, updates signature/encryption flags.BeforeDelete(Cancel)— when stored in volumes, initiates deletion of the physical file from the volume (viaFileOperationsInternal), cleans up versions.OnCopy(CopiedObject)— resets service fields (locks, ES) on the copy.
Manager / common subsystem modules
The logic resides in SSL common modules; the catalog only provides attributes for storage:
FileOperations/FileOperationsClient— adding a file, opening, saving, editing in an external program.FileOperationsInternal/...ServerCall— writing binary data to the infobase or volume, reading, moving between volumes, obtaining a file reference.FileFunctions/FileOperationsInternalClientServer— calculating size, generating the path in the volume, determining extension and MIME type.TextExtractionServer— extracting text for full-text search (populatingTextExtraction,TextExtractionStatus).- The
OnDefiningFileOperationsSettingshandler (in the owner document's module or an overridable module) — registers the catalog as the file storage for theВыкупВозвратнойТарыКлиентомdocument.
Forms
ItemForm.OnCreateAtServer/OnOpen— populates card attributes, configures command availability based on theEditProhibition,SignedWithES,Encryptedflags.
5. Posting and Movements
The catalog is not posted and generates no register movements — it is a file storage object, not an accounting document.
Business postings and movements are generated by the owner document, "Client Buyback of Returnable Packaging". For context, below is a typical accounting model for this operation under the Kazakhstan chart of accounts and 2026 Kazakhstan tax rules.
Owner document registers (typical set)
AccumulationRegister.RevenueAndCostOfSalesAccumulationRegister.GoodsInWarehouses/AvailableBalancesAccumulationRegister.SettlementsWithClients(orSettlementsWithPartners)AccumulationRegister.VATAccrued- Registers for generating ESF (ESF IS) and SNT electronic documents.
Typical postings under the Kazakhstan chart of accounts
| Operation | Debit | Credit |
|---|---|---|
| Recognized income from sale of packaging to client | 1210 (short-term receivables from buyers) | 6010 (sales revenue) |
| VAT 16% accrued payable | 1210 | 3130 (VAT payable) |
| Cost of packaging written off | 7010 (cost of sales) | 1330 (inventory) |
| Payment received from client | 1030 (cash on current accounts) | 1210 |
Example. Packaging is sold for 100,000 ₸ excluding VAT. VAT 16% = 16,000 ₸. Total payable: 116,000 ₸.
- Dr 1210 Cr 6010 — 100,000 ₸;
- Dr 1210 Cr 3130 — 16,000 ₸;
- Dr 7010 Cr 1330 — cost (at book value);
- Dr 1030 Cr 1210 — 116,000 ₸ upon receipt of payment.
An ESF is issued for the operation, and an SNT is drawn up if necessary.
Reference Kazakhstan tax constants for 2026 (used in the company's accounting, not directly related to files): MCI = 4,325 ₸, minimum wage = 85,000 ₸; individual income tax 10% up to 8,500 MCI of annual income and 15% above; basic individual income tax deduction — 30 MCI/month (no more than 360 MCI/year); mandatory pension contributions 10% (base cap of 50 minimum wages), employer pension contributions 3.5%, mandatory employer social health insurance 2%, mandatory social health insurance 3%, social contributions 5%, social tax 6%.
6. Related Objects and Entering Based On
| Relationship | Object | Nature of the relationship |
|---|---|---|
| Owner | Document.ВыкупВозвратнойТарыКлиентом |
Parent; when the document is marked for deletion, the presence of attached files is checked |
| Subsystem | StandardSubsystems.FileOperations (SSL) |
All file storage/handling functionality |
| Storage volumes | Catalog.FileStorageVolumes |
Physical location of files when stored outside the infobase |
| Electronic signatures | DigitalSignature subsystem |
Signing/encrypting files |
| Users | Catalog.Users |
File author, editing user (lock) |
| File versions | ...AttachedFilesFileVersions (when versioning is enabled) |
Storage of version history |
Entering based on. Not applicable. Catalog items are created exclusively through the mechanism of attaching a file to the owner document (the "Attached Files" → "Add" button). Manually creating an item via the list is impractical and usually not available interactively.
7. Extension Points
- File storage. Configured in the "Administration → File operations settings" section: storage in the infobase or in volumes (
FileStorageVolumes), maximum size limit, list of prohibited extensions. - Configuration extension (without removal from support). Adding attributes to the catalog and columns/commands to the common attached-files form; subscribing to
BeforeWrite/BeforeDeleteevents. - Overridable SSL modules.
FileOperationsOverridable,FileOperationsInternalOverridable— registering storage settings, restrictions, additional processing when adding/deleting. - Versioning. Enabling file version storage and retention depth.
- Full-text search. Indexing
TextExtractionfor searching attachment content. - Scheduled jobs. "Cleanup of outdated file versions," "File text extraction," "Moving files to volumes."
- ES and encryption. Connecting signing and encryption of attachments via the digital signature subsystem (relevant for ESF/SNT stored as files).
Requires verification in the specific version 3.4.5.21: the presence/composition of the subordinate file-versions catalog and the exact set of text-indexing attributes — depend on the SSL version built into this assembly. The rest of the attribute composition and logic for attached-files catalogs are stable.
