# Collega le tue apparecchiature. Trasforma i loro dati in servizi di manutenzione.

> Tu porti l’automazione e conosci il cliente. Wertek AI offre la piattaforma per monitorare gli asset, registrare osservazioni, gestire ordini di lavoro e offrire un servizio ricorrente.

Per gli integratori · Wertek AI · https://wertek.ai/it/integrators/

**Ingresso:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **Uscita verso:** SCADA / HMI · Storico di processo

**Sola lettura: Wertek AI non scrive sul tuo PLC.**

## I tuoi protocolli entrano. Il tuo SCADA legge lo stato con una chiave API di sola lettura.

Fai clic su una riga per vedere di cosa si tratta, come si collega e il suo stato.

**Wertek AI:** Asset · Condizione · Allarme · Ordine di lavoro · Report

### Ingresso

#### OT · Reparto produttivo

- **[Gateway Wertek AI](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP, con mappe dei registri per 32 dispositivi di 17 marchi (Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…) e banchi di condensatori. Le apparecchiature comunicano già così.
- **Dispositivi che pubblicano tramite MQTT** *(Con provisioning)* — Banner DXM (vibrazioni wireless, con modem 4G), kit Acrel e contatori di energia. Le apparecchiature comunicano già così.
- **Il tuo flusso tramite HTTP con una chiave** *(Tramite Node-RED / Ignition / gateway)* — Node-RED, Ignition, n8n, Python o JavaScript/TypeScript; ricette per Modbus TCP, MQTT e OPC UA, validate con valori simulati.
- **OPC UA da Bently Nevada System 1** *(Beta)* — Connettore di lettura.
- **[Sul campo, con il telefono](https://wertek.ai/it/mobile/)** — Osservazioni con foto, video con VibeDiag, analisi acustica e letture manuali (ore, cicli, kWh…).

> S7, EtherNet/IP e OPC UA generico: nessun driver nostro; vi accedi tramite Node-RED, Ignition o un gateway.

#### IT · Sistemi aziendali

- **Manutenzione ed ERP** — Importano i propri ordini di lavoro: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **File** — Asset da CSV o Excel, verificati prima dell’applicazione; segnali WAV, UFF58 e CSV.

### Uscita

#### OT · Reparto produttivo

- **Storici di processo dell’impianto** — Wertek AI scrive le proprie misurazioni e lo stato di salute degli asset nello storico di processo, accanto ai tuoi dati di processo: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **SCADA, HMI o Node-RED con una chiave di lettura** — Ignition, Node-RED o uno script legge asset, misurazioni con il relativo risultato e raccomandazione, ed energia, per mostrare la condizione accanto ai tag di processo. La chiave di lettura si crea a partire dal piano Monitoring.

> Wertek AI non scrive sul tuo PLC: pubblica fatti e stati, e decidi tu quale tag modificare.

#### IT · Sistemi aziendali

- **API con una chiave** — Asset, misurazioni, segnale e FFT, ed energia; esportazione in JSON. La chiave di lettura si crea a partire dal piano Monitoring.
- **Download** — CSV, XLSX, Parquet, WAV e PDF: misurazioni, osservazioni, ordini di lavoro, consumi e report di conformità al codice di rete elettrica.
- **Allarmi** — Push ed email, e in tempo reale nell’app.
- **Report periodici via email** — Energia e conformità al codice di rete elettrica, condizione e riepilogo mensile dei centri di consumo.
- **[Manutenzione ed ERP](https://wertek.ai/it/integrations/)** — Connettori, ciascuno con il proprio stato verificato: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## HTTP con una chiave: il percorso per qualsiasi dispositivo

1. **Crea il tuo account gratuito.** Su app.wertek.ai. Una chiave con il solo permesso di acquisizione funziona con qualsiasi piano. [Crea account](https://app.wertek.ai/signup)
2. **Crea l’asset e designa il punto di misura.** Nell’app, registra l’asset e designa la posizione che alimenterai: il suo codice, le sue variabili con l’unità UCUM e la sua cadenza. Puoi designarla anche con la chiave: POST /iaes/assets/{asset_id}/measurement-points. La designazione consuma un punto di misura: eseguila una volta per posizione, non a ogni invio.
3. **Crea la chiave di acquisizione.** In Impostazioni → Chiavi API (Settings → API Keys), con il permesso di acquisizione. Mantienila segreta: in una variabile d’ambiente, mai nel codice o in un tag.
4. **Invia la lettura.** Un evento asset.measurement per lettura, da solo o in un elenco di massimo 100, a POST https://api.wertek.ai/iaes/ingest. La risposta contiene un codice per evento; ciò che viene archiviato appare nella cronologia dell’asset, sotto la posizione designata.

### Come designare un punto di misura

1. **In Measurement points (o sull’asset), fai clic su «Designate position».** La designazione usa un punto di misura dal pool della tua organizzazione: una volta per posizione, non a ogni invio.
2. **Inserisci il codice, il modello e la cadenza.** Il codice è il `location` che la tua integrazione invierà (in minuscolo, senza spazi). Il modello include le variabili della famiglia con la loro unità UCUM; puoi aggiungere variabili personalizzate. La cadenza contrattuale, in secondi, indica ogni quanto invierai una lettura.

   ![Finestra «Designate a measurement position»: codice, modello, variabili e cadenza](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **La posizione appare nell’elenco e inizia a ricevere letture.** Ogni evento inviato con quel codice e la chiave di acquisizione viene salvato nello storico dell’asset, sotto quella posizione.

### L’evento (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"
  }
}
```

Validato con l’SDK IAES 2.0.2 pubblicato, la versione usata dall’acquisizione.

- `data.location` — il codice della posizione designata
- `data.measurement_type` — la chiave della variabile
- `data.unit` — l’unità del contratto (confrontata, mai convertita)
- `data.value` — un numero; i booleani sono trasmessi come 0 o 1
- `timestamp` — l’ora della misurazione, in UTC — non l’ora dell’invio
- `event_id` — nuova per ogni lettura; è la chiave di idempotenza

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

Importa il flusso della ricetta (pump-process-to-wertek.flow.json); il nodo iaes-publish usa la stessa chiave.

### Ricette

- **Node-RED.** Ricetta validata nel software: il suo script di accettazione viene eseguito contro l’API con valori simulati. Nodi IAES 2.0.2 importati ed eseguiti in un Node-RED 5.0.6 reale (Docker, 2026-11-12): 5/5 eventi validi. [Ricetta, flusso e script di accettazione](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** Ricetta verificata contro l’API il 2026-10-05, senza script di accettazione automatico. Nodi IAES 2.0.2 importati ed eseguiti in un n8n 2.8.4 reale (2026-11-12): 5/5 eventi validi. [Ricetta e flusso di lavoro](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **Qualsiasi client HTTP.** La ricetta di base: leggi il contratto dell’asset, designa la posizione, invia e leggi la risposta evento per evento. [Ricetta e script di accettazione](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### E MQTT?

Oggi MQTT significa canali per apparecchiature specifiche — Banner DXM, kit Acrel e contatori di energia — ciascuno con il proprio topic e la propria credenziale, configurati con provisioning. Non esiste un topic universale: per qualsiasi altro dispositivo, il percorso è HTTP con una chiave.

## Cosa protegge i tuoi dati in ingresso e cosa controlli

Ciò che il codice fa oggi, senza aggiungere altro.

- **Chiavi di acquisizione.** Una chiave inizia con wk_ e viene mostrata una volta, quando la crei. Wertek AI conserva solo il suo hash SHA-256 e un prefisso di 12 caratteri per riconoscerla.
- **Permessi, scadenza e revoca.** Ogni chiave ha i suoi permessi (telemetry.view, telemetry.export, iaes.ingest), può essere limitata ad asset specifici, può scadere tra 1 e 365 giorni e può essere revocata. Solo un proprietario o un amministratore gestisce le chiavi.
- **Legata alla tua organizzazione.** Un evento viene accettato solo per gli asset dell’organizzazione della chiave: una chiave non può scrivere negli asset di un’altra organizzazione.
- **In transito.** L’API è disponibile tramite HTTPS. Per MQTT, usa la porta 8883 con TLS.
- **File tramite link firmati.** Acquisizioni e documenti vengono forniti tramite link firmati con HMAC-SHA256 che scadono.
- **Dati archiviati.** I nostri fornitori (Supabase per il database e Cloudflare R2 per i file) crittografano i dati che archiviano.
- **Limiti e utilizzo.** Fino a 300 richieste al minuto per credenziale macchina (429 oltre il limite) e 100 eventi per lotto. L’API di telemetria registra l’utilizzo di ogni chiave e il suo ultimo uso.

### Raccomandazioni per gli integratori

- MQTT: porta 8883 con TLS.
- Sconsigliamo di inviare dati non crittografati. Se un dispositivo non supporta TLS, contattaci: può essere valutato con altre protezioni.
- Una chiave per stabilimento, con il permesso minimo (iaes.ingest per inviare dati) e una scadenza.
- Conserva la chiave in una variabile d’ambiente o in un archivio di segreti, mai nel codice o nel flusso.
- Revoca la chiave quando un dispositivo o uno stabilimento lascia il servizio.

## Pacchetti pubblicati, con il loro codice sorgente aperto

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. Sette nodi: measurement, health, work-order, validate, sparkplug, publish e route. Versione pubblicata: 2.0.2 · [Codice sorgente](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`. Nodo della comunità per n8n. Versione pubblicata: 2.0.2 · [Codice sorgente](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, modelli e validazione dell’evento (la validazione usa ajv). Versione pubblicata: 2.0.2 · [Codice sorgente](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"`. Modelli e validazione: lo stesso validatore usato dall’acquisizione Wertek AI. Versione pubblicata: 2.0.2 · [Codice sorgente](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**Anteprima.** Arduino Opta: iaes-opta-runtime emette IAES 1.4, e l’acquisizione Wertek AI richiede 2.x. È un’anteprima, non per la produzione. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: crea il flusso una volta.** Un formato di evento aperto, riutilizzato con ogni cliente, e ciò che il tuo cliente riceve in Wertek AI. [Vedi IAES per integratori](https://wertek.ai/it/integrators/iaes/index.md)

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

## Più di uno spazio per archiviare dati

- **L’asset e la sua cronologia.** Ogni lettura resta nella cronologia dell’asset, sotto la posizione che hai designato.
- **Osservazioni.** Il suo team registra ciò che trova sul campo, con foto, dal web o dal telefono.
- **Ordini di lavoro.** Per intervenire su quanto riscontrato e conservare il registro di ogni intervento. A partire da Technical.
- **L’app mobile.** Per il lavoro sul campo, su Android e iPhone.

## Ricevere i dati è gratuito; monitorarli no.

Paghi per il punto di misura monitorato, non per l’asset.

- 1 punto di misura: USD 36 all’anno
- Pacchetto di 5 punti di misura: USD 120 all’anno

Prezzi del catalogo Wertek AI attuale, consultati alla pubblicazione di questa pagina. [Vedi tutti i piani](https://wertek.ai/pricing.html)

## Il tuo cliente governa l’asset; tu vedi ciò che ti autorizza a vedere

- L’asset e la sua cronologia appartengono a chi lo governa: il tuo cliente. Ciò che registri mantiene la tua paternità.
- Vedi ciò che il tuo cliente ti autorizza a vedere: per stabilimento, area o asset, con finestre temporali.
- Per impostazione predefinita, il tuo cliente paga i punti di misura.
- Se interrompete la collaborazione, l’asset e la sua cronologia tecnica restano al tuo cliente; il tuo accesso termina quando viene revocato.

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

## Cosa accetta l’acquisizione

| | |
|---|---|
| Percorso | POST https://api.wertek.ai/iaes/ingest |
| Intestazione | X-API-Key, con il permesso iaes.ingest |
| Evento | IAES, spec_version 2.x |
| Lotto | fino a 100 eventi per richiesta |
| Limite | 300 richieste al minuto per chiave |
| Cadenza | una lettura che arriva prima del 90 % della cadenza contrattuale viene scartata (codice 504) |
| Contratto dell’asset | GET /iaes/assets/{asset_id}/measurement-points, con la chiave |
| Schema e codici | GET /iaes/schema e /iaes/schema/codes, con la chiave |
| Risposta | un codice per evento: 1xx archiviato · 2xx archiviato con avviso · 4xx correggi il messaggio · 5xx riprova |

## Domande frequenti

**Mi serve un piano?** Non serve un piano per inviare dati; ogni punto di misura monitorato viene pagato secondo il catalogo. Il piano attiva avvisi che raggiungono qualcuno, ordini di lavoro e una cronologia più estesa.

**Dove viene eseguito?** L’acquisizione è un servizio cloud di Wertek AI. Il gateway Wertek AI opera sulla tua rete: legge le apparecchiature e invia le letture.

**L’acquisizione scrive sul mio PLC?** No. L’acquisizione riceve soltanto dati.

**Cosa succede se invio più velocemente della cadenza?** Una lettura che arriva prima del 90 % della cadenza contrattuale viene scartata con il codice 504. Adatta gli invii alla cadenza del punto di misura.

