1C OData
Integrate with 1C enterprise systems via OData v3 — full CRUD and function calls
1C OData provides a standard OData v3 interface to 1C:Enterprise business applications (1C:Бухгалтерия, 1C:ERP, 1C:Управление торговлей, and others). It enables CRUD operations on any 1C entity — catalogs, documents, registers — and supports calling business process functions.
With the 1C OData integration in AACFlow, you can:
- List entities: Query collections with filtering, sorting, and pagination
- Get entity: Retrieve a single entity record by key
- Create entity: Add new records to catalogs or create documents
- Update entity: Modify existing records
- Delete entity: Remove records
- Call function: Invoke 1C business process functions and HTTP-services
This integration enables deep 1C enterprise system automation from AACFlow workflows.
Usage Instructions
Integrate 1C OData into the workflow. Requires the 1C OData standard endpoint base URL (e.g. http://server/base/odata/standard.odata), and basic authentication credentials (username and password of a 1C user with API access rights).
Tools
1c_odata_list_entities
Query a 1C entity collection
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
baseUrl | string | Yes | 1C OData endpoint base URL |
username | string | Yes | 1C username |
password | string | Yes | 1C password |
entity | string | Yes | Entity name (e.g. Catalog_Номенклатура) |
filter | string | No | OData filter expression |
top | number | No | Maximum records to return |
skip | number | No | Records to skip for pagination |
select | string | No | Comma-separated field names |
Output
| Parameter | Type | Description |
|---|---|---|
value | array | Array of entity records |
count | number | Total record count (if $count=true) |
1c_odata_get_entity
Get a single entity by key
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
baseUrl | string | Yes | 1C OData endpoint base URL |
username | string | Yes | 1C username |
password | string | Yes | 1C password |
entity | string | Yes | Entity name |
key | string | Yes | Entity key value (GUID or string) |
Output
| Parameter | Type | Description |
|---|---|---|
record | object | Entity record object |
1c_odata_create_entity
Create a new entity record
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
baseUrl | string | Yes | 1C OData endpoint base URL |
username | string | Yes | 1C username |
password | string | Yes | 1C password |
entity | string | Yes | Entity name |
data | object | Yes | Record field values |
Output
| Parameter | Type | Description |
|---|---|---|
record | object | Created entity record |
success | boolean | Whether the record was created |
Links
- Official API: https://v8.1c.ru/platforma/odata/
- AACFlow block source: apps/aacflow/blocks/blocks/1c_odata.ts