品號基本資料

基本資訊

請求參數

欄位	類型	必填	說明
enterprise_no	String	必填	公司編號
site_no	String	必填	據點編號
data_time	Date	必填	同步起始時間 (yyyy-MM-dd HH:mm:ss)
page_size	Numeric	必填	每頁筆數，預設 500
key_condition	String	選填	分頁續傳鍵

回應欄位

ERP 欄位	MES 欄位	說明
item_no	ID	品號
item_name	NAME	品名
item_spec	DESCRIPTION	規格
unit_no	UNIT	基本單位
second_unit_no	CONVERTUNIT	換算單位
process_item	STDROUTEITEMID	標準途程品號
process_code	STDROUTEID	標準途程代碼
item_sort	-	A=組合品(→ITEM), M=物料(→material_catalog)
tran_status	TRAN_STATUS	D=停用, AU=啟用

回應範例

{
  "item_data": [
    {
      "item_no": "ITEM-001",
      "item_name": "測試品項",
      "item_spec": "規格說明",
      "unit_no": "PCS",
      "second_unit_no": "BOX",
      "process_item": "ITEM-001",
      "process_code": "RT001",
      "item_sort": "A",
      "modify_no": "USER001",
      "tran_status": "AU"
    }
  ]
}

處理邏輯

資料庫更新 SQL

判斷新增或修改

SELECT COUNT(1) FROM ITEM WHERE ID = N'{item_no}'
-- count > 0 → UPDATE, count = 0 → INSERT

INSERT（新增品號）

INSERT INTO ITEM (
    ID, NAME, DESCRIPTION, UNIT, RELEASEUNIT,
    STDROUTEITEMID, STDROUTEID, ITEM001, ITEM002,
    ITEM004, ITEM005, CONVERTUNIT,
    LASTMAINTAINUSER, LASTMAINTAINDATETIME, FLAG
) VALUES (
    :ID, :NAME, :DESCRIPTION, :UNIT, :UNIT,
    :STDROUTEITEMID, :STDROUTEID, :ITEM001, :ITEM002,
    :ITEM004, :ITEM005, :CONVERTUNIT,
    :userid, N'{當前時間}', 0
)

UPDATE（修改品號）

UPDATE ITEM SET
    NAME = :NAME,
    DESCRIPTION = :DESCRIPTION,
    UNIT = :UNIT,
    RELEASEUNIT = :UNIT,
    STDROUTEITEMID = CASE WHEN STDROUTEITEMID IS NULL OR STDROUTEITEMID = ''
                     THEN :STDROUTEITEMID ELSE STDROUTEITEMID END,
    STDROUTEID = CASE WHEN STDROUTEID IS NULL OR STDROUTEID = ''
                 THEN :STDROUTEID ELSE STDROUTEID END,
    ITEM001 = :ITEM001,
    ITEM002 = :ITEM002,
    ITEM004 = :ITEM004,
    ITEM005 = :ITEM005,
    CONVERTUNIT = :CONVERTUNIT,
    LASTMAINTAINUSER = :userid,
    LASTMAINTAINDATETIME = N'{當前時間}',
    FLAG = (SELECT MAX(FLAG)+1 FROM ITEM WHERE ID = :ID)
WHERE ID = :ID

material_catalog 表（item_sort = "M"）

判斷新增或修改

SELECT COUNT(1) FROM material_catalog WITH (NOLOCK)
WHERE material_id = N'{item_no}'
-- count > 0 → UPDATE, count = 0 → INSERT

INSERT（新增物料）

INSERT INTO material_catalog (
    material_id, material_name, norm, unit_no,
    oper_date, oper_id, ENABLED, MODI_DATE
) VALUES (
    :ID,                    -- 品號 (item_no)
    :NAME,                  -- 品名 (item_name)
    :DESCRIPTION,           -- 規格 (item_spec)
    :UNIT,                  -- 單位 (unit_no)
    N'{當前時間}',
    :userid,
    :ENABLED,               -- Y/N (tran_status: AU→Y, D→N)
    N'{當前時間}'
)

UPDATE（修改物料）

UPDATE material_catalog SET
    material_name = :NAME,
    norm = :DESCRIPTION,
    unit_no = :UNIT,
    ENABLED = :ENABLED,
    MODI_DATE = N'{當前時間}'
WHERE material_id = :ID