TikTok Shop 接続：注文取込と履行実績の返送
TikTok Shop Partner Center から App Key と App Secret をコピーし、ショップを認可してアクセストークンを取得、Integration に入力してテスト・マッピング・有効化。
TikTok Shop コネクタは TikTok Shop の注文を OMS に取り込み、履行実績を TikTok Shop に返送します。商品と在庫の送信もでき、出品・在庫・出荷が両側で同期します。1 接続につき認可済みショップ 1 件です。
前提条件#
- この接続用に認可できるショップがある TikTok Shop セラーアカウント。
- TikTok Shop Partner Center へのアクセスと、アプリ管理を開いて App Key と App Secret をコピーする権限。
- 在庫を同期する場合は、在庫送信の宛先となる TikTok Shop 倉庫の Warehouse ID。Partner Center → Logistics → Warehouses でコピーします。これがないと在庫送信は拒否されます。
認証情報の取得#
- TikTok Shop Partner Center → アプリ管理を開き、App Key をコピー。
- 同じページで App Secret をコピー。すぐに安全な場所に保存してください。App Key を App Secret フィールドに入れたり、その逆をしないこと。
- 接続するショップを認可し、そのショップのアクセストークンを取得。トークンは認可したショップに属します。別のショップを認可する場合は、そのショップ用に新しいトークンを取得してください。
- 在庫を同期する場合のみ：Partner Center → Logistics → Warehouses で、在庫送信の宛先倉庫の Warehouse ID をコピー。
Integration への入力#
- Integration → コネクタマーケットプレイス → TikTok Shop → 新規接続。
- App Key、必須：TikTok Shop Partner Center → アプリ管理でコピーした App Key を貼付。
- App Secret、必須：同じページの App Secret を貼付。秘密フィールドで、暗号化保存され、再表示されません。
- Access token：ショップ認可後に取得したアクセストークンを貼付。秘密フィールドで、暗号化保存され、再表示されません。トークンの有効期限が切れたら、ショップを再認可して新しいトークンをここに貼ってください。
- Warehouse ID、注文のみなら任意、在庫同期では必須：Partner Center → Logistics → Warehouses でコピーした倉庫 ID を貼付。在庫送信はこの倉庫宛てです。これがないと送信は拒否され、間違った倉庫に在庫が書き込まれるのを防ぎます。
接続テスト#
接続テストをクリック。テストは認可済みショップについて App Key、App Secret、アクセストークンを TikTok Shop で確認します。通過すれば認証情報とショップ認可が一致。失敗したらエラーを控え、他の設定を変える前に下の FAQ を確認してください。
Mapping / テンプレート選択#
TikTok Shop 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先住所、履行ステータスを TikTok Shop と標準注文の間でマッピングします。有効化前に実注文 1 件でプレビューを確認し、特に各 TikTok Shop SKU が正しい OMS 製品に紐付いているか見てください。商品と在庫も同じ紐付けで返送されます。
有効化#
有効化後、設定した頻度で新規注文を取得し、追跡番号付きの履行実績に加え、商品と在庫の更新を TikTok Shop に返送します。最初は Runs / Logs で数件確認してください。
よくある質問#
テスト失敗：App Key または App Secret が違う
TikTok Shop がアプリ認証情報を拒否しました。最も多い原因は App Key と App Secret の取り違え、またはどちらかのコピーが不完全・余分なスペース入りで、Partner Center のアプリと一致しないことです。
TikTok Shop Partner Center → アプリ管理に戻り、App Key を App Key フィールドに、App Secret を App Secret フィールドにそのままコピーし、保存して再テストしてください。
以前使えたのに、テストが失敗する／同期が止まる
アクセストークンの有効期限が切れています。トークンはショップ認可時に発行され、永久には有効ではないため、期限切れ後はそのショップの呼び出しが拒否されます。
同じショップを再認可して新しいアクセストークンを取得し、新しいトークンを Access token フィールドに貼り、保存して再テストしてください。古いトークンは再利用しないでください。
注文や在庫が違うショップ／倉庫に対応してしまう
ショップまたは倉庫の識別子が、認可したショップと一致していません。アクセストークンが別のショップの認可で取得された、または Warehouse ID が別の倉庫からコピーされたため、TikTok Shop がデータを正しいショップ／倉庫に対応できず、在庫送信が拒否されることもあります。
両方をセットで確認してください。実際に接続したいショップを再認可して新しいトークンを貼り、同じショップについて Partner Center → Logistics → Warehouses から Warehouse ID をコピーし直します。保存して再テストし、取得または在庫送信を 1 回実行して、正しいショップと倉庫に反映されるか確認してください。
接続済みだが注文が取り込まれない
接続自体は正常でテストも通りますが、認可済み TikTok Shop に新規注文がまだなく、取り込むものがありません。
その TikTok Shop でテスト注文を作成する（または次の顧客注文を待つ）あと、手動取得を実行して Runs / Logs を確認してください。TikTok Shop が注文を発行すれば新規注文が表示されます。