# ECC CAPI 電子客戶協同API
## 作業清單

| 階段 | 交談作業代碼 | 項目 | 備註 |
| -------- | -------- | -------- | -------- |
| 生產 | M21 | 訂單進度追蹤 | 前稱「訂單進度」|
| 生產 | M23 | 成品入庫與出貨 | 前稱「提領狀態與提領回覆」代表「可出貨的成品」|
| 生產 | M24 | 提領確認 | |
| 生產 | M25 | 裝車出貨單 | |
| 交貨 | M31 | 信用狀餘額 | |
| 交貨 | M33 | 品證數據 | |
| 交貨 | M34 | 合約餘量資訊 | |

## 開發狀態

| 待確認 | 待開發 | 待測試 | 已完成 |
| -------- | -------- | -------- |-------- |

## COIL 訊息回傳
| Code | 發生情境 | 處理方式 |
| -------- | -------- | -------- |
| 200 | 返回成功 | 可以進行data數據解析 |
| 500 | 各種錯誤情況 | 讀取message看具體訊息，ERROR MESSAGE OR EXCEPTION MESSGE |

## M21 訂單進度 （待測試）
### 功能描述
查詢客戶訂單狀態
### 請求地址
::: info
http://localhost:8080/coil/requestDCMC305/getAllFromXmlByECC
:::
### 請求方式
:::info
POST
:::
### 參數

| 參數名 | 值 | 含義 | 備註 |
| -------- | -------- | -------- | -------- |
| ctNo | 11112S026 | 合約號 |
| unifiedCode | 22533297 | 統一編碼 |

{
  "ctNo": "11202S005",
  "unifiedCode": "22533297"
}

### 返回

{
  "message": "success",
  "code": 200,
  "timeStamp": 1678868659359,
  "data": [
    {
      "dataDate": "2023/03/15",
      "saleOrder": "Y1098873",
      "saleItem": "07",
      "ctNo": "11202S005",
      "stType": "S304LB",
      "srfType": "2B",
      "stt": "毛邊",
      "category": "1",
      "orWidth": 1240,
      "orThick": 0.71,
      "thickMax": 0.74,
      "thickMin": 0.71,
      "weight": 20000,
      "instockDate": "2023-02-25 00:00:00",
      "dlvedWeight": 0,
      "pndWeight": 0,
      "lftOntime": 0,
      "lftDelay": 20684,
      "plnDate": "2023-03-11 18:27:09",
      "lftWeight": 20000
    }
  ]
}

## M24 提領確認 （待測試）
### 功能描述
### 請求地址
::: info
http://localhost:8080/coil/requestDCMC305/getAllFromXml
:::
### 請求方式
:::info
POST
:::
### 參數

| 參數名 | 值 | 含義 | 備註 |
| -------- | -------- | -------- | -------- |
| ctNo | 11201S014 | 合約號 |

{
  "ctNo": "11201S014",
  "dlvAdd": "X",
  "dlvSite": "X",
  "dlvType": "X",
  "expDeliver": "2022-12-08",
  "note": "X",
  "prdId": "ZJ714L02",
  "prtNo": "1",
  "unifiedCode": "22318348"
}

### 返回

{
    "code":200,
    "message":'sucess',
    
}

## M23 成品入庫與出貨 （已完成）
### 功能描述
### 開發人員 09024

### 請求地址
::: info
http://localhost:8080/coil/requestDCMC301/getAllFromXml
unifiedCode=22533297&ctNo=11112S026
:::
### 請求方式
:::info
get
:::
### 參數
| 參數名 | 含義 | 備註 |
| -------- | -------- | -------- |
| unifiedCode | 統編 | |
| ctNo | 合約號 | |

### API返回
| Code | 發生情境 | 處理方式 |
| -------- | -------- | -------- |
| 200 | 返回成功 | 可以進行data數據解析 |
| 500 | 各種錯誤情況 | 讀取message看具體訊息 |

#### 1.錯誤的情況(寫一種)

{
  "message": "程式異常，請稍後重試",
  "code": 500,
  "timeStamp": 1676879517257,
  "data": null
}

#### 2.成功的情況

{
  "message": "success",
  "code": 200,
  "timeStamp": 1676879517257,
  "data": [
    {
      "dataDate": "2023/02/20",
      "cstName": "運錩鋼鐵股份有限公司 ",
      "prdID": "ZJ372L02",
      "ctNo": "11202S005",
      "csFlag": "N",
      "stType": "S304LB",
      "srfType": "2B",
      "stt": "毛邊",
      "category": "F1",
      "std": "Requirements: ASTM A240/A240M, A480/A480M-22 and A666; ASME SA-240/SA-240M and SA-480/SA-480M-2021EN 10088-2, EN 10088-4, EN 10028-7, PED 2014/68/EU, AD2000 W2/W10,ISO 3651-2A and ASTM A262-A&E:OK, ISO 9445-2, hardness acc. to NACE MR0175/ISO 15156",
      "orThick": 1.2,
      "orWidth": 1530,
      "thickMax": 1.2,
      "thickMin": 1.15,
      "rlThick": 1.15,
      "rlWidth": 1535,
      "rlLength": 1695,
      "netWeight": 24057,
      "grsWeight": 24135,
      "requirement": "運錩二月單"
    }
  ]
}

# M21 CAPI 接收格式問題
:::info
這個問題涉及客戶傳輸跟CAPI接收，需要統一
欄位有共識，擺放需要確認
:::
## 以M21為例

:::info
客戶端傳輸範例 1
:::

{
    "messageId": "M210101",
    "unifiedCode": "22533297",
    "userID":"Joyce",
    "userIP":"10.191.200.33",
    "ctNo":"11111S034",
    "scNo":"11203010001",
    "qSrtDate":"2023-01-08",
    "qEndDate":"2023-01-15"
}

:::info
客戶端傳輸範例 2
:::

{
    "messageId": "M210101",
    "userID":"Joyce",
    "userIP":"10.191.200.33",
    data:{
    "unifiedCode": "22533297",   
    "ctNo":"11111S034",
    "scNo":"11203010001",
    "qSrtDate":"2023-01-08",
    "qEndDate":"2023-01-15"  
    }
    
}

###### tags `ECC` `ECC CAPI`