錯誤碼與狀態碼對照表
本頁面彙整了富邦新一代 API（期貨交易）中常見的狀態碼、功能代碼與事件代碼，方便開發者在遇到問題或進行狀態判斷時快速檢索。
委託單狀態 (Status)
委託單的當前狀態，可透過 GetOrderResult 查詢或由主動回報取得。各語言 SDK 的實際查詢方法名稱分別為 Python get_order_results、Node.js getOrderResults 及 C# GetOrderResult。
| 狀態名稱 | 狀態碼 (Value) | 說明 |
|---|---|---|
| 預約單 | 0 | 預約單 |
| 中台收到委託 | 4 | 中間狀態；請用 GetOrderResult 查詢最新狀態 |
| 交易所回報處理中 | 8 | 交易所回報的中間狀態，常見於非漲跌停價委託；get_result 與 get_result_detail 不會顯示此狀態 |
| 後台連線逾時 | 9 | 請稍後再使用 GetOrderResult 查詢狀態，或聯絡您的營業員 |
| 委託或變更成功 | 10 | 新單成功；改價或改量成功也會直接回傳 10，須檢視回傳的委託欄位以判斷變更項目 |
| 刪單成功 | 30 | 刪單成功 |
| 部分成交，剩餘取消 | 40 | 部分成交後，剩餘未成交口數已取消 |
| 完全成交 | 50 | 完全成交 |
| 改價失敗 | 19 | 改價失敗 |
| 改量失敗 | 29 | 改量失敗 |
| 刪單失敗 | 39 | 刪單失敗 |
| 失敗 | 90 | 失敗 |
期貨與證券狀態碼的差異
- 期貨沒有證券使用的改價、改量成功狀態碼
15、20，也沒有 ACK 狀態碼14、24、34。 - 期貨改價或改量成功時，回報的
status會直接是10。請檢視該筆10回報中的價格與數量欄位，以區分改價或改量。 8是交易所回報的中間狀態，常見於非漲跌停價委託，而且不會出現在get_result或get_result_detail的查詢結果中。
功能類別 (Function Type)
表示該筆回報或查詢結果所屬的操作類型。此處的 15、20 是功能類別，不是期貨委託的改價、改量成功狀態碼。
| 功能名稱 | 代碼 (Value) | 說明 |
|---|---|---|
| 新單 | 0 | 新單 |
| 新單執行 | 10 | 新單執行 |
| 改價 | 15 | 改價 |
| 改量 | 20 | 改量 |
| 刪單 | 30 | 刪單 |
| 失敗 | 90 | 失敗 |
事件代碼 (Event Code)
透過 on_event 訂閱事件通知時，系統會回傳以下代碼。
| 回傳代碼 | 意義 |
|---|---|
100 | 連線建立成功 |
200 | 登入成功 |
201 | 登入警示 (例如：90 天未更換密碼) |
300 | 斷線 |
301 | 未收到連線 pong 回傳 |
302 | 用戶執行登出，並斷線 |
303 | 登入失敗，並斷線 |
304 | API Key 異動 (Revoked)，已強制登出 (2.2.7 版本新增) |
400 | 委託單自訂欄位 user_def 超過 10 個字元，已自動截取後送單 |
401 | 委託單自訂欄位 user_def 含英數字以外的字元，已清空該欄位後送單 |
500 | 錯誤 |