超電訂單拋轉鼎新 ERP 品號對應規格

SalesOrder_add API → DSP → OLAI12 → INVMB / INVMH

本文件描述「超電平台訂單」透過 API 拋轉到「鼎新 ERP」時，系統如何以品號為 KEY 完成核對並寫入訂單。當資料拋轉檢核時，除了品號 Key 值外，可能還有其它欄位檢核，但此份文件只著重在「品號 Key」範疇討論。

文件範圍

涵蓋：

  • API 拋轉入口欄位 product_no
  • 鼎新 DSP 中介的解析流程
  • 異質系統訂單格式設定作業 OLAI12 的 3 種對應邏輯
  • 對應到品號主檔 INVMB / 商品條碼檔 INVMH 的實際查表路徑

資料鏈全貌

flowchart TD
    SRC["超電後台
商品編號"]
    API["product_no
（鼎新 SalesOrder_add API 欄位）"]
    SRC ==>|依鼎新 API 規格填入| API
    API --> DSP["DSP 中介"]
    DSP -->|OLAI12
選 1 客戶品號| K1["客戶品號對照表"]
    DSP -->|OLAI12
選 2 品號| K2["INVMB.MB001"]
    DSP -->|OLAI12
選 3 條碼編號| K3["INVMH.MH002"]
    K1 --> M["拿到 MB001"]
    K2 --> M
    K3 --> M
    M --> W["寫入訂單"]
    style SRC fill:#e6f7ff,stroke:#0284c7,stroke-width:2px
    style API fill:#fff8e1,stroke:#f0b429,stroke-width:2px
    style M fill:#e6f5ec,stroke:#1f6f3f,stroke-width:2px

藍框 = 超電端資料來源；黃框 = 鼎新公告的 API 規格欄位；綠框 = 鼎新內部品號主鍵。

API 入口欄位 product_no

product_no 是鼎新公告的標準 API 欄位規格，外部廠商依此規格開發 API， 把自家系統的商品識別值填入這個欄位，POST 到鼎新 DSP。

  • API：SalesOrder_add（自有官網 新增訂單）
  • 欄位：product_no
  • 型態：string，長度 ≤ 40 characters
  • 必填：是
  • 描述：產品品號
  • 本 case 的填入方式：超電依規格開發 API，把超電後台商品資料裡的「商品編號」欄位值填進 product_no

DSP 中介處理流程

  1. 收到 SalesOrder_add 的 payload，取出 product_no
  2. 依「通路平台類別代號 + 平台代號」到 OLAI12 異質系統訂單格式設定作業 找對應設定
  3. 讀該設定的「選擇品號對應邏輯」欄位（3 選 1）
  4. 依對應邏輯查對應主檔，取得 INVMB.MB001
  5. 將商品基本資料同步寫入訂單

OLAI12 異質系統訂單格式設定作業

作業代號：OLAI12

核心欄位：

  • 通路平台類別代號（例：CM201 自有官網）
  • 平台代號（例：0001）
  • 平台名稱（例：快電商(超電)）
  • 轉入目的（轉入訂單 / 轉入銷貨單）
  • 格式類型（例：1.訂單）
  • 品號庫別來源（例：Y.依品號主要庫別）
  • 選擇品號對應邏輯：3 選 1（見下節）
  • 轉入鎖定碼、擷取會員資料等其他參數

選擇品號對應邏輯 3 個選項：

選項 名稱 DSP 拿 product_no 去比對的目標
1 客戶品號 客戶品號對照表
2 品號 INVMB.MB001（品號資料建立作業 INVI02）
3 條碼編號 INVMH.MH002（商品條碼資料建立作業 INVI13）

路徑細節 (三條對應邏輯)

當「選擇品號對應邏輯」= 2.品號

DSP 拿 product_no 去 INVI02 品號資料建立作業， 比對 INVMB.MB001，一致後將主檔資料同步寫入訂單。

要求：product_no 內容必須等於某筆 MB001 完整字串。

當「選擇品號對應邏輯」= 3.條碼編號

DSP 拿 product_no 去 INVI13 商品條碼資料建立作業， 比對 INVMH.MH002，核對到條碼後再利用商品品號欄位關聯回 INVMB， 將商品基本資料同步寫入訂單。

要求：product_no 內容必須等於 INVMH 表中某筆條碼字串。 DSP 查詢對象是 INVMH.MH002。 本公司無「一品號多條碼」情境，故 INVMH.MH002 = INVMB.MB013。

當「選擇品號對應邏輯」= 1.客戶品號

DSP 拿 product_no 去「客戶品號對照表」比對，找到對應 MB001， 再將商品基本資料同步寫入訂單。

要求：對照表需維護「超電端的品號字串 ↔ MB001」對應。 對照表所在的維護作業：待補（顧問確認中）。

相關作業與資料表對照

作業代號 名稱 主資料表 關鍵欄位
OLAI12 異質系統訂單格式設定作業 OLAIMB（設定檔） 選擇品號對應邏輯
INVI02 品號資料建立作業 INVMB MB001（品號）、MB002（品名）、MB013（國際條碼）等
INVI13 商品條碼資料建立作業 INVMH MH002（商品條碼）、對應品號
CMSB07 Excel 轉入批次作業 INVMB 首次匯入品號主檔用