linkfox-temu-order-eu

Temu 欧州サイト注文管理 API（注文管理）

本スキル（linkfox-temu-order-eu）は、Partner Platform for EU の Order メニュー（menu_code=dbd3d395963a408984b8ae7dbc5f64f9）にある 10 個の注文 bg.order.*／temu.order.*／temu.local.order.* インターフェースを対象としています（type は US と共通で、デフォルトは site=eu です）。米国サイトでは linkfox-temu-order-us、グローバルサイト（US／EU 以外）では linkfox-temu-order-global を使用してください。

詳しくは partner-eu-catalog.md をご覧ください。

現在、10 個のインターフェースに対応しています。その他の注文インターフェースは、Partner のドキュメントに従って references/apis/ および eu_order_*.py に順次追加します。

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

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

関連スキル

シナリオ	スキル
商品一覧／詳細／編集／在庫／出品・出品停止	linkfox-temu-manage-product-eu
商品登録、カテゴリー、V2 add	linkfox-temu-add-product-us
価格／仕入れ価格、価格設定	linkfox-temu-price-eu
注文キャンセル	linkfox-temu-cancel-order-eu
返品と返金	linkfox-temu-returns-refunds-eu
フルフィルメント／発送（ラベル購入、提携倉庫、自社発送、追跡）	linkfox-temu-fulfillment-eu
ゲートウェイと Temu トークン	本スキルの scripts/

呼び出し方法

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

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

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

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

ドキュメント	内容
api.md	ゲートウェイ、認証、エラーコード、拡張手順
partner-eu-catalog.md	インターフェース一覧 + Partner URL + スクリプト（対応状況に応じて更新）
apis/README.md	インターフェースごとのファイル（apis/<type-slug>.md）

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

以下の異常が発生した場合は、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	セミマネージド
tokenPurpose	order-shipping	注文／発送シナリオ用トークン（access-token.md を参照）

認証

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

Scripts（type 別）

スクリプト	type	状態
eu_order_list_v2_get.py	bg.order.list.v2.get	対応済み
eu_order_detail_v2_get.py	bg.order.detail.v2.get	対応済み
eu_order_shippinginfo_v2_get.py	bg.order.shippinginfo.v2.get	対応済み
eu_order_decryptshippinginfo_get.py	bg.order.decryptshippinginfo.get	対応済み
eu_order_amount_query.py	bg.order.amount.query	対応済み
eu_order_amount_v2_query.py	temu.order.amount.v2.query	対応済み
eu_order_amount_v3_query.py	temu.order.amount.v3.query	対応済み
eu_order_combinedshipment_list_get.py	bg.order.combinedshipment.list.get	対応済み
eu_order_customization_get.py	bg.order.customization.get	対応済み
eu_order_verification_upload.py	temu.local.order.verification.upload	対応済み
temu_eu_proxy.py	任意の type	汎用
temu_eu_file_download.py	署名付きファイルのダウンロード	汎用

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

Partner のドキュメント（type + パラメーター表 + 任意の sub_menu_code）を 1 件提供いただくと、次の内容を追加します。

1. references/apis/<type-slug>.md を追加（完全な入力／出力の階層）
2. scripts/eu_order_<slug>.py を追加（_eu_order_script.run_cli を呼び出す）
3. partner-eu-catalog.md、apis/README.md、および本表を更新

例

export LINKFOXAGENT_API_KEY="<key>"

# 订单列表 V2（待发货 parentOrderStatus=2）
python scripts/eu_order_list_v2_get.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "pageNumber": 1,
    "pageSize": 20,
    "parentOrderStatus": 2
  }
}'

# 按父订单号查询（最多 20 个）
python scripts/eu_order_list_v2_get.py '{
  "accessToken": "TOKEN",
  "request": {
    "parentOrderSnList": ["PO-123456789"]
  }
}'

# 订单详情 V2（须 parentOrderSn）
python scripts/eu_order_detail_v2_get.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "parentOrderSn": "PO-123456789"
  }
}'

# 收货地址 V2（传 parentOrderSn）
python scripts/eu_order_shippinginfo_v2_get.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "parentOrderSn": "PO-123456789"
  }
}'

# 敏感收货地址解密（传 parentOrderSn）
python scripts/eu_order_decryptshippinginfo_get.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "parentOrderSn": "PO-123456789"
  }
}'

# 订单金额/供货价（ERP 对账，传 parentOrderSn）
python scripts/eu_order_amount_query.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "parentOrderSn": "PO-123456789"
  }
}'

# 可合并发货订单组（request 可为空对象）
python scripts/eu_order_combinedshipment_list_get.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {}
}'

# 定制商品内容（子订单号 orderSn，单次最多 10 个）
python scripts/eu_order_customization_get.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "orderSnList": ["SO-123456789", "SO-987654321"]
  }
}'

# 上传 SN/IMEI 或二手鉴真（orderList[].orderSn）
python scripts/eu_order_verification_upload.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "request": {
    "orderList": [
      {
        "orderSn": "SO-123456789",
        "verificationInfo": [
          {
            "serialNumber": "SN-001234567890",
            "imeiNumberList": ["352099001761481"]
          }
        ]
      }
    ]
  }
}'

フィードバック： skillName：linkfox-temu-order-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

算力消耗规则

不消耗算力。