00-01_GLM002(GLM001)過帳傳票維護_畫面操作說明

系統說明文件：GLM002Controller API

簡介

GLM002Controller 是一組 Web API，用於過帳傳票維護。該 API 包含多項功能，例如查詢傳票、過帳、取消過帳及檢核等操作。本文將詳細描述每個 API 方法的運作流程、使用情境、輸入與輸出格式，以及檢核邏輯。

1. 查詢傳票（GetVoucherList）

目的

假設情境

使用者在進行傳票管理時，想要查詢特定條件的傳票列表，例如特定的帳簿期間、科目等級等，透過此 API 進行查詢。

運作流程

  1. 前端發送 GET 請求到 GetVoucherList API，包含查詢條件（如帳簿期間、科目等級等）。
  2. API 調用 _service.QueryVoucherList()，從資料庫中取得符合條件的傳票列表。
  3. API 返回傳票的詳細資訊，包括傳票號碼、日期、科目、摘要等。
  4. 前端顯示這些傳票資訊。

輸出結果（OutputList: VoucherList_OutputVo）

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "查詢成功",
    "RESULT": [
        {
            "VOUCHER_NO": "202408001",
            "VOUCHER_DATE": "2024-08-01",
            "ACCT_NO": "1001",
            "SUMMARY": "進貨折讓",
            "AMOUNT": 5000
        },
        {
            "VOUCHER_NO": "202408002",
            "VOUCHER_DATE": "2024-08-15",
            "ACCT_NO": "2001",
            "SUMMARY": "銷貨折讓",
            "AMOUNT": 3000
        }
    ]
}

2. 過帳（PostVoucher）

Stored procedure 流程圖
Stored procedure 流程圖

目的

假設情境

使用者在確認傳票資料無誤後，點擊「過帳」按鈕，將傳票資料過帳至正式帳簿中。

運作流程

  1. 使用者點擊「過帳」按鈕，前端將傳票編號等資訊打包成 JSON 格式，並發送 POST 請求到 PostVoucher API：
    {
    "VOUCHER_NO": "202408001",
    "USER_ID": "admin"
}
  2. API 調用 _service.PostVoucher() 進行傳票的過帳操作。
  3. API 將過帳結果打包成 PostVoucher_OutputVo，並返回至前端。

輸入參數（InputList: PostVoucher_InputVo）

輸出結果（OutputList: PostVoucher_OutputVo）

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "過帳成功",
    "RESULT": {
        "P_ERRMSG": ""
    }
}

3. 取消過帳（UnpostVoucher）

目的

假設情境

使用者發現傳票內容有誤，需要將已過帳的傳票取消過帳，回到暫存狀態。

運作流程

  1. 使用者點擊「取消過帳」按鈕，前端將傳票編號等資訊打包成 JSON 格式，並發送 POST 請求到 UnpostVoucher API：
    {
    "VOUCHER_NO": "202408001",
    "USER_ID": "admin"
}
  2. API 調用 _service.UnpostVoucher() 執行取消過帳操作。
  3. API 將結果打包成 UnpostVoucher_OutputVo，並返回至前端。

輸入參數（InputList: UnpostVoucher_InputVo）

輸出結果（OutputList: UnpostVoucher_OutputVo）

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "取消過帳成功",
    "RESULT": {
        "P_ERRMSG": ""
    }
}

4. 檢核傳票（CheckVoucher）

目的

假設情境

使用者在過帳前，想要先檢核傳票的資料，以確保可以順利過帳。

運作流程

  1. 使用者點擊「檢核」按鈕，前端將傳票編號打包成 JSON 格式，並發送 POST 請求到 CheckVoucher API：
    {
    "VOUCHER_NO": "202408001"
}
  2. API 調用 _service.CheckVoucher() 進行傳票的檢核操作，確認其符合過帳的條件。
  3. API 將檢核結果打包成 CheckVoucher_OutputVo，並返回至前端。

輸入參數（InputList: CheckVoucher_InputVo）

輸出結果（OutputList: CheckVoucher_OutputVo）

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "檢核成功",
    "RESULT": {
        "P_ERRMSG": ""
    }
}