圈款（預繳）查詢

QueryReserves

版本資訊

v2.2.9 起新增功能

輸入參數

參數	類別	說明
account	Account	帳號

Result 回傳

參數	類別	說明
IsSuccess	bool	是否成功
Data	*ReserveCashSummary	回傳整戶預繳彙總
Message	*string	當 IsSuccess = false 回傳錯誤訊息

預繳彙總 ReserveCashSummary 欄位

Return type : Object

參數	類別	說明
BranchNo	string	分公司代號
Account	string	帳號
Currency	string	幣別 : TWD 新台幣
ReservedAmount	int64	預收金額（元）
ReturnedAmount	int64	返還金額（元）
OrderedAmount	int64	已委託金額（元）

請求範例

package main

import (
    "fmt"
    "fubon"
)

func main() {
    // 初始化 SDK 並登入
    sdk := fubon.NewFubonSDK()

    // ... 登入、連線等初始化步驟 ...

    // 圈款（預繳）整戶彙總查詢
    reservesResult, err := sdk.Stock.QueryReserves(account)

    // 錯誤處理
    if err != nil {
        fmt.Printf("❌ Query Reserves Error: %v (Type: %T)\n", err, err)
        return
    }

    // 檢查是否成功
    if !reservesResult.IsSuccess {
        message := "No message"
        if reservesResult.Message != nil {
            message = *reservesResult.Message
        }
        fmt.Printf("Query reserves failed. Message: %s\n", message)
        return
    }

    // 輸出整戶預繳彙總
    if reservesResult.Data != nil {
        summary := *reservesResult.Data
        fmt.Printf("✅ Reserve summary\n")
        fmt.Printf("BranchNo: %s\n", summary.BranchNo)
        fmt.Printf("Account: %s\n", summary.Account)
        fmt.Printf("ReservedAmount: %d\n", summary.ReservedAmount)
        fmt.Printf("ReturnedAmount: %d\n", summary.ReturnedAmount)
        fmt.Printf("OrderedAmount: %d\n", summary.OrderedAmount)
    } else {
        fmt.Println("Query reserves success but no data returned.")
    }
}

回傳範例

// QueryReserves 回傳結構
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &ReserveCashSummary{
        BranchNo:       "20207",     // 分公司代號
        Account:        "9801163",   // 帳號
        Currency:       "TWD",       // 幣別
        ReservedAmount: 9960200,     // 預收金額
        ReturnedAmount: 0,           // 返還金額
        OrderedAmount:  0,           // 已委託金額
    },
}