Loop Returns 接続：返品は webhook で届き、倉庫でフラグと処理を行う

Loop 管理画面の Returns Management → Tools & integrations → Developer Tools で returns scope 付き API key を作成し、その 1 つのキーを Integration に入力します。テストが確認待ちのままになる理由を理解してから有効化してください。

Loop Returns コネクタは、Loop の返品ポータルを返品システム（RMS）に接続します。返品は API で取り込むのではありません。購入者が Loop で返品を作成すると webhook で届きます。返品が入った後は倉庫がここで作業します。この接続のアクションは、返品へのフラグ付けと返品処理の 2 つです。返品ラベルは作成しません。接続のフィールドは Loop API Key の 1 つだけです。

前提条件#

• 管理者としてログインできる Loop アカウントがあり、Returns Management → Tools & integrations → Developer Tools にアクセスできること。
• 返品はまず Loop で発生します。購入者が Loop で返品を開始し、この接続がそれを受け取ります。ここは返品をゼロから作成する場所ではありません。
• 開始前に受信方法を理解してください。返品は webhook のみで届き、定期的な API 取得はありません。この接続は返品ラベルも提供しません。

認証情報の取得#

1. Loop 管理画面にログインします。
2. Returns Management → Tools & integrations → Developer Tools を開きます。
3. そこで新しい API key を作成し、returns scope を必ず含めてください。returns scope は必須要件です。これがないと、後の返品へのフラグ付けと処理のアクションが失敗します。
4. キーを全文コピーします。このシステムが Loop と通信するとき、キーは X-Authorization ヘッダーで送信されます。このヘッダーを自分で入力する必要はなく、キーを入力するだけです。

Integration への入力#

1. Integration → コネクタマーケットプレイス → Loop Returns → 新規接続 を開きます。
2. api_key、必須、Loop API Key：Loop 管理画面の Returns Management → Tools & integrations → Developer Tools で作成したキーを、returns scope 付きであることを確認して全文貼り付けます。パスワード型のフィールドで、秘密情報として保存されます。この接続に他のフィールドはありません。店舗アドレスもサーバーアドレスもなく、入力項目はこれだけです。
3. 接続を保存してテストを実行してください。その前に次のセクションを読んでください。このチャネルのテスト結果は他のチャネルとは見た目が異なります。

接続テスト#

接続テストをクリックすると、次の結果が返ってきます。本物のキーを入力した場合、テストは合格にはならず、未合格・確認待ちとして返り、Loop へは一切リクエストを送信しません。これはこのチャネルで想定される動作であり、キーが間違っているというサインではありません。理由は単純です。Loop には、データを変更せずにキーが機能することを証明できる、確認済みの読み取り専用チェックがありません。既知の Loop のアクションであるフラグ付けと処理は返品を変更するため、無害なテストには使えません。また、返品詳細の読み取りパスも公式ドキュメントで確認されていません。そのためテストは、キーが存在することだけを確認し、リクエストは 0 件送信し、確認待ちと報告します。緑色の結果を求めてキーを繰り返し作り直さないでください。returns scope 付きの正しいキーは、まさにこの結果を表示します。キーを空欄のままテストした場合、結果はシミュレーションによるチェックのみで、シミュレーションと表示されます。実際の Loop アカウントについては何も証明しません。

Mapping / テンプレート選択#

Loop Returns 標準の Mapping を選択します。webhook で届いた返品を、Loop から送信された返品参照、注文参照、商品、数量とともに、返品システムの返品として記録します。有効化前に、実返品を 1 件通してください。Loop で返品を開始し、届くのを待ち、こちらの返品と Loop を並べて比較します（参照、商品、数量）。合わない点があれば、Loop 側を変更せず、Mapping でその項目を調整してください。

有効化#

有効化後、Loop で作成された返品は webhook で届き、作業対象の返品として表示されます。倉庫はここで返品を開き、注意が必要なときにフラグを付け、返品の対応が済んだときに処理します。この 2 つのアクションはその返品について Loop に送信されます。最初は Runs / Logs で実際の返品を確認し、Loop と照合してから無人運用に移してください。

