接 Logiwa：订单下发出去，查库存

在 WMS 连接里填有 API 访问权的 Logiwa 账号邮箱与密码，做真实的换 token 测试，配 Mapping 后激活——订单下发到 Logiwa，库存可查。

Logiwa 连接器把本系统连到 Logiwa 这个外部仓储系统。它能把发货订单下发到 Logiwa，支持单条与批量，还能查 Logiwa 里的库存。发货确认通过 Logiwa Webhook V2 回传，不靠本连接轮询拉取。这个连接在 WMS 域里配置，不走渠道向导，登录方式是用 Logiwa 用户名与密码换取会话 token。

前置条件#

• 一个能登录的 Logiwa 账号。本连接的用户名，是有 API 访问权的 Logiwa 用户的邮箱。
• 同一个 Logiwa 用户的密码。本连接没有要另外生成的 API Key——账号邮箱与密码就是凭证。
• 您清楚是用默认服务地址 https://myapi.logiwa.com，还是用为您 Logiwa 环境另行给出的 baseUrl。没人给过别的地址时，就用默认地址。

拿凭证#

1. 选定供集成使用的 Logiwa 用户，并确认该用户有 API 访问权。尽量用专用用户，避免个人改密码把连接弄断。
2. 记下用户名：该 Logiwa 用户的邮箱地址。
3. 记下同一个用户的密码。您会在 WMS 连接里填一次，系统把它作为秘密保存，并与用户名一起用来换取 token。
4. 如果您的 Logiwa 环境给出的服务地址与默认不同，把那个 baseUrl 也记下。否则没有其他要收集的东西。

填进 Integration#

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

1. username——必填：有 API 访问权的 Logiwa 用户邮箱，与登录 Logiwa 时用的完全一致。
2. password——必填：同一个 Logiwa 用户的密码。这是秘密字段，系统换 token 时会与 username 一起发送。
3. baseUrl——选填：Logiwa 服务地址。留空则用默认 https://myapi.logiwa.com；如为您环境另行给出了不同地址，就填那个地址。

测试连接#

用 WMS 连接上的测试。它会向您 baseUrl 下的 token 地址发一次真实登录请求，带上您填的 username 与 password，只有 Logiwa 返回 token 才算通过。username 或 password 缺失，测试以 MISSING_CREDENTIALS 停下；请求没有返回 token，则以 AUTH_FAILED 失败。您可能碰到两个测试入口：这里说的 WMS 连接测试才是真实凭证校验；渠道向导里出现的测试不会拿这组凭证去联系 Logiwa——那里显示通过，不能当作 Logiwa 账号可用的证明。判断连接只认 WMS 连接测试。

配 Mapping / 选模板#

选 Logiwa 标准 Mapping。用它，本系统的一张出库单会变成 Logiwa 的发货订单，库存查询会按已映射的 SKU 读 Logiwa 库存列表。测试通过后，先下发一张真实订单，到 Logiwa 里对照核对——订单参考号、明细行与数量——再拿一个 SKU 的数量和 Logiwa 显示的对一遍，确认后才激活。如果本系统某个 SKU 与 Logiwa 里同一产品的叫法不同，在 Mapping 里改那个 SKU，不要去改任何一边的产品名。

激活#

激活后，本系统的出库单会逐条或批量下发到 Logiwa 成为发货订单，库存查询按已映射 SKU 读 Logiwa 的当前数量。发货确认通过 Logiwa Webhook V2 回传，所以要保证 Logiwa 一侧的 webhook 投递正常。先在 运行监控 / 日志和 Logiwa 里盯头几单无误，再放手跑。

常见问题#

WMS 测试报 AUTH_FAILED

换 token 请求到了 Logiwa，但没有返回 token。用户名与密码这一对没被接受：邮箱不是有 API 访问权的 Logiwa 用户、密码不属于该用户，或 baseUrl 指向的 Logiwa 环境与账号所属环境不是同一个。

先在浏览器里用同一组邮箱与密码登录 Logiwa，证明这对凭证可用，并确认该用户有 API 访问权；然后在 WMS 连接里重新完整填入 username 与 password，不要截断。如果您的环境另行给出过 baseUrl，就原样填入；否则清空 baseUrl 用默认地址，再重新测试。

测试以 MISSING_CREDENTIALS 停下

WMS 连接上的 username 或 password 是空的。换 token 请求两个值都要有，所以测试在联系 Logiwa 之前就停下了。

在 WMS 连接表单里把两个字段都填上——username 填 Logiwa 用户邮箱、password 填该用户密码——保存后重新测试。

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

两个测试不是同一个校验。渠道向导没有 Logiwa 字段，它那里的测试不会拿您的 username 与 password 去 Logiwa 登录，所以那里通过与 Logiwa 账号是否可用无关。只有 WMS 连接测试做真实的换 token 登录。

这个连接不要看向导结果。去跑 WMS 连接上的测试，按它的结果处理：MISSING_CREDENTIALS 是字段有空，AUTH_FAILED 是账号组合被拒。

订单下发了，但 Logiwa 里数量对不上

连接与 token 都没问题——订单已经到了——但某一行对不上：通常是订单上的 SKU 在 Logiwa 里指的是另一个产品，或明细行的单位在两个系统里不一致。

把下发的订单与 Logiwa 里的订单逐行对照，在 Mapping 里修正对不上的那个产品的 SKU 映射，再下发一张新的测试单复对，确认后恢复正常下单。

Logiwa 里有的 SKU，库存查询却查不到

库存查询拿已映射的 SKU 去读 Logiwa 库存列表。如果发过去的 SKU 不是 Logiwa 存放库存所用的 SKU，即使产品存在，列表也会返回空。

在 Logiwa 的产品记录里找到准确的 SKU，把该值设进本产品在 Mapping 里的对应项，再重新跑库存查询。

Logiwa 里已发货，但这边收不到发货确认

本连接的发货确认走 Logiwa Webhook V2，不走下单或查库存的调用。如果 Logiwa 一侧的 webhook 投递停了或失败了，订单与库存照常工作，但确认会收不到。

检查 Logiwa 一侧的 webhook 投递状态并恢复，然后在 Logiwa 里发一张测试单，确认确认信息能到这边，再恢复正常量。