Directory «VirtualWarehouses»
Integration object with the electronic invoice information system (ESF) and the traceability system of goods in the Republic of Kazakhstan. The directory stores locations for accounting of inventory items registered (or subject to registration) in the state information system.
1. Identification
| Parameter | Value |
|---|---|
| Object Type | Directory (Catalog) |
| Name | VirtualWarehouses |
| Full Name | Directory.VirtualWarehouses / Catalogs.VirtualWarehouses |
| Alias | — (not specified in the configuration) |
| Configuration | Accounting for Kazakhstan, edition 3.0, version 3.0.74.2 |
| Country/Specificity | Republic of Kazakhstan, 2026 |
Purpose. The directory is intended for integration with the electronic invoice information system (ESF) of the RK. Virtual warehouses describe storage locations for goods registered in the state traceability system: regular warehouses, public warehouses (warehouse services for third parties), USD warehouses (simplified declaration system), leasing warehouses, processing warehouses for raw materials (tolling), warehouses of reorganized entities. Each record is associated with the owning organization and receives a unique identifier in the ESF. The directory is used by accountants and logistics specialists to set up accounting locations, synchronize with the external ESF system, and control balances.
Where to find in 1C: section “Nomenclature and Warehouse” → “Virtual Warehouses”.
Navigation link: e1cib/list/Directory.VirtualWarehouses
2. Header Attributes and Table Parts
2.1 Header Attributes
| Name | Type | Mandatory | Purpose |
|---|---|---|---|
| Organization | Reference (DirectoryReference.Organizations) |
ShowError | The organization owning the virtual warehouse. Mandatory, participates in controlling the uniqueness of warehouse attributes within the organization. |
| WarehouseType | EnumRef.WarehouseTypes |
DontCheck | Type of warehouse (regular, public, USD, leasing, etc.). Determines the set of available attributes and operating rules. |
| Status | EnumRef.WarehouseStatuses |
DontCheck | Status in the ESF (“NotCreatedInESF”, “Active”, “Blocked”, etc.). Managed automatically during synchronization. |
| WarehouseID | xs:decimal |
DontCheck | Unique numerical ID of the warehouse in the ESF. Assigned automatically after registration via API. |
| ReceivingIndicator | xs:boolean |
DontCheck | Warehouse for receiving goods according to the goods declaration (GD). Can only be set for one warehouse of the organization. |
| IsDefaultWarehouse | xs:boolean |
DontCheck | Priority (main) warehouse of the organization. Only one per organization. |
| ControlBalances | xs:boolean |
DontCheck | Indicator for controlling inventory balances at the warehouse during document processing. |
| Address | xs:string |
DontCheck | Physical address of the warehouse, transmitted during registration in the ESF. |
| ResponsiblePersonINN | xs:string |
DontCheck | INN of the person responsible for the warehouse. Required for registration in the ESF. |
| PublicWarehouseIndicator | xs:boolean |
DontCheck | Public warehouse (warehouse services for third parties). Affects accounting rules and document flow. |
| USDWarehouse | xs:boolean |
DontCheck | Warehouse for accounting goods under the simplified declaration system. |
| ReorganizedEntityWarehouse | xs:boolean |
DontCheck | Warehouse of a reorganized legal entity. Used during reorganization procedures. |
| TollingOperationsWarehouse | xs:boolean |
DontCheck | Warehouse for tolling operations. |
| LeasingWarehouse | xs:boolean |
DontCheck | Warehouse for goods transferred for leasing. Requires filling in lessee data. |
Standard directory attributes: Code, Name, DeletionMark, Predefined. Flags (ReceivingIndicator, IsDefaultWarehouse) are mutually exclusive within one organization — control is implemented during filling/checking.
2.2 Table Parts
Table parts are not provided in the directory (it is a flat directory of warehouse attributes). Data of lessees, responsible persons, and other attributes are stored in the header attributes or in related registers of ESF synchronization information.
3. Forms
| Form | Purpose |
|---|---|
ListForm (ListForm) |
Main form for selecting and viewing the list of virtual warehouses. Typically filtered by the current organization and includes columns “Name”, “Type”, “Status”, “ID in ESF”. |
ElementForm (ObjectForm) |
Form for creating/editing a warehouse: attributes of the organization, type, indicators, address, and INN of the responsible person, displaying status and ESF identifier. Manages visibility/accessibility of fields depending on WarehouseType (for example, leasing fields when LeasingWarehouse is set). |
| SelectionForm | Used when selecting a warehouse in documents and processes (may coincide with the list form). |
If there are additional forms in a specific delivery (for example, a warehouse registration assistant in the ESF) — their composition is specified according to the metadata of the version. Requires verification for a specific build.
4. Key Module Procedures
Evidence with module texts (BSL) for this object is not attached — below are the typical handlers for this type of object; specific lines of modules are specified according to the version code.
Object Module (ObjectModule):
CheckFilling(Refusal, CheckedAttributes)— control of fillingOrganization; checking the exclusivity ofReceivingIndicatorandIsDefaultWarehouse(no more than one warehouse with the indicator for the organization); checking filling ofAddress/ResponsiblePersonINNwhen preparing for registration in the ESF.BeforeSaving(Refusal)— removing the same indicator from other warehouses of the same organization when settingReceivingIndicator/IsDefaultWarehouse; adjusting the status.OnCopying(CopyingObject)— clearingWarehouseIDandStatus(ESF identifier is unique and not copied).
Element Form Module (ObjectForm):
OnCreationOnServer/OnReadingOnServer— setting visibility and accessibility of fields depending onWarehouseTypeand indicators (leasing, tolling, USD, public).<Indicator>OnChange(flag handlers) — recalculation of dependent visibility, blocking incompatible indicators.- Commands for interaction with the ESF (registration/updating/blocking of the warehouse) — calling server integration methods, obtaining
WarehouseIDand updatingStatus.
Manager Module (ManagerModule):
- Functions for obtaining the default warehouse/receiving warehouse for the organization, used from documents and common ESF integration modules.
5. Processing and Movements
The directory is not a document and is not processed — it does not generate its own movements in accumulation registers and accounting entries. The virtual warehouse acts as analytics (measurement) and an integration parameter for documents and registers.
How the object participates in accounting and document movements:
- ESF/SNT synchronization information registers — store the correspondence of the warehouse to its identifier and status in the ESF, registration and exchange history.
- Traceability of goods — the warehouse attribute is included in electronic documents: ESF (ESF) and SNT (accompanying invoices for goods) to indicate the storage/movement location of inventory items.
- Balance control — when
ControlBalances = True, goods movement documents reconcile balances by virtual warehouse.
Typical accounting entries for documents using the warehouse (RK chart of accounts, for reference):
| Operation | Debit | Credit |
|---|---|---|
| Receipt of goods to the warehouse | 1330 “Goods” | 3310 “Payables to suppliers” |
| Input VAT (16%) | 1420 “VAT” | 3310 |
| Sale of goods (revenue) | 1210 “Receivables from customers” | 6010 “Revenue from sales” |
| VAT on sales (16%) | 1210 | 3130 “VAT payable” |
| Cost of goods sold | 7010 “Cost of goods sold” | 1330 “Goods” |
| Payment from the customer | 1030 “Cash in current accounts” | 1210 |
The VAT rate in the RK from 2026 is 16%. Example: goods worth 1,000,000 ₸ → VAT 160,000 ₸ → total payment 1,160,000 ₸.
The directory itself does not participate in these entries from an accounting perspective, but it defines the warehouse analytics of inventory movements and storage location for ESF/SNT.
6. Related Objects and Input Based On
Related metadata:
Directory.Organizations— owner of the warehouse (attributeOrganization).Enumeration.WarehouseTypes— type of warehouse.Enumeration.WarehouseStatuses— status in the ESF.- Information registers of the subsystem for exchange with the ESF / SNT (correspondences, statuses, exchange log).
Usage in documents: the virtual warehouse attribute is substituted in commodity documents and electronic traceability documents — ESF and SNT, as well as in documents for receipt/sale/movement of goods when forming their electronic forms.
Input Based On. For the directory, input based on in the typical sense (creating a document “based on” an element) is not characteristic. The reverse — filling in the warehouse attribute in documents through selection from the directory, as well as auto-substitution of the default warehouse/receiving warehouse for the organization.
7. Extension Points
- Configuration Extension (Extensions): adding custom attributes (for example, additional attributes for internal logistics), borrowing element/list forms with added commands.
- Event Handlers of the Object Module:
BeforeSaving,CheckFilling— for additional control of indicators and mandatory fields according to the organization’s requirements. - Event Subscriptions: reaction to the recording of an element to initiate external synchronization with the ESF.
- Additional attributes and information (the “Properties” mechanism) — if support for PVC/additional attributes is enabled for the object.
- Integration through the manager module / common ESF modules: overridable procedures for registering and updating the warehouse in the ESF via API.
Version-specific (requires verification for 3.0.74.2): the exact composition of enumerations
WarehouseTypes/WarehouseStatusesand the presence of auxiliary registration assistant forms in the ESF.