# Połącz urządzenia. Zamień ich dane w usługi utrzymania ruchu.

> Zapewniasz automatykę i znasz klienta. Wertek AI zapewnia platformę do monitorowania aktywów, zapisywania obserwacji, zarządzania zleceniami pracy i oferowania usługi cyklicznej.

Dla integratorów · Wertek AI · https://wertek.ai/pl/integrators/

**Wejście:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **Wyjście do:** SCADA / HMI · Archiwum danych procesowych

**Tylko odczyt: Wertek AI nie zapisuje do Twojego PLC.**

## Twoje protokoły trafiają do systemu. Twoja SCADA odczytuje stan za pomocą klucza API z uprawnieniami tylko do odczytu.

Kliknij dowolną linię, aby zobaczyć, co przedstawia, jak się łączy i jaki ma stan.

**Wertek AI:** Aktywo · Stan · Alert · Zlecenie pracy · Raport

### Wejście

#### OT · Hala produkcyjna

- **[Brama Wertek AI](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP, z mapami rejestrów dla 32 urządzeń 17 marek (Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…) i baterii kondensatorów. Urządzenia już raportują w ten sposób.
- **Urządzenia publikujące przez MQTT** *(Z aprowizacją)* — Banner DXM (bezprzewodowe pomiary drgań, z modemem 4G), zestawy Acrel i liczniki energii. Urządzenia już raportują w ten sposób.
- **Własny przepływ przez HTTP z kluczem** *(Przez Node-RED / Ignition / bramę)* — Node-RED, Ignition, n8n, Python lub JavaScript/TypeScript; receptury dla Modbus TCP, MQTT i OPC UA, zweryfikowane na symulowanych wartościach.
- **OPC UA z Bently Nevada System 1** *(Beta)* — Konektor odczytu.
- **[W terenie, z telefonem](https://wertek.ai/pl/mobile/)** — Obserwacje ze zdjęciami, wideo z VibeDiag, analiza akustyczna i ręczne odczyty (godziny, cykle, kWh…).

> S7, EtherNet/IP i ogólne OPC UA: nie mamy własnego sterownika; dostęp uzyskujesz przez Node-RED, Ignition lub bramę.

#### IT · Systemy biznesowe

- **Utrzymanie ruchu i ERP** — Wnoszą swoje zlecenia pracy: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **Pliki** — Aktywa z CSV lub Excel, sprawdzane przed zastosowaniem; sygnały WAV, UFF58 i CSV.

### Wyjście

#### OT · Hala produkcyjna

- **Archiwa danych procesowych zakładu** — Wertek AI zapisuje swoje pomiary i stan techniczny aktywów w archiwum danych procesowych, obok Twoich danych procesowych: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **SCADA, HMI lub Node-RED z kluczem odczytu** — Ignition, Node-RED lub skrypt odczytuje aktywa, pomiary z ich wynikiem i zaleceniem oraz energię, aby pokazać stan obok tagów procesowych. Klucz odczytu można utworzyć od planu Monitoring.

> Wertek AI nie zapisuje do Twojego PLC: publikuje fakty i stany, a Ty decydujesz, który tag zmienić.

#### IT · Systemy biznesowe

- **API z kluczem** — Aktywa, pomiary, sygnał i FFT oraz energia; eksport w JSON. Klucz odczytu można utworzyć od planu Monitoring.
- **Pobieranie** — CSV, XLSX, Parquet, WAV i PDF: pomiary, obserwacje, zlecenia pracy, zużycie i raport zgodności z kodeksem sieci elektroenergetycznej.
- **Alerty** — Push i e-mail oraz na żywo w aplikacji.
- **Okresowe raporty e-mailem** — Energia i zgodność z kodeksem sieci elektroenergetycznej, stan i miesięczne podsumowanie centrów zużycia.
- **[Utrzymanie ruchu i ERP](https://wertek.ai/pl/integrations/)** — Konektory, każdy ze swoim zweryfikowanym stanem: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## HTTP z kluczem: ścieżka dla każdego urządzenia

1. **Utwórz bezpłatne konto.** Na app.wertek.ai. Klucz z samym uprawnieniem odbioru danych działa w każdym planie. [Utwórz konto](https://app.wertek.ai/signup)
2. **Utwórz aktywo i wyznacz punkt pomiarowy.** W aplikacji zarejestruj aktywo i wyznacz pozycję, którą będziesz zasilać: jej kod, zmienne z jednostką UCUM i interwał. Możesz ją też wyznaczyć kluczem: POST /iaes/assets/{asset_id}/measurement-points. Wyznaczenie zużywa punkt pomiarowy: wykonaj je raz na pozycję, nie przy każdym wysłaniu.
3. **Utwórz klucz odbioru danych.** W Ustawienia → Klucze API (Settings → API Keys), z uprawnieniem odbioru danych. Zachowaj go w tajemnicy: w zmiennej środowiskowej, nigdy w kodzie ani w tagu.
4. **Wyślij odczyt.** Jedno zdarzenie asset.measurement na odczyt, osobno lub na liście do 100, do POST https://api.wertek.ai/iaes/ingest. Odpowiedź zawiera jeden kod na zdarzenie; zapisane dane pojawiają się w historii aktywa, pod wyznaczoną pozycją.

### Jak wyznaczyć punkt pomiarowy

1. **W Measurement points (lub w aktywie) kliknij «Designate position».** Wyznaczenie zużywa jeden punkt pomiarowy z puli organizacji: raz na pozycję, nie przy każdym wysłaniu.
2. **Uzupełnij kod, szablon i interwał.** Kod to `location` wysyłane przez integrację (małe litery, bez spacji). Szablon zawiera zmienne rodziny z ich jednostką UCUM; możesz dodać własne zmienne. Uzgodniony interwał w sekundach określa, jak często będziesz wysyłać odczyt.

   ![Okno «Designate a measurement position»: kod, szablon, zmienne i interwał](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **Pozycja pojawia się na liście i zaczyna odbierać odczyty.** Każde zdarzenie wysłane z tym kodem i kluczem odbioru danych jest zapisywane w historii aktywa, pod tą pozycją.

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

Zweryfikowano za pomocą opublikowanego SDK IAES 2.0.2, wersji używanej przez usługę odbioru danych.

- `data.location` — kod wyznaczonej pozycji
- `data.measurement_type` — klucz zmiennej
- `data.unit` — jednostka kontraktu (porównywana, nigdy przeliczana)
- `data.value` — liczba; wartości logiczne są przesyłane jako 0 lub 1
- `timestamp` — czas pomiaru w UTC — nie czas wysłania
- `event_id` — nowy dla każdego odczytu; to klucz idempotencji

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

Zaimportuj przepływ z instrukcji (pump-process-to-wertek.flow.json); węzeł iaes-publish używa tego samego klucza.

### Instrukcje

- **Node-RED.** Instrukcja zweryfikowana programowo: jej skrypt odbiorczy działa z API na symulowanych wartościach. Węzły IAES 2.0.2 zaimportowane i uruchomione w prawdziwym Node-RED 5.0.6 (Docker, 2026-11-12): 5/5 zdarzeń poprawnych. [Instrukcja, przepływ i skrypt odbiorczy](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** Instrukcja sprawdzona z API w dniu 2026-10-05, bez automatycznego skryptu odbiorczego. Węzły IAES 2.0.2 zaimportowane i uruchomione w prawdziwym n8n 2.8.4 (2026-11-12): 5/5 zdarzeń poprawnych. [Instrukcja i przepływ pracy](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **Dowolny klient HTTP.** Podstawowa instrukcja: odczytaj kontrakt aktywa, wyznacz pozycję, wyślij dane i odczytaj odpowiedź zdarzenie po zdarzeniu. [Instrukcja i skrypt odbiorczy](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### A MQTT?

Dziś MQTT oznacza kanały dla konkretnych urządzeń — Banner DXM, zestawów Acrel i liczników energii — każdy z własnym tematem i poświadczeniem, skonfigurowany z aprowizacją. Nie ma uniwersalnego tematu: dla każdego innego urządzenia drogą jest HTTP z kluczem.

## Co chroni Twoje dane przy przesyłaniu i nad czym masz kontrolę

Co kod robi dzisiaj, bez niczego więcej.

- **Klucze odbioru danych.** Klucz zaczyna się od wk_ i jest wyświetlany raz, przy tworzeniu. Wertek AI przechowuje tylko jego skrót SHA-256 i prefiks o długości 12 znaków, aby go rozpoznać.
- **Uprawnienia, wygaśnięcie i cofnięcie.** Każdy klucz ma swoje uprawnienia (telemetry.view, telemetry.export, iaes.ingest), może być ograniczony do konkretnych aktywów, może wygasnąć po 1 do 365 dni i można go cofnąć. Tylko właściciel lub administrator zarządza kluczami.
- **Powiązany z Twoją organizacją.** Zdarzenie jest przyjmowane tylko dla aktywów organizacji klucza: klucz nie może zapisywać do aktywów innej organizacji.
- **Podczas przesyłania.** API jest udostępniane przez HTTPS. Dla MQTT używaj portu 8883 z TLS.
- **Pliki przez podpisane linki.** Zrzuty i dokumenty są dostarczane przez linki podpisane za pomocą HMAC-SHA256, które wygasają.
- **Przechowywane dane.** Nasi dostawcy (Supabase dla bazy danych i Cloudflare R2 dla plików) szyfrują dane, które przechowują.
- **Limity i użycie.** Do 300 żądań na minutę na poświadczenie maszyny (429 po przekroczeniu) i 100 zdarzeń na partię. API telemetrii rejestruje użycie każdego klucza i jego ostatnie użycie.

### Zalecenia dla integratorów

- MQTT: port 8883 z TLS.
- Nie zalecamy wysyłania niezaszyfrowanych danych. Jeśli urządzenie nie obsługuje TLS, skontaktuj się z nami: można je ocenić z innymi zabezpieczeniami.
- Jeden klucz na zakład, z minimalnym uprawnieniem (iaes.ingest do wysyłania danych) i terminem wygaśnięcia.
- Przechowuj klucz w zmiennej środowiskowej lub magazynie sekretów, nigdy w kodzie ani w przepływie.
- Cofnij klucz, gdy urządzenie lub zakład opuszcza usługę.

## Opublikowane pakiety z otwartym kodem źródłowym

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. Siedem węzłów: measurement, health, work-order, validate, sparkplug, publish i route. Opublikowana wersja: 2.0.2 · [Kod źródłowy](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`. Węzeł społecznościowy dla n8n. Opublikowana wersja: 2.0.2 · [Kod źródłowy](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`. Klient, modele i walidacja zdarzenia (walidacja używa ajv). Opublikowana wersja: 2.0.2 · [Kod źródłowy](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"`. Modele i walidacja: ten sam walidator, którego używa usługa odbioru Wertek AI. Opublikowana wersja: 2.0.2 · [Kod źródłowy](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**Wersja poglądowa.** Arduino Opta: iaes-opta-runtime emituje IAES 1.4, a usługa odbioru Wertek AI wymaga 2.x. To wersja poglądowa, nie do zastosowań produkcyjnych. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: zbuduj przepływ raz.** Jeden otwarty format zdarzeń, wykorzystywany ponownie u każdego klienta, oraz to, co Twój klient otrzymuje w Wertek AI. [Zobacz IAES dla integratorów](https://wertek.ai/pl/integrators/iaes/index.md)

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

## Więcej niż miejsce przechowywania danych

- **Aktywo i jego historia.** Każdy odczyt pozostaje w historii aktywa, pod wyznaczoną przez Ciebie pozycją.
- **Obserwacje.** Jego zespół zapisuje ustalenia z terenu wraz ze zdjęciami, przez stronę internetową lub telefon.
- **Zlecenia pracy.** Aby działać na podstawie ustaleń i zachować zapis każdej interwencji. Od Technical.
- **Aplikacja mobilna.** Do pracy w terenie, na Android i iPhone.

## Odbieranie danych jest bezpłatne; ich monitorowanie nie.

Płacisz za monitorowany punkt pomiarowy, nie za aktywo.

- 1 punkt pomiarowy: USD 36 rocznie
- Pakiet 5 punktów pomiarowych: USD 120 rocznie

Ceny z aktualnego katalogu Wertek AI, odczytane w chwili publikacji tej strony. [Zobacz wszystkie plany](https://wertek.ai/pricing.html)

## Twój klient zarządza aktywem; widzisz to, co Ci udostępni

- Aktywo i jego historia należą do tego, kto nim zarządza: Twojego klienta. Twoje wpisy zachowują Twoje autorstwo.
- Widzisz to, co udostępni Ci klient: według zakładu, obszaru lub aktywa, w określonych oknach czasowych.
- Domyślnie za punkty pomiarowe płaci Twój klient.
- Jeśli zakończycie współpracę, aktywo i jego historia techniczna pozostają u klienta; Twój dostęp kończy się po jego cofnięciu.

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

## Co przyjmuje usługa odbioru danych

| | |
|---|---|
| Ścieżka | POST https://api.wertek.ai/iaes/ingest |
| Nagłówek | X-API-Key, z uprawnieniem iaes.ingest |
| Zdarzenie | IAES, spec_version 2.x |
| Partia | do 100 zdarzeń na żądanie |
| Limit | 300 żądań na minutę na klucz |
| Interwał | odczyt, który dotrze przed upływem 90 % uzgodnionego interwału, jest odrzucany (kod 504) |
| Kontrakt aktywa | GET /iaes/assets/{asset_id}/measurement-points, z kluczem |
| Schemat i kody | GET /iaes/schema i /iaes/schema/codes, z kluczem |
| Odpowiedź | jeden kod na zdarzenie: 1xx zapisano · 2xx zapisano z ostrzeżeniem · 4xx popraw komunikat · 5xx ponów próbę |

## Najczęściej zadawane pytania

**Czy potrzebuję planu?** Nie potrzebujesz planu do wysyłania danych; każdy monitorowany punkt pomiarowy jest opłacany według katalogu. Plan włącza alerty docierające do odbiorcy, zlecenia pracy i dłuższą historię.

**Gdzie to działa?** Usługa odbioru danych działa w chmurze Wertek AI. Brama Wertek AI działa w Twojej sieci: odczytuje urządzenia i przesyła odczyty.

**Czy usługa odbioru zapisuje dane w moim PLC?** Nie. Usługa odbioru tylko przyjmuje dane.

**Co się stanie, jeśli wysyłam szybciej niż wynosi interwał?** Odczyt, który dotrze przed upływem 90 % uzgodnionego interwału, jest odrzucany z kodem 504. Dostosuj wysyłanie do interwału punktu pomiarowego.

