IVM API整合：如何將販賣機數據接入企業ERP系統？台灣2026

工廠的 ERP/MES 系統已經很複雜了——IVM 的數據要怎麼整合進去？

IVM API整合ERP系統說明

為什麼要整合 IVM 和 ERP？

數據孤島的問題：

沒有整合的問題（常見於大型企業客戶）：

場景：某科技大廠，300 名員工，5 台 IVM 設備

現況（沒有整合）：
• 龍雲數位：有完整的 IVM 銷售數據（每日/每品項/每設備）
• 企業採購部門：不知道這些數據的存在
• 企業 HR/總務部門：要查分潤，要登入 IVM 場地主 APP
• 企業 IT 部門：「這個設備和我們系統沒有連接，是個黑盒子」

問題：
• 銷售數據沒有進 ERP → 財務部門無法統一報告
• 員工補貼（公司幫員工付一部分）→ 需要手動對帳
• 總務部門：每月要手動下載 IVM 報告 + 匯入 Excel

---

整合後的樣子（IVM API 整合）：

企業 ERP（SAP/Oracle/鼎新/勤業）：
↕ API 連接
IVM 平台

每日自動同步：
• IVM 銷售數據 → 自動寫入 ERP 的「場地福利服務收入/支出」分類
• IVM 員工消費記錄 → 對應到員工編號（若有 IC 卡整合）
• IVM 設備狀態 → 寫入設備管理模組

好處：
→ 財務部門不需要手動處理
→ 員工補貼計算自動化
→ 總務部門只需要看 ERP，不用開另一個 APP

IVM API 的技術規格

工程師需要知道的細節：

IVM API 基本資訊（龍雲數位 2026 版）：

API 類型：RESTful API（標準 HTTP）
認證方式：OAuth 2.0 Bearer Token
數據格式：JSON
版本：v2.1（目前最新）

基礎 URL：
https://api.ivm.transtep.com/v2/

---

主要 API Endpoint 說明：

GET /sites
功能：取得所有場地清單
回傳：
{
  "sites": [
    {
      "site_id": "S001",
      "name": "XX工廠 廠區A",
      "address": "台中市...",
      "device_count": 3,
      "status": "active"
    }
  ]
}

---

GET /sites/{site_id}/sales
功能：取得指定場地的銷售數據
參數：
• start_date（YYYY-MM-DD）
• end_date（YYYY-MM-DD）
• granularity：daily / hourly / monthly

回傳（日度摘要範例）：
{
  "site_id": "S001",
  "period": {"start": "2026-06-01", "end": "2026-06-30"},
  "summary": {
    "total_revenue": 145800,
    "total_transactions": 2916,
    "avg_transaction": 50.0
  },
  "daily": [
    {
      "date": "2026-06-01",
      "revenue": 5160,
      "transactions": 103,
      "by_device": [
        {"device_id": "D001", "revenue": 1820, "transactions": 45},
        {"device_id": "D002", "revenue": 2450, "transactions": 38}
      ]
    }
  ]
}

---

GET /devices/{device_id}/status
功能：取得設備即時狀態
回傳：
{
  "device_id": "D001",
  "status": "online",
  "temperature": 4.2,
  "last_seen": "2026-06-17T14:30:00+08:00",
  "inventory": [
    {
      "slot": "A1",
      "product_id": "P001",
      "product_name": "礦泉水 600ml",
      "quantity": 8,
      "expiry_date": "2026-12-31",
      "alert": false
    }
  ],
  "alerts": []
}

---

POST /webhook/subscribe
功能：訂閱 IVM 告警的 Webhook 通知
用途：讓企業 IT 系統「即時接收」IVM 告警（不用輪詢）
設定：
{
  "url": "https://your-company.com/ivm-webhook",
  "events": ["device_alert_p1", "device_alert_p2", "low_inventory"],
  "secret": "your-hmac-secret"
}

IVM 收到告警時，自動 POST 到你的 URL：
{
  "event": "device_alert_p1",
  "device_id": "D001",
  "alert_type": "temperature_critical",
  "value": 14.5,
  "timestamp": "2026-06-17T15:00:00+08:00",
  "site_id": "S001"
}

常見整合場景

企業 IT 最常問的整合案例：

場景一：企業員工補貼自動計算

需求：
公司決定補貼員工每月在販賣機消費 NT$200（扣除後由公司支付）

整合方式：
• IVM IC 卡整合：員工刷工卡購買
• IVM API：每月導出每位員工的消費記錄（員工工號 + 消費金額）
• 企業薪資系統：自動計算「NT$200 補貼 - 員工實際消費」
  → 若員工消費 NT$150 → 本月補貼 NT$150（剩餘 NT$50 不累計）
  → 若員工消費 NT$350 → 員工自付 NT$150（超出部分）

