# ERP API 測試文件

## 環境資料
- Swagger: https://app.swaggerhub.com/apis/gentle.shao/erp
- 測試主機: https://api-admin.scalprecovery.tt.wabow.com/api
- 測試帳號: `washop_erp_account`
- 測試密碼: `washop_erp_token`

## 改動紀錄
### 1.0.3
- `商品異動`: 現在 `商品貨號` 重複時將不再返回錯誤訊息
- 錯誤代碼 `205` 已不再使用，但仍保留在列表中
- `商品異動`: HTTP 動詞 由 `PATCH` 調整為 `PUT`
- `商品異動`: 若 `商品貨號` 不存在 -> 新增商品，否則 -> 更新商品

### 1.0.2
- `商品異動`: 現在 `商品貨號` 重複時將返回錯誤訊息
- `商品異動`: 新增 `isPreOrder`、`isOfficial` 欄位
- `商品異動`: 若 `isOfficial` 為 `false`，商品將被放入預設停用的隱賣檔期
- `商品異動`: 移除 `isNormal`、`shop` 欄位
- `訂單異動`: 調整 `shipping` 中的枚舉代碼
- `可銷售數量異動`: 原先更新庫存前會扣除當日訂單中處於付款狀態的商品數量，現在會跳過這一步，直接更新庫存

### 1.0.1
- `商品異動`: 將 `分類資料` 由 `string` 調整為 `array[string]` 以便接受多個商品分類
- `商品異動`: 若分類名稱完全相符與原無異，若不完全相符或查無分類則不建立分類關聯資料

## 商業邏輯錯誤代碼
API 回應時會提供 `code` 及 `message` 欄位，請依照 `code` 判斷執行結果。

|Code|說明|
| -------- | -------- |
|0|操作順利完成|
|100|處理時發生錯誤|
|110|所提供的登入資料無效|
|120|此資源要求登入後才能使用|
|200|提供的隱形賣場資料無效|
|201|提供的分類名稱資料無效|
|202|提供的商品編號無效|
|203|更新後的商品數量將為負數|
|204|查無指定訂單|
|205|~~提供的商品編號已存在~~ (已棄用)|
|300|表單驗證時發生錯誤|

## 測試用資料
此處提供之資料僅為測試用途。

### 會員資料
共 `10` 筆，會員編號分別為 `1` 到 `10`，型別為 `integer`，最早更新時間為 `2021-09-02 10:37:34`

### 分類資料
共 `10` 筆，新增產品時需要提供分類名稱

|分類名稱|
|--------|
|天天居家系列|
|居家護理套組|
|洗頭必備小物|
|洗髮|
|經典沙龍系列|
|護髮|
|身體沐浴|
|隨身旅行組|
|頂級鉑金系列|
|頭皮護理|

### 訂單資料
共 `16` 筆，分別逐一對應了每一種訂單狀態，最早新增時間為 `2021-09-27 15:03:57`，開立發票時需要提供訂單編號
|訂單編號|
|--------|
|13|
|282|
|283088|
|31057326|
|4517|
|50|
|511601650|
|57|
|66820|
|786174025|
|788|
|8|
|852869|
|885690390|
|890960|
|989|

### 商品資料
共 `20` 筆，商品編號如下，更新庫存時可以直接使用，亦可自行建立商品

|商品編號|
|--------|
|511|
|38|
|6569|
|642895824|
|8389|
|6|
|60951123|
|566345519|
|981|
|8|
|76230|
|3791720|
|963|
|4777|
|602617216|
|8838|
|663834|
|5|
|9885|
|357|

### 隱形賣場資料
共 `2` 筆，代號如下，新增商品時可作為隱形賣場資料帶入

|代號|
|--------|
|kyontw_202107|
|official_202108|