# Verbinden Sie Ihre Anlagen. Machen Sie ihre Daten zu Wartungsleistungen.

> Sie bringen die Automatisierung mit und kennen den Kunden. Wertek AI bietet die Plattform, um Assets zu überwachen, Beobachtungen zu dokumentieren, Arbeitsaufträge zu verwalten und einen wiederkehrenden Service anzubieten.

Für Integratoren · Wertek AI · https://wertek.ai/de/integrators/

**Eingang:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **Ausgang an:** SCADA / HMI · Prozessdatenarchiv

**Nur lesend: Wertek AI schreibt nicht in Ihre PLC.**

## Ihre Protokolle kommen an. Ihr SCADA liest den Zustand mit einem API-Schlüssel mit reinem Lesezugriff.

Klicken Sie auf eine Zeile, um zu sehen, worum es sich handelt, wie die Verbindung erfolgt und welchen Status sie hat.

**Wertek AI:** Asset · Zustand · Alarm · Arbeitsauftrag · Bericht

### Eingang

#### OT · Produktion

- **[Wertek AI-Gateway](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP, mit Registertabellen für 32 Geräte von 17 Marken (Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…) und Kondensatorbänke. Geräte melden bereits auf diesem Weg.
- **Geräte, die über MQTT veröffentlichen** *(Mit Provisionierung)* — Banner DXM (drahtlose Schwingungsmessung, mit 4G-Modem), Acrel-Kits und Energiezähler. Geräte melden bereits auf diesem Weg.
- **Ihr eigener Ablauf über HTTP mit einem Schlüssel** *(Über Node-RED / Ignition / Gateway)* — Node-RED, Ignition, n8n, Python oder JavaScript/TypeScript; Rezepte für Modbus TCP, MQTT und OPC UA, mit simulierten Werten validiert.
- **OPC UA von Bently Nevada System 1** *(Beta)* — Lese-Konnektor.
- **[Vor Ort, mit dem Telefon](https://wertek.ai/de/mobile/)** — Beobachtungen mit Fotos, Video mit VibeDiag, akustische Analyse und manuelle Ablesungen (Stunden, Zyklen, kWh…).

> S7, EtherNet/IP und generisches OPC UA: kein eigener Treiber; der Zugriff erfolgt über Node-RED, Ignition oder ein Gateway.

#### IT · Unternehmenssysteme

- **Instandhaltung und ERP** — Sie bringen ihre Arbeitsaufträge ein: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **Dateien** — Assets aus CSV oder Excel, vor der Übernahme geprüft; WAV-, UFF58- und CSV-Signale.

### Ausgang

#### OT · Produktion

- **Prozessdatenarchive der Anlage** — Wertek AI schreibt seine Messwerte und den Gesundheitszustand der Assets in das Prozessdatenarchiv, neben Ihre Prozessdaten: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **SCADA, HMI oder Node-RED mit einem Leseschlüssel** — Ignition, Node-RED oder ein Skript liest Assets, Messwerte mit Ergebnis und Empfehlung sowie Energie aus, um den Zustand neben den Prozess-Tags anzuzeigen. Der Leseschlüssel wird ab dem Tarif Monitoring erstellt.

> Wertek AI schreibt nicht in Ihre PLC: Es veröffentlicht Fakten und Zustände, und Sie entscheiden, welches Tag Sie ändern.

#### IT · Unternehmenssysteme

- **API mit einem Schlüssel** — Assets, Messwerte, Signal und FFT sowie Energie; Export in JSON. Der Leseschlüssel wird ab dem Tarif Monitoring erstellt.
- **Downloads** — CSV, XLSX, Parquet, WAV und PDF: Messwerte, Beobachtungen, Arbeitsaufträge, Verbrauch und Bericht zur Einhaltung der Netzanschlussregeln.
- **Alarme** — Push und E-Mail sowie live in der App.
- **Regelmäßige Berichte per E-Mail** — Energie und Einhaltung der Netzanschlussregeln, Zustand und monatliche Zusammenfassung der Verbrauchsstellen.
- **[Instandhaltung und ERP](https://wertek.ai/de/integrations/)** — Konnektoren, jeder mit geprüftem Status: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## HTTP mit einem Schlüssel: der Weg für jedes Gerät

1. **Erstellen Sie Ihr kostenloses Konto.** Unter app.wertek.ai. Ein Schlüssel nur mit Ingest-Berechtigung funktioniert in jedem Tarif. [Konto erstellen](https://app.wertek.ai/signup)
2. **Erstellen Sie das Asset und weisen Sie den Messpunkt zu.** Registrieren Sie in der App das Asset und weisen Sie die Position zu, die Sie versorgen werden: ihren Code, ihre Variablen mit UCUM-Einheit und ihren Takt. Sie können sie auch mit dem Schlüssel zuweisen: POST /iaes/assets/{asset_id}/measurement-points. Die Zuweisung verbraucht einen Messpunkt: einmal pro Position, nicht bei jeder Übertragung.
3. **Erstellen Sie den Ingest-Schlüssel.** Unter Einstellungen → API-Schlüssel (Settings → API Keys), mit Ingest-Berechtigung. Halten Sie ihn geheim: in einer Umgebungsvariable, niemals im Code oder in einem Tag.
4. **Senden Sie den Messwert.** Ein asset.measurement-Ereignis pro Messwert, einzeln oder als Liste mit bis zu 100, an POST https://api.wertek.ai/iaes/ingest. Die Antwort enthält einen Code pro Ereignis; gespeicherte Daten erscheinen im Verlauf des Assets unter der zugewiesenen Position.

### So weisen Sie einen Messpunkt zu

1. **Unter Measurement points (oder am Asset) auf «Designate position» klicken.** Die Zuweisung verbraucht einen Messpunkt aus dem Kontingent Ihrer Organisation: einmal pro Position, nicht bei jeder Übertragung.
2. **Code, Vorlage und Takt eingeben.** Der Code ist die `location`, die Ihre Integration sendet (Kleinbuchstaben, keine Leerzeichen). Die Vorlage enthält die Variablen der Familie mit ihrer UCUM-Einheit; Sie können eigene Variablen hinzufügen. Der vertragliche Takt in Sekunden gibt an, wie oft Sie einen Messwert senden.

   ![Dialog «Designate a measurement position»: Code, Vorlage, Variablen und Takt](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **Die Position erscheint in der Liste und empfängt Messwerte.** Jedes Ereignis, das Sie mit diesem Code und dem Ingest-Schlüssel senden, wird im Verlauf des Assets unter dieser Position gespeichert.

### Das Ereignis (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"
  }
}
```

Mit dem veröffentlichten IAES 2.0.2 SDK validiert, der vom Ingest verwendeten Version.

- `data.location` — der Code der zugewiesenen Position
- `data.measurement_type` — der Schlüssel der Variable
- `data.unit` — die Einheit des Vertrags (verglichen, niemals umgerechnet)
- `data.value` — eine Zahl; boolesche Werte werden als 0 oder 1 übertragen
- `timestamp` — der Zeitpunkt der Messung in UTC — nicht der Sendezeitpunkt
- `event_id` — für jeden Messwert neu; dies ist der Idempotenzschlüssel

### 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
```

Importieren Sie den Flow der Anleitung (pump-process-to-wertek.flow.json); der Knoten iaes-publish verwendet denselben Schlüssel.

### Anleitungen

- **Node-RED.** In Software validierte Anleitung: Ihr Abnahmeskript läuft mit simulierten Werten gegen die API. IAES-Nodes 2.0.2 in ein echtes Node-RED 5.0.6 importiert und ausgeführt (Docker, 2026-11-12): 5/5 Ereignisse gültig. [Anleitung, Flow und Abnahmeskript](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** Am 2026-10-05 gegen die API geprüfte Anleitung, ohne automatisches Abnahmeskript. IAES-Nodes 2.0.2 in ein echtes n8n 2.8.4 importiert und ausgeführt (2026-11-12): 5/5 Ereignisse gültig. [Anleitung und Workflow](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **Jeder HTTP-Client.** Die Basisanleitung: Lesen Sie den Vertrag des Assets, weisen Sie die Position zu, senden Sie und lesen Sie die Antwort Ereignis für Ereignis. [Anleitung und Abnahmeskript](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### Und MQTT?

MQTT bedeutet heute Kanäle für bestimmte Geräte — Banner DXM, Acrel-Kits und Energiezähler — jeweils mit eigenem Topic und Zugangsdaten, mit Provisionierung eingerichtet. Es gibt kein universelles Topic: Für jedes andere Gerät führt der Weg über HTTP mit einem Schlüssel.

## Was Ihre Daten beim Eingang schützt und was Sie steuern

Was der Code heute tut, und nichts darüber hinaus.

- **Ingest-Schlüssel.** Ein Schlüssel beginnt mit wk_ und wird bei der Erstellung einmal angezeigt. Wertek AI speichert nur seinen SHA-256-Hash und ein Präfix mit 12 Zeichen, um ihn zuzuordnen.
- **Berechtigungen, Ablauf und Widerruf.** Jeder Schlüssel hat seine Berechtigungen (telemetry.view, telemetry.export, iaes.ingest), kann auf bestimmte Assets beschränkt werden, nach 1 bis 365 Tagen ablaufen und widerrufen werden. Nur Eigentümer oder Administratoren verwalten Schlüssel.
- **An Ihre Organisation gebunden.** Ein Ereignis wird nur für Assets der Organisation des Schlüssels angenommen: Ein Schlüssel kann nicht in Assets einer anderen Organisation schreiben.
- **Bei der Übertragung.** Die API wird über HTTPS bereitgestellt. Verwenden Sie für MQTT Port 8883 mit TLS.
- **Dateien über signierte Links.** Aufnahmen und Dokumente werden über mit HMAC-SHA256 signierte Links mit Ablaufzeit bereitgestellt.
- **Gespeicherte Daten.** Unsere Anbieter (Supabase für die Datenbank und Cloudflare R2 für Dateien) verschlüsseln die Daten, die sie speichern.
- **Grenzen und Nutzung.** Bis zu 300 Anfragen pro Minute und Maschinenzugangsdaten (darüber 429) und 100 Ereignisse pro Stapel. Die Telemetrie-API protokolliert die Nutzung jedes Schlüssels und seine letzte Verwendung.

### Empfehlungen für Integratoren

- MQTT: Port 8883 mit TLS.
- Wir empfehlen nicht, unverschlüsselte Daten zu senden. Wenn ein Gerät TLS nicht unterstützt, sprechen Sie mit uns: Es kann mit anderen Schutzmaßnahmen bewertet werden.
- Ein Schlüssel pro Werk, mit der minimalen Berechtigung (iaes.ingest zum Senden von Daten) und einer Ablaufzeit.
- Bewahren Sie den Schlüssel in einer Umgebungsvariable oder einem Geheimnisspeicher auf, niemals im Code oder im Flow.
- Widerrufen Sie den Schlüssel, wenn ein Gerät oder ein Werk ausscheidet.

## Veröffentlichte Pakete mit offenem Quellcode

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. Sieben Knoten: measurement, health, work-order, validate, sparkplug, publish und route. Veröffentlichte Version: 2.0.2 · [Quellcode](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`. Community-Knoten für n8n. Veröffentlichte Version: 2.0.2 · [Quellcode](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`. Client, Modelle und Ereignisvalidierung (die Validierung verwendet ajv). Veröffentlichte Version: 2.0.2 · [Quellcode](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"`. Modelle und Validierung: derselbe Validator, den der Wertek AI-Ingest verwendet. Veröffentlichte Version: 2.0.2 · [Quellcode](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**Vorschau.** Arduino Opta: iaes-opta-runtime gibt IAES 1.4 aus, und der Wertek AI-Ingest verlangt 2.x. Eine Vorschau, nicht für den Produktivbetrieb. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: Flow einmal erstellen.** Ein offenes Ereignisformat, bei jedem Kunden wiederverwendet, und was Ihr Kunde in Wertek AI erhält. [IAES für Integratoren ansehen](https://wertek.ai/de/integrators/iaes/index.md)

Der Standard: IAES 2.0, offen (CC BY 4.0). [iaes.dev](https://iaes.dev/) · [DOI 10.5281/zenodo.22663498](https://doi.org/10.5281/zenodo.22663498)

## Mehr als ein Datenspeicher

- **Das Asset und sein Verlauf.** Jeder Messwert bleibt im Verlauf des Assets unter der von Ihnen zugewiesenen Position.
- **Beobachtungen.** Das Team Ihres Kunden dokumentiert seine Feststellungen vor Ort mit Fotos, im Web oder per Telefon.
- **Arbeitsaufträge.** Um auf Feststellungen zu reagieren und jeden Eingriff zu dokumentieren. Ab Technical.
- **Die mobile App.** Für Arbeiten vor Ort, auf Android und iPhone.

## Der Datenempfang ist kostenlos; die Überwachung nicht.

Sie zahlen für den überwachten Messpunkt, nicht für das Asset.

- 1 Messpunkt: USD 36 pro Jahr
- Paket mit 5 Messpunkten: USD 120 pro Jahr

Preise aus dem aktuellen Wertek AI-Katalog, bei Veröffentlichung dieser Seite abgerufen. [Alle Tarife ansehen](https://wertek.ai/pricing.html)

## Ihr Kunde verwaltet das Asset; Sie sehen, was er Ihnen freigibt

- Das Asset und sein Verlauf gehören demjenigen, der es verwaltet: Ihrem Kunden. Ihre Einträge behalten Ihre Urheberschaft.
- Sie sehen, was Ihr Kunde Ihnen freigibt: nach Werk, Bereich oder Asset, mit Zeitfenstern.
- Standardmäßig zahlt Ihr Kunde für die Messpunkte.
- Wenn sich Ihre Wege trennen, bleiben das Asset und sein technischer Verlauf bei Ihrem Kunden; Ihr Zugriff endet mit dem Entzug.

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

## Was der Ingest akzeptiert

| | |
|---|---|
| Route | POST https://api.wertek.ai/iaes/ingest |
| Header | X-API-Key, mit der Berechtigung iaes.ingest |
| Ereignis | IAES, spec_version 2.x |
| Stapel | bis zu 100 Ereignisse pro Anfrage |
| Grenze | 300 Anfragen pro Minute und Schlüssel |
| Takt | ein Messwert, der vor 90 % des vertraglichen Takts eintrifft, wird verworfen (Code 504) |
| Vertrag des Assets | GET /iaes/assets/{asset_id}/measurement-points, mit dem Schlüssel |
| Schema und Codes | GET /iaes/schema und /iaes/schema/codes, mit dem Schlüssel |
| Antwort | ein Code pro Ereignis: 1xx gespeichert · 2xx mit Warnung gespeichert · 4xx Nachricht korrigieren · 5xx erneut versuchen |

## Häufig gestellte Fragen

**Brauche ich einen Tarif?** Zum Senden von Daten brauchen Sie keinen Tarif; jeder überwachte Messpunkt wird gemäß Katalog berechnet. Der Tarif aktiviert Benachrichtigungen, die jemanden erreichen, Arbeitsaufträge und einen längeren Verlauf.

**Wo läuft es?** Der Ingest ist ein Cloud-Dienst von Wertek AI. Das Wertek AI-Gateway läuft in Ihrem Netzwerk: Es liest die Geräte aus und sendet die Messwerte.

**Schreibt der Ingest in meine PLC?** Nein. Der Ingest empfängt nur Daten.

**Was passiert, wenn ich schneller als im Takt sende?** Ein Messwert, der vor 90 % des vertraglichen Takts eintrifft, wird mit Code 504 verworfen. Passen Sie Ihre Übertragungen an den Takt des Messpunkts an.

