1. Identification
| Parameter | Value |
|---|---|
| Object type | Catalog |
| Name | ВиртуальныеСкладыКонтрагента |
| Full name | Catalog.ВиртуальныеСкладыКонтрагента |
| Synonym | "Counterparty Virtual Warehouses" |
| Configuration | Trade Management for Kazakhstan, edition 3.4 (version 3.4.5.21) |
| Where to find | Section "Electronic Waybills" → "Counterparty Virtual Warehouses" |
| Navigation link | e1cib/list/Справочник.ВиртуальныеСкладыКонтрагента |
Purpose. The catalog stores a list of virtual warehouses of counterparties (suppliers and customers) registered in the state "Virtual Warehouse" Module of the ESF IS of the State Revenue Committee of the RK. A virtual warehouse is an accounting unit of the tax system used for end-to-end state tracking of the movement of traceable goods, broken down by specific taxpayer. Catalog values are substituted into electronic documents SNT (goods waybill) and ESF as the sender/receiver warehouse on the counterparty side, ensuring correct issuance and receipt of documents in the ESF IS.
Difference from "own" virtual warehouses: the catalog ВиртуальныеСклады (or analog) describes virtual warehouses of the user's own organizations, while this catalog describes virtual warehouses of third-party counterparties, needed to fill in the details of the other party of the electronic document.
2. Header attributes and tabular sections
The attached evidence contains only the "purpose" facet; the composition of attributes below is given based on the standard model of virtual warehouse catalogs in UT KZ 3.4. Verify the exact composition in configurator for build 3.4.5.21.
Standard attributes
| Attribute | Type | Purpose |
|---|---|---|
Код |
String | Internal code of the catalog item. |
Наименование |
String | Representation of the virtual warehouse for selection in documents. |
Владелец |
CatalogRef.Counterparties | The counterparty who owns the virtual warehouse (the catalog is generally subordinate to the counterparty). |
ПометкаУдаления |
Boolean | Standard deletion mark. |
Предопределённый |
Boolean | Predefined item flag (usually not used). |
Attributes specific to the RK virtual warehouse
| Attribute | Type | Purpose |
|---|---|---|
НомерВиртуальногоСклада / ИдентификаторВС |
String | Unique number (GUID/identifier) of the virtual warehouse in the ESF IS. Key attribute for data exchange. |
АдресМестаНахождения |
String | Address of the physical storage location linked to the virtual warehouse. |
КодАТЕ / КАТО |
String | Code of the administrative-territorial unit of the warehouse location. |
Комментарий |
String | Free-form description. |
Tabular sections in a catalog of this type are generally absent — this is a flat card-type item.
3. Forms
| Form | Purpose |
|---|---|
ФормаЭлемента |
Counterparty virtual warehouse card: entering/editing owner, VW number in ESF IS, address and KATO. |
ФормаСписка |
List of warehouses; used during navigation via e1cib/list/… and for filtering by counterparty-owner. |
ФормаВыбора |
Selection of a virtual warehouse for SNT/ESF document attributes. |
If no custom forms are defined, the platform uses auto-generated forms; the standard delivery typically defines at least ФормаЭлемента to control mandatory attributes.
4. Key module procedures
No BSL evidence attached. Below is a typical set of handlers for a catalog of this kind; verify signatures against the code in the actual build.
Object module:
ОбработкаЗаполнения(ДанныеЗаполнения, СтандартнаяОбработка)— fills the owner-counterparty when entering from the counterparty card or on the basis of another document.ПередЗаписью(Отказ)— checks thatВладелецandНомерВиртуальногоСкладаare filled in, verifies uniqueness of the VW number per counterparty.ПриКопировании(ОбъектКопирования)— clears the VW identifier to avoid duplicating the number from the ESF IS.
Item form module:
ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)— configures attribute availability, sets the owner from parameters.ПриЗаписиНаСервере(...)— additional validation of exchange attributes.
5. Posting and movements
The catalog is not a postable object — by itself it does not generate register movements or accounting entries. It serves as the source of a value (counterparty warehouse) for electronic documents and goods movement documents.
Movements are generated by documents referencing the catalog item (sales/receipt, SNT, reflection in regulated accounting). Following the standard logic of UT KZ 3.4 and the RK chart of accounts:
Sale of goods to a customer (VAT rate 16%):
| Dr | Cr | Content |
|---|---|---|
| 1210 | 6010 | Sales revenue accrued (customer debt) |
| 1210 | 3130 | VAT payable (16%) on sales |
| 7010 | 1330 | Cost of goods sold written off |
| 1030 | 1210 | Payment received to current account |
Example. Sale of a batch of goods for 1,000,000 ₸ excluding VAT:
- VAT 16% = 160,000 ₸ → Dr 1210 Cr 3130;
- amount payable by customer = 1,160,000 ₸ → Dr 1210 Cr 6010 (1,000,000) and Cr 3130 (160,000);
- cost of goods sold (e.g., 700,000 ₸) → Dr 7010 Cr 1330.
Receipt of goods from a supplier:
| Dr | Cr | Content |
|---|---|---|
| 1330 | 3310 | Goods received |
| 1420 | 3310 | Input VAT creditable on purchase (16%) |
| 3310 | 1030 | Payment to supplier |
In this case, the attribute from this catalog is used as the "counterparty's virtual warehouse" in SNT/ESF and in state traceability records, but does not directly affect the accounting entries.
All numerical norms are given for the RK for 2026: VAT rate 16%, MCI (MRP) 4,325 ₸, minimum wage (MZP) 85,000 ₸.
6. Related objects and entry on the basis of
Exchange and electronic documents:
- SNT — goods waybill (ESF IS): the counterparty's warehouse is filled in from this catalog.
- ESF — electronic invoice: the virtual warehouse participates in the traceable goods block.
Referencing catalogs/documents:
Catalog.Counterparties— owner of the item.- Goods movement documents (sales/receipt) — use the counterparty's warehouse when generating SNT.
Entry on the basis of: the typical scenario is creating an item directly from the counterparty card ("Virtual Warehouses" button) or automatic filling when loading incoming SNT/ESF from the ESF IS, when the counterparty's VW number is not yet registered in the database.
7. Extension points
- Configuration extension: adding attributes (e.g., a "Main counterparty warehouse" flag, external accounting system code) via an extension while preserving exchange compatibility.
- Object module handlers: subscriptions to
ПередЗаписью/ПриЗаписиevents for additional validation of the VW number format in accordance with ESF IS. - Additional attributes/information: the "Properties" mechanism (
ПланыВидовХарактеристик) for storing non-standard attributes without changing the structure. - SNT/ESF filling rules: overriding the algorithm for selecting the counterparty's virtual warehouse when issuing electronic documents.
- Loading from ESF IS: refinement of item auto-creation procedures when receiving incoming documents (matching by VW number).
Version-specific (requires verification in build 3.4.5.21): the exact composition of exchange attributes and module procedure names — the object's composition in edition 3.4 is periodically expanded to accommodate changes in the ESF IS format.
