匯撥紀錄查詢

QueryTransfers

版本資訊

v2.2.9 起新增功能

輸入參數

參數	類別	說明
account	Account	帳號
startDate	*string	查詢起日（YYYYMMDD），帶入 nil 時依伺服器預設區間
endDate	*string	查詢止日（YYYYMMDD）
stockNo	*string	股票代號，帶入 nil 時查詢全部

Result 回傳

參數	類別	說明
IsSuccess	bool	是否成功
Data	*[]TransferRecord	回傳匯撥紀錄列表，查無資料時為空列表
Message	*string	當 IsSuccess = false 回傳錯誤訊息

匯撥紀錄 TransferRecord 欄位

Return type : Object

參數	類別	說明
SeqNo	string	委託單流水序號
Date	string	申請日期
Time	string	申請時間
StockNo	string	股票代號
Market	Market	市場別 : MarketTaiex 上市 、 MarketTaisdaq 上櫃 、 MarketTaiemg 興櫃
Quantity	int64	匯撥股數（股）
TargetBranchNo	string	撥入方分公司代號
TargetAccount	string	撥入方帳號
Status	int32	狀態碼 : 10 成功 、 90 失敗

請求範例

package main

import (
    "fmt"
    "fubon"
)

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

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

    // 匯撥紀錄查詢（指定日期區間，不篩股票代號）
    startDate := "20260701"
    endDate := "20260722"

    transfersResult, err := sdk.Stock.QueryTransfers(account, &startDate, &endDate, nil)

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

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

    // 輸出匯撥紀錄列表
    if transfersResult.Data != nil && len(*transfersResult.Data) > 0 {
        fmt.Printf("✅ Found %d transfer records\n", len(*transfersResult.Data))

        for i, record := range *transfersResult.Data {
            fmt.Printf("\n--- Record %d ---\n", i+1)
            fmt.Printf("SeqNo: %s\n", record.SeqNo)
            fmt.Printf("Date: %s\n", record.Date)
            fmt.Printf("StockNo: %s\n", record.StockNo)
            fmt.Printf("Quantity: %d\n", record.Quantity)
            fmt.Printf("Status: %d\n", record.Status)
        }
    } else {
        fmt.Println("Query transfers success but no data returned.")
    }
}

回傳範例

// QueryTransfers 回傳結構
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &[]TransferRecord{
        {
            SeqNo:          "418181",         // 委託單流水序號
            Date:           "2026/07/28",     // 申請日期
            Time:           "10:53:48.340",   // 申請時間
            StockNo:        "006205",           // 股票代號
            Market:         MarketTaiex,      // 市場別
            Quantity:       1000,             // 匯撥股數
            TargetBranchNo: "960C",           // 撥入方分公司代號
            TargetAccount:  "7654321",        // 撥入方帳號
            Status:         10,               // 狀態碼
        },
        // ... 更多紀錄
    },
}