Kontrum 3.6.0 · Protocol 2.1 · Schema 1.1

Universal Integration API

Единый контракт для 1С и других учётных систем. Protocol 2.0 / Schema 1.0 полностью сохранён; новые возможности включаются только после capability negotiation.

Legacy 2.0 / 1.0

organization, client, product, order и прежний error:string остаются совместимыми.

OpenAPI 2.0 / 1.0

Protocol 2.1 / Schema 1.1

Snapshot, per-item results, structured errors, token lifecycle, Warehouse и Cash.

OpenAPI 2.1 / 1.1

Analytics

Versioned metrics, freshness, drill-down и асинхронный export.

OpenAPI Analytics

Warehouse API

Склады, остатки и документы: синхронизация из 1С или ручное ведение и импорт.

OpenAPI Warehouse

Безопасность и область данных

Tenant определяется только по connector token. Передача tenantId в payload не меняет область данных. Команды требуют idempotency key, а Warehouse/Cash доступны только при согласованной capability и активном entitlement.

Пример negotiation

PUT /api/v2/connectors/profile
Authorization: Bearer <connector-token>
Idempotency-Key: profile-2026-08-09
Content-Type: application/json

{
  "protocolVersion": "2.1",
  "schemaVersions": ["1.0", "1.1"],
  "capabilities": ["snapshot.v1", "warehouse.entities.v1", "cash.entities.v1"]
}