> ## 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 套餐（或 Partner）。

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)）。账簿中是否已经有你的客户和供应商？请现在运行 **导入客户和供应商**（Import customers & vendors）——它在同步关闭时也能工作，并会关联现有记录，这样首次同步是更新它们而不是重复创建。

### 打开同步

使用集成顶部的 **同步** 开关。在 **账户映射** 中所有标记为 **必需** 的账户都映射完成之前，无法打开。之后将其关闭会暂停同步；如果你重新连接到同一个组织，该开关会保持之前的位置。

### 发送现有记录

账簿中尚无对应记录的记录，可以通过 **推送客户、供应商和物料**（Push customers, vendors & items）发送（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 会自行建立对应字段，因此它的槽位编辑器不适用。

### 过账

| 选项 | 决定什么 |
| - | - |
| **源类型** | 哪些已过账凭证类型始终同步。为某个类型打开 **每日汇总**，则该类型每天向提供商发送一条分录，而不是每张凭证一条。 |
| **AR / AP 表示方式** | 分别用于应收和应付：**文档**（Documents）发送发票或账单本身；**关闭——在同步之外处理**（Off — handled outside the sync）则不包含它们。 |
| **账册锁定日期** | 你选择的日期。Alforse 不会发送日期早于它的新分录，因此账簿中已关闭的期间保持关闭。 |

### 同步活动

参见[监控同步](#monitoring-the-sync)。

## 监控同步

### 同步活动标签页

每个操作一行，显示 **状态**、**实体**、**方向**、**触发器**、**尝试次数**、**上次尝试** 和 **错误**。可用操作：

| 操作 | 用途 |
| - | - |
| 状态筛选 | 缩小列表范围。 |
| **重试** / **跳过** | 重试失败的操作，或跳过它。 |
| **重新发送** | 再次发送已完成的操作。 |
| **全部重试** | 一次重试所有失败项。 |
| **导出 CSV** | 下载符合状态筛选条件的所有操作，包含单据编号、提供商 ID 和完整错误信息。 |

当出站运行结束时仍有未处理的失败项，你会收到应用内通知。

### 同步对账报告

每周的对账会填充 **会计 → 报告 → 同步对账**。每一行是会计期间、账户和集成的一种组合，并排列出三个余额——**Alforse已过账**、**已同步** 和 **提供商**——任何差额显示为 **内部** 和 **外部差异**。

TIP

**操作与余额**

同步活动回答“这条记录发生了什么？”。对账回答“这个账户在这个期间的账簿是否一致？”。你可以从同步活动跳转到该集成的对账汇总。

## 故障排查

| 你看到 | 原因 | 处理办法 |
| - | - | - |
| **同步** 无法打开 | **账户映射** 中有一个 **必需** 账户没有映射 | 完成映射，然后打开 **同步** |
| 账簿中的客户或供应商重复 | 同步前未关联账簿中已有的记录 | 在首次同步之前运行 **导入客户和供应商** |
| Rillet 付款始终没有到达 Alforse | 连接上没有 **Webhook 令牌** | 输入该令牌 |
| 账簿中缺少某张凭证 | 它的来源是 `Manual`，或日期早于 **账册锁定日期** | 检查来源和锁定日期；在 **同步活动** 上查找该操作 |

## 汇率

独立的汇率集成没有任何设置：打开后，货币汇率每天 UTC 午夜刷新。

NOTE

汇率取自 **exchangeratesapi.io**，并以各公司的本位币表示。

## 相关内容

**发票**

同步发送到你账簿的销售发票和采购发票。

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

**会计参考**

集成所镜像的 Alforse 过账。

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


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