IVM平台API整合：第三方系統如何串接販賣機數據2026

IVM 的數據可以串接到公司的 ERP 或 HR 系統嗎？API 文件怎麼取得？

台灣IVM平台API第三方整合

IVM 平台的 API 架構

龍雲數位 IVM 的技術整合能力：

IVM API 的整體架構：

IVM 核心後台（龍雲數位管理）：
├── REST API（HTTP/HTTPS）
│   ├── 裝置管理 API → 設備狀態/位置/型號
│   ├── 銷售數據 API → 交易記錄/銷售報表
│   ├── 庫存 API → 庫存量/補貨告警
│   ├── 用戶 API → IC 卡用戶管理/補貼設定
│   └── 告警 API → 故障/溫度/效期告警
│
├── MQTT（即時推送）
│   ├── 設備狀態推送（每 5 分鐘）
│   ├── 交易事件推送（即時）
│   └── 告警事件推送（即時）
│
└── Webhook
    ├── 交易完成通知
    ├── 設備告警通知
    └── 補貨需求觸發

API 安全機制：
• 認證：OAuth 2.0（Bearer Token）
• 加密：TLS 1.2 以上
• 速率限制：100 requests/分鐘（標準方案）
• IP 白名單：企業整合可設定

常見整合場景

哪些企業系統和 IVM 整合最多？

整合場景一：HR 系統 ← → IVM 員工補貼

需求：
• HR 系統中的「員工福利模組」
• 想要自動化管理「販賣機飲料補貼」
• 員工入職/離職自動啟用/停用補貼

IVM 提供的 API：

POST /api/users/register
→ 創建新 IC 卡用戶（員工入職時）
{
  "ic_card_id": "0A:12:34:56",
  "employee_id": "EMP001",
  "monthly_subsidy": 300,
  "department": "RD"
}

DELETE /api/users/{ic_card_id}
→ 停用 IC 卡（員工離職時）

GET /api/users/{ic_card_id}/usage?month=2026-06
→ 查詢特定員工本月補貼使用量

GET /api/reports/subsidy?month=2026-06
→ 所有員工補貼使用報表（HR 月結用）

整合後效果：
• HR 系統入職流程 → 自動觸發 IVM 創建帳號
• 員工離職 → HR 系統自動停用 IVM 帳號
• 月初自動刷新補貼額度（依 HR 設定）

整合場景二：ERP ← → IVM 進貨對帳

需求：
• 大型企業使用 ERP（SAP/Oracle）管理採購
• 販賣機補貨算是「採購進貨」
• 想要讓 IVM 的補貨記錄自動進 ERP

IVM 提供的 API：

GET /api/replenishments?date_from=2026-06-01&date_to=2026-06-30
→ 本月所有補貨記錄
{
  "replenishments": [
    {
      "date": "2026-06-05",
      "device_id": "IVM-001",
      "items": [
        {"sku": "TE001", "product": "統一綠茶 500ml", "qty": 60, "unit_cost": 16.5},
        {"sku": "CF002", "product": "拿鐵咖啡 350ml", "qty": 36, "unit_cost": 28}
      ]
    }
  ]
}

ERP 整合後：
• IVM 補貨記錄 → 自動建立 ERP 「採購進貨單」
• 每月底：ERP 應付帳款 ← IVM 補貨金額
• 月結時不需要人工對帳（全自動）

整合場景三：BMS ← → IVM 設備監控

（已在「智慧大樓BMS整合」文章中詳述）

IVM 主要提供：
• GET /api/devices/{id}/energy → 用電量
• GET /api/devices/{id}/status → 設備狀態
• GET /api/alerts/active → 未處理告警

BMS 接收後：
• 販賣機用電量進 ESG 能源報表
• 販賣機告警進大樓統一告警系統

API 文件取得方式

開發人員如何取得 IVM API 文件？

IVM API 文件取得流程：

Step 1：場地主聯繫龍雲數位
• 說明：貴公司想要 API 整合的系統和用途
• 提供：IT 負責人的聯絡資訊

Step 2：龍雲數位技術評估
• 確認整合場景（HR/ERP/BMS/自建系統）
• 確認合約等級（標準合約 vs 企業整合合約）
• 標準合約：API 基本讀取權限
• 企業整合合約：完整 API 權限 + SLA 保證

Step 3：簽署 API 使用協議
• 保密條款（API 規格不對外公開）
• 使用限制（僅限自家系統整合，不得轉售）
• 責任條款（API 調用錯誤的責任歸屬）

Step 4：取得 API 文件 + 測試環境
• API 文件：Swagger/OpenAPI 格式
• 測試環境：龍雲數位提供 Sandbox（測試帳號）
• 技術支援：Email + Line 工程師支援（企業合約）

時間：Step 1-4 通常需要 2-4 週

整合費用

API 整合需要額外付費嗎？

費用結構（依整合複雜度）：

基礎 API 讀取（免費）：
• 場地主可以免費使用：銷售查詢/設備狀態 API
• 用途：自己做報表、數據可視化
• 限制：100 requests/分鐘，僅限讀取

標準整合方案（年費 NT$30,000-80,000）：
• 雙向 API（讀取 + 寫入）
• 員工帳號管理 API（HR 整合）
• Webhook 即時推送
• 技術支援 Email（48 小時響應）

企業整合方案（NT$100,000+/年）：
• 全功能 API
• 自訂 Webhook endpoints
• MQTT 即時推送
• 專屬技術支援（4 小時響應 SLA）
• 可討論：ERP 整合協助（由龍雲數位派工程師）

→ 若整合需求是「HR 自動化補貼」：標準方案足夠
→ 若整合需求是「ERP 對帳 + BMS 能源管理」：企業方案

常見問題

Q：我們公司的 IT 部門可以自己用 API 開發整合，不需要龍雲數位工程師介入嗎？ A：可以。龍雲數位提供 Swagger 格式的完整 API 文件，IT 人員可以自行開發。龍雲數位只需要提供 API 金鑰和測試環境。若遇到問題，有技術支援 Email 可以詢問。大多數整合（HR/BMS）IT 人員 2-4 週可以完成。

Q：API 有版本控制嗎？升版了舊的整合會壞掉嗎？ A：IVM API 採用版本號管理（如：/api/v2/）。若 IVM 升版，舊版 API 會繼續支援至少 12 個月（提前公告），不會突然壞掉。升版前會發 email 通知場地主的 IT 人員。

Q：API 可以讀取其他場地（別家公司）的數據嗎？ A：不行。API 金鑰綁定到場地主帳號，只能讀取自己場地的設備和交易數據。龍雲數位嚴格執行數據隔離，不同場地主之間的數據完全獨立。

小結

IVM API 整合：提供 REST API / MQTT / Webhook 三種整合路徑；主要整合場景：HR 員工補貼自動化、ERP 採購對帳、BMS 能源管理；API 文件需簽署使用協議後取得；基礎讀取免費，雙向整合年費 NT$3-8 萬（企業方案 NT$10 萬+）。IVM 的開放 API 架構讓台灣企業可以將販賣機 IoT 數據整合進更廣泛的企業管理系統中。

聯繫龍雲數位（transtep.com）了解IVM API整合方案和企業技術支援。