# Подключите оборудование. Превратите его данные в услуги технического обслуживания.

> Вы обеспечиваете автоматизацию и знаете клиента. Wertek AI предоставляет платформу для мониторинга активов, записи наблюдений, управления нарядами на работы и оказания регулярных услуг.

Для интеграторов · Wertek AI · https://wertek.ai/ru/integrators/

**Вход:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **Выход в:** SCADA / HMI · Архив технологических данных

**Только чтение: Wertek AI не записывает в ваш PLC.**

## Ваши протоколы поступают на вход. Ваша SCADA считывает состояние с помощью ключа API с доступом только для чтения.

Нажмите на любую линию, чтобы узнать, что это, как подключается и в каком состоянии находится.

**Wertek AI:** Актив · Состояние · Оповещение · Наряд на работы · Отчёт

### Вход

#### OT · Цех

- **[Шлюз Wertek AI](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP, с картами регистров для 32 устройств 17 марок (Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…) и конденсаторных батарей. Оборудование уже передаёт данные таким способом.
- **Устройства, публикующие через MQTT** *(С провижинингом)* — Banner DXM (беспроводное измерение вибрации, с модемом 4G), комплекты Acrel и счётчики электроэнергии. Оборудование уже передаёт данные таким способом.
- **Собственный поток через HTTP с ключом** *(Через Node-RED / Ignition / шлюз)* — Node-RED, Ignition, n8n, Python или JavaScript/TypeScript; рецепты для Modbus TCP, MQTT и OPC UA, проверенные на моделируемых значениях.
- **OPC UA из Bently Nevada System 1** *(Beta)* — Коннектор чтения.
- **[На месте, с телефоном](https://wertek.ai/ru/mobile/)** — Наблюдения с фотографиями, видео с VibeDiag, акустический анализ и ручные показания (часы, циклы, kWh…).

> S7, EtherNet/IP и универсальный OPC UA: собственного драйвера нет; доступ к ним — через Node-RED, Ignition или шлюз.

#### IT · Бизнес-системы

- **Техобслуживание и ERP** — Передают свои наряды на работы: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **Файлы** — Активы из CSV или Excel, проверяемые перед применением; сигналы WAV, UFF58 и CSV.

### Выход

#### OT · Цех

- **Архивы технологических данных завода** — Wertek AI записывает свои измерения и техническое состояние активов в архив технологических данных, рядом с вашими данными процесса: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **SCADA, HMI или Node-RED с ключом чтения** — Ignition, Node-RED или скрипт читает активы, измерения с их результатом и рекомендацией, а также энергию, чтобы показать состояние рядом с тегами процесса. Ключ чтения создаётся начиная с плана Monitoring.

> Wertek AI не записывает в ваш PLC: публикует факты и состояния, а вы решаете, какой тег изменить.

#### IT · Бизнес-системы

- **API с ключом** — Активы, измерения, сигнал и FFT, энергия; экспорт в JSON. Ключ чтения создаётся начиная с плана Monitoring.
- **Загрузки** — CSV, XLSX, Parquet, WAV и PDF: измерения, наблюдения, наряды на работы, потребление и отчёт о соответствии сетевому кодексу электроэнергетики.
- **Оповещения** — Push и электронная почта, а также в реальном времени в приложении.
- **Периодические отчёты по электронной почте** — Энергия и соответствие сетевому кодексу электроэнергетики, состояние и ежемесячная сводка по центрам потребления.
- **[Техобслуживание и ERP](https://wertek.ai/ru/integrations/)** — Коннекторы, каждый с проверенным состоянием: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## HTTP с ключом: путь для любого устройства

1. **Создайте бесплатную учётную запись.** На app.wertek.ai. Ключ только с разрешением на приём данных работает на любом тарифе. [Создать учётную запись](https://app.wertek.ai/signup)
2. **Создайте актив и назначьте точку измерения.** В приложении зарегистрируйте актив и назначьте позицию для передачи данных: её код, переменные с единицами UCUM и период. Можно назначить её и с помощью ключа: POST /iaes/assets/{asset_id}/measurement-points. Назначение расходует точку измерения: выполняйте его один раз для каждой позиции, а не при каждой отправке.
3. **Создайте ключ приёма данных.** В Настройки → Ключи API (Settings → API Keys), с разрешением на приём данных. Храните его в секрете: в переменной окружения, никогда не в коде и не в теге.
4. **Отправьте показание.** Одно событие asset.measurement на показание, отдельно или в списке до 100, на POST https://api.wertek.ai/iaes/ingest. Ответ содержит один код на событие; сохранённые данные появляются в истории актива под назначенной позицией.

### Как назначить точку измерения

1. **В Measurement points (или в активе) нажмите «Designate position».** Назначение расходует одну точку измерения из пула организации: один раз для каждой позиции, а не при каждой отправке.
2. **Укажите код, шаблон и период.** Код — это `location`, который будет отправлять ваша интеграция (строчными буквами, без пробелов). Шаблон содержит переменные семейства с их единицами UCUM; можно добавить свои переменные. Установленный контрактом период в секундах определяет, как часто вы будете отправлять показания.

   ![Диалог «Designate a measurement position»: код, шаблон, переменные и период](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **Позиция появляется в списке и начинает получать показания.** Каждое событие, отправленное с этим кодом и ключом приёма данных, сохраняется в истории актива под этой позицией.

### Событие (reading.json)

```json
{
  "spec_version": "2.0",
  "event_id": "6f1c2b7e-3d4a-4e8b-9a10-5c2d7e9f1a34",
  "correlation_id": "0b8e4c21-7f3a-4d6e-8c95-1a2b3c4d5e6f",
  "event_type": "asset.measurement",
  "timestamp": "2026-11-11T14:32:00Z",
  "source": "plant_x.plc_12",
  "dataschema": "https://iaes.dev/schema/v2/asset.measurement",
  "asset": {
    "asset_id": "PUMP-07"
  },
  "data": {
    "measurement_type": "temperature",
    "value": 23.5,
    "unit": "Cel",
    "location": "zona_1"
  }
}
```

Проверено с опубликованным SDK IAES 2.0.2 — версией, которую использует сервис приёма.

- `data.location` — код назначенной позиции
- `data.measurement_type` — ключ переменной
- `data.unit` — единица контракта (сравнивается, никогда не преобразуется)
- `data.value` — число; логические значения передаются как 0 или 1
- `timestamp` — время измерения в UTC — не время отправки
- `event_id` — новый для каждого показания; это ключ идемпотентности

### curl

```bash
curl -X POST https://api.wertek.ai/iaes/ingest \
  -H "X-API-Key: $WERTEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d @reading.json
```

### Python

```python
# pip install requests          (the validator: pip install "iaes[validate]==2.0.2")
import json, os, uuid
from datetime import datetime, timezone
import requests

event = json.load(open("reading.json"))
event["event_id"] = str(uuid.uuid4())         # new for each reading
event["correlation_id"] = str(uuid.uuid4())   # one per batch
event["timestamp"] = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")  # when it was measured

r = requests.post(
    "https://api.wertek.ai/iaes/ingest",
    json=[event],
    headers={"X-API-Key": os.environ["WERTEK_API_KEY"]},
    timeout=30,
)
print(r.status_code, r.json())
```

### Node-RED

```bash
cd ~/.node-red
npm install node-red-contrib-iaes@2.0.2
```

Импортируйте поток из рецепта (pump-process-to-wertek.flow.json); узел iaes-publish использует тот же ключ.

### Рецепты

- **Node-RED.** Рецепт проверен программно: его приёмочный скрипт обращается к API с имитированными значениями. Узлы IAES 2.0.2 импортированы и запущены в реальном Node-RED 5.0.6 (Docker, 2026-11-12): 5/5 событий валидны. [Рецепт, поток и приёмочный скрипт](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** Рецепт проверен через API 2026-10-05, без автоматического приёмочного скрипта. Узлы IAES 2.0.2 импортированы и запущены в реальном n8n 2.8.4 (2026-11-12): 5/5 событий валидны. [Рецепт и рабочий процесс](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **Любой HTTP-клиент.** Базовый рецепт: прочитайте контракт актива, назначьте позицию, отправьте данные и прочитайте ответ по каждому событию. [Рецепт и приёмочный скрипт](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### А MQTT?

Сегодня MQTT — это каналы для конкретного оборудования — Banner DXM, комплектов Acrel и счётчиков электроэнергии — каждый со своим топиком и учётными данными, настроенный с провижинингом. Универсального топика нет: для любого другого устройства путь — HTTP с ключом.

## Что защищает ваши данные при поступлении и чем управляете вы

Что код делает сегодня, и ничего сверх этого.

- **Ключи приёма данных.** Ключ начинается с wk_ и показывается один раз при создании. Wertek AI хранит только его хеш SHA-256 и префикс из 12 символов для распознавания.
- **Права доступа, срок действия и отзыв.** У каждого ключа есть права доступа (telemetry.view, telemetry.export, iaes.ingest); его можно ограничить конкретными активами, установить срок действия от 1 до 365 дней и отозвать. Ключами управляет только владелец или администратор.
- **Привязка к вашей организации.** Событие принимается только для активов организации, которой принадлежит ключ: ключ не может записывать данные в активы другой организации.
- **При передаче.** API предоставляется по HTTPS. Для MQTT используйте порт 8883 с TLS.
- **Файлы по подписанным ссылкам.** Снимки и документы передаются по ссылкам, подписанным с помощью HMAC-SHA256 и имеющим срок действия.
- **Хранимые данные.** Наши поставщики (Supabase для базы данных и Cloudflare R2 для файлов) шифруют данные, которые хранят.
- **Ограничения и использование.** До 300 запросов в минуту на учётные данные машины (429 при превышении) и 100 событий в пакете. API телеметрии регистрирует использование каждого ключа и его последнее использование.

### Рекомендации для интеграторов

- MQTT: порт 8883 с TLS.
- Мы не рекомендуем отправлять незашифрованные данные. Если устройство не поддерживает TLS, свяжитесь с нами: его можно оценить с другими средствами защиты.
- Один ключ на площадку с минимальными правами (iaes.ingest для отправки данных) и сроком действия.
- Храните ключ в переменной окружения или хранилище секретов, никогда не в коде или потоке.
- Отзовите ключ, когда устройство или площадка прекращает пользоваться сервисом.

## Опубликованные пакеты с открытым исходным кодом

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. Семь узлов: measurement, health, work-order, validate, sparkplug, publish и route. Опубликованная версия: 2.0.2 · [Исходный код](https://github.com/wertek-ai/iaes/tree/nodered-v2.0.2/node-red) · [npm](https://www.npmjs.com/package/node-red-contrib-iaes)
- **n8n** — `npm install n8n-nodes-iaes@2.0.2`. Узел сообщества для n8n. Опубликованная версия: 2.0.2 · [Исходный код](https://github.com/wertek-ai/iaes/tree/n8n-v2.0.2/n8n-nodes) · [npm](https://www.npmjs.com/package/n8n-nodes-iaes)
- **JavaScript / TypeScript** — `npm install @iaes/sdk@2.0.2`. Клиент, модели и проверка события (проверка использует ajv). Опубликованная версия: 2.0.2 · [Исходный код](https://github.com/wertek-ai/iaes/tree/sdk-v2.0.2/npm) · [npm](https://www.npmjs.com/package/@iaes/sdk)
- **Python** — `pip install "iaes[validate]==2.0.2"`. Модели и проверка: тот же валидатор, который использует сервис приёма Wertek AI. Опубликованная версия: 2.0.2 · [Исходный код](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**Предварительная версия.** Arduino Opta: iaes-opta-runtime выдаёт IAES 1.4, а сервис приёма Wertek AI требует 2.x. Это предварительная версия, не для промышленной эксплуатации. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: создайте поток один раз.** Единый открытый формат событий, используемый повторно с каждым клиентом, и то, что ваш клиент получает в Wertek AI. [Посмотреть IAES для интеграторов](https://wertek.ai/ru/integrators/iaes/index.md)

Стандарт: IAES 2.0, открытый (CC BY 4.0). [iaes.dev](https://iaes.dev/) · [DOI 10.5281/zenodo.22663498](https://doi.org/10.5281/zenodo.22663498)

## Больше, чем место для хранения данных

- **Актив и его история.** Каждое показание остаётся в истории актива под назначенной вами позицией.
- **Наблюдения.** Команда клиента записывает результаты осмотра на месте с фотографиями, через веб или телефон.
- **Наряды на работы.** Чтобы действовать по результатам осмотра и сохранять запись о каждом вмешательстве. Начиная с Technical.
- **Мобильное приложение.** Для работы на месте, на Android и iPhone.

## Приём данных бесплатен; мониторинг — нет.

Вы платите за отслеживаемую точку измерения, а не за актив.

- 1 точка измерения: USD 36 в год
- Пакет из 5 точек измерения: USD 120 в год

Цены из актуального каталога Wertek AI, просмотренные при публикации этой страницы. [Посмотреть все тарифы](https://wertek.ai/pricing.html)

## Клиент управляет активом; вы видите то, к чему он предоставил доступ

- Актив и его история принадлежат тому, кто им управляет: вашему клиенту. Ваши записи сохраняют ваше авторство.
- Вы видите то, к чему клиент предоставил доступ: по заводу, области или активу, с временными окнами.
- По умолчанию точки измерения оплачивает клиент.
- Если вы прекратите сотрудничество, актив и его техническая история останутся у клиента; ваш доступ закончится при его отзыве.

[О Growth Program](https://wertek.ai/growth-program.html)

## Что принимает сервис приёма

| | |
|---|---|
| Маршрут | POST https://api.wertek.ai/iaes/ingest |
| Заголовок | X-API-Key, с разрешением iaes.ingest |
| Событие | IAES, spec_version 2.x |
| Пакет | до 100 событий на запрос |
| Лимит | 300 запросов в минуту на ключ |
| Период | показание, поступившее до истечения 90 % установленного контрактом периода, отбрасывается (код 504) |
| Контракт актива | GET /iaes/assets/{asset_id}/measurement-points, с ключом |
| Схема и коды | GET /iaes/schema и /iaes/schema/codes, с ключом |
| Ответ | один код на событие: 1xx сохранено · 2xx сохранено с предупреждением · 4xx исправьте сообщение · 5xx повторите попытку |

## Частые вопросы

**Нужен ли мне тариф?** Для отправки данных тариф не нужен; каждая отслеживаемая точка измерения оплачивается по каталогу. Тариф включает оповещения с доставкой получателю, наряды на работы и более длительную историю.

**Где это работает?** Приём данных — облачный сервис Wertek AI. Шлюз Wertek AI работает в вашей сети: опрашивает оборудование и отправляет показания.

**Записывает ли сервис приёма данные в мой PLC?** Нет. Сервис приёма только получает данные.

**Что, если отправлять чаще установленного периода?** Показание, поступившее до истечения 90 % установленного контрактом периода, отбрасывается с кодом 504. Согласуйте отправку с периодом точки измерения.

