接 Walmart:拉订单进来,推履约出去
从 Walmart Developer Portal 复制 Consumer ID 和 Private Key,填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。
Walmart 连接器把 Walmart Marketplace 的订单拉进 OMS,再把履约和库存推回 Walmart;还能拉退货进来、把产品和库存更新推出去——一个连接管住您的 Marketplace 经营。
前置条件#
- 一个 Walmart Marketplace 卖家账号。
- 能进 Walmart Developer Portal,且有打开该账号 My apps 的权限。
- 有人能妥善保管 Private Key——重连或轮换时还需要完整的 Key。
拿凭证#
- 去 Walmart Developer Portal → My apps,打开您 Marketplace 账号对应的应用。
- 复制该页显示的 Consumer ID。
- 复制同页的 Private Key。它是 PKCS#8 PEM 格式、以 -----BEGIN PRIVATE KEY----- 开头——复制全文,含首尾行。
填进 Integration#
- 打开 Integration → 连接器市场 → Walmart → 新建连接。
- Consumer ID:粘贴您从 Walmart Developer Portal → My apps 复制的 Consumer ID。两个字段都必填。
- Private Key:粘贴完整的 Private Key,PKCS#8 PEM 格式、以 -----BEGIN PRIVATE KEY----- 开头并含收尾行。请求用 Consumer ID + Private Key 签名;Key 加密存储,永不回显。
测试连接#
点测试连接。测试会用您的 Consumer ID 和 Private Key 发一个带签名的请求,去探活 Walmart Marketplace API。通过说明 Walmart 接受了签名、凭证可用。失败时先记下报错、对照下面的常见问题排查,再改其他设置。
配 Mapping / 选模板#
选 Walmart 标准模板。它在 Walmart 与标准订单之间映射订单号、行 SKU、数量、收货地址和履约状态。激活前先看映射预览,重点确认每个 Walmart SKU 都配到了正确的 OMS 产品。
激活#
激活后,Integration 按您设的频率拉 Walmart Marketplace 新订单、拉退货进来,并把带追踪号的履约、产品更新和库存变化推回 Walmart。先在 运行监控 / 日志里盯几单,确认无误再放手跑。
常见问题#
测试报 401
Walmart 拒绝了测试请求的签名。最常见的原因是 Private Key 复制不完整或格式坏了,签名验不过。
从 Walmart Developer Portal → My apps 重新复制 Private Key 并全文粘贴:必须是完整的 PKCS#8 PEM、以 -----BEGIN PRIVATE KEY----- 开头、含收尾行、一个字符都不能少。保存后重新测试。
测试失败:Consumer ID 不被认
Consumer ID 字段填错了——常是把别的 ID 粘了进来,而不是这个应用的 Consumer ID,Walmart 对不上您的应用。
回 Walmart Developer Portal → My apps,把该应用显示的 Consumer ID 原样复制,替换连接里的值,保存后重新测试。
连接以前能用,现在测试全失败
Walmart 侧的密钥或应用已失效——比如 Private Key 被吊销,或应用在 Walmart Developer Portal 被停用。Walmart 不再接受的 Key,怎么粘都签不了请求。
在 Walmart Developer Portal 为该应用重新生成 Private Key,把新的完整 Key 粘进连接,保存后重新测试。新 Key 只在生成时完整可见,记得妥善保存。
连接正常但没有订单进来
连接本身没问题——测试能通过——只是这个账号在 Walmart Marketplace 还没有新订单,没东西可拉。
在您的 Walmart Marketplace 商品上真实下一单(或等下一笔客户订单),然后手动拉一次并看 运行监控 / 日志。Walmart 出单后,新订单就会出现。