银行连接

本指南介绍如何与银行建立实时连接（PSD2 开放银行），包括如何连接、如何将银行账户关联至总账、如何通过导入模板让每次同步自动创建往来单位、核销发票并记账，以及同步返回的内容。API 详情请参见银行与支付导入。如果需要使用对账单文件而非实时连接，请参见导入银行对账单 (camt.053)。

1. 连接银行

在 Bank → Connections（银行 - 连接）中选择国家并点击 Show banks（显示银行）。选择您的银行和账户持有人类型（企业或个人），然后点击 Connect（连接）。系统会将您重定向至银行自身的授权页面，请在此登录并批准访问权限；随后银行会将您重定向回 Nordlet。该连接将显示在列表中，并带有授权到期日。银行对该授权设有时间限制（通常为 90 天或 180 天）；当授权到期时，需重新连接。

银行列表来源于为 Nordlet 实例配置的开放银行服务商。如果某个国家没有显示任何银行，说明该服务商尚未覆盖该地区。

2. 关联银行账户

在连接下方，银行提供的每个账户都会显示其 IBAN 和币种。为每个账户选择总账中的现有银行账户，或点击 Create a new bank account（创建新银行账户），可选择设置起始同步日期，然后点击 Link（关联）。只有关联的账户才会进行同步。如果没有设置起始同步日期，首次同步将获取最近 90 天的数据。

3. 创建导入模板

在 Bank → Import templates（银行 - 导入模板）中点击 New import template（新建导入模板），选择类型 Bank connection（银行连接），并为其命名。各行对应银行数据流中每笔交易所返回的属性。Required in file（文件中必填）复选框仅用于保持结构完整性，实时数据流不会对其进行校验。

Ledger account（总账科目）。 金额纯文本行 transaction_amount.amount 以及规则行可指定总账科目；由指定行生成的每笔已同步交易将立即过账，并标记为已与日记账分录核销。规则行通过银行交易代码或收支方向来筛选交易：

行	筛选对象	典型科目
Bank charges (code CHRG)（银行手续费 - 代码 CHRG）	代码族为 CHRG 的交易	银行手续费支出（标准科目表中的 6800）
Interest (code INTR)（利息 - 代码 INTR）	代码族为 INTR	利息收入或支出
Taxes (code TAXE)（税费 - 代码 TAXE）	代码族为 TAXE	税费支付
Other money out（其他支出）	任何其他借方交易	保持“Not posted”（未过账），以便将付款与采购发票进行核销
Other money in（其他收入）	任何其他贷方交易	保持“Not posted”（未过账），以便将收款与销售发票进行核销
transaction_amount.amount	未被任何规则筛选的其他交易	通常为“Not posted”（未过账）

交易将过账至其匹配的第一行所指定的科目：依次按代码族、收支方向，最后按金额纯文本行匹配。代码来自银行的 bank_transaction_code；未发送代码的银行将使代码行的匹配为空。

Create missing customers / suppliers（创建缺失的客户/供应商）。 在 debtor.name 行勾选 Create missing customers（创建缺失的客户），以便为所有未知的收款付款人创建客户；在 creditor.name 行勾选 Create missing suppliers（创建缺失的供应商），以便为所有未知的付款收款人创建供应商。系统通过 IBAN（debtor_account.iban / creditor_account.iban，存储在往来单位的银行账户中）识别往来单位，随后通过精确名称识别；通过名称找到的往来单位将补录 IBAN。如果新往来单位的名称包含法定形式（UAB、MB、SIA、GmbH、Ltd 等），则识别为公司，否则识别为个人。

Create partner for the bank（为银行创建往来单位）。 在“Bank charges”（银行手续费）规则行勾选此项。同步操作将以连接的银行名称创建一个供应商，并在日记账中记录该往来单位的每笔费用。

Link invoices by this field（通过此字段关联发票）。 在 remittance_information 或 reference_number 行勾选此项。每笔新交易（如果其附言或参考编号包含已开具的未结销售发票（收款）或已登记的采购发票（付款）的编号），都会与该发票进行核销并记账。当付款人为已知往来单位（通过保存的 IBAN、准确的往来单位名称或代码识别）时，发票必须属于该往来单位。来自未知付款人的付款，仅在金额等于剩余余额且发票编号包含其系列前缀时才会进行核销。金额大于剩余余额的付款绝不会被核销。未通过这些校验的交易将保持未核销状态，供您手动核销。Create advance invoices for unmatched incoming payments（为未核销的收款创建预收款发票）选项可将来自已知往来单位的未核销收款转化为按该金额、交易日期、指定税率或所选目录项目开具的预收销售发票；该功能需要勾选 Create missing customers（创建缺失的客户）以确保往来单位已知。

保存模板。

4. 应用模板并选择计划

返回 Bank → Connections（银行 - 连接），每个关联的账户都有一个模板下拉菜单和一个计划下拉菜单。选择模板，选择 Sync manually（手动同步）、Sync daily（每天同步）、Sync weekly（每周同步）或 Sync monthly（每月同步），然后点击 Apply（应用）。没有模板的关联账户仍然可以同步，但只会记录交易；不会进行过账、核销或创建任何记录。

通过每天、每周或每月的计划，API 会自行同步账户：每小时检查一次，寻找上次同步时间超过其周期（24 小时、7 天或 30 天）的账户，并完全按照 Sync now（立即同步）的方式对其进行同步，随后运行模板。计划同步会像手动同步一样计入使用量（每获取 10 笔交易记为一个请求）。如果银行拒绝同步（例如由于授权到期），连接将标记错误并被跳过，直到您重新连接。

5. 同步

点击连接上的 Sync now（立即同步）。Nordlet 会获取每个关联账户的新记账交易；待处理交易将被跳过，直到银行完成记账。系统会获取这些交易（自上次同步以来，并重叠一周以免漏掉延迟记账），并记录一次 —— 交易通过银行的分录参考编号识别 —— 然后运行账户模板。结果行将报告导入的交易数量以及已存在的交易数量；通过 API 同步还会返回已过账的变动数量、创建的往来单位数量、关联及创建的发票数量、已核销的付款数量，以及无法核销的付款警告信息。

可以通过 API（bank/feeds/sync）按计划触发同步；每获取 10 笔交易计为一个 API 请求。

6. 后续查看位置

• Bank → Transactions（银行 - 交易）- 所有已同步的交易，按账户分列标签页；已核销的交易会链接至发票或日记账分录。
• Invoices（发票）- 为未核销收款创建的预收款发票。
• Partners（往来单位）- 创建的客户和供应商，每个单位的银行账户下都包含 IBAN。
• Ledger → Journal（总账 - 日记账）- 费用（以银行为往来单位）、利息、税费和付款的分录。

当连接停止工作时

同步失败会使连接带上银行的错误信息。授权到期是最常见的原因：再次点击该银行的 Connect（连接）并批准访问权限；关联的账户及其模板将予以保留。Disconnect（断开连接）会删除连接及其账户关联，但不会删除已记录的交易。