用户手册
帮助中心/用户手册/接 Oracle Fusion ERP:拉订单与发票进来

接 Oracle Fusion ERP:拉订单与发票进来

最后更新 2026-11-01

把 Oracle Fusion 实例 URL 填进 Integration,再用 Fusion REST 用户名加密码、或预先取好的 OAuth bearer token 二选一登录,测试、配 Mapping、激活——销售订单与发票拉进来。

Oracle Fusion ERP 连接器把您 Oracle Fusion Cloud ERP 里的销售订单与发票拉进本系统。这就是本连接的全部范围:不拉客户,不查也不拉库存,也不把任何东西推回 Oracle Fusion。登录二选一——Fusion REST 用户名加密码,或您预先取好粘贴进来的 OAuth bearer token——填了 token 时优先用 token。一个 Oracle Fusion 实例对应一个连接。

Oracle Fusion 接入步骤:先在两套登录方式里选一套,再填入,再做真实凭证测试,再配 Mapping,最后激活。

前置条件#

  • 一个能登录的 Oracle Fusion Cloud 实例及其实例 URL,例如 https://fa-xxx.oraclecloud.com。
  • 一套完整的登录凭证,提前选好:要么是一个带集成角色的 Fusion 用户加上它的密码——要么是一个预先在您的 OCI / IDCS 身份域里取好的 OAuth2 access token。半套凭证连不上。
  • 如果您打算用 token:要有一条能在粘贴的 token 失效时、到您的 OCI / IDCS 身份域里重新取一个新 token 的路径,因为本连接只按粘贴的原样使用 token,不会替您去取新的。

拿凭证#

  1. 记下您的实例 URL,例如 https://fa-xxx.oraclecloud.com。无论您选哪套登录方式,这是每个连接都需要的值。
  2. 方式 A——Basic 登录:备好一个带集成角色的 Fusion 用户,例如 REST_USER,并备好它的密码。用户名和密码必须一起填;只填一个不算一套。
  3. 方式 B——Token 登录:到您的 OCI / IDCS 身份域里,预先取好一个 OAuth2 access token 并复制。在这里粘贴的是取好的 token——本连接里没有登录跳转,也没有换 token 的步骤。
  4. 选其中一种作为您实际使用的一套。之后如果在一个原本用用户名加密码的连接里填入 token,从那时起就改用 token。
API 版本字段有内置默认值 11.13.18.05。除非您的环境跑的是别的版本,否则留空即可——连上不需要您去查版本号。

填进 Integration#

  1. 打开 Integration → 连接器市场 → Oracle Fusion ERP → 新建连接。
  2. base_url——必填,实例 URL:填您的 Oracle Fusion 实例地址,例如 https://fa-xxx.oraclecloud.com。
  3. api_version——可选,API 版本:留空即用内置默认值 11.13.18.05。只有您的环境跑的是别的版本时才填。
  4. username——Basic 登录用,用户名(Basic 认证):填带集成角色的 Fusion REST 用户,例如 REST_USER。要与 password 一起填;或两个都留空、改用 token。
  5. password——Basic 登录用,密码(Basic 认证):填同一个 Fusion 用户的密码。这是密码类型字段,作为秘密保存。
  6. token——可选的另一套,OAuth bearer token:粘贴您预先在 OCI / IDCS 身份域里取好的 OAuth2 access token。这是密码类型字段,作为秘密保存。填了 token 时,它优先于 username 与 password 使用。

测试连接#

点测试连接。测试先检查填写情况:base_url 缺失,或两套登录方式都不成套——没有用户名加密码、也没有 token——会以缺值信息停下,什么都不发送。然后它用您选的那套做一次真实的轻量只读请求——填了 token 就用 token 走 Bearer 登录,否则用用户名加密码走 Basic 登录——向 invoices 资源要一条记录。返回 200 才算测通。返回 401 或 403 表示实际用的那套登录被拒:查那一套,不要查另一套。实例约 12 秒不应答,测试会超时停下。

