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

最終更新 2026-11-01

DHgate 開発者コンソールで API ゲートウェイ URL と App Key をコピーし、DHgate OAuth フローでアクセストークンを取得、Integration に入力、テスト・マッピング・有効化。

DHgate コネクタは DHgate 販売者アカウントの注文を OMS に取り込み、履行実績を DHgate に返送します。商品・在庫の送信も可能で、注文・出品・在庫・出荷を両側で同期できます。

DHgate 接続手順：まずゲートウェイ URL と認証情報、次にテスト、Mapping、有効化。

前提条件#

DHgate 販売者アカウント。アクセストークンはその販売者アカウント向けに発行されます。
DHgate 開発者コンソールへのアクセス。そこにアプリ、App Key、API ゲートウェイ URL が表示されます。
その販売者アカウントで DHgate OAuth 認可フローを完了できること。アクセストークンはそのフローから取得します。

認証情報の取得#

API ゲートウェイ URL のコピー：DHgate 開発者コンソールで、API ゲートウェイ URL を表示どおりコピー。記憶で入力しないこと。固定値ではなく、1 文字の誤りで全呼び出しが失敗します。
App Key のコピー：DHgate 開発者コンソールでアプリを開き、App Key をコピーします。
アクセストークンの取得：販売者アカウントで DHgate OAuth 認可フローを完了し、そのフローで得たアクセストークンをコピー。安全に保管し、Integration の Access token フィールドに貼り付けます。
使用するエンドポイントパスを控えます：注文、商品、在庫、履行、プローブのパスは DHgate Open Platform ドキュメントにあり、ゲートウェイ URL からの相対パスです。次の手順で高度なエンドポイントフィールドを変更する場合にのみ必要です。

Integration への入力#

Integration → コネクタマーケットプレイス → DHgate → 新規接続。
API ゲートウェイ URL（base_url）、必須：DHgate 開発者コンソールでコピーしたゲートウェイ URL を表示どおり貼付、例 https://… 。末尾にエンドポイントパスを追加しないこと。下のエンドポイントフィールドはこの URL からの相対パスです。
App Key（app_key）、必須：DHgate 開発者コンソール → アプリの App Key を貼付。
Access token（token）、必須：DHgate OAuth 認可フローで取得した販売者アカウントのアクセストークンを貼付。シークレットとして保存され、保存後は再表示されません。
注文エンドポイント（ep_orders）、任意・高度：「未出荷注文一覧」API のパス。ゲートウェイ URL からの相対パスで、例 /order/list、DHgate Open Platform ドキュメントに従います。アプリのドキュメントに別途指示がない限り、提供値のままにしてください。パスが間違っていると注文を取得できません。
商品エンドポイント（ep_products）、任意・高度：商品一覧 API のパス。ゲートウェイ URL からの相対パスで、DHgate Open Platform ドキュメントに従います。商品の送信・読み取り時に使用します。
在庫エンドポイント（ep_inventory）、任意・高度：在庫更新 API のパス。ゲートウェイ URL からの相対パスで、DHgate Open Platform ドキュメントに従います。DHgate へ在庫を送信する時に使用します。
履行エンドポイント（ep_fulfillment）、任意・高度：出荷 / 追跡送信 API のパス。ゲートウェイ URL からの相対パスで、DHgate Open Platform ドキュメントに従います。DHgate へ履行実績を返送する時に使用します。
プローブエンドポイント（ep_me）、任意・高度：「接続テスト」プローブ用の軽量読み取り API のパス。ゲートウェイ URL からの相対パスで、DHgate Open Platform ドキュメントに従います。このパスが間違っていると、認証情報が正しくてもテストが失敗します。

接続テスト#

接続テストをクリック。プローブパスを使ってゲートウェイ URL、App Key、アクセストークンをまとめて確認し、実注文 1 件で伝票レベルのプレビューを表示して、プラットフォーム項目と標準注文を並べて確認できます。未出荷注文がまだない場合は、先にテスト注文を作成してください。プレビューには実伝票が必要です。失敗した場合はエラーを控え、他を変更する前に下の FAQ を確認してください。

Mapping / テンプレート選択#

DHgate 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先、履行ステータスをマッピングします。有効化前に実注文 1 件でマッピングプレビューを確認し、特に各 DHgate SKU が OMS 製品に紐付いているか確認してください。注文・商品・在庫が両側で一致します。

DHgate 注文の往復：注文を取り込み、履行実績・商品・在庫を返送。

有効化#

有効化後、設定した頻度で新規の未出荷注文を取得し、追跡番号付き履行実績を DHgate に返送、商品・在庫の変更を DHgate に送信します。最初は Runs / Logs で数件確認してから無人運用してください。

よくある質問#

テストが認証エラーで失敗する

App Key またはアクセストークンが間違っているか、無効になっています。App Key が別アプリのものであるか、OAuth フローのアクセストークンが期限切れのため、DHgate が呼び出しを拒否しています。

DHgate 開発者コンソールでアプリを開き、App Key をコピーし直してください。次に DHgate OAuth 認可フローを再度完了し、新しいアクセストークンを Access token フィールドに貼り付けて再テストしてください。

接続済みだが注文が取り込めない

接続自体は正常です。取得範囲内に販売者アカウントの新規未出荷注文がないだけです。

未出荷として表示されるテスト注文を作成し、時刻が取得範囲内か確認、手動取得を実行してプレビューまたは Runs / Logs に表示されるか確認してください。

エンドポイントパス変更後にテスト失敗、またはデータが戻らない

高度なエンドポイントパスが DHgate Open Platform ドキュメントと一致していません。ゲートウェイ URL と認証情報が正しくても、プローブパスが間違っていればテストは失敗し、注文パスが間違っていれば注文を取得できません。

変更した各エンドポイントフィールドを、アプリ向け DHgate Open Platform ドキュメントのパスに戻してください（注文、商品、在庫、履行、プローブはいずれもゲートウェイ URL からの相対パス）。保存して再テストしてください。どのパスが間違っていたか分かるよう、1 つずつ変更してください。

注文は取り込めるが、履行・商品・在庫が返送できない

取込と返送では異なるエンドポイントパスを使います。注文が動作していても、履行・商品・在庫のパスが間違っていれば、その方向だけが失敗します。

接続で失敗している方向を確認してください。履行エンドポイント、商品エンドポイント、在庫エンドポイントの各フィールドを DHgate Open Platform ドキュメントと照合し、間違っているものを修正して、次回の送信を Runs / Logs で確認してください。