linkfox-temu-cancel-order-us

Temu 米国サイト — 注文のキャンセル（購入者＋販売者）

このスキル（linkfox-temu-cancel-order-us）では、Partner Platform for US の注文キャンセル関連インターフェースを扱います。

• 購入者／消費者：bg.aftersales.cancel.list.get、bg.aftersales.cancel.agree
• 店舗／販売者：temu.order.cancel.appeal.apply、temu.order.cancel.appeal.result.get、temu.order.cancel.outofstock.apply、temu.order.cancel.outofstock.result.get

詳しくは partner-us-catalog.md をご覧ください（インターフェース 6 件）。

ゲートウェイ（このスキルに組み込み済み）：

機能	メソッド	パス
キャンセル注文 OpenAPI（us_cancel_*、us_seller_cancel_*、temu_us_proxy）	POST	https://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロード	POST	https://tool-gateway.linkfox.com/temu/fileDownload

関連スキル

シナリオ	スキル
注文一覧／詳細／出荷／住所／金額	linkfox-temu-order-us
欧州サイトの注文キャンセル	linkfox-temu-cancel-order-eu
グローバルサイト（US／EU 以外）の注文キャンセル	linkfox-temu-cancel-order-global
フルフィルメント／出荷	linkfox-temu-fulfillment-us
商品管理	linkfox-temu-manage-product-us
返品と返金	linkfox-temu-returns-refunds-us
ゲートウェイと Temu トークン	このスキルの scripts/

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-cancel-order-us-<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	us	Partner US
managementType	semi-managed	セミマネージド
tokenPurpose	order-shipping	注文／キャンセル用トークン

認証

1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization ＋ Token
2. Temu：accessToken または storeKey（tokenPurpose=order-shipping を推奨）

Scripts（type 別）

購入者によるキャンセル

スクリプト	type
us_cancel_aftersales_cancel_list_get.py	bg.aftersales.cancel.list.get
us_cancel_aftersales_cancel_agree.py	bg.aftersales.cancel.agree

販売者によるキャンセル

スクリプト	type
us_seller_cancel_order_cancel_appeal_apply.py	temu.order.cancel.appeal.apply
us_seller_cancel_order_cancel_appeal_result_get.py	temu.order.cancel.appeal.result.get
us_seller_cancel_order_cancel_outofstock_apply.py	temu.order.cancel.outofstock.apply
us_seller_cancel_order_cancel_outofstock_result_get.py	temu.order.cancel.outofstock.result.get

共通

スクリプト	説明
temu_us_proxy.py	任意の type
temu_us_file_download.py	署名付きファイルのダウンロード

新しいインターフェースの追加（規約）

1. references/apis/<type-slug>.md を追加します
2. scripts/us_cancel_* または us_seller_cancel_* を追加します（_us_cancel_order_script.run_cli を呼び出します）
3. partner-us-catalog.md、apis/README.md を更新します

例

export LINKFOXAGENT_API_KEY="<key>"

# 买家取消 — 待处理列表
python scripts/us_cancel_aftersales_cancel_list_get.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": { "pageNo": 1, "pageSize": 20, "afterSalesStatusGroup": 8 }
}'

# 卖家 — 缺货取消申请
python scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "parentOrderSn": "PO-123456789",
    "orderSnList": ["O-111111111"]
  }
}'

フィードバック： skillName：linkfox-temu-cancel-order-us

ゲートウェイと認証スクリプト

スクリプト	説明
check_linkfox_token.py	LinkFox Token を検証します
save_temu_access_token.py / list_temu_access_tokens.py / get_temu_access_token.py	ローカルトークン
temu_token_guide.py	Temu 認証ガイド

認証の説明：references/access-token.md

計算リソースの消費ルール

計算リソースは消費しません。