用户手册
帮助中心/用户手册/接 Oracle WMS:只能查库存——不下订单

接 Oracle WMS:只能查库存——不下订单

最后更新 2026-11-01

在 WMS 连接里填 IDCS 的 Client ID、Client Secret、Token URL 与您的租户实例地址,测试 OAuth 换 token 后激活查库存。本连接不把订单下发到 Oracle WMS。

Oracle WMS 连接器把本系统连到一个 Oracle WMS Cloud 租户,只做一件事:查库存。它按 SKU 从租户实例读库存数量。它不把订单下发到 Oracle WMS——订单下发不在本连接范围内,订单请继续走您现有的通道进 Oracle WMS。这个连接在 WMS 域里配置,不走渠道向导,登录方式是用 Client ID、Client Secret 与 Token URL 做 IDCS OAuth 换 token,查库存的调用还要用租户实例地址。

Oracle WMS 接入步骤:先备 IDCS 三件套,再填 WMS 连接,再做真实换 token 测试,再配 Mapping,最后激活——只查库存。

前置条件#

  • 一个 Oracle WMS Cloud 租户实例,以及它的实例地址。地址按租户配置——没有一个适用于所有租户的统一默认地址。
  • 一个为您 WMS 实例建的 IDCS 机密应用,其 Client ID 与 Client Secret 可复制。
  • 您 IDCS 域的 OAuth token 端点,用作 Token URL。必须是与上面应用同一个 IDCS 域的端点。
  • 团队内部已达成一致:本连接只用于查库存。订单仍需要现有的通道进 Oracle WMS。

拿凭证#

  1. 从 Oracle WMS 实例配置里,找到为该 WMS 实例建的 IDCS 机密应用。复制它的 Client ID。
  2. 复制同一个应用的 Client Secret。Client ID 与 Client Secret 必须来自同一个应用——拿别的应用的 Secret 在这里换不到 token。
  3. 记下 Token URL:您 IDCS 域的 OAuth token 端点。
  4. 记下您 Oracle WMS 实例的租户实例地址,作为 baseUrl。从您自己的租户信息里复制——不要借用其他租户的地址,也不要用示例地址。

填进 Integration#

这个连接没有渠道向导字段表。在 Integration 里打开 Oracle WMS 的 WMS 连接,在那张 WMS 连接表单里填下面的值。不要去渠道向导的字段步骤里找 Oracle WMS——向导里没有它的字段。

  1. Client ID——必填:为您 WMS 实例建的 IDCS 机密应用的 Client ID。
  2. Client Secret——必填:同一个 IDCS 应用的 Secret。这是秘密字段,系统换 token 时会与 Client ID 一起使用。
  3. Token URL——必填:您 IDCS 域的 OAuth token 端点。换 token 请求就发到这个地址,务必完整复制。
  4. 租户实例地址(baseUrl)——查库存时必填:您自己 Oracle WMS 租户实例的地址。连接测试不用这个地址,但每次查库存都用,所以现在就填、且要填准确。

测试连接#

用 WMS 连接上的测试。它会向您填的 Token URL 发一次 client credentials 换取请求,用 Client ID 与 Client Secret 认证,只有返回 access token 才算通过。Client ID、Client Secret、Token URL 任一缺失,测试以 MISSING_CREDENTIALS 停下;换取没有返回 access token,则以 AUTH_FAILED 失败。注意测试不做的事:它不调用租户实例地址,所以 baseUrl 填错测试照样可能通过,要到第一次查库存才暴露。您可能碰到两个测试入口:这里说的 WMS 连接测试才是真实凭证校验;渠道向导里出现的测试不会拿这组值去联系 IDCS——那里显示通过,不能当作 IDCS 值可用的证明。判断连接只认 WMS 连接测试,之后再认一次真实查库存。

配 Mapping / 选模板#

选 Oracle WMS 库存模板。它只覆盖库存:本系统的一个 SKU 对应租户实例上该 SKU 的库存记录,返回数量以租户报告的为准。本连接没有订单模板可选,因为订单不下发。查库存调用走租户的实体接口,所以先在一个已知产品上确认您租户所用的 SKU 形态——准确编码、大小写与任何前缀。测试通过后,拿一个库存已知的 SKU 跑一次查库存,把数字与租户里显示的对一遍,确认后才激活。

Oracle WMS 数据流:先从 IDCS 换 token,再从租户读库存。订单不走本连接。

激活#

激活后,本系统的库存查询按已映射 SKU 从您的 Oracle WMS 租户读当前数量。先在 运行监控 / 日志里盯头几次查询、和租户对照无误,再放手跑。

这个连接不做的事:不把订单下发到 Oracle WMS,也不从 Oracle WMS 回传发货确认。订单请继续走您现有的通道进 Oracle WMS,发货确认继续在今天实际处理它的系统里处理。

常见问题#

下发订单时报 WMS_ENDPOINTS_PENDING

本连接不把订单下发到 Oracle WMS。订单进 Oracle WMS 依赖租户配置,本连接只读库存,所以下发会以 WMS_ENDPOINTS_PENDING 停下、不会发出请求。这不是凭证问题,重试也不会改变结果。

不要再通过本连接下发订单。把订单走您现有的通道送进 Oracle WMS,本连接只用来查库存。

测试通过,但查库存报 MISSING_BASE_URL

测试只在 Token URL 换 token——从不调用租户实例地址。查库存是第一步用到 baseUrl 的环节,所以租户地址缺失或为空只会在那里以 MISSING_BASE_URL 暴露。

在 WMS 连接里填入租户实例地址,用您自己 Oracle WMS 租户的准确地址,保存后重新跑查库存。测试结果不用变——它本来就不查这个地址。

WMS 测试报 AUTH_FAILED

在 Token URL 的换取没有返回 access token。Client ID 与 Client Secret 这一对在该端点没被接受:Secret 不属于该 Client ID 对应的应用,或 Token URL 是另一个 IDCS 域的端点。

回到为您 WMS 实例建的 IDCS 应用,从同一个应用重新复制 Client ID 与 Client Secret,再确认 Token URL 是同一个 IDCS 域的 OAuth token 端点,然后重新测试。

测试以 MISSING_CREDENTIALS 停下

WMS 连接上的三个 IDCS 值有空的:Client ID、Client Secret 或 Token URL。换取三个都要有,所以测试在联系 IDCS 之前就停下了。

在 WMS 连接表单里把三个字段都按 IDCS 应用与域填齐,保存后重新测试。不要把租户实例地址填进 Token URL 字段——两者是不同地址、干不同的事。

渠道向导测试通过了,但 WMS 测试还是失败

两个测试不是同一个校验。渠道向导没有 Oracle WMS 字段,它那里的测试不会拿您的 Client ID、Client Secret 与 Token URL 去 IDCS 换 token,所以那里通过与 IDCS 值是否可用无关。只有 WMS 连接测试做真实换取。

这个连接不要看向导结果。去跑 WMS 连接上的测试、按它的结果处理,之后再跑一次真实查库存,把租户地址也一并证明。

租户里有库存的 SKU,查库存却查不到

查库存向租户实例要发过去那个 SKU 的库存记录。如果发过去的 SKU 形态——准确编码、大小写或前缀——与租户所用的不一致,或租户地址指向了另一个租户,即使有库存,回答也会是空。

先确认租户实例地址是您自己的租户。然后从租户的产品记录里取准确 SKU,把该形态设进 Mapping,再重新跑查库存。