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

最終更新 2026-11-01

Overstock パートナー統合ドキュメントから API ベース URL と API キーを取得し、Integration に入力、テスト・マッピング・有効化。

Overstock コネクタは Overstock（現在は Bed Bath & Beyond プラットフォームとして運営）の注文を OMS に取り込み、履行実績をプラットフォームに返送します。製品・在庫の更新も送信でき、注文・出荷・在庫を両側で同期できます。

接続手順：認証情報、テスト、Mapping、有効化。

前提条件#

現在 Bed Bath & Beyond ブランドのプラットフォームで販売する Overstock パートナーアカウント。
Overstock パートナー統合ドキュメント。API ベース URL とエンドポイントのパスはそのドキュメントが基準です。Overstock は REST API 仕様を公開していないため、エンドポイントを他で確認することはできません。
同じ統合ドキュメントに記載された、アカウント向けに発行されたパートナー API キー。コピーできる状態で用意してください。記憶で入力せず、Integration に貼り付けます。

認証情報の取得#

アカウントの Overstock パートナー統合ドキュメントを開く。必要な 2 つの値（API ベース URL と API キー）はそのドキュメントから取得します。代わりに参照できる公開 REST API 仕様はありません。
そのドキュメントで API ルート URL を見つけ、そのままコピーする。これが API ベース URL フィールドの値で、https:// で始まります。ルート URL はドキュメントの記載どおりにコピーし、エンドポイントのパスも同じドキュメントで確認してください。
同じドキュメントでパートナー API キーを見つけてコピーする。安全な場所に保管してください。これはシークレットで、すべてのリクエストで x-api-key ヘッダーとして送信され、保存後に Integration が再表示することはありません。

Integration への入力#

Integration → コネクタマーケットプレイス → Overstock → 新規接続。
API ベース URL（必須）：Overstock パートナー統合ドキュメントからコピーした API ルート URL を https://… の形式で貼付。ドキュメントのルート URL をそのまま貼ってください。プラットフォームのストアフロント住所を入力したり、住所を推測したりしないでください。Overstock は REST API 仕様を公開していないため、この値の情報源はドキュメントのみです。
API キー（必須）：同じドキュメントのパートナー API キーを貼付。x-api-key ヘッダーとして送信され、暗号化して保存され、再表示されることはありません。保存後、このフィールドにキーは表示されなくなるため、ドキュメントから自分のコピーを保管してください。

接続テスト#

接続テストをクリック。テストでは API ベース URL を使い、API キーを x-api-key ヘッダーとして送信して接続性を確認し、実注文 1 件で伝票レベルのプレビュー（プラットフォームのフィールドと標準注文の対照）を表示します。アカウントに注文がまだない場合でも接続確認は通過することがあります。プレビューを判断する前に実注文が発生するのを待つか用意し、テストが失敗した場合は下の FAQ を確認してください。

Mapping / テンプレート選択#

Overstock 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先住所を標準注文にマッピングし、履行実績をプラットフォーム形式に変換して返します。有効化前にプレビューを確認し、特に各プラットフォーム SKU が正しい製品に紐付いているか見てください。製品・在庫プッシュで正しい商品が報告されます。

Overstock 注文の往復：注文を取り込み、履行実績を返送し、製品・在庫を送信。

有効化#

有効化後、設定した頻度で Overstock の新規注文を取得し、追跡番号付きの履行実績に加え、製品・在庫の更新をプラットフォームに返送します。無人で任せる前に、最初は Runs / Logs で数件確認してください。

よくある質問#

テスト失敗：API キーが拒否される

API キーが誤っています。すべてのリクエストでキーが x-api-key ヘッダーとして送信されるため、文字が 1 つ欠けてコピーしたキー、別アカウントのキー、またはパートナー API キーではない値は、最初の呼び出しで拒否されます。ベース URL が関わる余地すらありません。

Overstock パートナー統合ドキュメントに戻り、パートナー API キーをそこからコピーし直し、接続の API キーの値を置き換えて保存し、再テストしてください。入力し直さず、貼り付けてください。

テスト失敗：API ベース URL でプラットフォームに接続できない

API ベース URL の入力が誤っています。このフィールドには統合ドキュメントの API ルート URL が必要です。プラットフォームのストアフロント住所、ブラウザからコピーしたページ住所、推測した住所は、いずれも API が応答しない場所を指します。Overstock は REST API 仕様を公開していないため、もっともらしく見える URL でも誤っていることがあります。正しいのはドキュメントで定義されたものだけであり、エンドポイントのパスも同様です。

統合ドキュメントを開き、API ルート URL を記載どおりにコピーし直し、接続の API ベース URL を置き換え、エンドポイントのパスを同じドキュメントで確認してください。保存して再テストしてください。

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

接続自体は正常でテストも通りますが、プラットフォームにアカウントの新規注文がまだなく、取り込むものがありません。接続が正常でも注文リストが空の場合は、次の注文が発生するまでこの状態になります。

プラットフォームで次の実注文が発生するのを待ち、手動取得を実行して Runs / Logs を確認してください。新規注文はプラットフォームが発行すれば表示されます。プラットフォームに注文があるのに手動取得後も表示されない場合は、まずパートナー統合ドキュメントと照らして API ベース URL と API キーを再確認してください。