この接続が行わないこと：スケジュールに従って API 経由で Loop から返品を取り込むことはしません。そのため、待つべき同期ボタンはありません。また、返品ラベルも作成しません。購入者は引き続き Loop 自体が提供する方法でラベルを受け取ります。返品は Loop で開始され、webhook で届き、ここでフラグ付けと処理が行われます。

よくある質問#

本物のキーを入力したのに、テストが未合格・確認待ちと表示される

これは Loop Returns で想定される結果です。キーが完全に正しくても同じです。Loop には、データを変更せずにキーが機能することを証明できる確認済みの読み取り専用チェックがないため、テストはリクエストを一切送信せず、確認待ちと報告します。この結果はキーが存在することを示すもので、キーが間違っていることを示すものではありません。

キーを作り直し続けないでください。保存されたキーが Loop 管理画面の Returns Management → Tools & integrations → Developer Tools で returns scope 付きで作成したものか確認し、Mapping と有効化に進んでください。接続の判断は、webhook で届く最初の実際の返品で行ってください。

キーなしではテストが問題なさそうだったのに、実際の業務が何も起きない

キーを空欄にすると、テストはシミュレーションによるチェックのみを実行し、結果をシミュレーションと表示します。その結果は Loop アカウントと通信することは決してないため、返品を取り込むことも、フラグ付けや処理のアクションを送信することもできません。

Loop 管理画面の Returns Management → Tools & integrations → Developer Tools で returns scope 付きの実際の API key を作成し、api_key フィールドに貼り付けて保存してください。その後、テストは確認待ちと表示されます。このチャネルでは、本物のキーはそのように見えます。

返品へのフラグ付けや処理が失敗する

最も可能性が高い原因は API key 自体にあります。フラグ付けと処理は Loop と実際に通信するアクションであり、returns scope 付きで作成されたキーが必要です。その scope なしで作成されたキーは接続の中で完全なように見えていても、返品に対する実際のアクションはすべて Loop に拒否されます。

Loop 管理画面の Returns Management → Tools & integrations → Developer Tools で、今度は returns scope を含めて新しいキーを作成し、保存されている api_key をそれに置き換えて、同じ返品でフラグ付けまたは処理のアクションを再試行してください。

接続は有効なのに返品が届かない

この接続で返品が届く方法は 1 つだけです。購入者が Loop で返品を作成した瞬間に webhook で届きます。その背後に API 取得はないため、接続が有効でも Loop に新しい返品がなければ、ここには正しく何も新しいものが表示されません。有効化前に作成された返品が後から取り込まれることもありません。

Loop で実際の返品を 1 件開始し、ここ と Runs / Logs で届くか確認してください。届けば接続は機能しており、前の静かな期間は単に新しい返品がなかっただけです。届かない場合は、接続が有効で正しいキーが保存されているか確認し、その時間帯の Runs / Logs を確認してください。

購入者が返品ラベルの場所を尋ねる

この接続は返品ラベルを一切提供しません。返品を受け取り、フラグ付けと処理のアクションを送信します。購入者が印刷するラベルは、Loop ですでに用意しているラベルの仕組みを通じて、Loop 自体から提供されます。

購入者のラベルの流れは Loop 内に保ち、Loop のラベル設定をそこで確認してください。この接続は、その役割のために使ってください。返品をここで受け取り、倉庫がフラグ付けと処理を行えるようにすることです。

Loop の API key が複数ある場合、どれを使うべきですか？

この接続に合うキーは 1 種類だけです。Returns Management → Tools & integrations → Developer Tools で returns scope 付きで作成されたキーです。他の目的で作成されたキーや、その scope のないキーはフィールドには入力できますが、返品へのフラグ付けや処理のアクションは機能しません。

returns scope 付きのキーを選ぶか、上記の認証情報の手順に従って新規作成し、api_key に全文貼り付けて保存してください。フィールドは 1 つだけなので、間違ったキーが隠れる 2 つ目の場所はありません。