TrueCommerce 接続：注文メッセージ取込、出荷・請求メッセージ送信
TrueCommerce の担当チームに Base URL を確認し、API キーまたは OAuth クライアント認証情報を入力、テスト、取引先マッピング設定、有効化を行います。
TrueCommerce コネクタは TrueCommerce 経由で取引先と EDI ドキュメントを交換します。取引先からの注文メッセージが入り込んで注文になり、出荷・請求メッセージが取引先へ返送されます。ストア接続ではなく、すべて取引先ごと・メッセージごとに構成されます。
前提条件#
- TrueCommerce アカウントと、API の Base URL と認証情報を依頼できる担当チーム。
- EDI メッセージを交換する取引先が少なくとも 1 社あること——注文メッセージの受信、出荷・請求メッセージの送信。本ガイドの後半で取引先ごとにマッピングします。
- この接続で使う認証方式を決めておくこと：API キー単独か、API キーがない場合は OAuth クライアント認証情報（Client ID + Client Secret）か。2 つの方式は選択肢であり、両方のフィールドを混ぜないでください。
認証情報の取得#
- TrueCommerce の担当チームに、アカウントの API Base URL を依頼してください。これがないと接続を入力できません。すべてのメッセージ交換はこのアドレスを経由します。
- API キー方式を使う場合：TrueCommerce にアカウントの API キーを依頼し、全文をコピーしてください。API キーがあれば OAuth フィールドは不要です。
- API キーがない場合：代わりに TrueCommerce に OAuth クライアント認証情報を依頼してください——OAuth Client ID と OAuth Client Secret です。両方がセットで必須です。
- Client Secret を受け取ったらすぐに安全な場所へ保存してください。一度だけ表示されます。紛失した場合は TrueCommerce の担当チームに再発行を依頼してください。
Integration への入力#
- Integration → コネクタマーケットプレイス → TrueCommerce → 新規接続を開きます。
- Base URL：担当チームから受け取った TrueCommerce API の Base URL を https:// から貼り付けます。このフィールドは必須で、TrueCommerce のアドレスでなければなりません。他システムのアドレスでは応答しません。
- API key：API キー方式を使う場合は、TrueCommerce の API キーをここに貼り付けます。代わりに OAuth を使う場合はこのフィールドを空にしてください。API key が空であることが、OAuth クライアント認証情報を使う合図になります。
- OAuth Client ID：API key フィールドが空の場合にのみ必須です。TrueCommerce がアカウント向けに発行した OAuth Client ID を貼り付けます。API キーを入力した場合は、このフィールドは空で構いません。
- OAuth Client Secret：API key フィールドが空の場合にのみ必須で、OAuth Client ID と対になります。両方は同じ発行セットのものでなければなりません。暗号化して保存され、再表示されることはありません。
接続テスト#
接続テストをクリックします。テストは入力した Base URL にアクセスし、選択した方式の認証情報を提示します——API キー、または API key フィールドが空の場合は OAuth Client ID と Client Secret です。通過すれば、そのアドレスで TrueCommerce に到達し、認証情報が受け付けられたということです。失敗したらテストが表示するエラーを控えてください。アドレスが拒否されたのか認証情報が拒否されたのかが分かり、下の FAQ で各ケースを説明しています。
Mapping / テンプレート選択#
TrueCommerce のマッピングは接続全体で 1 設定ではなく、取引先ごとに行います。取引先ごとにその取引先のテンプレートを選び、注文メッセージが標準注文にどうマッピングされるか——注文番号、明細、数量、配送先情報——と、出荷・請求データがその取引先の期待するメッセージ形式にどう戻るかを確認してください。マッピング未設定の取引先はメッセージの受け皿がなく、注文メッセージは注文にならず、出荷・請求メッセージも組み立てられません。取引先を 1 社ずつ進め、有効化前に各社のマッピングプレビューを確認してください。
有効化#
有効化後、マッピング済みの取引先からの注文メッセージが入り込んで注文になり、出荷・請求メッセージが TrueCommerce 経由で各取引先へ返送されます。マッピングのない取引先は沈黙したままで、マッピングを設定するまで何も流れません。無人で任せる前に、Runs / Logs で取引先ごとの最初の数メッセージを確認してください。
よくある質問#
テスト失敗：認証情報が拒否される
接続の認証情報が、TrueCommerce がアカウント向けに発行したものと一致していません。よくある原因は、値のコピーが不完全なこと、または方式の入力が中途半端なことです。API key フィールドが空——これは接続を OAuth に切り替えます——なのに OAuth Client ID と Client Secret の片方しか入力されておらず、ペアが揃っていないため受け付けられません。
1 つの方式を決めて完全に入力してください。API キー方式：API キー全文を貼り、OAuth フィールドは空にします。OAuth 方式：API key は空にし、同じ発行セットの OAuth Client ID と OAuth Client Secret の両方を貼ります。Secret は一度だけ表示されるため、保存したコピーを失った場合は TrueCommerce の担当チームに再発行を依頼してください。保存して再テストしてください。
テスト失敗：TrueCommerce にまったく到達できない
接続の Base URL が誤っているため、テストが間違った入口を叩いています。よくある原因は、アドレスの入力ミスや途中で切れた貼り付け、別システム向けのアドレス、あるいは担当チームから新しいアドレスを受け取ったのに旧アドレスのままになっていることです。そのアドレスでは TrueCommerce が応答しないため、認証情報の確認にすら進みません。
TrueCommerce の担当チームにアカウントの正確な API Base URL を確認してもらい、接続の Base URL を渡されたとおりのアドレス——https:// から始まるもの——に置き換え、保存して再テストしてください。
接続できているのに、ある取引先の注文メッセージが注文にならない
接続自体は正常で、テストも通り、他の取引先は流れているかもしれません。問題は、この取引先のマッピングが未設定であるか、そのテンプレートが注文メッセージをカバーしておらず、入ってきたメッセージの受け皿がないため注文にならないことです。
その取引先のマッピングを開き、テンプレートを選び、実際の注文メッセージ 1 件でマッピングプレビューを確認してください。注文番号、明細、数量、配送先情報がすべて標準注文に落ちるはずです。マッピングを保存したら、Runs / Logs でその取引先の次のメッセージを確認してください。
注文は入るのに、出荷・請求メッセージが取引先に届かない
受信は動作しているため、アドレスと認証情報に問題はありません。不足しているのはその取引先マッピングの送信側です。注文メッセージの受信は設定済みでも、出荷・請求メッセージの送信が未設定のため、履行結果を乗せて戻るメッセージがありません。
その取引先のマッピングを開き、送信側も設定してください。出荷メッセージと請求メッセージを、その取引先が期待する形式で設定します。履行済みの注文でマッピングプレビューを確認し、Runs / Logs でその取引先への次の送信メッセージを確認してください。