> For the complete documentation index, see [llms.txt](https://support.cregis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.cregis.com/cregis-wallet-guide/zh-tw/api/manual/collection.md).

# 歸集

歸集用於將 WaaS 項目子地址中的資產，主動歸集到指定的歸集地址，便於統一管理資金餘額、提升資金利用效率以及減少分散資產管理成本。當前支援以下三種歸集方式：

* 手動歸集
  * 透過創建歸集規則後，手動發起歸集，系統會根據規則自動篩選符合條件的子地址，並將地址內符合條件的資產，全部歸集到指定接收地址。
* API歸集
  * 透過 API 發起歸集請求後，在 API 歸集頁面手動處理或開啟自動化處理，可指定歸集地址和金額，精確控制歸集行為；
* 自動歸集
  * 透過建立自動化規則後，系統自動發起歸集，無需人工手動操作，系統會根據規則自動篩選符合條件的子地址，並將地址內符合條件的資產，全部歸集到指定接收地址。

## 手動歸集

用戶可提前配置歸集規則，在需要時手動觸發歸集任務，系統會根據規則篩選符合條件的子地址進行歸集。\
功能入口：WaaS 項目 → 歸集 → 規則配置

### 創建歸集規則

點擊頁面「新增」按鈕進入創建頁面。

<figure><img src="/files/ZtJFHtb8QwP7xoWyaxRf" alt=""><figcaption></figcaption></figure>

配置歸集規則，包括規則名稱、歸集幣種、歸集金額、到帳地址，歸集金額支援以下四種模式：

* 不限：歸集所有地址資金，如果地址餘額小於等於最小發送金額，則不進行歸集；
* 大於等於：僅歸集餘額大於等於指定金額的地址；
* 小於等於：僅歸集餘額小於等於指定金額的地址；
* 金額區間：僅歸集餘額在指定金額範圍內的地址。

<figure><img src="/files/HWk0sih5dHLAJ1P7hGlZ" alt=""><figcaption></figcaption></figure>

配置完成後，點擊「確定」按鈕進行Google Authenticator驗證，驗證通過則規則創建成功。

### 發起歸集

規則創建完成後，可在規則列表中點擊「開始歸集」按鈕發起歸集。<br>

<figure><img src="/files/pEEfG06TNen21AHJiRQc" alt=""><figcaption></figcaption></figure>

進入歸集確認頁面，系統將根據當前規則自動篩選符合條件的子地址，並顯示預計可歸集金額/筆數，確認後點擊「確定」按鈕。

<figure><img src="/files/VFkkthkIvBcKF61eyTJi" alt=""><figcaption></figcaption></figure>

輸入交易密碼後，點擊「確定」按鈕開始歸集。

<figure><img src="/files/lw8HnVyEnY7lYdZrNB3f" alt=""><figcaption></figcaption></figure>

開始歸集後，可在「任務記錄」頁面查看歸集進度。

<figure><img src="/files/m2JwV0lyt5ZRs2uh3Vpk" alt=""><figcaption></figcaption></figure>

### API歸集

業務系統呼叫API歸集後，系統會產生待處理歸集任務，並在API歸集頁面顯示，在需要時可手動觸發或自動化任務觸發歸集。

功能入口：WaaS項目 → 歸集 → API歸集

### 發起API歸集請求

請前往 [開發者文件](https://developer-cn.cregis.com/api-reference/request-apis/address/address-balance-collect) 了解詳細API歸集請求呼叫方法。

### 手動處理API歸集

在 API 歸集頁面中，可批次選擇多個歸集請求同時進行處理（歸集、駁回），如果是進行批次歸集操作，請先篩選指定幣種再進行操作，因為不同幣種鏈上處理機制不同，所以系統不支援跨幣種批次歸集。

<figure><img src="/files/9r4ce5LZ4WgQvntLSvJv" alt=""><figcaption></figcaption></figure>

選擇好要處理的歸集請求後，點擊「歸集」按鈕進入歸集確認頁面，確認並選擇礦工費後，點擊「確定」按鈕。<br>

<figure><img src="/files/2941VMH6zJD6pvylNWOL" alt=""><figcaption></figcaption></figure>

輸入交易密碼後，點擊「確定」按鈕開始歸集。<br>

<figure><img src="/files/eCLFVxPyep8aLGLUm66m" alt=""><figcaption></figcaption></figure>

開始歸集後，可點擊API歸集頁面右下角的歸集進度按鈕，查看歸集進度

<figure><img src="/files/jRqsc86LuqYtVYzlT0bB" alt=""><figcaption></figcaption></figure>

### 自動處理API歸集

創建自動化任務後，系統將會根據規則自動處理符合條件的API歸集請求，詳情請查看下方自動歸集了解。

## 自動歸集

用戶可創建自動化任務，系統會根據規則自動觸發並篩選符合條件的子地址進行歸集，無需人工手動操作。了解自動化功能請前往 [自動歸集/簽名 ](/cregis-wallet-guide/zh-tw/risk_management/automation.md)。

## 歸集礦工費規則說明

為確保交易能夠順利上鏈，並兼顧不同區塊鏈網路的費用模型差異，Cregis 針對不同網路，採用差異化的 Gas（礦工費 / 資源）扣除機制。歸集過程中系統會自動檢測Gas（礦工費 / 資源）是否充足 ，並自動進行充值，具體規則如下：

* Tron 網路採用 資源模型（頻寬 / 能量），而非傳統意義上的 Gas 費，在 Tron 網路下發生交易時，Cregis 將按照以下順序自動消耗資源：
  * 進行Tron 網路主幣（TRX）歸集
    * 優先消耗地址資源（頻寬）：如果交易的發送方地址有足夠的資源，將優先消耗地址資源；
    * 頻寬不足時，將燃燒TRX抵扣資源（頻寬）：資源不足時，系統將燃燒地址中的 TRX，將 TRX 轉換為資源完成交易。
  * 進行Tron 網路代幣（如USDT）歸集
    * 優先消耗地址資源（頻寬、能量）：如果交易的發送方地址有足夠的資源，將優先消耗地址資源；
    * 資源不足時，由 Cregis 進行資源代付：Cregis 自動補充所需資源，確保交易可正常完成，代付的資源將從團隊帳戶餘額進行扣費；
    * 如以上方式仍無法滿足交易需求：系統將燃燒地址中的 TRX，將 TRX 轉換為資源完成交易。
* 其他網路幣種歸集
  * 優先使用地址礦工費：如果交易的發送方地址有足夠的礦工費，可直接進行歸集交易；
  * 如果地址礦工費不足：系統將自動從歸集接收地址給被歸集地址充值礦工費。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://support.cregis.com/cregis-wallet-guide/zh-tw/api/manual/collection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
