连接到 Oracle Fusion

通过 OData 和 BI Publisher（BIP）报表端点将 PlaidCloud 连接到 Oracle Fusion Cloud ERP，无需手写 OData 即可拉取总账余额和日记账批次，并通过 Oracle 的基于文件的数据导入（FBDI）路径将日记账分录过账回去。本指南涵盖连接、导入步骤和过账步骤。

前提条件

在 Oracle Fusion Cloud 中，您需要：

一个供 PlaidCloud 使用的专用 API 用户，其角色可访问您将要读取的实体（总账查询）以及您将通过其过账的 FBDI/GL Interface 功能。
您的 Fusion Cloud 实例 URL（例如 https://yourorg.fa.us2.oraclecloud.com）。
OAuth2 客户端凭据（客户端 ID 和密钥），或 Fusion Cloud 安全设置为集成用户签发的基本身份验证 API 凭据——取决于您的租户是按哪种方式配置的。

创建连接

打开 Tools > Connections 并点击 New Connection。
从菜单中选择 Oracle Fusion。

填写字段：

字段	值
名称	一个易记的名称，例如 `Fusion Prod`。
实例 URL	您的 Fusion Cloud 实例 URL。
客户端 ID	API 用户的 OAuth2 客户端 ID（基本身份验证则为用户名）。
客户端密钥	API 用户的 OAuth2 客户端密钥（基本身份验证则为密码）。

点击 Create。

对连接进行冒烟测试

向工作流中添加一个 Import Fusion Entity 步骤。
将 Fusion 连接设置为您的连接，实体类型设置为 gl_balances，目标表设置为一个临时表。
运行该步骤（参见在工作流中运行单个步骤）。

目标表中有数据即可确认凭据和实例 URL 正确。出错时，消息会指明问题——凭据错误、实例 URL 错误，或角色缺少该实体的读取权限。

导入数据

两个导入步骤适用于不同的拉取规模：

对于常规的有界拉取，请添加 Import Fusion Entity 步骤——它会直接调用 Oracle Fusion 的 OData 或 BIP 端点。
对于大型提取，请改为添加 Import Fusion Bulk Extract 步骤——它会提交 FBDI/BIP 提取作业，并在作业完成后下载生成的文件。
将实体类型设置为 gl_balances 或 journal_batches。
添加筛选器以限定拉取范围——日期和会计期间范围（ge/le），以及余额/金额字段上的数值范围，且按实体仅限于 Oracle Fusion 实际可在服务器端筛选的字段。
运行该步骤并检查目标表。

实体和筛选器

实体类型	拉取内容	可筛选的字段
`gl_balances`	总账科目余额	会计期间范围、科目范围、余额金额范围
`journal_batches`	日记账批次表头和状态	日期范围、会计期间范围

过账日记账分录

Oracle Fusion：过账日记账分录步骤通过 PlaidCloud 共享的 ERP 写入管道，使用 Oracle 的 FBDI GL Interface 加载路径过账总账日记账分录。

构建一个表头表——每个日记账分录一行——包含 batch_id（您的批次标识符）、ledger_id、journal_source、journal_category、accounting_date 和 description。
构建一个行表——每个 batch_id 对应一行或多行——包含 account_combination（或其段列）、entered_debit、entered_credit 和 currency_code。
添加一个 Oracle Fusion：过账日记账分录步骤，设置 Fusion 连接、标题表、行表和结果表。
保持勾选仅验证并运行该步骤——PlaidCloud 会构建并检查每个批次，不占用账本声明，也不过账任何内容。
查看结果表（每个批次一行：batch_id、natural_key、confirmation_id、status、message）。修复所有 error 行并重新验证。
取消勾选仅验证并再次运行，以真正过账。除非希望运行在第一个失败的批次处直接停止，否则请保持勾选出错时继续。

过账的工作方式

PlaidCloud 将每个日记账批次作为 FBDI 文件写入 Oracle 的 GL_INTERFACE 暂存表，然后提交并异步轮询 Journal Import Launcher Enterprise Scheduler Service（ESS）作业，直到其报告终止状态。只有在该终止状态得到确认后，分录才会被报告为 posted——已进入接口表但其导入作业始终未能完成的批次，会保持隔离状态，而不会被记录为已过账，因此卡住的 ESS 作业绝不会悄悄地被当作成功。PlaidCloud 自身的账本声明可防止在重试或重新运行批次时重复加载同一批次。

更正已过账的分录

该步骤绝不会删除或重写已过账的日记账批次。要更正某个批次，请针对原批次过账一个借贷方互换的新批次——即已过账的冲销分录——而不是就地编辑原批次。这样可以保留 Oracle Fusion 自身的审计追踪，也与直接在应用程序中进行更正的方式一致。