配 Mapping / 选模板#

选 Oracle Fusion 标准 Mapping。它覆盖本连接拉的两类数据:销售订单来自 salesOrdersForOrderHub 资源,发票来自 invoices 资源。测试通过后先拉一次,把一个真实订单和一张真实发票对照核对——编号、客户引用、明细行与金额——确认后再激活。本连接没有客户或库存的 Mapping,因为本连接不拉客户、也不拉库存。

Oracle Fusion 数据流:销售订单与发票拉进来。客户与库存不在本连接范围内。

激活#

激活后,连接按您设的频率把 Oracle Fusion 的销售订单与发票拉进本系统。先在 运行监控 / 日志里盯头几次拉取、和 Oracle Fusion 对照无误,再放手跑。如果您用 token 登录,要留意它:粘贴的 token 失效后,拉取会开始失败,直到您粘贴一个新的。

这个连接不做的事:不从 Oracle Fusion 拉客户,不查也不拉库存,也不把库存或任何其他东西推回 Oracle Fusion。客户与库存请继续在 Oracle Fusion 里处理,或在实际作业的系统里处理。

常见问题#

测试报 401 或 403

Oracle Fusion 拒绝了测试实际使用的那套登录。如果填了 token,用的就是 token——所以被拒的是 token,哪怕用户名和密码也填了。没填 token 时,被拒的是用户名和密码,或者该 Fusion 用户没有 REST 资源需要的集成角色。

查实际用的那套。用的是 token:到您的 OCI / IDCS 身份域里重新取一个 OAuth2 access token,完整粘贴进 token。用的是 Basic:一起核对 username 与 password,并在 Fusion 里确认该用户带有集成角色。然后重新测试。

测试在发送任何请求前以缺值信息停下

填写不完整:要么 base_url 为空,要么两套登录方式都不成套。只有用户名没有密码不算一套,只有密码没有用户名也不算一套——再没有填 token,测试根本没有办法登录。

把 base_url 填成完整的实例 URL,然后只补全一套:username 与 password 一起填,或完整粘贴一个 token。保存后重新测试。

之前连得上,后来拉取自己开始失败

如果本连接用 token 登录,那就是粘贴的 token 失效了。本连接只按粘贴的原样使用 token、不会去取新的,所以测试时好用的 token 后来会失效,而其他每个值都还是对的。

到您的 OCI / IDCS 身份域里重新取一个 OAuth2 access token,完整粘贴进 token 字段,保存并测试。如果换了新 token 仍失败,改查 Basic 那套——或有意清空 token 字段、回到用户名加密码。

我填了用户名和密码,但登录表现得像没填一样

本连接里还填着一个 token,而填了的 token 会优先于 username 与 password 使用。Basic 的值没有坏——只是只要有 token 值在,实际用的就不是那一套。

先定您想用哪套。用 token:保持它新鲜,不用管 Basic 字段。用用户名加密码:把 token 字段彻底清空,保存后重新测试。

连接成功,但客户或库存一直不出现

这是本连接的范围,不是故障:它只拉销售订单与发票。客户与库存不在本连接的拉取范围内,所以改 Mapping、频率或凭证都不会让它们在这里出现。

客户与库存请继续在 Oracle Fusion 里处理,或在那些数据实际所在的系统里处理。本连接用来拉订单与发票,核验时在 运行监控 / 日志里看这两类即可。

连接成功,但没有订单或发票拉进来

连接是通的——测试已经真实读到了 invoices 资源——只是没有新的可拉:实例在拉取范围内没有新的销售订单或发票。如果您的环境跑的不是那个版本,api_version 填错也会造成同样的空结果。

在 Oracle Fusion 里新建或确认一个销售订单和一张发票;api_version 留空,除非您确定环境跑的版本与内置默认值不同。然后手动拉一次,在预览或 运行监控 / 日志里确认两者都出现。