Lowe's 接続：注文取込と履行実績の返送
Lowe's Mirakl 販売者ポータルの API ドキュメントで Mirakl API ベース URL を確認し、ユーザー名 → API Key から API Key をコピーして、両方を Integration に入力、テスト・マッピング・有効化。
Lowe's コネクタは Mirakl 経由で Lowe's マーケットプレイスの店舗の注文を OMS に取り込み、履行実績を Lowe's に返送します。製品・在庫の更新も送信でき、注文・出荷・在庫が両側で同期します。1 つの接続は 1 つの Lowe's Mirakl 環境を指します。API ベース URL と API Key は同じ環境のものでなければなりません。
前提条件#
- Lowe's マーケットプレイスの販売者アカウントと、その店舗の Lowe's Mirakl 販売者ポータルへのアクセス。
- Mirakl 販売者ポータルで API ドキュメントを閲覧し、自分のユーザー向けに API Key を生成する権限。コネクタはそのキーで認証します。
- コピーできる自分の Lowe's Mirakl 環境が手元にあること。API ベース URL は環境ごとに異なり、すべての Mirakl マーケットプレイスで同じではないため、別の Mirakl 店舗のアドレスを流用しないでください。
認証情報の取得#
- Lowe's Mirakl 販売者ポータルにサインインし、販売者ポータルの API ドキュメントを開きます。そこで API ルート URL を確認します。https://<your-env>/api のような形式です。お使いの環境用に表示されたアドレスを全文そのままコピーしてください。
- 同じ販売者ポータルで、右上のユーザー名をクリックし、API Key を開きます。
- API Key ページで、キーがまだない場合は Generate New Key を選んで新規生成し、既にある場合は Copy でコピーします。キーは安全な場所に保管してください。次の手順で Integration に貼り付けます。このキーは各リクエストで Authorization ヘッダーの値として送信されます。
Integration への入力#
- Integration → コネクタマーケットプレイス → Lowe's → 新規接続を開きます。
- Mirakl API base URL：Lowe's Mirakl 販売者ポータルの API ドキュメントで確認した API ルート URL を貼り付けます。例：https://<your-env>/api。自分の Lowe's 環境のアドレスだけを貼ってください。別の Mirakl インスタンスのアドレスでは、形式が正しく見えても誤ったマーケットプレイスに接続します。
- API key：Lowe's Mirakl 販売者ポータル → ユーザー名（右上）→ API Key からコピーした API Key を貼り付けます。このフィールドは必須で、Authorization ヘッダーの値として送信され、暗号化して保存され、再表示されることはありません。
接続テスト#
接続テストをクリックします。テストは入力した Mirakl API ベース URL と API Key を使って Lowe's Mirakl 環境にアクセスし、キーが Authorization ヘッダーとして受け付けられるか確認します。通過すればアドレスが正しい環境に届き、キーが使えるということです。失敗したらエラーを控え、他の設定を変える前に下の FAQ を確認してください。失敗の多くはキー、またはベース URL が誤った Mirakl インスタンスを指していることが原因です。
Mapping / テンプレート選択#
Lowe's 標準テンプレートを選択します。注文番号、明細 SKU、数量、配送先住所、履行ステータスを Lowe's（Mirakl）と標準注文の間でマッピングし、更新送信時に使う製品・在庫フィールドも含みます。有効化前にプレビューを確認し、特に各 Lowe's SKU が正しい OMS 製品に紐付いているか見てください。
有効化#
有効化後、設定した頻度で Lowe's の新規注文を取得し、追跡番号付きの履行実績を Lowe's に返送し、製品・在庫の更新を送信します。無人で任せる前に、まず Runs / Logs で最初の数件を確認してください。
よくある質問#
テスト失敗：API Key が受け付けられない
接続の API Key が誤っているか、もう有効ではありません。例えばコピーが不完全だった、別のユーザーのキーだった、または新しいキーを生成して接続に保存された古いキーが現在のものではなくなった場合です。このキーは各リクエストで Authorization ヘッダーとして送信されるため、Mirakl が認識しないキーではすべてのリクエストが入口で拒否されます。
Lowe's Mirakl 販売者ポータルを開き、右上のユーザー名 → API Key をクリックし、現在のキーを全文コピーしてください。新しいキーが必要な場合は Generate New Key を選んでください。その後、接続の API key フィールドに貼り直し、保存して再テストしてください。
テスト失敗または別の店舗につながる：Mirakl ベース URL が間違っている
Mirakl API base URL フィールドに、自分の Lowe's 環境ではないアドレスが入っています。最も多い原因は、別の Mirakl インスタンスのアドレスを貼ってしまったことです。同じく Mirakl で動く別のマーケットプレイスや別の環境です。そのアドレスは完全に有効に見えるかもしれませんが、指している場所が違うため、Lowe's の API Key がそこで一致せず、テストが自分の Lowe's 店舗に届きません。
Lowe's Mirakl 販売者ポータルを開き、販売者ポータルの API ドキュメントを再度開いてください。お使いの環境用に表示された API ルート URL（https://<your-env>/api のような形式）をコピーし、接続の Mirakl API base URL をその正確なアドレスに置き換え、保存して再テストしてください。別の Mirakl 店舗からコピーしたアドレスは再利用しないでください。
接続できているのに注文が入ってこない
接続自体は正常でテストも通りますが、Lowe's 店舗に新規注文がまだなく、取り込むものがありません。
まず Lowe's Mirakl 販売者ポータルで、自分の店舗に新規注文が実際に出ているか確認してください。出ている場合は手動取得を実行し、Runs / Logs を確認してください。ポータルにも新規注文がない場合は、次の顧客注文を待ってください。Lowe's が注文を発行すれば、新規注文が Integration に表示されます。