> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 會計

> 連接 Xero、QuickBooks Online 或 Rillet，讓客戶、供應商、品項、發票、帳單與自動化的總帳日記帳流向你的外部帳本，並每日更新匯率。

如果你的帳簿記在 **Xero**、**QuickBooks Online** 或 **Rillet**，會計整合會把 Alforse 過帳的內容複製到該帳本，並把付款帶回來。財務人員只需設定一次，之後回來檢查同步狀況並核對餘額。你需要 Business 方案（或合作夥伴方案）。

Paid

## 資料流向

### 從 Alforse 到你的帳本

開啟**同步**後，以下記錄會送往提供者：

* 客戶與供應商；
* 品項；
* 銷售發票與帳單；
* 自動化的總帳日記帳——每筆自動過帳都會鏡像，但來源為 `Manual` 的日記帳仍留在 Alforse。

NOTE

**日記帳會自動跟上**

不需要額外觸發：只要**同步**開啟，每筆自動總帳過帳都會送到提供者。只有來源為 `Manual` 的日記帳會被略過。

資料歸 Alforse 所有。如果兩個系統不一致，以 Alforse 的版本為準。每筆記錄都與帳本中的對應記錄保有固定連結，因此再次傳送只會更新該對應記錄，而不會另建一筆。

### 從你的帳本回到 Alforse

在提供者中記錄的付款會被帶回來。每一筆都會成為 Alforse 的付款，並對其所支付的發票或帳單建立發票核銷，然後過帳到 Alforse 的總帳。

| 提供者 | 將付款帶入 Alforse | 接受在 Alforse 中建立的付款 |
| - | - | - |
| Xero | 是 | 否 |
| QuickBooks Online | 是 | 否 |
| Rillet | 是 | 是 |

## 設定連線

Xero 與 QuickBooks Online 透過 **OAuth** 連線；Rillet 使用每家公司專屬的 **API 金鑰**連線。

### 連接到提供者

為 Xero 或 QuickBooks Online 完成 OAuth 登入。對於 Rillet，請輸入 [Rillet 連線欄位](#rillet-connection-fields)中所述的值。

### 在同步關閉時設定

全新的連線**同步**為關閉，因此你作業時不會送出任何東西。完成科目對應、維度與過帳選項（見[同步設定](#sync-settings)）。帳本中是否已有你的客戶與供應商？現在就執行**匯入客戶與供應商**——它在同步關閉時也能運作，並會連結既有記錄，因此第一次同步是更新它們，而不是重複建立。

### 開啟同步

使用整合頂端的**同步**開關。在**科目對應**上每個標示為**必填**的科目都完成對應之前，無法開啟。之後關閉它會暫停同步；如果你重新連到同一個組織，開關會維持先前的位置。

### 送出既有記錄

帳本中尚無對應記錄的記錄，可以用**推送客戶、供應商與品項**送出（Xero 與 Rillet）。從那時起，變更會持續流動。

### Rillet 連線欄位

| 欄位 | 必填 | 說明 |
| - | - | - |
| **API 金鑰** | 是 | 驗證連線；以密鑰儲存。 |
| **環境（Environment）** | — | **正式（Production）**（`api.rillet.com`）或**沙盒（Sandbox）**（`sandbox.api.rillet.com`）。 |
| **子公司 ID（Subsidiary ID）** | 否 | 在多實體的 Rillet 帳本中，Alforse 過帳到的子公司（實體）。 |
| **Webhook 權杖（Webhook token）** | 否 | 密鑰。設定之前，Rillet 的付款不會寫回 Alforse。 |

## 同步設定

除了包含連線本身的**設定**之外，每個會計整合還有四個分頁。

### 科目對應

把每個 Alforse 過帳科目與提供者會計科目表中的科目代碼配對；已過帳的日記帳會送到配對的科目。**以 AI 建議**與**依代碼比對**會填好大部分對應，其餘尚未對應的由你完成。

### 維度

把 Alforse 維度指派給提供者的追蹤欄位——Xero 與 QuickBooks 各提供兩個。Rillet 的做法不同：每個維度都隨每一行傳送，Rillet 會自行建立相符的欄位，因此其欄位編輯器不適用。

### 過帳

| 選項 | 決定什麼 |
| - | - |
| **來源類型** | 哪些已過帳的日記帳類型一律同步。為某個類型開啟**每日摘要**，則該類型每天只送一筆提供者分錄，而不是每張日記帳一筆。 |
| **應收／應付呈現方式** | 應收與應付分別設定：**文件**送出發票或帳單本身；**Off — handled outside the sync** 則不納入。 |
| **帳簿鎖定日期（Books lock date）** | 你選定的日期。Alforse 不會送出日期早於它的新分錄，因此帳本中已關閉的期間維持關閉。 |

### 同步活動

請見[監控同步](#monitoring-the-sync)。

## 監控同步

### 同步活動分頁

每個操作一列，顯示**狀態**、**實體**、**方向**、**觸發條件**、**嘗試次數**、**上次嘗試**與**錯誤**。可用的動作：

| 動作 | 用途 |
| - | - |
| 狀態篩選 | 縮小清單。 |
| **重試** ／ **略過** | 再試一次失敗的操作，或略過它。 |
| **重新傳送** | 再次送出已完成的操作。 |
| **全部重試** | 一次重試所有失敗。 |
| **匯出 CSV** | 下載所有符合狀態篩選的操作，含文件編號、提供者 ID 與完整錯誤。 |

當一次外送執行結束但仍有未解決的失敗時，你會收到應用程式內通知。

### 同步核對報表

每週一次的核對會填入**會計 → 報表 → 同步核對**。每一列是一個會計期間、科目與整合的組合，並排顯示三個餘額——**Alforse 已過帳**、**已同步**與**供應商**（此處指帳務提供者，Provider）——任何差異則顯示為**內部**與**外部差額**。

TIP

**操作與餘額**

同步活動回答的是「這筆記錄發生了什麼事？」。核對回答的是「這個科目與期間的兩邊帳本是否一致？」。你可以從同步活動跳到該整合的核對摘要。

## 疑難排解

| 你看到 | 因為 | 處理方式 |
| - | - | - |
| **同步**無法開啟 | **科目對應**上有一個**必填**科目沒有對應 | 完成對應，然後開啟**同步** |
| 客戶或供應商在帳本中重複 | 同步之前沒有先連結帳本中的既有記錄 | 在第一次同步前執行**匯入客戶與供應商** |
| Rillet 的付款一直沒有到達 Alforse | 連線上沒有 **Webhook 權杖** | 輸入權杖 |
| 帳本中缺少某張日記帳 | 它的來源是 `Manual`，或日期早於**帳簿鎖定日期** | 檢查來源與鎖定日期；在**同步活動**上找到該操作 |

## 匯率

獨立的匯率整合沒有任何設定：開啟後，貨幣匯率每天在 UTC 午夜更新。

NOTE

匯率取自 **exchangeratesapi.io**，並以各公司的基準幣別表示。

## 相關內容

**發票**

同步送往你帳本的銷售與採購發票。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/invoices.md)

**會計參考**

整合所鏡像的 Alforse 過帳。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/accounting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.