# 會員樹葉與樹轉換
Custos-EnterpriseAPP-API-021
V1.0
2023-11-06

Custos 企業會員 APP 使用者透過此 API 將所擁有的樹葉與樹進行轉換。

[toc]
## 作業啟動
1. 以傳入之使用者 token 取得使用者流水編號 #emp_data_id
2. 記錄 SystemLog：#emp_data_id|樹葉與樹進行轉換|作業啟動

## API 作業啟動
1. 傳入樹葉數 #leaves_accum、樹數 #trees_accum、此次轉換用掉多少片樹葉 #consume_leaves
2. 以 #emp_data_id 查詢 corp_ls_emp_carbon_records，更新 corp_ls_emp_carbon_records.leaves_accum、corp_ls_emp_carbon_records.trees_accum
3. 以 #emp_data_id 新增一筆 corp_ls_carbon_records 紀錄，將 #consume_leaves 以負數紀錄於 leaves 欄位

## 作業結束
記錄 SystemLog：#emp_data_id|樹葉與樹進行轉換|作業結束

## 例外處理
若執行中有發生異常，將攔截到的 exception 訊息記錄 ErrorLog：[YYYYMMDDHHMMSS] EnterpriseAPP-API-021 發生異常：【#攔截到的 exception 訊息】

## 規格及範例
|API No|EnterpriseAPP-API-021|
|-|-|
|API Name|setEmpLeavesTrees|
|URL|${url}/APP/setData/setEmpLeavesTrees|
|Purpose|樹葉與樹進行轉換|
|Description|透過 API 將使用者的樹葉與樹進行轉換|
|Protocol|JSON over HTTP POST|
|Content-Type|application/json|

**Request**
|參數|型態|必填|長度|說明|
|-|-|:-:|:-:|-|
|token|String|Y||使用者驗證字串|
|leaves_accum|INT|Y||樹葉數|
|trees_accum|INT|Y||樹數|
|consume_leaves|INT|Y||轉換用掉的樹葉數，樹增加為負，樹減少為正|

**Response**
|參數|型態|必回|說明|
|-|-|:-:|-|
|result|String|Y|API 執行結果，Y：成功，N：失敗|
|message|String|N|API 執行失敗的訊息說明|

**Request Sample**

var input = {
  "token": "xxx",
  "leaves_accum": 541,
  "trees_accum": 3,
  "consume_leaves": 2000 
}

**Response Sample**

{	
  "result": "Y",	 //API 結果，Result = Y 時才會有資料
  "message": "..."	 //API 訊息，Ex："執行失敗，原因：XXXXXXXXX"	
}