enterprise-1c-odata

Typed OData v3/v4 connector and query engine for 1C:Enterprise 8.3 (1C:ERP, 1C:Trade Management, 1C:Accounting) and LLM/MCP (Model Context Protocol) agents.

Key Features

• Typed OData Query Builder: Fluent API for constructing $filter, $select, $top, $skip, and $orderby clauses without syntax errors.
• LLM/MCP Ready: Serializes 1C entity schemas and records into compact JSON representations optimized for LLM context windows.
• Enterprise Robustness: Built-in HTTP basic authentication, configurable request timeouts, and structured error hierarchies (ODataAuthError, ODataQueryError).
• Zero Heavy Dependencies: Pure standard library architecture compatible with modern Python 3.9 through 3.12.

Installation

pip install enterprise-1c-odata

Quickstart

from enterprise_1c_odata import ODataClient, ODataQuery

# 1. Initialize client
client = ODataClient(
    base_url="https://erp.company.ru/base/odata/standard.odata",
    username="ai_operator",
    password="secure_password",
    timeout=10.0,
)

# 2. Build structured OData query
query = (
    ODataQuery("Catalog_Товары")
    .select("Ref_Key", "Description", "Артикул", "Цена")
    .filter("DeletionMark eq false and Цена gt 1000")
    .top(25)
    .orderby("Description asc")
)

# 3. Inspect target query URL
print(query.build_url(client.base_url))
# -> https://erp.company.ru/base/odata/standard.odata/Catalog_Товары?$select=Ref_Key,Description,Артикул,Цена&$filter=DeletionMark eq false and Цена gt 1000&$top=25&$orderby=Description asc

Architecture & MCP Integration

+------------------------------------+
|  LLM / MCP Agent (Claude, Gemini)  |
+-----------------+------------------+
                  |  JSON-RPC tool_calls
                  v
+-----------------+------------------+
|      enterprise-1c-odata           |
|  - ODataQuery (Fluent Builder)     |
|  - ODataClient (Auth & Dispatch)   |
+-----------------+------------------+
                  |  OData v3/v4 HTTP GET
                  v
+-----------------+------------------+
|   1C:Enterprise 8.3 (ERP / UT)     |
|   /odata/standard.odata/           |
+------------------------------------+

Enterprise Support & Maintainer

Maintained by AI Avtopilot (АвтоПилот) — provider of autonomous AI agent infrastructure and enterprise ERP integrations.

For production turnkey integration, SLA consulting, and custom MCP connectors, visit Enterprise System Integration.

Interactive guide: 1C OData MCP Documentation.

Legal & Trademark Notice

Independent open-source community client. 1C:Enterprise (1С:Предприятие) is a registered trademark of 1C Company. This project is developed independently and is not affiliated with, sponsored by, or endorsed by 1C Company.

License

MIT License. See LICENSE for details.