oneCInteraction 1.2.3__tar.gz → 1.2.5__tar.gz

{onecinteraction-1.2.3/src/oneCInteraction.egg-info → onecinteraction-1.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oneCInteraction
-Version: 1.2.3
+Version: 1.2.5
 Summary: A Python library for interacting with 1C:Enterprise databases via COM connection.
 Author: agcl
 Classifier: Programming Language :: Python :: 3
@@ -21,6 +21,7 @@ A modular Python library for interacting with «1C:Enterprise» databases via a
 - **Full COM Connection Support** via `win32com`.
 - **Nomenclature and Categories Management**: retrieve group trees, batch load products, prices, and stock balances across warehouses.
 - **Product Characteristics**: read variant properties from information registers or parse text descriptions.
+- **Product Properties (Metadata)**: read and write general metadata (properties) of Nomenclature items to/from information registers.
 - **Images**: download product images directly from the 1C database to the local disk.
 - **Order Management**: create customer orders, track statuses, and update document comments with customer contact details.
 - **Smart Logging**: automatically creates log files in the directory of the host project importing the library.
@@ -48,6 +49,7 @@ The library is built on the principle of composition: the main `Connection` clas
 - `Connection.orders` (`OrdersManager`) — handles creation and updates of customer orders.
 - `Connection.customers` (`CustomersManager`) — manages customers/counterparties.
 - `Connection.discounts` (`DiscountsManager`) — manages discount groups and active nomenclature discounts.
+- `Connection.properties` (`PropertiesManager`) — manages reading and writing general product properties.
 
 ---
 
@@ -68,7 +70,7 @@ def __init__(self, s_oneCDatabasePathIn: str, s_usernameIn: str, s_passwordIn: s
 - `s_warehouse_code` (str): 1C warehouse code for new orders.
 - `s_counteragent_code` (str): 1C counteragent (customer) code for new orders.
 - `s_organisation_code` (str): 1C organization code for new orders.
-- `sl_price_types` (list): List of price type names to cache automatically (defaults to `["Розничная", "Оптовая"]`).
+- `sl_price_types` (list): List of price type names to cache automatically (defaults to `["Розничная", "Оптовая", "Закупочная"]`).
 - `c_v8`: The active 1C COM connection object (equals `None` if not connected).
 
 #### Methods:
@@ -92,6 +94,8 @@ Represents a product.
 - `s_uuid` (str): Unique identifier (UUID) of the product in 1C.
 - `s_code` (str): 1C product code.
 - `l_images` (list): List of image UUIDs associated with the product in 1C.
+- `dt_last_arrival` (datetime): Date of the last physical arrival of the product to the warehouse from 1C.
+- `l_properties` (list of `Property`): List of general properties (metadata) of the product.
 
 #### `Price`
 Represents a price with its value, assignment date, and type.
@@ -112,6 +116,11 @@ A key-value pair for a variant property.
 - `s_name` (str): Property name (e.g., `"Color"`).
 - `s_value` (str): Property value (e.g., `"Red"`).
 
+#### `Property`
+A key-value pair for a product property (metadata).
+- `s_name` (str): Property name (e.g., `"Material"`).
+- `s_value` (str): Property value (e.g., `"Cotton"`).
+
 #### `Group`
 A product group (category).
 - `s_name` (str): Group name.
@@ -153,6 +162,8 @@ A buyer's order.
 - `s_status` (str): Status of the order in 1C.
 - `s_date` (str): Order creation date (automatically generated).
 - `n_orderCode` (str / int): Order number in 1C.
+- `s_price_type` (str): Price type name used for the order (e.g. `"Розничная"`, `"Оптовая"`, `"Закупочная"`).
+- `s_comment` (str): Additional comment/notes for the order (often parsed to extract Telegram ID).
 
 Calling `str(order_obj)` returns a nicely formatted HTML string suitable for sending to a Telegram bot.
 
@@ -170,13 +181,15 @@ Represents a group of nomenclature discounts.
 Defined in [nomenclature.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/nomenclature.py).
 
 - `get(s_articleIn: str = "", s_nameIn: str = "", s_codeIn: str = "") -> Nomenclature | None`
-  Searches for and returns a product by its article, name, or code. Fetches retail/wholesale prices, stock balances by warehouses, and characteristics.
+  Searches for and returns a product by its article, name, or code. Fetches retail, wholesale, and purchase prices, stock balances by warehouses, characteristics, and the parent group's UUID (`s_parent_uuid`).
+- `search(s_queryIn: str, s_searchByIn: str = "all") -> list`
+  Searches for nomenclature items by a query string matching the name, article, code, or all of them. Returns a list of `Nomenclature` objects (without full detailed price/stock breakdown, but containing basic fields).
 - `get_images(c_productObjIn: Nomenclature, s_imageDirIn: str = None) -> list`
   Downloads all attached images for a product from 1C. Saves them in the specified directory `s_imageDirIn` (defaults to `data/images`). Returns a list of the saved filenames (e.g., `["[uuid]_0.jpg"]`).
 - `get_by_group(c_groupRefIn) -> list`
   Batch fetches all products within a specific 1C group. Using optimized COM queries, this method minimizes DB requests and operates significantly faster than calling `get()` sequentially in a loop.
-- `get_by_category(c_categoryIn, s_attributeNameIn: str = "ВидНоменклатуры", s_catalogNameIn: str = "ВидыНоменклатуры") -> list`
-  Batch fetches all products within a specific 1C category (by default using the `ВидНоменклатуры` attribute in the `ВидыНоменклатуры` catalog). `c_categoryIn` can be a COM reference object or a string representing the category name.
+- `get_by_category(c_categoryIn) -> list`
+  Batch fetches all products within a specific 1C category. `c_categoryIn` can be a COM reference object or a string representing the category name (searched within `Справочник.КатегорииОбъектов`).
 
 ---
 
@@ -196,9 +209,9 @@ Defined in [groups.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/
 Defined in [categories.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/categories.py).
 
 - `get(s_codeIn: str = "", s_nameIn: str = "") -> Category | None`
-  Finds a single Category by its code or name in the `ВидыНоменклатуры` catalog.
+  Finds a single Category by its code or name in the `КатегорииОбъектов` (Object Categories) catalog.
 - `create(s_nameIn: str) -> Category | None`
-  Creates a new Category with the specified name in `Справочник.ВидыНоменклатуры` and returns it.
+  Creates a new Category with the specified name in `Справочник.КатегорииОбъектов` and returns it.
 
 ---
 
@@ -220,12 +233,12 @@ Defined in [orders.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/
 - `push(c_orderObjIn: Order) -> str`
   Creates a new `"Заказ покупателя"` (Buyer's Order) document in 1C.
   - Automatically queries the warehouse, counteragent, and organization based on codes specified in the `Connection` object.
-  - Sets the retail price type, document currency (Hryvnia, code `"980"`), and organization's primary bank account.
-  - Adds products from the order, queries the exact price for the specific characteristic selected, and computes totals.
+  - Sets the price type (defaulting to `"Розничная"` or using `s_price_type` from the order), document currency (Hryvnia, code `"980"`), and organization's primary bank account.
+  - Adds products from the order, queries/compares the exact price for the specific characteristic selected (using `s_price_type` to determine retail, wholesale, or purchase price), and computes totals.
   - Attempts to post the document (`Posting`). If posting fails, it writes the document in draft/save mode (`Write`).
   - Returns the number of the created document in 1C (or an empty string on error).
 - `get(s_codeIn: str) -> Order | None`
-  Retrieves a buyer's order by its 1C document number and parses it into an `Order` object. The comment field is parsed to retrieve the Telegram ID.
+  Retrieves a buyer's order by its 1C document number and parses it into an `Order` object. The comment field is parsed to retrieve the Telegram ID, and the price type is retrieved.
 - `get_today() -> list`
   Returns a list of all today's orders created for the configured bot counteragent (filtered by current date and counteragent code).
 - `update_info(c_orderObjIn: Order) -> bool`
@@ -259,7 +272,23 @@ Defined in [discounts.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionL
 
 ---
 
-### 10. Logging (`log.py`)
+### 10. Properties Manager `PropertiesManager` (`Connection.properties`)
+Defined in [properties.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/properties.py).
+
+- `write(self, c_productIn, s_propertyNameOrCodeIn: str, s_propertyValueIn: str) -> bool`
+  Writes or updates a single property value for a product (Nomenclature item).
+- `write_batch(self, c_productIn, l_propertiesIn: list, b_forceIn: bool = False) -> list`
+  Writes/updates multiple properties for a product using a single 1C RecordSet. `l_propertiesIn` can be a list of `Property` objects or dicts `{"name": "...", "value": "..."}`.
+- `get_assigned_properties(self, c_productIn) -> list`
+  Returns a list of `Property` objects assigned to the specified product.
+- `delete(self, c_productIn, s_propertyNameOrCodeIn: str) -> bool`
+  Removes a specific property from a product in 1C register.
+- `get_all_definitions(self) -> list`
+  Retrieves definitions of all active properties in 1C.
+
+---
+
+### 11. Logging (`log.py`)
 Defined in [log.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/log.py).
 
 All actions are logged automatically. The library resolves the root directory of the project that imported it and stores log files in the relative path `log/system/[calling_module_name].log`.

{onecinteraction-1.2.3 → onecinteraction-1.2.5}/README.md

@@ -6,6 +6,7 @@ A modular Python library for interacting with «1C:Enterprise» databases via a
 - **Full COM Connection Support** via `win32com`.
 - **Nomenclature and Categories Management**: retrieve group trees, batch load products, prices, and stock balances across warehouses.
 - **Product Characteristics**: read variant properties from information registers or parse text descriptions.
+- **Product Properties (Metadata)**: read and write general metadata (properties) of Nomenclature items to/from information registers.
 - **Images**: download product images directly from the 1C database to the local disk.
 - **Order Management**: create customer orders, track statuses, and update document comments with customer contact details.
 - **Smart Logging**: automatically creates log files in the directory of the host project importing the library.
@@ -33,6 +34,7 @@ The library is built on the principle of composition: the main `Connection` clas
 - `Connection.orders` (`OrdersManager`) — handles creation and updates of customer orders.
 - `Connection.customers` (`CustomersManager`) — manages customers/counterparties.
 - `Connection.discounts` (`DiscountsManager`) — manages discount groups and active nomenclature discounts.
+- `Connection.properties` (`PropertiesManager`) — manages reading and writing general product properties.
 
 ---
 
@@ -53,7 +55,7 @@ def __init__(self, s_oneCDatabasePathIn: str, s_usernameIn: str, s_passwordIn: s
 - `s_warehouse_code` (str): 1C warehouse code for new orders.
 - `s_counteragent_code` (str): 1C counteragent (customer) code for new orders.
 - `s_organisation_code` (str): 1C organization code for new orders.
-- `sl_price_types` (list): List of price type names to cache automatically (defaults to `["Розничная", "Оптовая"]`).
+- `sl_price_types` (list): List of price type names to cache automatically (defaults to `["Розничная", "Оптовая", "Закупочная"]`).
 - `c_v8`: The active 1C COM connection object (equals `None` if not connected).
 
 #### Methods:
@@ -77,6 +79,8 @@ Represents a product.
 - `s_uuid` (str): Unique identifier (UUID) of the product in 1C.
 - `s_code` (str): 1C product code.
 - `l_images` (list): List of image UUIDs associated with the product in 1C.
+- `dt_last_arrival` (datetime): Date of the last physical arrival of the product to the warehouse from 1C.
+- `l_properties` (list of `Property`): List of general properties (metadata) of the product.
 
 #### `Price`
 Represents a price with its value, assignment date, and type.
@@ -97,6 +101,11 @@ A key-value pair for a variant property.
 - `s_name` (str): Property name (e.g., `"Color"`).
 - `s_value` (str): Property value (e.g., `"Red"`).
 
+#### `Property`
+A key-value pair for a product property (metadata).
+- `s_name` (str): Property name (e.g., `"Material"`).
+- `s_value` (str): Property value (e.g., `"Cotton"`).
+
 #### `Group`
 A product group (category).
 - `s_name` (str): Group name.
@@ -138,6 +147,8 @@ A buyer's order.
 - `s_status` (str): Status of the order in 1C.
 - `s_date` (str): Order creation date (automatically generated).
 - `n_orderCode` (str / int): Order number in 1C.
+- `s_price_type` (str): Price type name used for the order (e.g. `"Розничная"`, `"Оптовая"`, `"Закупочная"`).
+- `s_comment` (str): Additional comment/notes for the order (often parsed to extract Telegram ID).
 
 Calling `str(order_obj)` returns a nicely formatted HTML string suitable for sending to a Telegram bot.
 
@@ -155,13 +166,15 @@ Represents a group of nomenclature discounts.
 Defined in [nomenclature.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/nomenclature.py).
 
 - `get(s_articleIn: str = "", s_nameIn: str = "", s_codeIn: str = "") -> Nomenclature | None`
-  Searches for and returns a product by its article, name, or code. Fetches retail/wholesale prices, stock balances by warehouses, and characteristics.
+  Searches for and returns a product by its article, name, or code. Fetches retail, wholesale, and purchase prices, stock balances by warehouses, characteristics, and the parent group's UUID (`s_parent_uuid`).
+- `search(s_queryIn: str, s_searchByIn: str = "all") -> list`
+  Searches for nomenclature items by a query string matching the name, article, code, or all of them. Returns a list of `Nomenclature` objects (without full detailed price/stock breakdown, but containing basic fields).
 - `get_images(c_productObjIn: Nomenclature, s_imageDirIn: str = None) -> list`
   Downloads all attached images for a product from 1C. Saves them in the specified directory `s_imageDirIn` (defaults to `data/images`). Returns a list of the saved filenames (e.g., `["[uuid]_0.jpg"]`).
 - `get_by_group(c_groupRefIn) -> list`
   Batch fetches all products within a specific 1C group. Using optimized COM queries, this method minimizes DB requests and operates significantly faster than calling `get()` sequentially in a loop.
-- `get_by_category(c_categoryIn, s_attributeNameIn: str = "ВидНоменклатуры", s_catalogNameIn: str = "ВидыНоменклатуры") -> list`
-  Batch fetches all products within a specific 1C category (by default using the `ВидНоменклатуры` attribute in the `ВидыНоменклатуры` catalog). `c_categoryIn` can be a COM reference object or a string representing the category name.
+- `get_by_category(c_categoryIn) -> list`
+  Batch fetches all products within a specific 1C category. `c_categoryIn` can be a COM reference object or a string representing the category name (searched within `Справочник.КатегорииОбъектов`).
 
 ---
 
@@ -181,9 +194,9 @@ Defined in [groups.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/
 Defined in [categories.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/categories.py).
 
 - `get(s_codeIn: str = "", s_nameIn: str = "") -> Category | None`
-  Finds a single Category by its code or name in the `ВидыНоменклатуры` catalog.
+  Finds a single Category by its code or name in the `КатегорииОбъектов` (Object Categories) catalog.
 - `create(s_nameIn: str) -> Category | None`
-  Creates a new Category with the specified name in `Справочник.ВидыНоменклатуры` and returns it.
+  Creates a new Category with the specified name in `Справочник.КатегорииОбъектов` and returns it.
 
 ---
 
@@ -205,12 +218,12 @@ Defined in [orders.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/
 - `push(c_orderObjIn: Order) -> str`
   Creates a new `"Заказ покупателя"` (Buyer's Order) document in 1C.
   - Automatically queries the warehouse, counteragent, and organization based on codes specified in the `Connection` object.
-  - Sets the retail price type, document currency (Hryvnia, code `"980"`), and organization's primary bank account.
-  - Adds products from the order, queries the exact price for the specific characteristic selected, and computes totals.
+  - Sets the price type (defaulting to `"Розничная"` or using `s_price_type` from the order), document currency (Hryvnia, code `"980"`), and organization's primary bank account.
+  - Adds products from the order, queries/compares the exact price for the specific characteristic selected (using `s_price_type` to determine retail, wholesale, or purchase price), and computes totals.
   - Attempts to post the document (`Posting`). If posting fails, it writes the document in draft/save mode (`Write`).
   - Returns the number of the created document in 1C (or an empty string on error).
 - `get(s_codeIn: str) -> Order | None`
-  Retrieves a buyer's order by its 1C document number and parses it into an `Order` object. The comment field is parsed to retrieve the Telegram ID.
+  Retrieves a buyer's order by its 1C document number and parses it into an `Order` object. The comment field is parsed to retrieve the Telegram ID, and the price type is retrieved.
 - `get_today() -> list`
   Returns a list of all today's orders created for the configured bot counteragent (filtered by current date and counteragent code).
 - `update_info(c_orderObjIn: Order) -> bool`
@@ -244,7 +257,23 @@ Defined in [discounts.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionL
 
 ---
 
-### 10. Logging (`log.py`)
+### 10. Properties Manager `PropertiesManager` (`Connection.properties`)
+Defined in [properties.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/properties.py).
+
+- `write(self, c_productIn, s_propertyNameOrCodeIn: str, s_propertyValueIn: str) -> bool`
+  Writes or updates a single property value for a product (Nomenclature item).
+- `write_batch(self, c_productIn, l_propertiesIn: list, b_forceIn: bool = False) -> list`
+  Writes/updates multiple properties for a product using a single 1C RecordSet. `l_propertiesIn` can be a list of `Property` objects or dicts `{"name": "...", "value": "..."}`.
+- `get_assigned_properties(self, c_productIn) -> list`
+  Returns a list of `Property` objects assigned to the specified product.
+- `delete(self, c_productIn, s_propertyNameOrCodeIn: str) -> bool`
+  Removes a specific property from a product in 1C register.
+- `get_all_definitions(self) -> list`
+  Retrieves definitions of all active properties in 1C.
+
+---
+
+### 11. Logging (`log.py`)
 Defined in [log.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/log.py).
 
 All actions are logged automatically. The library resolves the root directory of the project that imported it and stores log files in the relative path `log/system/[calling_module_name].log`.

{onecinteraction-1.2.3 → onecinteraction-1.2.5}/src/oneCInteraction/__init__.py

@@ -4,6 +4,7 @@ from .structures import (
     Variety,
     Price,
     Characteristic,
+    Property,
     Group,
     Category,
     Customer,
@@ -18,6 +19,7 @@ __all__ = [
     'Variety',
     'Price',
     'Characteristic',
+    'Property',
     'Group',
     'Category',
     'Customer',

{onecinteraction-1.2.3 → onecinteraction-1.2.5}/src/oneCInteraction/connection.py

@@ -9,6 +9,7 @@ from .characteristics import CharacteristicsManager
 from .categories import CategoriesManager
 from .customers import CustomersManager
 from .discounts import DiscountsManager
+from .properties import PropertiesManager
 
 
 class Connection:
@@ -41,6 +42,7 @@ class Connection:
         self.categories = CategoriesManager(self)
         self.customers = CustomersManager(self)
         self.discounts = DiscountsManager(self)
+        self.properties = PropertiesManager(self)
 
     def initiate_connection(self) -> None:
         """Establishes COM connection to 1C and caches price type references."""

{onecinteraction-1.2.3 → onecinteraction-1.2.5}/src/oneCInteraction/nomenclature.py

@@ -54,7 +54,8 @@ class NomenclatureManager:
                     Артикул AS Article, 
                     ISNULL(ДополнительноеОписаниеНоменклатуры, "") AS FullDescription,
                     ISNULL(НаименованиеПолное, "") AS FullName,
-                    ISNULL(ЕдиницаХраненияОстатков.Наименование, "шт.") AS Unit
+                    ISNULL(ЕдиницаХраненияОстатков.Наименование, "шт.") AS Unit,
+                    Родитель.Ссылка AS ParentRef
                 FROM Справочник.Номенклатура
                 WHERE ({" OR ".join(where_clauses)}) AND ЭтоГруппа = ЛОЖЬ AND ПометкаУдаления = ЛОЖЬ
             """
@@ -71,6 +72,8 @@ class NomenclatureManager:
             if not s_description:
                 s_description = self.c_v8.String(c_selection.FullName)
 
+            s_parent_uuid = self.c_v8.String(c_selection.ParentRef.UUID()) if not c_selection.ParentRef.IsEmpty() else ""
+
             log_sys(f"Nomenclature found: Name='{c_selection.Name}', Article='{c_selection.Article}'")
             return self._fetch_details(
                 c_selection.Ref, 
@@ -78,8 +81,9 @@ class NomenclatureManager:
                 c_selection.Article, 
                 s_description,
                 getattr(c_selection, "Unit", "шт."),
-                self.c_v8.String(c_selection.Ref.UUID()),
-                self.c_v8.String(c_selection.Code)
+                self.c_v8.String(c_selection.Ref.UUID()), 
+                self.c_v8.String(c_selection.Code),
+                s_parent_uuidIn=s_parent_uuid
             )
         except Exception as e:
             log_sys(f"Error in NomenclatureManager.get: {e}", 1)
@@ -162,6 +166,8 @@ class NomenclatureManager:
                 return []
 
             d_batchDetails = self._fetch_batch_details(l_productRefs)
+            d_batchArrivals = self._fetch_batch_last_arrivals(l_productRefs)
+            d_batchProperties = self._fetch_batch_properties(l_productRefs)
             
             l_allCharRefs = []
             for s_productUuid in d_batchDetails:
@@ -216,7 +222,9 @@ class NomenclatureManager:
                         s_unitIn=d_item["unit"],
                         s_uuidIn=s_productUuid,
                         s_codeIn=self.c_v8.String(d_item["code"]),
-                        l_imagesIn=d_batchImages.get(s_productUuid, [])
+                        l_imagesIn=d_batchImages.get(s_productUuid, []),
+                        dt_last_arrivalIn=d_batchArrivals.get(s_productUuid),
+                        l_propertiesIn=d_batchProperties.get(s_productUuid, [])
                     ))
 
             log_sys(f"Successfully processed {len(l_nomenclatures)} items in search mode.")
@@ -225,6 +233,47 @@ class NomenclatureManager:
             log_sys(f"Error in NomenclatureManager.search (batch): {e}", 1)
             return []
 
+    def _fetch_batch_properties(self, l_productRefsIn: list) -> dict:
+        """Batch fetches properties and values for a list of product references."""
+        if not self.c_v8 or not l_productRefsIn:
+            return {}
+
+        log_sys(f"Batch fetching properties for {len(l_productRefsIn)} products...")
+        
+        c_productRefsV8 = self.c_v8.NewObject("ValueList")
+        for c_ref in l_productRefsIn:
+            if c_ref and not c_ref.IsEmpty():
+                c_productRefsV8.Add(c_ref)
+
+        d_productProps = {} # {product_uuid: [Property]}
+
+        if c_productRefsV8.Count() > 0:
+            try:
+                c_propQuery = self.c_v8.NewObject("Query")
+                c_propQuery.Text = """
+                    SELECT
+                        Properties.Объект AS ProductRef,
+                        Properties.Свойство.Наименование AS PropName,
+                        Properties.Значение.Наименование AS ValName
+                    FROM
+                        РегистрСведений.ЗначенияСвойствОбъектов AS Properties
+                    WHERE
+                        Properties.Объект В (&ProductRefs)
+                """
+                c_propQuery.SetParameter("ProductRefs", c_productRefsV8)
+                c_propRes = c_propQuery.Execute()
+                if c_propRes is not None and not c_propRes.IsEmpty():
+                    c_sel = c_propRes.Select()
+                    while c_sel.Next():
+                        s_uuid = self.c_v8.String(c_sel.ProductRef.UUID())
+                        if s_uuid not in d_productProps:
+                            d_productProps[s_uuid] = []
+                        d_productProps[s_uuid].append(structures.Property(c_sel.PropName, c_sel.ValName))
+            except Exception as e:
+                log_sys(f"Error batch fetching properties: {e}", 1)
+
+        return d_productProps
+
     def _fetch_batch_details(self, l_productRefsIn: list) -> dict:
         """Batch fetches prices and stock quantities for a list of product references."""
         if not self.c_v8 or not l_productRefsIn:
@@ -347,6 +396,47 @@ class NomenclatureManager:
 
         return d_batchData
 
+    def _fetch_batch_last_arrivals(self, l_productRefsIn: list) -> dict:
+        """Batch fetches the last physical arrival date for a list of product references."""
+        if not self.c_v8 or not l_productRefsIn:
+            return {}
+
+        log_sys(f"Batch fetching last arrival dates for {len(l_productRefsIn)} items...")
+        
+        c_productRefsV8 = self.c_v8.NewObject("ValueList")
+        for c_ref in l_productRefsIn:
+            c_productRefsV8.Add(c_ref)
+
+        c_query = self.c_v8.NewObject("Query")
+        c_query.Text = """
+            SELECT
+                ТоварыНаСкладах.Номенклатура AS ProductRef,
+                MAX(ТоварыНаСкладах.Период) AS LastArrivalDate
+            FROM
+                РегистрНакопления.ТоварыНаСкладах AS ТоварыНаСкладах
+            WHERE
+                ТоварыНаСкладах.Номенклатура В (&ProductRefs)
+                AND ТоварыНаСкладах.ВидДвижения = ЗНАЧЕНИЕ(ВидДвиженияНакопления.Приход)
+            GROUP BY
+                ТоварыНаСкладах.Номенклатура
+        """
+        c_query.SetParameter("ProductRefs", c_productRefsV8)
+
+        d_arrivals = {}
+        try:
+            c_result = c_query.Execute()
+            if c_result is not None and not c_result.IsEmpty():
+                c_sel = c_result.Select()
+                while c_sel.Next():
+                    s_productUuid = self.c_v8.String(c_sel.ProductRef.UUID())
+                    dt_last_arrival = _parse_1c_date(c_sel.LastArrivalDate)
+                    if dt_last_arrival:
+                        d_arrivals[s_productUuid] = dt_last_arrival
+        except Exception as e:
+            log_sys(f"Error in batch last arrivals query execution: {e}", 1)
+
+        return d_arrivals
+
     def _fetch_batch_image_metadata(self, l_productRefsIn: list) -> dict:
         """Batch fetches image references (UUIDs) for a list of product references."""
         if not self.c_v8 or not l_productRefsIn:
@@ -389,7 +479,8 @@ class NomenclatureManager:
         s_descriptionIn: str,
         s_unitIn: str = "шт.",
         s_uuidIn: str = "",
-        s_codeIn: str = ""
+        s_codeIn: str = "",
+        s_parent_uuidIn: str = ""
     ):
         """Fetches details (prices, stock, characteristics) for a single Nomenclature."""
         c_retailPtRef = self.c_connection.get_price_type_ref("Розничная")
@@ -527,6 +618,49 @@ class NomenclatureManager:
                 )
             ))
 
+        # Fetch last arrival date
+        dt_last_arrival = None
+        try:
+            c_arrivalQuery = self.c_v8.NewObject("Query")
+            c_arrivalQuery.Text = """
+                SELECT
+                    MAX(ТоварыНаСкладах.Период) AS LastArrivalDate
+                FROM
+                    РегистрНакопления.ТоварыНаСкладах AS ТоварыНаСкладах
+                WHERE
+                    ТоварыНаСкладах.Номенклатура = &ProductRef
+                    AND ТоварыНаСкладах.ВидДвижения = ЗНАЧЕНИЕ(ВидДвиженияНакопления.Приход)
+            """
+            c_arrivalQuery.SetParameter("ProductRef", c_productRefIn)
+            c_arrivalResult = c_arrivalQuery.Execute()
+            if c_arrivalResult is not None and not c_arrivalResult.IsEmpty():
+                c_arrivalSel = c_arrivalResult.Select()
+                if c_arrivalSel.Next():
+                    dt_last_arrival = _parse_1c_date(c_arrivalSel.LastArrivalDate)
+        except Exception as e:
+            log_sys(f"Error fetching last arrival date for {s_articleIn}: {e}", 1)
+        # Fetch product properties
+        l_properties = []
+        try:
+            c_propQuery = self.c_v8.NewObject("Query")
+            c_propQuery.Text = """
+                SELECT
+                    Properties.Свойство.Наименование AS PropName,
+                    Properties.Значение.Наименование AS ValName
+                FROM
+                    РегистрСведений.ЗначенияСвойствОбъектов AS Properties
+                WHERE
+                    Properties.Объект = &ProductRef
+            """
+            c_propQuery.SetParameter("ProductRef", c_productRefIn)
+            c_propRes = c_propQuery.Execute()
+            if c_propRes is not None and not c_propRes.IsEmpty():
+                c_sel = c_propRes.Select()
+                while c_sel.Next():
+                    l_properties.append(structures.Property(c_sel.PropName, c_sel.ValName))
+        except Exception as e:
+            log_sys(f"Error fetching properties for {s_articleIn}: {e}", 1)
+
         return structures.Nomenclature(
             s_nameIn=s_nameIn,
             s_articleIn=s_articleIn,
@@ -534,7 +668,10 @@ class NomenclatureManager:
             s_descriptionIn=s_descriptionIn,
             s_unitIn=s_unitIn,
             s_uuidIn=s_uuidIn,
-            s_codeIn=s_codeIn
+            s_codeIn=s_codeIn,
+            s_parent_uuidIn=s_parent_uuidIn,
+            dt_last_arrivalIn=dt_last_arrival,
+            l_propertiesIn=l_properties
         )
 
     def get_images(self, c_productObjIn, s_imageDirIn: str = None) -> list:
@@ -665,6 +802,8 @@ class NomenclatureManager:
 
 
             d_batchDetails = self._fetch_batch_details(l_productRefs)
+            d_batchArrivals = self._fetch_batch_last_arrivals(l_productRefs)
+            d_batchProperties = self._fetch_batch_properties(l_productRefs)
             
 
             l_allCharRefs = []
@@ -721,8 +860,11 @@ class NomenclatureManager:
                         l_varietyIn=l_varieties,
                         s_descriptionIn=d_item["description"],
                         s_unitIn=d_item["unit"],
+                        s_uuidIn=s_productUuid,
                         s_codeIn=self.c_v8.String(d_item["code"]),
-                        l_imagesIn=d_batchImages.get(s_productUuid, [])
+                        l_imagesIn=d_batchImages.get(s_productUuid, []),
+                        dt_last_arrivalIn=d_batchArrivals.get(s_productUuid),
+                        l_propertiesIn=d_batchProperties.get(s_productUuid, [])
                     ))
 
             log_sys(f"Successfully processed {len(l_nomenclatures)} items in batch mode.")
@@ -818,6 +960,8 @@ class NomenclatureManager:
 
 
             d_batchDetails = self._fetch_batch_details(l_productRefs)
+            d_batchArrivals = self._fetch_batch_last_arrivals(l_productRefs)
+            d_batchProperties = self._fetch_batch_properties(l_productRefs)
             
 
             l_allCharRefs = []
@@ -874,8 +1018,11 @@ class NomenclatureManager:
                         l_varietyIn=l_varieties,
                         s_descriptionIn=d_item["description"],
                         s_unitIn=d_item["unit"],
+                        s_uuidIn=s_productUuid,
                         s_codeIn=self.c_v8.String(d_item["code"]),
-                        l_imagesIn=d_batchImages.get(s_productUuid, [])
+                        l_imagesIn=d_batchImages.get(s_productUuid, []),
+                        dt_last_arrivalIn=d_batchArrivals.get(s_productUuid),
+                        l_propertiesIn=d_batchProperties.get(s_productUuid, [])
                     ))
 
             log_sys(f"Successfully processed {len(l_nomenclatures)} items in batch mode.")

{onecinteraction-1.2.3 → onecinteraction-1.2.5}/src/oneCInteraction/structures.py

@@ -11,7 +11,9 @@ class Nomenclature:
         s_parent_uuidIn: str = "",
         s_uuidIn: str = "",
         s_codeIn: str = "",
-        l_imagesIn: list = None
+        l_imagesIn: list = None,
+        dt_last_arrivalIn: datetime = None,
+        l_propertiesIn: list = None
     ):
         self.s_name = s_nameIn
         self.s_article = s_articleIn
@@ -22,6 +24,8 @@ class Nomenclature:
         self.s_uuid = s_uuidIn
         self.s_code = s_codeIn
         self.l_images = l_imagesIn if l_imagesIn is not None else []
+        self.dt_last_arrival = dt_last_arrivalIn
+        self.l_properties = l_propertiesIn if l_propertiesIn is not None else []
 
 class Price:
     def __init__(self, n_value: float, dt_assigned: datetime = None, s_type: str = ""):
@@ -53,6 +57,14 @@ class Characteristic:
         self.s_name = s_nameIn
         self.s_value = s_valueIn
 
+class Property:
+    def __init__(self, s_nameIn: str, s_valueIn: str):
+        self.s_name = s_nameIn
+        self.s_value = s_valueIn
+
+    def __repr__(self):
+        return f"Property(name='{self.s_name}', value='{self.s_value}')"
+
 class Group:
     def __init__(
         self,

{onecinteraction-1.2.3 → onecinteraction-1.2.5/src/oneCInteraction.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oneCInteraction
-Version: 1.2.3
+Version: 1.2.5
 Summary: A Python library for interacting with 1C:Enterprise databases via COM connection.
 Author: agcl
 Classifier: Programming Language :: Python :: 3
@@ -21,6 +21,7 @@ A modular Python library for interacting with «1C:Enterprise» databases via a
 - **Full COM Connection Support** via `win32com`.
 - **Nomenclature and Categories Management**: retrieve group trees, batch load products, prices, and stock balances across warehouses.
 - **Product Characteristics**: read variant properties from information registers or parse text descriptions.
+- **Product Properties (Metadata)**: read and write general metadata (properties) of Nomenclature items to/from information registers.
 - **Images**: download product images directly from the 1C database to the local disk.
 - **Order Management**: create customer orders, track statuses, and update document comments with customer contact details.
 - **Smart Logging**: automatically creates log files in the directory of the host project importing the library.
@@ -48,6 +49,7 @@ The library is built on the principle of composition: the main `Connection` clas
 - `Connection.orders` (`OrdersManager`) — handles creation and updates of customer orders.
 - `Connection.customers` (`CustomersManager`) — manages customers/counterparties.
 - `Connection.discounts` (`DiscountsManager`) — manages discount groups and active nomenclature discounts.
+- `Connection.properties` (`PropertiesManager`) — manages reading and writing general product properties.
 
 ---
 
@@ -68,7 +70,7 @@ def __init__(self, s_oneCDatabasePathIn: str, s_usernameIn: str, s_passwordIn: s
 - `s_warehouse_code` (str): 1C warehouse code for new orders.
 - `s_counteragent_code` (str): 1C counteragent (customer) code for new orders.
 - `s_organisation_code` (str): 1C organization code for new orders.
-- `sl_price_types` (list): List of price type names to cache automatically (defaults to `["Розничная", "Оптовая"]`).
+- `sl_price_types` (list): List of price type names to cache automatically (defaults to `["Розничная", "Оптовая", "Закупочная"]`).
 - `c_v8`: The active 1C COM connection object (equals `None` if not connected).
 
 #### Methods:
@@ -92,6 +94,8 @@ Represents a product.
 - `s_uuid` (str): Unique identifier (UUID) of the product in 1C.
 - `s_code` (str): 1C product code.
 - `l_images` (list): List of image UUIDs associated with the product in 1C.
+- `dt_last_arrival` (datetime): Date of the last physical arrival of the product to the warehouse from 1C.
+- `l_properties` (list of `Property`): List of general properties (metadata) of the product.
 
 #### `Price`
 Represents a price with its value, assignment date, and type.
@@ -112,6 +116,11 @@ A key-value pair for a variant property.
 - `s_name` (str): Property name (e.g., `"Color"`).
 - `s_value` (str): Property value (e.g., `"Red"`).
 
+#### `Property`
+A key-value pair for a product property (metadata).
+- `s_name` (str): Property name (e.g., `"Material"`).
+- `s_value` (str): Property value (e.g., `"Cotton"`).
+
 #### `Group`
 A product group (category).
 - `s_name` (str): Group name.
@@ -153,6 +162,8 @@ A buyer's order.
 - `s_status` (str): Status of the order in 1C.
 - `s_date` (str): Order creation date (automatically generated).
 - `n_orderCode` (str / int): Order number in 1C.
+- `s_price_type` (str): Price type name used for the order (e.g. `"Розничная"`, `"Оптовая"`, `"Закупочная"`).
+- `s_comment` (str): Additional comment/notes for the order (often parsed to extract Telegram ID).
 
 Calling `str(order_obj)` returns a nicely formatted HTML string suitable for sending to a Telegram bot.
 
@@ -170,13 +181,15 @@ Represents a group of nomenclature discounts.
 Defined in [nomenclature.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/nomenclature.py).
 
 - `get(s_articleIn: str = "", s_nameIn: str = "", s_codeIn: str = "") -> Nomenclature | None`
-  Searches for and returns a product by its article, name, or code. Fetches retail/wholesale prices, stock balances by warehouses, and characteristics.
+  Searches for and returns a product by its article, name, or code. Fetches retail, wholesale, and purchase prices, stock balances by warehouses, characteristics, and the parent group's UUID (`s_parent_uuid`).
+- `search(s_queryIn: str, s_searchByIn: str = "all") -> list`
+  Searches for nomenclature items by a query string matching the name, article, code, or all of them. Returns a list of `Nomenclature` objects (without full detailed price/stock breakdown, but containing basic fields).
 - `get_images(c_productObjIn: Nomenclature, s_imageDirIn: str = None) -> list`
   Downloads all attached images for a product from 1C. Saves them in the specified directory `s_imageDirIn` (defaults to `data/images`). Returns a list of the saved filenames (e.g., `["[uuid]_0.jpg"]`).
 - `get_by_group(c_groupRefIn) -> list`
   Batch fetches all products within a specific 1C group. Using optimized COM queries, this method minimizes DB requests and operates significantly faster than calling `get()` sequentially in a loop.
-- `get_by_category(c_categoryIn, s_attributeNameIn: str = "ВидНоменклатуры", s_catalogNameIn: str = "ВидыНоменклатуры") -> list`
-  Batch fetches all products within a specific 1C category (by default using the `ВидНоменклатуры` attribute in the `ВидыНоменклатуры` catalog). `c_categoryIn` can be a COM reference object or a string representing the category name.
+- `get_by_category(c_categoryIn) -> list`
+  Batch fetches all products within a specific 1C category. `c_categoryIn` can be a COM reference object or a string representing the category name (searched within `Справочник.КатегорииОбъектов`).
 
 ---
 
@@ -196,9 +209,9 @@ Defined in [groups.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/
 Defined in [categories.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/categories.py).
 
 - `get(s_codeIn: str = "", s_nameIn: str = "") -> Category | None`
-  Finds a single Category by its code or name in the `ВидыНоменклатуры` catalog.
+  Finds a single Category by its code or name in the `КатегорииОбъектов` (Object Categories) catalog.
 - `create(s_nameIn: str) -> Category | None`
-  Creates a new Category with the specified name in `Справочник.ВидыНоменклатуры` and returns it.
+  Creates a new Category with the specified name in `Справочник.КатегорииОбъектов` and returns it.
 
 ---
 
@@ -220,12 +233,12 @@ Defined in [orders.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/
 - `push(c_orderObjIn: Order) -> str`
   Creates a new `"Заказ покупателя"` (Buyer's Order) document in 1C.
   - Automatically queries the warehouse, counteragent, and organization based on codes specified in the `Connection` object.
-  - Sets the retail price type, document currency (Hryvnia, code `"980"`), and organization's primary bank account.
-  - Adds products from the order, queries the exact price for the specific characteristic selected, and computes totals.
+  - Sets the price type (defaulting to `"Розничная"` or using `s_price_type` from the order), document currency (Hryvnia, code `"980"`), and organization's primary bank account.
+  - Adds products from the order, queries/compares the exact price for the specific characteristic selected (using `s_price_type` to determine retail, wholesale, or purchase price), and computes totals.
   - Attempts to post the document (`Posting`). If posting fails, it writes the document in draft/save mode (`Write`).
   - Returns the number of the created document in 1C (or an empty string on error).
 - `get(s_codeIn: str) -> Order | None`
-  Retrieves a buyer's order by its 1C document number and parses it into an `Order` object. The comment field is parsed to retrieve the Telegram ID.
+  Retrieves a buyer's order by its 1C document number and parses it into an `Order` object. The comment field is parsed to retrieve the Telegram ID, and the price type is retrieved.
 - `get_today() -> list`
   Returns a list of all today's orders created for the configured bot counteragent (filtered by current date and counteragent code).
 - `update_info(c_orderObjIn: Order) -> bool`
@@ -259,7 +272,23 @@ Defined in [discounts.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionL
 
 ---
 
-### 10. Logging (`log.py`)
+### 10. Properties Manager `PropertiesManager` (`Connection.properties`)
+Defined in [properties.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/properties.py).
+
+- `write(self, c_productIn, s_propertyNameOrCodeIn: str, s_propertyValueIn: str) -> bool`
+  Writes or updates a single property value for a product (Nomenclature item).
+- `write_batch(self, c_productIn, l_propertiesIn: list, b_forceIn: bool = False) -> list`
+  Writes/updates multiple properties for a product using a single 1C RecordSet. `l_propertiesIn` can be a list of `Property` objects or dicts `{"name": "...", "value": "..."}`.
+- `get_assigned_properties(self, c_productIn) -> list`
+  Returns a list of `Property` objects assigned to the specified product.
+- `delete(self, c_productIn, s_propertyNameOrCodeIn: str) -> bool`
+  Removes a specific property from a product in 1C register.
+- `get_all_definitions(self) -> list`
+  Retrieves definitions of all active properties in 1C.
+
+---
+
+### 11. Logging (`log.py`)
 Defined in [log.py](file:///c:/Users/agcl/PycharmProjects/oneCInteractionLib/src/oneCInteraction/log.py).
 
 All actions are logged automatically. The library resolves the root directory of the project that imported it and stores log files in the relative path `log/system/[calling_module_name].log`.

{onecinteraction-1.2.3 → onecinteraction-1.2.5}/src/oneCInteraction.egg-info/scm_file_list.json

@@ -1,21 +1,21 @@
 {
   "files": [
+    ".gitignore",
     "README.md",
-    "LICENSE",
     "pyproject.toml",
-    ".gitignore",
-    "src/oneCInteraction/groups.py",
-    "src/oneCInteraction/__init__.py",
-    "src/oneCInteraction/orders.py",
+    "LICENSE",
     "src/oneCInteraction/discounts.py",
-    "src/oneCInteraction/structures.py",
-    "src/oneCInteraction/log.py",
-    "src/oneCInteraction/customers.py",
-    "src/oneCInteraction/connection.py",
     "src/oneCInteraction/categories.py",
     "src/oneCInteraction/nomenclature.py",
+    "src/oneCInteraction/log.py",
+    "src/oneCInteraction/connection.py",
+    "src/oneCInteraction/structures.py",
+    "src/oneCInteraction/orders.py",
+    "src/oneCInteraction/groups.py",
     "src/oneCInteraction/characteristics.py",
-    "tests/test_lib.py",
-    ".github/workflows/publish.yml"
+    "src/oneCInteraction/customers.py",
+    "src/oneCInteraction/__init__.py",
+    ".github/workflows/publish.yml",
+    "tests/test_lib.py"
   ]
 }

onecinteraction-1.2.5/src/oneCInteraction.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.2.5",
+  "distance": 0,
+  "node": "g9d43c395277bcfc4d0afa6eef38eb5a16f0da6bd",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-18"
+}

{onecinteraction-1.2.3 → onecinteraction-1.2.5}/tests/test_lib.py

@@ -10,11 +10,17 @@ if hasattr(sys.stdout, 'reconfigure'):
 
 try:
     from datetime import datetime
-    from oneCInteraction import Connection, Customer, Order, OrderItem, Nomenclature, Variety, Price, Characteristic, Group, Category, DiscountGroup
+    from oneCInteraction import Connection, Customer, Order, OrderItem, Nomenclature, Variety, Price, Characteristic, Property, Group, Category, DiscountGroup
     from oneCInteraction.log import log_sys, LOGS_DIR
     
     print("Success: Imported Connection and all structures successfully from oneCInteraction!")
     
+    # Test Property structure
+    c_prop = Property("Колір", "Зелений")
+    assert c_prop.s_name == "Колір"
+    assert c_prop.s_value == "Зелений"
+    print("Success: Property instantiated.")
+    
     # Test instantiation of structures
     c_cust = Customer(s_customerIdIn="123456789", s_customerNameIn="Ivan", s_customerSurnameIn="Ivanov", s_customerPhoneIn="+380991112233")
     print("Success: Customer instantiated.")
@@ -80,8 +86,20 @@ try:
     
     c_var = c_var_no_char
     
-    c_nom = Nomenclature(s_nameIn="Product 1", s_articleIn="ART001", l_varietyIn=[c_var])
-    print("Success: Nomenclature instantiated.")
+    c_nom = Nomenclature(s_nameIn="Product 1", s_articleIn="ART001", l_varietyIn=[c_var], l_propertiesIn=[c_prop])
+    assert c_nom.dt_last_arrival is None
+    assert len(c_nom.l_properties) == 1
+    assert c_nom.l_properties[0].s_name == "Колір"
+    
+    dt_now = datetime.now()
+    c_nom_with_arrival = Nomenclature(
+        s_nameIn="Product 2",
+        s_articleIn="ART002",
+        l_varietyIn=[c_var],
+        dt_last_arrivalIn=dt_now
+    )
+    assert c_nom_with_arrival.dt_last_arrival == dt_now
+    print("Success: Nomenclature instantiated and verified with dt_last_arrival.")
     
     c_cat = Category(s_categoryNameIn="Shoes", l_nomenclaturesIn=[c_nom])
     print("Success: Category instantiated.")
@@ -111,7 +129,16 @@ try:
     assert c_conn.categories is not None
     assert c_conn.customers is not None
     assert c_conn.discounts is not None
-    print("Success: Checked all composition managers exist.")
+    assert c_conn.properties is not None
+    print("Success: Checked all composition managers exist (including properties).")
+    
+    # Test PropertiesManager when connection is not active
+    assert c_conn.properties.get_assigned_properties("ART001") == []
+    assert c_conn.properties.write("ART001", "Колір", "Зелений") is False
+    assert c_conn.properties.write_batch("ART001", [{"name": "Колір", "value": "Зелений"}]) == []
+    assert c_conn.properties.delete("ART001", "Колір") is False
+    assert c_conn.properties.get_all_definitions() == []
+    print("Success: PropertiesManager tested with no active connection.")
     
     # Test DiscountsManager when connection is not active
     discounts_res = c_conn.discounts.get_active_groups()

onecinteraction-1.2.3/src/oneCInteraction.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.2.3",
-  "distance": 0,
-  "node": "gf2c9f1c0e0280923eb11b1c941bd21defdb76dd6",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-07-13"
-}