開發工作量：
• IVM API 取得員工消費記錄：1-2 天開發
• 對接薪資系統：3-5 天（依薪資系統開放性）

---

場景二：設備狀態整合進企業維修工單系統

需求：
IVM P1 告警 → 自動在企業的 ITSM 系統（如 ServiceNow / Jira）建立維修工單

整合方式：
• IVM Webhook：訂閱 P1/P2 告警事件
• 企業 ITSM API：接收 Webhook 後，自動建立工單
  → 工單內容：設備 ID / 告警類型 / 發生時間 / 場地地址

好處：
→ 維修工單和 IVM 告警自動關聯
→ 維修完成後，工單關閉 → IVM 狀態同步更新

---

場景三：銷售數據進 ERP 財務模組

需求：
每月 IVM 分潤 → 自動進入企業 ERP 的「財務收入」分類

整合方式：
• 每月 5 日（龍雲數位結算日）：IVM API 推送月度銷售報告
• 企業 ERP Connector：接收 JSON 數據 → 轉換格式 → 寫入 ERP

開發工作量：
• 中等複雜度（約 1-2 週），主要取決於 ERP 的開放性

台灣常見 ERP 的整合難易度：
• SAP S/4HANA：提供完整 API，開放性高（中等難度）
• Oracle ERP Cloud：API 開放，文件完整（中等難度）
• 鼎新雲（台灣本土）：有 API，但文件相對少（需要較多工時）
• 自建系統：視系統設計而定（差異極大）

IT 部門的 IVM 整合評估

IVM 的資安和合規說明：

IT 部門最常問的問題：

問題一：IVM 的數據儲存在哪裡？

回答：
• 主要數據中心：AWS Asia Pacific（ap-northeast-1 / ap-southeast-1）
• 數據分類：設備狀態數據、銷售交易數據、設備地理位置數據
• 不包含：消費者個人資料（除非有 IC 卡整合，才有員工工號）

---

問題二：IVM 的網路連線方式？

回答：
• 設備連網：4G LTE SIM 卡（獨立於企業內網）
• 資料傳輸：HTTPS（TLS 1.3）加密
• 不進入企業內網（不需要開防火牆規則）

IT 部門通常最在意這一點 → IVM 完全不接觸企業內網（零風險）

---

問題三：API 存取的資安控制？

回答：
• OAuth 2.0 認證（業界標準）
• API 密鑰有有效期限（可設定 30-365 天）
• 帳號有角色權限控制（只讀 / 讀寫 / 管理員）
• 所有 API 呼叫有記錄（稽核日誌，保存 1 年）

---

問題四：IVM 符合哪些合規標準？

回答（2026年現況）：
• 台灣個資法：符合（不蒐集超出必要的個人資料）
• ISO 27001：龍雲數位持有（資訊安全管理認證）
• PCI DSS：透過第三方支付閘道（龍雲數位本身不持有信用卡數據）

---

整合開始前需要的文件/資源：
□ API 文件（龍雲數位提供，英文版 + 繁中版）
□ 測試環境帳號（用於開發測試，不影響正式數據）
□ 龍雲數位技術對接窗口（提供 API 整合技術支援）
□ 企業 IT 聯絡人（負責對接）

常見問題

Q：IVM API 的使用費用？ A：標準合作方案（設備 + 補貨 + 維修）中，IVM 的基本 API 存取是免費包含的（場地主/企業客戶可以免費使用場地主 APP 和基本 API）。進階功能（如：高頻率 Webhook / 大量數據歷史查詢 / 自定義報告格式）視具體需求另行報價。一般中型企業的整合需求（員工補貼計算 + 設備狀態監控）通常在免費方案範圍內。

Q：IVM API 有 SDK 嗎？還是要自己從零開始串？ A：目前龍雲數位提供的是 RESTful API + 詳細的 API 文件。尚未有官方 SDK（Python/Node.js）。對有 HTTP 請求基礎的工程師：串接難度不高（用 axios/fetch/requests 即可）。若企業 IT 需要更多技術支援，龍雲數位技術團隊提供「整合協助服務」（依複雜度收費）。

小結

IVM API整合：RESTful API + OAuth 2.0，主要endpoint：/sites（場地清單）+/sales（銷售數據）+/devices/status（即時狀態）+Webhook（即時告警推送）；常見整合：員工補貼自動計算+設備告警進ITSM工單+月銷售進ERP財務；資安優勢：設備用4G SIM完全不進企業內網，HTTPS TLS 1.3加密，ISO 27001認證；基本API免費，進階功能另報價。

了解龍雲數位（transtep.com）IVM API技術文件和企業系統整合服務。