linkfox-temu-returns-refunds-eu

Temu 欧州サイト — 返品・返金（Returns & Refunds）

この skill（linkfox-temu-returns-refunds-eu）は、Partner Platform for EU の Returns & Refunds / EC 返品・返金（および関連する After-sales の返品・返金カテゴリ）に関する bg.* / temu.* インターフェースを対象とします（menu_code と各 sub_menu_code は Partner 管理画面に準拠します。詳細は partner-eu-catalog.md を参照してください）。

Partner の Return and Refund インターフェースを 9 件接続済みです。リストは partner-eu-catalog.md を参照してください。

ゲートウェイ（本 skill に組み込み済み）：

機能	メソッド	パス
返品・返金 OpenAPI（eu_returns_refunds_*、temu_eu_proxy）	POST	https://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロード	POST	https://tool-gateway.linkfox.com/temu/fileDownload

関連 skill

シナリオ	skill
返品・返金（本 skill）	linkfox-temu-returns-refunds-eu
購入者が開始する注文キャンセル（返品・返金の全フローを伴わないもの）	linkfox-temu-cancel-order-eu
販売者が開始する注文キャンセル／在庫切れによるキャンセル／申し立て	linkfox-temu-cancel-order-eu
注文一覧／詳細／金額／アフターサービスのコンテキスト	linkfox-temu-order-eu
商品管理	linkfox-temu-manage-product-eu
フルフィルメント／出荷	linkfox-temu-fulfillment-eu
ゲートウェイと Temu トークン	本 skill の scripts/

呼び出し方法

• API エンドポイント：POST /temu/proxy（操作ごとにリクエスト本文で区別します。パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照してください）
• Python スクリプト：python scripts/<脚本名>.py '<JSON 参数>' [--inline]（使用可能なスクリプトは上記のスクリプト一覧を参照してください）
• コストに関する制約：本ツールは計算リソースを消費します。失敗または結果が空の場合、キーワードを自動で変更したり、ページ送りしたり、連続して試したりしないでください。検索を続行する必要がある場合は、追加のコストが発生することを事前にユーザーへ伝えてください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-returns-refunds-eu-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動で集約します。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーを返します）
• レスポンス本文が 8 KB 以下の場合：ファイルに保存後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルに保存後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を追加すると、stdout に全量を強制出力します（同様にファイルにも保存します）

データの読み取りに関する推奨事項：まず要約を確認して十分かどうか判断してください。具体的なフィールドが必要な場合は、保存された json ファイルから jq または ConvertFrom-Json を使って必要なデータだけを抽出し、JSON 全体をコンテキストに取り込まないようにしてください。

認証と計算リソースの問題の解決

次の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高が不足している旨のレスポンス：メッセージに「計算リソースの残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」または類似の内容が含まれている場合。

デフォルトパラメーター

フィールド	デフォルト	説明
site	eu	Partner EU
managementType	semi-managed	セミマネージド（詳細は各インターフェースの Partner ドキュメントを参照）
tokenPurpose	order-shipping	注文／アフターサービスのシナリオ向けトークン（access-token.md を参照）

認証

1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token
2. Temu：accessToken または storeKey（storeKey の場合は tokenPurpose=order-shipping を付けることを推奨）

スクリプト

スクリプト	説明
temu_eu_proxy.py	任意の type を汎用転送
temu_eu_file_download.py	署名付きファイルのダウンロード
eu_returns_refunds_aftersales_parentaftersales_list_get.py	bg.aftersales.parentaftersales.list.get
eu_returns_refunds_aftersales_aftersales_list_get.py	bg.aftersales.aftersales.list.get
eu_returns_refunds_aftersales_parentaftersales_detail_get.py	temu.aftersales.parentaftersales.detail.get
eu_returns_refunds_aftersales_parentreturnorder_get.py	bg.aftersales.parentreturnorder.get
eu_returns_refunds_aftersales_returnaddress_get.py	temu.aftersales.returnaddress.get
eu_returns_refunds_aftersales_returnlabel_prepare_get.py	temu.aftersales.returnlabel.prepare.get
eu_returns_refunds_aftersales_signature_get.py	temu.aftersales.signature.get
eu_returns_refunds_aftersales_upload_returnlabel.py	temu.aftersales.upload.returnlabel
eu_returns_refunds_aftersales_carrier_get.py	temu.aftersales.carrier.get

インターフェースの追加接続（取り決め）

Partner ドキュメント（type + sub_menu_code + URL + Request/Response パラメーター表）を 1 件提供するごとに、次を行います。

1. references/apis/<type-slug>.md を新規作成します（完全な入力／出力階層）
2. scripts/eu_returns_refunds_<slug>.py を新規作成します（_eu_returns_refunds_script.run_cli を呼び出します）
3. partner-eu-catalog.md、apis/README.md、および本表を更新します

例（汎用プロキシ）

export LINKFOXAGENT_API_KEY="<key>"

python scripts/temu_eu_proxy.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "type": "<TEMU_API_TYPE>",
  "params": {
    "request": {}
  }
}'

フィードバック： skillName：linkfox-temu-returns-refunds-eu

网关与授权脚本

脚本	说明
check_linkfox_token.py	校验 LinkFox 用户 Token
temu_token_guide.py	Temu accessToken 后台授权步骤
save_temu_access_token.py	保存 accessToken 到本地
list_temu_access_tokens.py	列出已保存 token
get_temu_access_token.py	读取已保存 token
temu_proxy.py	通用网关转发（多 site）
temu_file_download.py	加签文件下载（多 site）

授权说明：references/access-token.md

算力消耗规则

不消耗算力。