linkfox-temu-tax-eu

Temu EU サイト — Eコマース税務（Tax）

この skill（linkfox-temu-tax-eu）は、Partner Platform for EU の Tax / Eコマース税務 関連 OpenAPI をカバーします（menu_code と各 sub_menu_code は Partner 管理画面に準じます。partner-eu-catalog.md を参照してください）。

現在 7 個のインターフェースに対応しています。その他の Tax インターフェースは、Partner のドキュメントに従って順次追加します。

ゲートウェイ（この skill に内蔵）：

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

関連 skill

シナリオ	skill
商品一覧／編集／コンプライアンス（taxCodeInfo などのフィールドを含む）	linkfox-temu-manage-product-eu
注文金額（税抜／税込の明細）	linkfox-temu-order-eu
価格／仕入れ価格	linkfox-temu-price-eu
購入者／販売者による注文のキャンセル	linkfox-temu-cancel-order-eu
商品の出品	linkfox-temu-add-product-us（site=eu）
ゲートウェイと Temu token	この skill の scripts/

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-tax-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	セミマネージド
tokenPurpose	product-inventory	酷鸟の販売者アシスタント token（Partner が別の purpose を指定する場合は、ドキュメントに従ってください）

認証

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

Scripts（type 別）

スクリプト	type	状態
eu_tax_apply_export_report.py	temu.pay.tax.apply.export.report	対応済み
eu_tax_get_galerie_signature.py	temu.pay.tax.get.galerie.signature	対応済み
eu_tax_invoice_detail_query.py	temu.pay.tax.invoice.detail.query	対応済み
eu_tax_invoice_info_query.py	temu.pay.tax.invoice.info.query	対応済み
eu_tax_invoice_pdf_download.py	temu.pay.tax.invoice.pdf.download	対応済み
eu_tax_merchant_report_download.py	temu.pay.tax.merchant.report.download	対応済み
eu_tax_merchant_upload_invoice.py	temu.pay.tax.merchant.upload.invoice	対応済み
temu_eu_proxy.py	任意の type	汎用
temu_eu_file_download.py	署名付きファイルのダウンロード	汎用

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

Partner のドキュメント（HTML／URL + type + Request／Response テーブル、および任意の sub_menu_code）を 1 件提供いただくごとに、次の作業を行います。

1. references/apis/<type-slug>.md を新規作成します（入出力のすべての階層を展開します）
2. scripts/eu_tax_<slug>.py を新規作成します（_eu_tax_script.run_cli を呼び出します）
3. partner-eu-catalog.md、apis/README.md、およびこの表を更新します

例

export LINKFOXAGENT_API_KEY="<key>"

# 发票信息查询（最多 20 个父单号）
python scripts/eu_tax_invoice_info_query.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "product-inventory",
  "site": "eu",
  "request": {
    "parentOrderSnList": ["PO-123456789"]
  }
}'

# 申请导出税务报表（月份 YYYY-MM）
python scripts/eu_tax_apply_export_report.py '{
  "accessToken": "TOKEN",
  "request": {
    "reportMonth": "2025-04",
    "requestId": "req-uuid-001"
  }
}'

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

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

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

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

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