Walmart 接続：注文取込と履行実績の返送

Walmart Developer Portal から Consumer ID と Private Key をコピーし、Integration に貼り、テスト・マッピング・有効化。

Walmart コネクタは Walmart Marketplace の注文を OMS に取り込み、履行実績と在庫を Walmart に返送します。返品の取込や、製品・在庫更新の送信もできます。

前提条件#

• Walmart Marketplace の販売者アカウント。
• Walmart Developer Portal へのアクセスと、そのアカウントの My apps を開く権限。
• Private Key を安全に保管できる担当者。再接続やローテーション時に完全なキーが必要です。

認証情報の取得#

1. Walmart Developer Portal → My apps を開き、Marketplace アカウントのアプリを開く。
2. そのページに表示される Consumer ID をコピー。
3. 同じページの Private Key をコピー。PKCS#8 PEM 形式で -----BEGIN PRIVATE KEY----- で始まります。先頭行と末尾行を含め全文をコピー。

Integration への入力#

1. Integration → コネクタマーケットプレイス → Walmart → 新規接続。
2. Consumer ID：Walmart Developer Portal → My apps からコピーした Consumer ID を貼付。両フィールドとも必須。
3. Private Key：PKCS#8 PEM 形式の完全な Private Key を貼付。-----BEGIN PRIVATE KEY----- で始まり、終了行まで含めること。リクエストは Consumer ID＋Private Key で署名されます。キーは暗号化保存され、再表示されません。

接続テスト#

接続テストをクリック。テストは Consumer ID と Private Key で署名したリクエストを送り、Walmart Marketplace API の疎通を確認します。通過すれば Walmart が署名を受け付け、認証情報が使えます。失敗したらエラーを控え、他の設定を変える前に下の FAQ を確認してください。

Mapping / テンプレート選択#

Walmart 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先住所、履行ステータスを Walmart と標準注文の間でマッピングします。有効化前にプレビューを確認し、特に各 Walmart SKU が正しい OMS 製品に紐付いているか見てください。

有効化#

有効化後、設定した頻度で Walmart Marketplace の新規注文を取得し、返品を取り込み、追跡番号付きの履行実績、製品更新、在庫変更を Walmart に返送します。最初は Runs / Logs で数件確認してください。

よくある質問#

テストが 401 で失敗する

Walmart がテストリクエストの署名を拒否しました。最も多い原因は Private Key のコピーが不完全、または形式が壊れていて署名を検証できないことです。

Walmart Developer Portal → My apps から Private Key を再コピーし、全文を貼り直してください。完全な PKCS#8 PEM で、-----BEGIN PRIVATE KEY----- で始まり終了行まで含み、1 文字も欠けてはいけません。保存して再テストしてください。

テスト失敗：Consumer ID が認識されない

Consumer ID フィールドに誤った値が入っています。このアプリの Consumer ID ではない別の ID が貼られたことが多く、Walmart が署名済みリクエストをアプリに紐付けられません。

Walmart Developer Portal → My apps に戻り、そのアプリの Consumer ID を正確にコピーして接続の値を置き換え、保存して再テストしてください。

以前使えた接続が、今はテスト全て失敗する

Walmart 側のキーまたはアプリが無効になっています。例えば Private Key が失効した、またはアプリが Walmart Developer Portal で無効化された場合です。Walmart が受け付けないキーでは、どう貼ってもリクエストに署名できません。

Walmart Developer Portal でアプリの Private Key を新規生成し、新しい完全なキーを接続に貼り、保存して再テストしてください。新キーは生成時にのみ完全に表示されるため、安全に保管してください。

接続できているのに注文が入ってこない

接続自体は正常でテストも通りますが、このアカウントには Walmart Marketplace の新規注文がまだなく、取り込むものがありません。

Walmart Marketplace の出品で実際に注文する（または次の顧客注文を待つ）あと、手動取得を実行して Runs / Logs を確認してください。Walmart が注文を発行すれば新規注文が表示されます。