# Connectez vos équipements. Transformez leurs données en services de maintenance.

> Vous apportez l’automatisation et connaissez le client. Wertek AI apporte la plateforme pour surveiller les actifs, consigner les observations, gérer les ordres de travail et proposer un service récurrent.

Pour les intégrateurs · Wertek AI · https://wertek.ai/fr/integrators/

**Entrée:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **Sortie vers:** SCADA / HMI · Historien de données

**Lecture seule : Wertek AI n’écrit pas dans votre PLC.**

## Vos protocoles entrent. Votre SCADA lit l’état avec une clé API en lecture seule.

Cliquez sur une ligne pour voir de quoi il s’agit, comment elle se connecte et son état.

**Wertek AI:** Actif · État · Alerte · Ordre de travail · Rapport

### Entrée

#### OT · Atelier

- **[Passerelle Wertek AI](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP, avec des tables de registres pour 32 appareils de 17 marques (Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…) et des batteries de condensateurs. Les équipements transmettent déjà ainsi.
- **Appareils publiant via MQTT** *(Avec provisionnement)* — Banner DXM (vibrations sans fil, avec modem 4G), kits Acrel et compteurs d’énergie. Les équipements transmettent déjà ainsi.
- **Votre propre flux via HTTP avec une clé** *(Via Node-RED / Ignition / passerelle)* — Node-RED, Ignition, n8n, Python ou JavaScript/TypeScript ; recettes pour Modbus TCP, MQTT et OPC UA, validées avec des valeurs simulées.
- **OPC UA de Bently Nevada System 1** *(Beta)* — Connecteur de lecture.
- **[Sur le terrain, avec le téléphone](https://wertek.ai/fr/mobile/)** — Observations avec photos, vidéo avec VibeDiag, analyse acoustique et relevés manuels (heures, cycles, kWh…).

> S7, EtherNet/IP et OPC UA générique : aucun pilote développé par nos soins ; vous y accédez via Node-RED, Ignition ou une passerelle.

#### IT · Systèmes d’entreprise

- **Maintenance et ERP** — Ils apportent leurs ordres de travail : SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **Fichiers** — Actifs issus de CSV ou Excel, vérifiés avant application ; signaux WAV, UFF58 et CSV.

### Sortie

#### OT · Atelier

- **Historiens de données de l’usine** — Wertek AI écrit ses mesures et l’état de santé des actifs dans l’historien de données, à côté de vos données de procédé : AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **SCADA, HMI ou Node-RED avec une clé de lecture** — Ignition, Node-RED ou un script lit les actifs, les mesures avec leur résultat et leur recommandation, ainsi que l’énergie, pour afficher l’état à côté des tags de procédé. La clé de lecture se crée à partir du forfait Monitoring.

> Wertek AI n’écrit pas dans votre PLC : il publie des faits et des états, et vous décidez quel tag modifier.

#### IT · Systèmes d’entreprise

- **API avec une clé** — Actifs, mesures, signal et FFT, et énergie ; export en JSON. La clé de lecture se crée à partir du forfait Monitoring.
- **Téléchargements** — CSV, XLSX, Parquet, WAV et PDF : mesures, observations, ordres de travail, consommation et rapport de conformité au code de réseau électrique.
- **Alertes** — Notifications push et e-mail, et en direct dans l’application.
- **Rapports périodiques par e-mail** — Énergie et conformité au code de réseau électrique, état et synthèse mensuelle des centres de consommation.
- **[Maintenance et ERP](https://wertek.ai/fr/integrations/)** — Connecteurs, chacun avec son état audité : MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## HTTP avec une clé : la voie pour tout appareil

1. **Créez votre compte gratuit.** Sur app.wertek.ai. Une clé avec la seule permission d’ingestion fonctionne avec toutes les offres. [Créer un compte](https://app.wertek.ai/signup)
2. **Créez l’actif et désignez le point de mesure.** Dans l’application, enregistrez l’actif et désignez la position à alimenter : son code, ses variables avec leur unité UCUM et sa cadence. Vous pouvez aussi la désigner avec la clé : POST /iaes/assets/{asset_id}/measurement-points. La désignation consomme un point de mesure : faites-la une fois par position, pas à chaque envoi.
3. **Créez la clé d’ingestion.** Dans Paramètres → Clés API (Settings → API Keys), avec la permission d’ingestion. Gardez-la secrète : dans une variable d’environnement, jamais dans le code ni dans un tag.
4. **Envoyez le relevé.** Un événement asset.measurement par relevé, seul ou dans une liste de 100 maximum, vers POST https://api.wertek.ai/iaes/ingest. La réponse contient un code par événement ; les données stockées apparaissent dans l’historique de l’actif, sous la position désignée.

### Comment désigner un point de mesure

1. **Dans Measurement points (ou sur l’actif), cliquez sur «Designate position».** La désignation utilise un point de mesure de la réserve de votre organisation : une fois par position, pas à chaque envoi.
2. **Renseignez le code, le modèle et la cadence.** Le code est le `location` que votre intégration enverra (en minuscules, sans espaces). Le modèle fournit les variables de la famille avec leur unité UCUM ; vous pouvez ajouter des variables personnalisées. La cadence contractuelle, en secondes, indique la fréquence d’envoi d’un relevé.

   ![Boîte de dialogue «Designate a measurement position» : code, modèle, variables et cadence](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **La position apparaît dans la liste et commence à recevoir des relevés.** Chaque événement envoyé avec ce code et la clé d’ingestion est stocké dans l’historique de l’actif, sous cette position.

### L’événement (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"
  }
}
```

Validé avec le SDK IAES 2.0.2 publié, la version utilisée par l’ingestion.

- `data.location` — le code de la position désignée
- `data.measurement_type` — la clé de la variable
- `data.unit` — l’unité du contrat (comparée, jamais convertie)
- `data.value` — un nombre ; les booléens sont transmis sous la forme 0 ou 1
- `timestamp` — l’heure de la mesure, en UTC — pas l’heure de l’envoi
- `event_id` — nouvelle pour chaque relevé ; c’est la clé d’idempotence

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

Importez le flux de la recette (pump-process-to-wertek.flow.json) ; le nœud iaes-publish utilise la même clé.

### Recettes

- **Node-RED.** Recette validée en logiciel : son script d’acceptation s’exécute contre l’API avec des valeurs simulées. Nœuds IAES 2.0.2 importés et exécutés dans un vrai Node-RED 5.0.6 (Docker, 2026-11-12) : 5/5 événements valides. [Recette, flux et script d’acceptation](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** Recette vérifiée contre l’API le 2026-10-05, sans script d’acceptation automatique. Nœuds IAES 2.0.2 importés et exécutés dans un vrai n8n 2.8.4 (2026-11-12) : 5/5 événements valides. [Recette et workflow](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **Tout client HTTP.** La recette de base : lisez le contrat de l’actif, désignez la position, envoyez et lisez la réponse événement par événement. [Recette et script d’acceptation](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### Et MQTT ?

Aujourd’hui, MQTT désigne des canaux pour des équipements précis — Banner DXM, kits Acrel et compteurs d’énergie — chacun avec son propre sujet et identifiant, configurés avec provisionnement. Il n’y a pas de sujet universel : pour tout autre appareil, la voie est HTTP avec une clé.

## Ce qui protège vos données à leur arrivée et ce que vous contrôlez

Ce que fait le code aujourd’hui, sans rien de plus.

- **Clés d’ingestion.** Une clé commence par wk_ et n’est affichée qu’une fois, à sa création. Wertek AI conserve uniquement son empreinte SHA-256 et un préfixe de 12 caractères pour la reconnaître.
- **Permissions, expiration et révocation.** Chaque clé porte ses permissions (telemetry.view, telemetry.export, iaes.ingest), peut être limitée à certains actifs, peut expirer sous 1 à 365 jours et peut être révoquée. Seul un propriétaire ou un administrateur gère les clés.
- **Liée à votre organisation.** Un événement est accepté uniquement pour les actifs de l’organisation de la clé : une clé ne peut pas écrire dans les actifs d’une autre organisation.
- **En transit.** L’API est accessible via HTTPS. Pour MQTT, utilisez le port 8883 avec TLS.
- **Fichiers via des liens signés.** Les captures et les documents sont transmis via des liens signés avec HMAC-SHA256 qui expirent.
- **Données stockées.** Nos fournisseurs (Supabase pour la base de données et Cloudflare R2 pour les fichiers) chiffrent les données qu’ils stockent.
- **Limites et utilisation.** Jusqu’à 300 requêtes par minute et par identifiant de machine (429 au-delà) et 100 événements par lot. L’API de télémétrie consigne l’utilisation de chaque clé et sa dernière utilisation.

### Recommandations pour les intégrateurs

- MQTT : port 8883 avec TLS.
- Nous déconseillons l’envoi de données non chiffrées. Si un appareil ne prend pas en charge TLS, contactez-nous : il peut être évalué avec d’autres protections.
- Une clé par usine, avec la permission minimale (iaes.ingest pour envoyer des données) et une expiration.
- Conservez la clé dans une variable d’environnement ou un gestionnaire de secrets, jamais dans le code ni dans le flux.
- Révoquez la clé lorsqu’un appareil ou une usine quitte le service.

## Paquets publiés, avec leur code source ouvert

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. Sept nœuds : measurement, health, work-order, validate, sparkplug, publish et route. Version publiée: 2.0.2 · [Code source](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`. Nœud communautaire pour n8n. Version publiée: 2.0.2 · [Code source](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, modèles et validation de l’événement (la validation utilise ajv). Version publiée: 2.0.2 · [Code source](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"`. Modèles et validation : le même validateur que celui utilisé par l’ingestion Wertek AI. Version publiée: 2.0.2 · [Code source](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**Aperçu.** Arduino Opta : iaes-opta-runtime émet IAES 1.4, et l’ingestion Wertek AI exige 2.x. C’est un aperçu, pas destiné à la production. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES : créez le flux une fois.** Un format d'événement ouvert, réutilisé avec chaque client, et ce que votre client reçoit dans Wertek AI. [Voir IAES pour intégrateurs](https://wertek.ai/fr/integrators/iaes/index.md)

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

## Plus qu’un espace de stockage de données

- **L’actif et son historique.** Chaque relevé reste dans l’historique de l’actif, sous la position que vous avez désignée.
- **Observations.** Son équipe consigne ses constats sur le terrain, avec des photos, depuis le web ou le téléphone.
- **Ordres de travail.** Pour agir sur les constats et conserver la trace de chaque intervention. À partir de Technical.
- **L’application mobile.** Pour le travail sur le terrain, sur Android et iPhone.

## Recevoir les données est gratuit ; les surveiller ne l’est pas.

Vous payez pour le point de mesure surveillé, pas pour l’actif.

- 1 point de mesure : USD 36 par an
- Lot de 5 points de mesure : USD 120 par an

Prix du catalogue Wertek AI en vigueur, consultés à la publication de cette page. [Voir toutes les offres](https://wertek.ai/pricing.html)

## Votre client gouverne l’actif ; vous voyez ce qu’il vous autorise

- L’actif et son historique appartiennent à celui qui le gouverne : votre client. Les enregistrements que vous créez conservent votre qualité d’auteur.
- Vous voyez ce que votre client vous autorise : par usine, zone ou actif, avec des fenêtres temporelles.
- Par défaut, votre client paie les points de mesure.
- Si vous vous séparez, l’actif et son historique technique restent chez votre client ; votre accès prend fin lors de sa révocation.

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

## Ce que l’ingestion accepte

| | |
|---|---|
| Route | POST https://api.wertek.ai/iaes/ingest |
| En-tête | X-API-Key, avec la permission iaes.ingest |
| Événement | IAES, spec_version 2.x |
| Lot | jusqu’à 100 événements par requête |
| Limite | 300 requêtes par minute et par clé |
| Cadence | un relevé qui arrive avant 90 % de la cadence contractuelle est rejeté (code 504) |
| Contrat de l’actif | GET /iaes/assets/{asset_id}/measurement-points, avec la clé |
| Schéma et codes | GET /iaes/schema et /iaes/schema/codes, avec la clé |
| Réponse | un code par événement : 1xx stocké · 2xx stocké avec un avertissement · 4xx corriger le message · 5xx réessayer |

## Questions fréquentes

**Ai-je besoin d’une offre ?** Vous n’avez pas besoin d’une offre pour envoyer des données ; chaque point de mesure surveillé est facturé selon le catalogue. L’offre active des alertes transmises à quelqu’un, les ordres de travail et un historique plus long.

**Où cela fonctionne-t-il ?** L’ingestion est un service cloud de Wertek AI. La passerelle Wertek AI fonctionne sur votre réseau : elle lit les équipements et envoie les relevés.

**L’ingestion écrit-elle dans mon PLC ?** Non. L’ingestion reçoit uniquement des données.

**Et si j’envoie plus vite que la cadence ?** Un relevé qui arrive avant 90 % de la cadence contractuelle est rejeté avec le code 504. Adaptez vos envois à la cadence du point de mesure.

