Skip to main content

交割款查詢

QuerySettlement

輸入參數​

參數類別說明
accountAccount帳號
rangestring時間區間，目前有效值為 "0d" (當日)、"3d" (三日)

Result 回傳​

參數類別說明
IsSuccessbool是否成功
Data*SettlementData回傳交割款資訊
Message*string當 IsSuccess = false 回傳錯誤訊息

交割資訊 SettlementData 欄位​

參數類別說明
Account*AccountRes帳戶資訊
Details*[]Settlement交割明細列表

帳戶 AccountRes 欄位​

參數類別說明
Account*string帳號
BranchNo*string分公司代號

交割明細 Settlement 欄位​

參數類別說明
Date*string查詢日
SettlementDate*string交割日 (Optional)
BuyValue*int64買進金額 (Optional)
BuyFee*int64買進手續費 (Optional)
BuySettlement*int64買進應收付款 (Optional)
BuyTax*int64買進交易稅 (Optional)
SellValue*int64賣出金額 (Optional)
SellFee*int64賣出手續費 (Optional)
SellSettlement*int64賣出應收付款 (Optional)
SellTax*int64賣出交易稅 (Optional)
TotalBsValue*int64合計買賣金額 (Optional)
TotalFee*int64合計手續費 (Optional)
TotalTax*int64合計交易稅 (Optional)
TotalSettlementAmount*int64合計交割金額 (Optional)
Currency*string幣別 (Optional)

請求範例​

package main

import (
    "fmt"
    "fubon"
)

func main() {
    sdk := fubon.NewSDK()
    // ... 登入、連線等初始化步驟 ...
    
    // 查詢交割款 (查詢三日)
    settlement, err := sdk.Accounting.QuerySettlement(account, "3d")
    if err != nil {
        fmt.Printf("❌ Query Settlement Format/Parser Error: %v\n", err)
        return
    }
    
    if settlement.IsSuccess && settlement.Data != nil {
        fmt.Println("✅ Settlement Data:")
        fmt.Printf("Account: %s\n", *settlement.Data.Account.Account)
        
        if settlement.Data.Details != nil {
            for i, detail := range *settlement.Data.Details {
                fmt.Printf("\n=== Day %d (%s) ===\n", i+1, *detail.Date)
                
                if detail.SettlementDate != nil {
                    fmt.Printf("交割日: %s\n", *detail.SettlementDate)
                    fmt.Printf("買進: %d (手續費: %d, 稅: %d)\n", 
                        *detail.BuyValue, *detail.BuyFee, *detail.BuyTax)
                    fmt.Printf("賣出: %d (手續費: %d, 稅: %d)\n", 
                        *detail.SellValue, *detail.SellFee, *detail.SellTax)
                    fmt.Printf("合計交割款: %d\n", *detail.TotalSettlementAmount)
                } else {
                    fmt.Println("尚無交割資料")
                }
            }
        }
    }
}

回傳範例​

Result{
    IsSuccess: true,
    Message:   nil,
    Data: &SettlementData{
        Account: &AccountRes{
            Account:  "26",
            BranchNo: "6460",
        },
        Details: &[]Settlement{
            {
                Date:                  "2024/03/04",
                SettlementDate:        "2024/03/06",
                BuyValue:              735500,
                BuyFee:                313,
                BuySettlement:         -1429513,
                BuyTax:                0,
                SellValue:             770500,
                SellFee:               320,
                SellSettlement:        0,
                SellTax:               2309,
                TotalBsValue:          1506000,
                TotalFee:              633,
                TotalSettlementAmount: -1429513,
                TotalTax:              2309,
                Currency:              "TWD",
            },
            {
                Date:           "2024/03/06",
                SettlementDate: nil,  // 尚未產生交割資料
                // 其他欄位皆為 nil
            },
        },
    },
}