# 機器を接続。データを保全サービスに変える。

> 自動化技術と顧客への理解は皆様が提供します。Wertek AI は、アセットの監視、観察記録、作業指示書の管理、継続的なサービスの提供を支えるプラットフォームを提供します。

インテグレーター向け · Wertek AI · https://wertek.ai/ja/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。17 ブランドの 32 機器（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 のレシピはシミュレーション値で検証済み。
- **Bently Nevada System 1 の OPC UA** *(Beta)* — 読み取りコネクター。
- **[現場でスマートフォンを使う](https://wertek.ai/ja/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：測定値、観察記録、作業指示書、消費量、グリッドコード適合報告書。
- **アラート** — プッシュとメール、アプリ内でのリアルタイム表示。
- **メールによる定期レポート** — エネルギーとグリッドコード適合、状態、消費センターの月次概要。
- **[保全と ERP](https://wertek.ai/ja/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"
  }
}
```

取り込みサービスが使用するバージョンである、公開済みの IAES 2.0.2 SDK で検証済みです。

- `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.** 2026-10-05 に API に対して確認した構成手順です。自動受け入れスクリプトはありません。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 には TLS とポート8883を使用してください。
- **署名付きリンク経由のファイル.** キャプチャと文書は、有効期限のある HMAC-SHA256 署名付きリンクで配信されます。
- **保存データ.** 当社のプロバイダー (データベースは Supabase、ファイルは Cloudflare R2) は、保存するデータを暗号化します。
- **制限と使用状況.** マシン認証情報ごとに毎分最大300リクエスト (超過時は429)、バッチごとに100イベントです。テレメトリ API は各キーの使用状況と最終使用を記録します。

### インテグレーターへの推奨事項

- MQTT: TLS とポート8883。
- 暗号化されていないデータの送信は推奨しません。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/ja/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 で破棄されます。測定点の周期に合わせて送信してください。

