设置用于过账的 ERP 系统
系统是某个环境中的一个 ERP 连接。过账凭证步骤、从文件过账以及其他所有过账方式(请参阅向 ERP 系统过账凭证)都会把每张凭证发送到某个系统,由该系统决定凭证如何构建、检查和发送。您能看到的每个 ERP 连接都会自动成为一个系统:五个 SAP 连接就是五个系统,云端和本地部署并存;同一个连接在沙盒和生产环境中则是两个系统,各自有独立的设置。
系统按环境设置一次即可。该环境中的每个项目共享“哪个实体过账到哪里”的网格以及各系统的设置。只有“上线”是按项目进行的。
打开过账登记簿,在左侧栏的设置下选择系统。页眉包含:
- 环境选择器:选择要列出其系统的环境。
- 项目选择器,初始为无项目。选择一个项目后,可查看每个系统在该项目中是否处于实时状态,并可上线。
- 操作,其中有在此项目中上线…(向项目架构师显示)、复制到其他环境…(向工作区管理员显示)、建议各实体过账到哪里…和更改历史。
页面显示两张卡片:系统 · 环境和哪个实体向何处过账。如果环境中没有 ERP 连接,页面会显示没有可过账的系统:在“连接”中添加到 ERP 系统的连接后,它就会出现在这里。
每个系统占一行:包括其名称、ERP 类型和一组标签。
| 标签 | 含义 |
|---|---|
| 云端 | 云端系统。 |
| 本地部署 · 代理在线 | 本地部署系统,其代理在最近五分钟内有过联系。 |
| 本地部署 · 代理自 时间 起离线 / 本地部署 · 代理未连接 | 代理不在线,或没有代理服务于此环境。 |
| 可过账 | 可以向该系统过账。 |
| 未检查 | 代理不在线的本地部署系统。 |
| 实时 / 模拟 | 仅在选择了项目时显示:该系统在该项目中是否真实过账。 |
| 已停用 | 该系统不再接受新的过账。取代“实时”或“模拟”显示。 |
一行还可以带有两个按钮:
- 重新连接:当本地部署系统的代理不在线时显示。它会打开连接,以便您重新登录。
- 上线 ›:在已选择项目时,向项目架构师显示,适用于未停用、可过账且仍处于“模拟”的系统。请参阅上线。
一行展开后的内容
Section titled “一行展开后的内容”使用行左侧的切换按钮展开一行。它会显示三项内容和一排链接。
待办事项是系统与过账之间仍需完成的事项清单,每项都注明由谁负责。已完成的事项会被勾选并标记为已完成。
| 事项 | 负责人 | 完成条件 |
|---|---|---|
| 服务账户及其权限 | IT | 目前始终已完成,无需设置。 |
| 已安装代理且代理在线(仅限本地部署) | IT | 代理在线。 |
| 有实体过账到此系统 | 工作区管理员 | 哪个实体向何处过账中有一行指定了此系统。 |
| 上线 | 项目架构师 | 系统在所选项目中处于实时状态。 |
可执行的操作是一行文字,例如“可处理日记账、客户发票 · 可冲销日记账 · 在调用中返回结果”。它列出系统可处理的凭证类型、可冲销的类型,以及其答复是在调用中返回结果还是稍后返回结果。每个系统的完整列表见下文的各系统能做什么。
其列表的副本显示系统的科目、公司和期间副本有多旧,并提供立即刷新和查看副本。请参阅系统列表的副本。
它们下方的链接是供 IT 使用、设置…、标记为已停用(或从“已停用”恢复)以及历史记录,其中历史记录会仅针对该系统打开更改历史。
每项设置都有初始值,大多数项目从不需要更改。
| 设置 | 位置 | 谁来更改 | 初始值 |
|---|---|---|---|
| 哪个实体向何处过账 | 每个环境一次,在系统中 | 工作区管理员 | 无行。没有行时,系统中列出的唯一未停用的系统处理所有实体。 |
| 已停用 | 系统所在行 | 工作区管理员 | 未停用 |
| 模拟或实时 | 按系统、按项目在上线中设置 | 项目的架构师 | 模拟 |
| 每次都需要的值 | 系统的设置 | 工作区管理员 | 无 |
| 代码匹配(包括实体匹配) | 系统的设置 | 工作区管理员 | 无 |
| 客户自有函数(SAP 本地部署) | 系统的设置 | 工作区管理员 | 无,或由已转换步骤带来的函数 |
| 暂挂规则 | 按系统,在暂挂规则中 | 登记簿管理员(erp.register.admin) |
没有暂挂内容 |
| 交由人工处理 | 步骤,位于更多 ▸ 下 | 步骤的构建者 | 没有暂挂内容 |
| 通知对象 | 步骤,位于更多 ▸ 下 | 步骤的构建者 | 启动运行的人 |
| 舍入科目和限额 | 步骤,位于更多 ▸ 下 | 步骤的构建者 | 不舍入 |
| 已过账凭证被更改时 | 步骤,位于更多 ▸ 下 | 步骤的构建者 | 询问(初始值)。该凭证将列入“需要关注”,并提供两个选项。 |
这四项步骤设置与步骤一起在向 ERP 系统过账凭证中说明;步骤自己的暂挂见下文。
在展开的行上选择设置…。对话框设置:系统仅工作区管理员可以编辑;其他人会看到只有工作区管理员可以更改这些设置。 保存会替换该系统的全部设置,每次更改都会记录在更改历史中。
每次都需要的值是添加到发送给该系统的每张凭证上的值,以值和设置为成对出现。系统按名称读取它所需要的值,凭证自带的同义列优先于系统的值:
| 系统 | 值 | 用途 |
|---|---|---|
| Sage Intacct | gl_journal_id |
当凭证没有 journal_type 时,日记账分录过账到的日记账。 |
| Sage 100 | bank_code |
当凭证没有 bank_code 时,付款所使用的银行账户。 |
代码匹配说明这里的某个代码在系统中对应另一个代码,包含维度、我方代码和系统中的代码。对于在系统中公司代码不同的实体,使用维度 entity;对于科目,使用 account。检查会通过匹配在系统的列表中查找代码,没有匹配时则按原样查找,实体匹配还能让网格为该实体建议此系统。
客户自有函数仅在 SAP 本地部署时出现。为每种单据类型指定函数。设置中只指定函数:每个函数的字段匹配(SAP 的哪个字段接收哪一列)原样保存在系统上,而由已转换的 SAP 过账步骤带来的函数会保留该步骤原有的字段匹配。请参阅 SAP 本地部署。
哪个实体向何处过账
Section titled “哪个实体向何处过账”第二张卡片是一个网格,规定哪个实体从哪个日期起过账到哪个系统,按环境设置一次,并由该环境中的每个项目共享。每行包含一个实体、→、一个系统和一个可选的起始日期(YYYY-MM-DD)。
- 选择添加一行,输入实体,并从选择系统中选择一个系统。仅提供未停用的系统。
- 起始日期(YYYY-MM-DD) 留空表示“从一开始”,或填写该实体开始过账到该系统的日期。若要在年中把实体转到另一个系统,请保留它的第一行,再添加第二行,写明新系统及其转入日期,例如
2026-07-01。 - 选择保存。格式不符的日期会被拒绝,并提示日期格式如 2026-07-01。
编辑网格需要工作区管理员;其他人只能只读查看。已保存的实体无法重命名:请用行末的叉号删除其行,再添加另一行。凭证中出现过但尚无任何行指定的实体会列出,且不选择系统;若一个都没有,卡片会显示暂无实体。它们是在您过账的表中找到的实体。添加一行即可指定一个。
凭证如何找到其系统
Section titled “凭证如何找到其系统”凭证通过其项目所在环境的系统过账。
- 其系统是实体中“起始日期”不晚于凭证过账日期(无过账日期时为今天)的最新一行。
- 当环境的网格完全没有行,且系统中只列出了一个未停用的系统时,该系统处理所有凭证。
- 若没有任何行在该日期覆盖凭证的实体,则该凭证不会过账,并提示其实体没有对应的系统。
- 若凭证所在行指定的系统已停用,则该凭证不会过账,并提示该系统已停用。
对于尚无任何行指定的实体,当环境中恰好有一个未停用的系统通过 entity 代码匹配或在其自己的公司列表副本中指明了该实体时,网格会建议该系统。该行显示建议,并保持只读,直到您选择接受;只有已接受的行才会被保存。
操作中的建议各实体过账到哪里… 是 Weave 基于 Data Foundation 给出的建议:选择项目后,它会为该项目的 Foundation 加载的每个实体填入加载它的连接。不会由模型计算任何内容,也不会保存任何内容:这些行只是被填好,并有消息说明填了多少行,您逐行阅读后选择保存。如果没有加载任何内容,则显示暂无建议。
此处无法更改的行
Section titled “此处无法更改的行”- 系统已停用的行以只读方式显示,并带有已停用。保存网格会保留它。
- 系统您看不到的行以只读方式显示,并带有不在此列表中。保存网格会将其删除,因此保存会先请您在保存路由中确认。
只有有人有意上线后,才会真实过账。上线按系统、按项目进行:在同一个项目中,有些系统可以处于实时状态,而其他系统仍处于“模拟”。新建、复制或试用的项目在每个系统上都从“模拟”开始,直到有人在其中上线。
- 在页眉的项目选择器中选择项目。
- 在系统所在行选择上线 ›,或在操作中选择在此项目中上线…,对所有可过账但尚未实时的系统上线。未选择项目时,会提示选择要上线的项目。
- 上线对话框会先检查将发生的更改(不会真正更改任何内容)并显示出来:
- 这些将变为实时:将真实过账的系统。
- 项目的过账模式将变为“正式”,因此每个正式系统都会真实过账。:当项目本身尚未处于实时模式时显示。
- 已实时:已经是实时状态的系统。
- 系统无法上线: 并给出原因:系统已停用、项目已锁定、您对该连接没有写入权限,或它不是您可以过账的系统。
- 选择上线。仅当至少有一个系统将变为实时时,它才可用。
上线会写入项目对这些系统在该环境中的授权,并在项目的过账模式尚未为实时时将其设置为实时。每个上线的系统都会记录在更改历史中。上线绝不会复制到其他环境或项目。
上线需要项目的架构师,项目不能被锁定,并且您自己对每个连接具有写入权限。通过 REST API(POST /erp/go-live)和 MCP 工具 erp_go_live 时适用同样的检查,后者还会拒绝委托的 AI 令牌:上线由人来完成,绝不由代表人的代理完成。除非将 dry_run 设为 false,否则两者都只报告将发生的更改。
在展开的行上选择标记为已停用,并用停用确认:系统将不再提供过账,直到被恢复。它在网格中的行会保留,路由到它的凭证不会过账。从“已停用”恢复则可撤销此操作。两者都需要工作区管理员,并记录在更改历史中。
供 IT 使用
Section titled “供 IT 使用”供 IT 使用会打开供 IT 使用:系统,其中列出产品在该系统中的操作,以便对其放行和审计:
- 登录身份:连接登录所用的账户。
- 批大小:系统设置所设置的批大小,或未设置。
- 代理和代理版本:适用于本地部署系统。
- 我们的称呼:产品按名称调用的每个函数或服务,以及上次使用的时间。对于 SAP 本地部署,这些是在设置中设置的函数。在尚未过账或测试之前,它显示暂无内容。向此系统过账或测试后将列出。
登录过期时,对话框会说明,并提供重新连接。
复制到其他环境
Section titled “复制到其他环境”沙盒只需设置一次,然后复制到生产,而不必重新输入。在操作中选择复制到其他环境…(仅限工作区管理员)。
- 在复制到下选择环境。
- 此环境的每个系统都会列出;当同一连接在另一个环境中也是系统时,该系统会被勾选;不是的则显示为系统(不在此环境中),无法勾选。
- 选择复制并确认。
对于每个已勾选的系统,复制会用这里的内容替换另一个环境中该系统的设置、代码匹配和 SAP 函数,并添加网格中指定该系统且另一个环境所没有的行(同一实体、同一起始日期)。已存在的行保持原样。结果会说明复制了多少行网格和多少个系统的设置。“上线”不会被复制:另一个环境中的每个项目都保持“模拟”,直到有人在那里上线。
系统列表的副本
Section titled “系统列表的副本”检查会把凭证与系统自己的科目、公司和期间进行比较。PlaidCloud 保存其中每一项的副本,直接从系统读取:
- 在实时系统上每次实时运行开始时,从系统读取,整个读取最多 60 秒。只有该次运行的读取才能阻止凭证。
- 在展开的行上选择立即刷新时。刷新会像过账一样联系您的 ERP 系统,因此需要工作区管理员,以及您自己对该连接的写入权限。它会报告读取了多少个科目、公司和期间,以及读取耗时。刷新后的副本仅供查看:它不会用于检查。
每个列表都在行上显示其时效,例如“科目读取于 3 小时前”“期间部分读取,读取于 2 天前”或“公司尚未读取”,或者说明无法读取及其原因。被中断或返回为空的副本不会替换之前的副本。
查看副本会打开列表的副本,每次显示一个列表(科目、公司或期间),包含代码、名称、已阻止、系统中的状态、从和至。最多显示前 5,000 行。税码、客户和供应商不会被复制,留给系统处理。
“模拟”运行不会从系统读取任何内容,因此在“模拟”中这些检查不会运行,由系统在您上线时决定。
对照列表的检查
Section titled “对照列表的检查”在实时系统上的实时运行开始时,每张凭证都会对照该次运行读取的列表进行检查。如果某个检查所需的列表无法读取、读取不完整或为空,或未能及时完成,则该检查视为未检查:既不算通过,也不会阻止,由系统决定。运行页面会显示每张凭证运行了哪些检查。
- Period open(期间未结)。 凭证的期间通过其期间代码查找,否则通过其过账日期所在的期间查找。只有当包含它的每个期间在系统中都已关闭过账时,才会被阻止:与其月份重叠的调整期间会使该日期保持开放。如果系统用 PlaidCloud 不认识的措辞报告期间状态,则该期间不会被检查。
- 实体是一家公司。 读取公司列表后,凭证的实体(通过其
entity代码匹配(若有),否则按原样)必须是系统中的公司之一。 - 科目存在。 读取科目列表后,每一行的科目(通过其
account代码匹配(若有),否则按原样)必须存在于系统中,且未被阻止过账。数字代码的匹配与前导零无关,因此6100能找到0000006100。
被阻止的凭证显示为“未过账”并附原因,例如“第 3 行:科目 6100 不在 系统 中”。各 ERP 系统提供哪些列表见下表。
在规则要求之前,不会暂挂任何内容。被规则暂挂的凭证会以“需要审批”状态等待,由人员在审批中批准;其他通过检查的凭证则无需审批直接发送。在左侧栏的设置下选择暂挂规则。
列表包含名称、适用于、暂挂条件、批准人和操作者。没有规则时显示没有暂挂内容。拥有 erp.register.view 的人都可以阅读规则;添加、编辑和删除需要登记簿管理员(erp.register.admin),其工具栏中会显示新建规则、编辑和删除。删除规则后,它不再暂挂新的内容;已在等待的凭证继续等待,直到有人做出决定。每次更改都会记录在更改历史中。
新建规则会打开新建暂挂规则:
- 为规则命名,例如“超过 250,000 的日记账”。
- 在适用于下选择系统。会提供您能看到的所有环境中的系统。
- 在暂挂条件下勾选会暂挂凭证的情形。所有已勾选的条件都必须满足才会暂挂;什么都不勾选,则不暂挂任何内容。
- 金额超过某个数值,以实体自身的货币计:凭证的大小是其借方加正的本币金额,或者当表中没有本币金额时,是其交易金额。
- 它是从文件过账的。
- 它是一笔冲销、贷项或更正:三者可任选其一或多个。
- 它被标记为异常:请参阅标记为异常。
- 始终暂挂,例如在结账期间:暂挂系统上的每张凭证;它会关闭其他条件。
- 在批准人下选择由谁批准:登记簿的批准人,或指定人员:勾选人员,并可选择填写他们负责批准的实体,用逗号分隔(留空表示所有实体)。
- 选择保存。当规则有名称、系统、至少一个条件、为数字的金额,并且(指定人员时)至少有一个人员后,它才可用。
被暂挂的凭证会使其所在批次的其他所有凭证一并暂挂,因此一个批次会作为一个整体被批准并过账。
批准人需要 erp.register.approve,并在凭证所在的连接上拥有自己的授权。当规则指定了人员时,只有这些人员可以批准,并且如果规则列出了实体,也只能批准这些实体。任何人都不能批准自己发送的凭证:既不能是启动运行的人,也不能是通过过账这些发送它的人。
凭证在“模拟”下发送时给出的批准,对实时发送无效:当同一张凭证之后以实时方式发送时,它会再次被暂挂,等待新的决定。
如果您的工作区要求过账职责分离,那么即使没有规则,其所涵盖的冲销、贷项或更正也会被暂挂,等待第二个人处理。
步骤自己的暂挂
Section titled “步骤自己的暂挂”过账凭证步骤可以暂挂得比其系统更多,位于更多 ▸ → 交由人工处理。其条件为金额高于、它是从文件过账的、属于冲销、贷项或更正、它被标记为异常和始终,组合方式相同;什么都不勾选,则不会再多暂挂任何内容。步骤的暂挂只是在系统规则之外增加条件,它无法放行系统规则所暂挂的内容,其凭证由登记簿的批准人批准。指定批准人须在系统规则上设置。
通过 REST API(PUT /erp/steps/{step_id}/holds)或 MCP 工具 erp_hold_upsert 更改步骤的暂挂,需要 analyze.step.write,以及在未锁定项目中的项目架构师或管理者角色。
与其实体之前过账的内容相比,满足以下情形时,凭证会被标记为异常:
- 其金额比同一引用的上一次过账大十倍以上或小十倍以上;
- 它使用了其实体在最近 500 张凭证中未使用过的科目、客户、供应商或交易伙伴;或
- 其过账日期不在其期间内。
每个标记都会记录说明原因的句子,例如“过账日期 2026-08-02 不在期间 2026-07 内。”该标记根据实体之前的凭证计算得出,不会调用任何 AI 模型。没有先前凭证的实体绝不会被标记。
各系统能做什么
Section titled “各系统能做什么”下面的每个系统都可以在“模拟”中运行,“模拟”会构建并检查每张凭证,但不发送任何内容。系统不接受的类型的凭证显示为“未过账”,不会被转换为其他类型。
| 系统 | 位置 | 可处理 | 可冲销 | 答复 | 检查所用的列表 |
|---|---|---|---|---|---|
| NetSuite | 云端 | 日记账、客户发票 | 日记账 | 在调用中 | 科目、子公司、过账期间 |
| Sage Intacct | 云端 | 日记账、客户发票 | 日记账 | 在调用中 | 科目、实体、报告期间 |
| QuickBooks | 云端 | 日记账、客户发票、供应商发票、贷项通知单 | 日记账、客户发票 | 在调用中 | 科目、公司、截至账簿结账日期已关闭的月份 |
| Xero | 云端 | 日记账、客户发票、供应商发票、贷项通知单 | 日记账、客户发票 | 在调用中 | 科目、组织、截至锁定日期已关闭的月份 |
| Acumatica | 云端 | 日记账、客户发票、供应商发票、付款、贷项通知单 | 日记账 | 稍后 | 科目、分支机构、财务期间 |
| Business Central | 云端 | 日记账 | 日记账 | 在调用中 | 公司、科目、会计期间 |
| Dynamics 365 F&O | 云端 | 日记账 | 日记账 | 稍后 | 主科目、法人实体、会计期间 |
| Oracle Fusion | 云端 | 日记账 | 日记账 | 稍后 | 分类账、科目组合、会计期间 |
| S/4HANA Cloud | 云端 | 日记账 | 日记账 | 稍后 | 公司代码、总账科目:无期间,因此不检查“Period open” |
| Workday | 云端 | 日记账 | 日记账 | 稍后 | 公司、分类账科目、会计期间 |
| SAP(本地部署) | 本地部署 | 日记账、客户发票、供应商发票,通过客户自有函数 | — | 稍后,来自代理的报告 | 不读取任何列表;由系统决定 |
| Sage 100 | 本地部署 | 日记账、付款 | — | 稍后,来自代理 | 不读取任何列表;实时运行中由代理检查期间和未结发票 |
在调用中返回的答复会在凭证发送时返回。稍后返回的答复在发送之后才到达,凭证在此之前处于“等待中”;答复始终未确定的凭证为“未确认”,您可以从过账登记簿中处理。
SAP 本地部署
Section titled “SAP 本地部署”SAP 本地部署通过代理过账,为每种单据类型调用客户自有的函数,函数在客户自有函数下设置。如果凭证的类型没有函数,或者函数的字段匹配中没有凭证引用对应的字段,则该凭证为“未过账”。转换现有的 SAP 过账步骤时,如果系统尚无该单据类型的函数,会把该步骤的函数和字段匹配带到系统中;请参阅向 ERP 系统过账凭证。
- 模拟会构建相同的请求,并在到达代理之前停止:不会有任何内容到达 SAP。
- 实时会把凭证交给服务于系统所在环境的代理。代理把 SAP 的答复写入项目默认文档账户中的报告(位于
/erp_posting/sap下),每张凭证保持“等待中”,直到读取该报告。没有默认文档账户的项目无法向 SAP 实时过账,其凭证为“未过账”并给出该原因。 - 当代理离线时,不会发送任何内容:凭证为“未过账”,并说明代理已离线,待代理恢复后可以重试。如果代理在大约 18 秒内没有接收凭证,它们会被未发送地收回,并以同样方式显示为“未过账”。
- SAP 的报告中尚未确定的凭证为“未确认”。请从过账登记簿中处理。
Sage 100
Section titled “Sage 100”Sage 100 是本地部署系统,没有网络 API:凭证通过代理到达它,代理运行 Sage 的 Business Object Interface。
- 每个连接对应一家公司。 连接指定 Sage 公司及其货币。其他公司的凭证,或有行使用其他货币的凭证,不会发送。
- 日记账作为总账日记账分录过账。日记账的引用在 Sage 中是其描述,因此最多 30 个字符。
- 付款作为应付手工支票过账,用于在 Sage 之外支付的款项:每笔付款对应一个供应商,引用作为支票号码(最多 7 个字符),一个
bank_code(来自凭证,或系统的每次都需要的值),且每一行都指明其所支付的发票并带有正金额。 - 在实时运行中,代理会先询问 Sage:日期落在 Sage 已关闭期间的日记账会被阻止,对 Sage 中未保持未结的发票的付款也会被阻止。
- 发送之后,只有 Sage 已过账的表中能看到某张凭证时,它才是“已过账”。已录入 Sage 批次但尚未更新的凭证保持“等待中”;后台扫描会再次询问代理,最多每小时一次,等待超过七天的凭证会变为“未确认”。
对系统的每次更改都会记录是谁在何时所做:系统设置、已停用、SAP 函数、代码匹配、哪个实体向何处过账、暂挂规则、上线和列表复制(对系统列表的每次读取)。在左侧栏的设置下或操作菜单中选择更改历史,或在系统所在行选择历史记录,仅查看该系统。列表包含时间、操作者、内容、系统、哪个、从和至。
您可以看到自己持有授权的系统的更改;上线仅限您能访问的项目,步骤的暂挂也仅限您能访问的项目。
谁可以做什么
Section titled “谁可以做什么”除非某行另有说明,下面的每条规则都由服务器检查,对应用、REST API 和 MCP 工具都相同。
| 要做的事 | 您需要 |
|---|---|
| 查看系统、系统的设置、网格及其列表的副本 | analyze.connection.read,且仅限您能看到的连接 |
| 更改设置、停用系统、保存网格、复制到其他环境 | 工作区管理员 |
| 刷新系统的列表 | 在“系统”页面上为工作区管理员,或通过 REST API 和 MCP 工具 erp_system_lists 拥有 analyze.connection.read;无论哪种方式,都需要您自己对该连接的写入权限 |
| 上线 | 未锁定项目的架构师,并且您自己对每个连接具有写入权限;必须是人,绝不能是委托的 AI 令牌 |
| 阅读暂挂规则 | erp.register.view |
| 添加、更改或删除系统的暂挂规则 | 登记簿管理员(erp.register.admin) |
| 更改步骤自己的暂挂 | analyze.step.write,以及在未锁定项目中的项目架构师或管理者角色 |
| 批准被暂挂的凭证 | erp.register.approve 以及您自己对凭证所在连接的授权;规则指定了人员时须在规则中列出;绝不能批准自己发送的凭证 |