用户指南银行同步

银行同步

连接 US 和 EU 银行账户,自动同步交易,并将付款与发票进行核对。

银行同步将您的银行交易记录到 NomadBill 中,以便您可以根据发票跟踪收款和付款。

连接账户后,NomadBill 会同步最多 365 天的交易历史记录,并通过增量同步保持连接更新。然后,同步的交易可以自动或手动与销项发票和进项发票进行匹配。

选择与您要连接的机构相匹配的银行区域。 银行同步页面有 US 和 EU 库的单独连接按钮,您必须从正确的按钮开始。

  • US 支持 US 和 CA 中的银行
  • EU 支持 GB、FR、ES、NL、IE 和 DE 中的银行

如果您的银行在某个地区无法使用,请仅在该机构实际在该地区运营的情况下尝试另一家银行。

连接银行账户

从银行同步页面连接每个银行账户。 NomadBill 使用 Plaid 作为连接提供商并将连接存储在您的公司下。

打开银行同步页面

登录 NomadBill 并从应用程序的经过身份验证的区域打开 银行同步。

您应该在页面上看到两个连接选项:一种用于 US 银行,另一种用于 EU 银行。

选择正确的地区

选择您的银行账户所在地区的按钮。

  • 对 US 或 CA 中的银行使用 US 选项
  • 对 GB、FR、ES、NL、IE 或 DE 中的银行使用 EU 选项

选择区域后,Plaid 将打开安全的银行连接流程。

与您的银行进行身份验证

选择您的机构并使用您的银行凭据登录(如果需要),完成 Plaid 流程。

Plaid 将连接详细信息返回给 NomadBill,包括链接的账户和机构名称。

等待初始同步

连接创建后,NomadBill 开始第一次交易同步。

成功的连接会存储提供商、区域、机构、链接账户、同步状态和上次成功同步时间等详细信息。同步完成后,您的交易将显示在连接的银行账户下。

交易同步

NomadBill 使用基于游标的增量同步来保持交易列表最新。第一次同步请求最多 365 天的历史记录,以后的同步从上次保存的游标继续,而不是再次提取完整的历史记录。

同步的内容

每个银行连接都存储自己的同步状态,包括 Plaid 项目、链接账户和同步游标。保存交易的详细信息,例如金额、货币、方向、入账日期、交易对手信息、商户详细信息、类别、待处理状态和原始交易负载。

增量同步的工作原理

NomadBill通过Plaid的增量交易同步流程来同步交易。每次同步都会读取结果页,直到 Plaid 没有更多更改要返回或同步达到安全限制。

  • 同步是基于游标,因此每次运行都从上次成功的同步点继续
  • 单次同步最多可处理 20 页
  • 每页最多可包含 500 笔交易
  • 每次同步运行的有效限制是 10,000 笔交易

NomadBill 仅在完全同步成功完成后保存更新的同步游标。如果同步中途失败,NomadBill 会保留上一个游标,以便下次运行可以安全地重试。

交易是如何编写的

同步交易一次批量插入或更新 200 记录。这使得大型同步易于管理,同时仍然有效地处理高交易量。

每笔交易都与:

  • 你的公司
  • 它来自的银行连接
  • 原始外部交易ID
  • 连接机构内的源账户

金额和方向如何运作

Plaid 和 NomadBill 使用相反的现金流量约定。 Plaid 将正数视为离开账户的资金,而 NomadBill 将正数存储为收到的资金。

Plaid 标志Plaid 的含义NomadBill 中存储的金额方向
积极资金离开账户负面out
负面资金进入账户积极in

这种符号翻转使 NomadBill 内部的对帐更加直观。收到的客户付款显示为正金额,而付款(例如供应商账单)显示为负金额。

自动匹配

NomadBill 自动尝试根据发票协调同步交易。钱进来和钱出去的匹配逻辑是不同的。

匹配的工作原理

将收到的款项与您发送的和逾期的发票进行比较。将支出的资金与您进项发票进行比较。在这两种情况下,NomadBill 都会查找精确的金额和货币匹配,然后检查交易日期是否在发票日期窗口的 14 天内。

如果找到匹配项,NomadBill 会将链接写入交易并自动更新发票付款状态。

匹配置信度和结果

比赛流程交易类型比赛规则信心结果
autoMatchInvoices收款14天内准确金额+货币+日期9090将 matched_invoice_id、match_method 设置为 amount+date,将发票 payment_status 设置为 paid,并将发票 status 设置为 paid
autoMatchIncomingInvoices付款14天内准确金额+货币+日期8585将 matched_incoming_invoice_id、match_method 设置为 amount+date,并将进项发票 payment_status 设置为 paid

自动匹配什么

当满足所有这些条件时,交易可以自动匹配:

  • 金额完全匹配
  • 货币完全匹配
  • 日期在 14 天的匹配窗口内
  • 发票处于仍可核对的状态

对于销项发票,NomadBill 针对已发送或逾期的发票。对于进项发票,NomadBill 将发票标记为已付款,而不将其更改为其他文档状态。

手动匹配

自动匹配首先处理明显的情况。当交易需要审核时,您可以手动匹配。

候选人建议

NomadBill 生成手动审核候选者,其搜索窗口比自动匹配器更宽。

  • 它在 30 天 日期窗口内进行搜索
  • 每笔交易最多返回 5 个候选人
  • 它是为审查而设计的,而不是自动分配的

当付款日期与发票日期的差异超出预期或当您想要确认几个可能的匹配项之一时,这会很有帮助。

手动链接行为

当您手动链接交易时,NomadBill 将其记录为已确认的匹配。

  • match_confidence 设置为 100
  • match_method 设置为 manual

手动链接会覆盖对该交易的进一步建议逻辑的需要,并清楚地表明匹配是用户确认的。

取消链接和管理连接

当交易连接到错误的发票时,请使用取消链接。当您想要完全删除银行源时,请删除连接。

取消关联匹配的交易

取消链接会删除交易与其匹配的发票记录之间的关系。

当您取消链接交易时,NomadBill:

  • 清除交易中所有与比赛相关的字段
  • 将链接的销项发票 payment_status 设置回 unpaid
  • 如果已设置为 paid,则保留销项发票 status 不变
  • 将链接的进项发票 payment_status 设置回 unpaid

如果您已依赖已付款状态进行簿记审核,请谨慎使用取消链接,因为取消链接不会将销项发票状态从 paid 移回到 sent。

删除银行连接

删除连接会删除 Plaid 链接以及属于它的所有同步交易。

当您删除连接时,NomadBill:

  • 尝试撤销 Plaid 对该项目的访问权限
  • 即使 Plaid 撤销步骤失败也会继续
  • 删除银行连接记录
  • 级联删除该连接下的所有交易

如果您稍后重新连接同一组,NomadBill 会创建新的连接和同步状态。