linkfox-temu-tax-eu

Temu Europe — E-commerce Tax (Tax)

This skill (linkfox-temu-tax-eu) covers Partner Platform for EU Tax / e-commerce tax related OpenAPI (menu_code and each sub_menu_code subject to the Partner backend, see partner-eu-catalog.md）。

Currently integrated 7 endpoints; the remaining Tax endpoints will be added one by one according to the Partner documentation.

Gateway (built into this skill)：

Capability	Method	Path
Tax OpenAPI (eu_tax_*、temu_eu_proxy）	POST	https://tool-gateway.linkfox.com/temu/proxy
signed file download	POST	https://tool-gateway.linkfox.com/temu/fileDownload

Related skills

Scenario	skill
Product list/edit/compliance (including taxCodeInfo and other fields)	linkfox-temu-manage-product-eu
Order amount (tax-inclusive/tax-exclusive details)	linkfox-temu-order-eu
Price/supply price	linkfox-temu-price-eu
Buyer/seller order cancellation	linkfox-temu-cancel-order-eu
Product publishing	linkfox-temu-add-product-us（site=eu）
Gateway and Temu token	This skill scripts/

How to call

• API endpoint：POST /temu/proxy(different operations are distinguished by request body; for complete parameters/responses/error codes see references/api.md）
• Python script：python scripts/<脚本名>.py '<JSON 参数>' [--inline](available scripts see the script list above)
• Cost constraint: this tool consumes compute; on failure/empty results do not automatically switch keywords, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that additional consumption will be incurred.

Output strategy (default script behavior)：

• Alwayswrite the complete response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-tax-eu-<timestamp>.json（<cwd> is the working directory when the script runs, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, if the current directory is not writable then report an error)
• Response body ≤ 8 KB: after writing to disk, print the complete JSON to stdout
• Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, length of the largest list field + first 3 samples)
• Add --inline to force full printing to stdout (also written to disk)

Data reading suggestions: first look at the summary to judge whether it is sufficient; when specific fields are needed, prefer jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.

Resolving authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide resolution:

Abnormal situation

• API Key not configured: environment variable not configured LINKFOX_AGENT_API_KEY, and also not configured LINKFOXAGENT_API_KEY。
• Response 401 or 402 status code
• Response indicates insufficient compute or balance: the message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.

Default parameters

Field	Default	Description
site	eu	Partner EU
managementType	semi-managed	Semi-managed
tokenPurpose	product-inventory	Kuniao Seller Assistant token (if the Partner requires another purpose, the documentation shall prevail)

Authentication

1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token
2. Temu：accessToken or storeKey（storeKey , it is recommended to include tokenPurpose=product-inventory）

Scripts (by type)

Script	type	Status
eu_tax_apply_export_report.py	temu.pay.tax.apply.export.report	Integrated
eu_tax_get_galerie_signature.py	temu.pay.tax.get.galerie.signature	Integrated
eu_tax_invoice_detail_query.py	temu.pay.tax.invoice.detail.query	Integrated
eu_tax_invoice_info_query.py	temu.pay.tax.invoice.info.query	Integrated
eu_tax_invoice_pdf_download.py	temu.pay.tax.invoice.pdf.download	Integrated
eu_tax_merchant_report_download.py	temu.pay.tax.merchant.report.download	Integrated
eu_tax_merchant_upload_invoice.py	temu.pay.tax.merchant.upload.invoice	Integrated
temu_eu_proxy.py	Any type	General
temu_eu_file_download.py	Signed file download	General

Integrating a new API (convention)

Each time you provide a Partner document (HTML/URL + type + Request/Response table + optional sub_menu_code), you will:

1. Add references/apis/<type-slug>.md(all input/output parameter levels fully expanded)
2. Add scripts/eu_tax_<slug>.py(call _eu_tax_script.run_cli）
3. Update partner-eu-catalog.md、apis/README.md and this table

Example

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"
  }
}'

Feedback： skillName：linkfox-temu-tax-eu

Gateway and authorization scripts

Authorization notes:references/access-token.md

Computing power consumption rules

No computing power is consumed.