{"id":"58f30270-4caa-4f78-a8ab-82717d697762","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-temu-cancel-order-us","name":"Temu美国站-取消订单","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-temu-cancel-order-us","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-temu-cancel-order-us","generatedAt":"2026-10-10T21:53:01.477Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:03:00.745Z","emptyReason":null},"description":"Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-cancel-order-us","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-temu-cancel-order-us","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-temu-cancel-order-us","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-temu-cancel-order-us","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-temu-cancel-order-us","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Temu美国站-取消订单 technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:03:00.745Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:03:00.745Z","emptyReason":null},"stars":null,"forks":null,"downloads":1327,"packageName":null,"latestVersion":"1.0.6","tractionLabel":"1.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:03:00.745Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T17:03:00.745Z","lastCrawledAt":"2026-10-10T17:03:00.745Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T17:03:00.745Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.6","createdAt":"2026-08-14T15:12:51.776Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":36,"zipByteSize":50331},{"version":"1.0.5","createdAt":"2026-08-07T11:13:47.747Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":36,"zipByteSize":50411},{"version":"1.0.4","createdAt":"2026-07-13T12:30:55.076Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":34,"zipByteSize":41435},{"version":"1.0.3","createdAt":"2026-07-06T11:39:27.776Z","changelog":"Update from 1.0.2 to 1.0.3","fileCount":34,"zipByteSize":40991},{"version":"1.0.2","createdAt":"2026-07-03T09:39:12.838Z","changelog":"Update from 1.0.0 to 1.0.2","fileCount":33,"zipByteSize":39272},{"version":"1.0.0","createdAt":"2026-05-27T06:26:22.024Z","changelog":"Initial release","fileCount":34,"zipByteSize":37671}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-cancel-order-us","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-temu-cancel-order-us` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/linkfox-ai/linkfox-temu-cancel-order-us before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T21:53:01.473Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-temu-cancel-order-us/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:03:00.745Z","emptyReason":null},"readme":"Skill: Temu美国站-取消订单\n\nOwner: linkfox-ai\n\nSummary: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。\n\nTags: latest:1.0.6\n\nVersion history:\n\nv1.0.6 | 2026-08-14T15:12:51.776Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-08-07T11:13:47.747Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-13T12:30:55.076Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nv1.0.3 | 2026-07-06T11:39:27.776Z | user\n\nUpdate from 1.0.2 to 1.0.3\n\nv1.0.2 | 2026-07-03T09:39:12.838Z | user\n\nUpdate from 1.0.0 to 1.0.2\n\nv1.0.0 | 2026-05-27T06:26:22.024Z | user\n\nInitial release\n\nArchive index:\n\nArchive v1.0.6: 36 files, 50331 bytes\n\nFiles: references/access-token.md (4527b), references/api.md (4358b), references/apis/bg-aftersales-cancel-agree.md (2732b), references/apis/bg-aftersales-cancel-list-get.md (5811b), references/apis/README.md (953b), references/apis/temu-order-cancel-appeal-apply.md (3922b), references/apis/temu-order-cancel-appeal-result-get.md (2818b), references/apis/temu-order-cancel-outofstock-apply.md (3192b), references/apis/temu-order-cancel-outofstock-result-get.md (3393b), references/authorization-flow.md (1186b), references/onboarding.md (2046b), references/partner-us-catalog.md (2853b), scripts/_temu_auth_guide.py (6198b), scripts/_temu_common.py (12431b), scripts/_temu_token_store.py (4273b), scripts/_temu_us_common.py (3200b), scripts/_us_cancel_order_script.py (504b), scripts/check_linkfox_token.py (1798b), scripts/get_temu_access_token.py (1843b), scripts/list_temu_access_tokens.py (652b), scripts/onboarding.py (24089b), scripts/save_temu_access_token.py (1377b), scripts/temu_file_download.py (1681b), scripts/temu_proxy.py (2124b), scripts/temu_token_guide.py (1594b), scripts/temu_us_file_download.py (719b), scripts/temu_us_proxy.py (956b), scripts/us_cancel_aftersales_cancel_agree.py (260b), scripts/us_cancel_aftersales_cancel_list_get.py (281b), scripts/us_seller_cancel_order_cancel_appeal_apply.py (283b), scripts/us_seller_cancel_order_cancel_appeal_result_get.py (304b), scripts/us_seller_cancel_order_cancel_outofstock_apply.py (289b), scripts/us_seller_cancel_order_cancel_outofstock_result_get.py (316b), skill-card.md (2949b), SKILL.md (6136b), _meta.json (147b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-temu-cancel-order-us\ndescription: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。\n---\n\n# Temu 美国站 — 取消订单（买家 + 卖家）\n\n本 skill（`linkfox-temu-cancel-order-us`）覆盖 Partner Platform for US **取消订单**相关接口：\n\n- **买家/消费者**：`bg.aftersales.cancel.list.get`、`bg.aftersales.cancel.agree`\n- **店家/卖家**：`temu.order.cancel.appeal.apply`、`temu.order.cancel.appeal.result.get`、`temu.order.cancel.outofstock.apply`、`temu.order.cancel.outofstock.result.get`\n\n详见 [partner-us-catalog.md](./references/partner-us-catalog.md)（**6** 个接口）。\n\n**网关（本 skill 内置）**：\n\n| 能力 | 方法 | 路径 |\n|------|------|------|\n| 取消单 OpenAPI（`us_cancel_*`、`us_seller_cancel_*`、`temu_us_proxy`） | POST | `https://tool-gateway.linkfox.com/temu/proxy` |\n| 加签文件下载 | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` |\n\n## 相关 skill\n\n| 场景 | skill |\n|------|--------|\n| 订单列表/详情/发货/地址/金额 | `linkfox-temu-order-us` |\n| 欧洲站取消订单 | `linkfox-temu-cancel-order-eu` |\n| 全球站（非 US/EU）取消订单 | `linkfox-temu-cancel-order-global` |\n| 履约/发货 | `linkfox-temu-fulfillment-us` |\n| 商品管理 | `linkfox-temu-manage-product-us` |\n| 退货与退款 | `linkfox-temu-returns-refunds-us` |\n| 网关与 Temu token | 本 skill `scripts/` |\n\n## 调用方式\n\n- **API 端点**：`POST /temu/proxy`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/<脚本名>.py '' [--inline]`（可用脚本见上文脚本一览）\n- **成本约束**：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-temu-cancel-order-us-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 默认参数\n\n| 字段 | 默认 | 说明 |\n|------|------|------|\n| site | `us` | Partner US |\n| managementType | `semi-managed` | 半托管 |\n| tokenPurpose | `order-shipping` | 订单/取消场景 token |\n\n## 鉴权\n\n1. **LinkFox**：`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token`\n2. **Temu**：`accessToken` 或 `storeKey`（建议 `tokenPurpose=order-shipping`）\n\n## Scripts（按 type）\n\n### 买家取消\n\n| 脚本 | type |\n|------|------|\n| `us_cancel_aftersales_cancel_list_get.py` | `bg.aftersales.cancel.list.get` |\n| `us_cancel_aftersales_cancel_agree.py` | `bg.aftersales.cancel.agree` |\n\n### 卖家取消\n\n| 脚本 | type |\n|------|------|\n| `us_seller_cancel_order_cancel_appeal_apply.py` | `temu.order.cancel.appeal.apply` |\n| `us_seller_cancel_order_cancel_appeal_result_get.py` | `temu.order.cancel.appeal.result.get` |\n| `us_seller_cancel_order_cancel_outofstock_apply.py` | `temu.order.cancel.outofstock.apply` |\n| `us_seller_cancel_order_cancel_outofstock_result_get.py` | `temu.order.cancel.outofstock.result.get` |\n\n### 通用\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_us_proxy.py` | 任意 `type` |\n| `temu_us_file_download.py` | 加签文件下载 |\n\n## 接入新接口（约定）\n\n1. 新增 `references/apis/.md`\n2. 新增 `scripts/us_cancel_*` 或 `us_seller_cancel_*`（调用 `_us_cancel_order_script.run_cli`）\n3. 更新 [partner-us-catalog.md](./references/partner-us-catalog.md)、[apis/README.md](./references/apis/README.md)\n\n## 示例\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\n\n# 买家取消 — 待处理列表\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": { \"pageNo\": 1, \"pageSize\": 20, \"afterSalesStatusGroup\": 8 }\n}'\n\n# 卖家 — 缺货取消申请\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n**Feedback：** `skillName`：`linkfox-temu-cancel-order-us`\n\n## 网关与授权脚本\n\n| 脚本 | 说明 |\n|------|------|\n| `check_linkfox_token.py` | 校验 LinkFox Token |\n| `save_temu_access_token.py` / `list_temu_access_tokens.py` / `get_temu_access_token.py` | 本地 token |\n| `temu_token_guide.py` | Temu 授权指引 |\n\n授权说明：[references/access-token.md](./references/access-token.md)\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.6:references/apis/README.md\n\n# Cancel Order — 接口文档索引\n\n每个 `type` 单独一份文档，经 `POST /temu/proxy` 调用。\n\n## 买家/消费者取消（2）\n\n| type | 文档 |\n|------|------|\n| `bg.aftersales.cancel.list.get` | [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) |\n| `bg.aftersales.cancel.agree` | [bg-aftersales-cancel-agree.md](./bg-aftersales-cancel-agree.md) |\n\n## 卖家/店家取消（4）\n\n| type | 文档 |\n|------|------|\n| `temu.order.cancel.appeal.apply` | [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) |\n| `temu.order.cancel.appeal.result.get` | [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) |\n| `temu.order.cancel.outofstock.apply` | [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) |\n| `temu.order.cancel.outofstock.result.get` | [temu-order-cancel-outofstock-result-get.md](./temu-order-cancel-outofstock-result-get.md) |\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-cancel-order-us\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1786720371776\n}\n\nFile v1.0.6:references/access-token.md\n\n# Temu accessToken 授权与获取\n\nTemu **没有** LinkFox 侧自动 OAuth；`accessToken` 须在 Temu 卖家后台「服务市场 → 授权管理」**手动复制**。与 `LINKFOXAGENT_API_KEY`（LinkFox 用户鉴权）是两套令牌。\n\n## 两种鉴权（勿混淆）\n\n| 令牌 | 用途 | 获取方式 |\n|------|------|----------|\n| **LinkFox 用户 Token** | 调用 `/temu/proxy`、`/temu/fileDownload` **必填** | `LINKFOXAGENT_API_KEY` 或请求 JSON 的 `token`；Header `Authorization` + `Token`（同 amazon-store-auth）（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\n| **Temu accessToken** | Temu 业务 API（经紫鸟转发） | Temu 卖家后台授权后复制 |\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/check_linkfox_token.py\n```\n\n## tokenPurpose 与场景\n\n| tokenPurpose | 店铺类型 | 推荐 site | 授权应用 |\n|--------------|----------|-----------|----------|\n| `product-inventory` | 半托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `order-shipping` | 半托管 | `us` / `global` / `eu` | Cyber-ERP酷鸟助手 |\n| `full-managed` | 全托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `local-native` | 本土（美/欧主体） | `us` 等 | Cyber-ERP |\n\n## 1. 半托管 — 商品/库存 Token\n\n1. 登录 [seller.kuajingmaihuo.com](https://seller.kuajingmaihuo.com) 或 [agentseller.temu.com](https://agentseller.temu.com)\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → 选择 **「酷鸟卖家助手」**\n4. 全选常规和特殊授权 → 确认 → **复制 access_token**\n5. 调用 API：`site=cn` 或 `partner`，`managementType=semi-managed`\n\n## 2. 半托管 — 订单/发货 Token\n\n1. 登录 Temu 卖家后台\n2. 右上角 **Seller Central** → 切换到目标区域（美区 / 欧区 / 全球）\n3. **服务市场** → **授权管理**\n4. **获取授权** → 选择 **「Cyber-ERP酷鸟助手」**\n5. 全选授权 → 确认 → 复制 token\n6. 调用 API：`site=us` / `global` / `eu`，`managementType=semi-managed`\n\n## 3. 全托管店铺\n\n1. 登录 Temu 平台\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → **「酷鸟卖家助手」** → 全选 → 复制 token\n4. 调用 API：`managementType=full-managed`，`site` 通常 `cn` 或 `partner`\n\n## 4. 本土店铺（美区、欧区主体）\n\n1. 登录 Temu\n2. **Apps And Services** → **Manage Your Apps**\n3. **Authorize a new app** → 搜索 **「Cyber-ERP」**\n4. 一般权限与敏感权限全选 → 确认 → 复制 token\n\n## 站点与 OpenAPI 网关\n\n| site | 说明 | Temu 网关 |\n|------|------|-----------|\n| cn | 中国站 | openapi.kuajingmaihuo.com |\n| partner | Partner 网关 | openapi-b-partner.temu.com |\n| us | 美国站 | openapi-b-us.temu.com |\n| global | 全球区 | openapi-b-global.temu.com |\n| eu | 欧洲站 | openapi-b-eu.temu.com |\n\n## 本地保存 Token（推荐）\n\n默认存储：`~/.linkfox/temu-access-tokens.json`（可用 `TEMU_TOKEN_STORE_PATH` 覆盖）。\n\n```bash\n# 查看授权步骤\npython scripts/temu_token_guide.py '{\"shopType\":\"semi-managed\",\"tokenPurpose\":\"product-inventory\",\"site\":\"cn\"}'\n\n# 保存 token\npython scripts/save_temu_access_token.py '{\n \"storeKey\": \"my-shop\",\n \"label\": \"中国半托管\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"accessToken\": \"PASTE_TOKEN\"\n}'\n\n# 列出已保存（脱敏）\npython scripts/list_temu_access_tokens.py\n\n# 用 storeKey 调 API（无需每次粘贴 token）\npython scripts/temu_proxy.py '{\n \"storeKey\": \"my-shop\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"type\": \"bg.goods.category.mapping\",\n \"params\": {\"goodsName\": \"测试\", \"goodsNameEn\": \"Test\"}\n}'\n```\n\n## 注意事项\n\n1. **子账号**：可能无法进入服务市场，需主账号授权。\n2. **多站点**：美国站、英国站等需分别登录对应后台获取 Token。\n3. **有效期**：Token 会过期，过期后重新在后台复制并 `save_temu_access_token.py`。\n4. **IP 白名单**：需联系紫鸟开放平台配置调用 IP。\n5. **参数小写**：`site`、`managementType` 必须小写。\n\n## 脚本一览\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_token_guide.py` | 按店铺类型/用途输出授权步骤 |\n| `save_temu_access_token.py` | 保存 accessToken 到本地 |\n| `list_temu_access_tokens.py` | 列出已保存 token（默认脱敏）|\n| `get_temu_access_token.py` | 读取指定 store 的 token |\n\nFile v1.0.6:references/api.md\n\n# linkfox-temu-cancel-order-us — API 参考\r\n\r\nTemu **美国站取消订单**（买家取消 + 卖家取消）（Partner US **Cancel Order** — 买家 `bg.aftersales.cancel.*` + 卖家 `temu.order.cancel.*`），经本 skill `temu_us_proxy`（`POST /temu/proxy`） 转发。Temu 的 `type` 写在 Body，**不是** URL 路径。\r\n\r\n> 网关与鉴权：本 skill `scripts/`（`LINKFOXAGENT_API_KEY`、`accessToken` / `storeKey`）。建议 token 见 `references/access-token.md`（`tokenPurpose=order-shipping`）。\r\n\r\n---\r\n\r\n## 调用规范\r\n\r\n| 项 | 说明 |\r\n|----|------|\r\n| 网关根地址 | `${LINKFOX_TOOL_GATEWAY}`（可用 `LINKFOX_TOOL_GATEWAY` / `TEMU_API_BASE_URL` / `STORE_API_BASE_URL` 覆盖） |\r\n| 卖家取消单 OpenAPI | `POST /temu/proxy` |\r\n| 加签文件下载 | `POST /temu/fileDownload`（`temu_us_file_download.py`） |\r\n| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**（同值）；或 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`；或 JSON `token`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\r\n| Temu 鉴权 | Body `accessToken`，或 `storeKey` + `site` + `managementType` + `tokenPurpose` |\r\n| 默认 | `site=us`，`managementType=semi-managed`，`tokenPurpose=order-shipping` |\r\n| 上游 OpenAPI（US） | `https://openapi-b-us.temu.com/openapi/router`（网关按 `site` 解析） |\r\n\r\n### 网关请求 Body（`/temu/proxy`）\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| site | string | 是 | `us`（本 skill 默认） |\r\n| managementType | string | 是 | `semi-managed` |\r\n| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌 |\r\n| storeKey | string | 与 accessToken 二选一 | `~/.linkfox/temu-access-tokens.json` 中的键 |\r\n| tokenPurpose | string | 否 | 建议 **`order-shipping`** |\r\n| type | string | 是 | Temu 接口名，如 Partner 文档中的 `bg.*` / `temu.*` |\r\n| params | object | 否 | 业务参数；多数接口业务块在 **`params.request`** |\r\n\r\n### 网关响应\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| body | string | Temu 原始 JSON 字符串；脚本解析为 `temuBody` |\r\n| code | integer | 网关错误码：`1002` 参数/Token，`1003` 转发失败 |\r\n\r\n解析顺序：**网关 `code`** → `JSON.parse(body)` → `success` / `errorCode` / `errorMsg` / `result`。\r\n\r\n### 脚本调用\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\npython scripts/temu_us_proxy.py '{\"accessToken\":\"TOKEN\",\"tokenPurpose\":\"order-shipping\",\"type\":\"\",\"params\":{\"request\":{}}}'\r\n```\r\n\r\n业务字段可放在顶层或嵌套 `params`；含 `request` 时通常整体作为 `params` 转发。\r\n\r\n---\r\n\r\n## 接口一览\r\n\r\n完整 `sub_menu_code` 与 Partner 文档 URL 见 [partner-us-catalog.md](./partner-us-catalog.md)。\r\n\r\n**每个接口单独一份文档**：[apis/README.md](./apis/README.md)（随接入递增）。\r\n\r\n> 已接入接口见 [apis/README.md](./apis/README.md)。\r\n\r\n---\r\n\r\n## 典型买家取消流程\r\n\r\n```text\r\n1. bg.aftersales.cancel.list.get（本 skill） → 查待处理买家取消售后（afterSalesStatusGroup=8 等）\r\n2. bg.aftersales.cancel.agree（本 skill） → 同意取消（parentAfterSalesSn + parentOrderSn）\r\n3. linkfox-temu-order-us → 刷新订单状态\r\n```\r\n\r\n## 典型卖家取消流程\r\n\r\n```text\r\n1. linkfox-temu-order-us → 查订单 parentOrderSn / orderSn、发货状态\r\n2a. temu.order.cancel.appeal.apply（本 skill） → 申诉类取消申请，返回 applySn\r\n2b. temu.order.cancel.outofstock.apply（本 skill） → 缺货取消申请（提交风控），返回 applyResult\r\n3. temu.order.cancel.appeal.result.get（本 skill） → 按 applySnList 查询申诉 status\r\n4. linkfox-temu-order-us → 取消后刷新订单状态（list/detail）\r\n```\r\n\r\n---\r\n\r\n## 网关错误码\r\n\r\n| code | 说明 | 处理 |\r\n|------|------|------|\r\n| 1002 | 参数或 LinkFox Token 无效 | 修正参数与 `LINKFOXAGENT_API_KEY` |\r\n| 1003 | 转发失败 | 检查 Temu token、`tokenPurpose`、白名单、网络 |\r\n| 402 | HTTP 402 | 按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- `skillName`: **`linkfox-temu-cancel-order-us`**\n\nFile v1.0.6:references/apis/bg-aftersales-cancel-agree.md\n\n# 同意取消订单 — `bg.aftersales.cancel.agree`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_agree.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.agree`，业务载荷放在 Body 的 `params` |\n\n**Description:** Agree cancel order（同意买家发起的取消订单申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentAfterSalesSn`、`parentOrderSn` 通常来自 [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) 列表接口返回（`afterSalesStatusGroup=8` 待处理）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── parentAfterSalesSn (STRING, 是)\n └── parentOrderSn (STRING, 是)\n```\n\n### `request` 内字段\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentAfterSalesSn | STRING | **是** | Parent after-sales order number（父售后单号），**不能为空** |\n| parentOrderSn | STRING | **是** | Parent order number（父订单号），**不能为空** |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── result (OBJECT)\n├── success\n├── errorCode\n└── errorMsg\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| result | OBJECT | Empty field（官方未展开子字段；成功时通常为空对象） |\n| success | BOOLEAN | Whether it was successful or not（是否成功） |\n| errorCode | INTEGER | Error code（错误码） |\n| errorMsg | STRING | Error message（错误信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| _(无子字段)_ | — | Partner 文档标注为 Empty field；若实际响应含其它字段，以 Temu 返回 JSON 为准 |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_agree.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}'\n```\n\n典型流程：`bg.aftersales.cancel.list.get`（`afterSalesStatusGroup=8`）取得 `parentAfterSalesSn` + `parentOrderSn` → 本接口**同意取消** → 可再查列表确认状态变为已同意（`9`）或用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.6:references/apis/bg-aftersales-cancel-list-get.md\n\n# 取消订单售后列表查询 — `bg.aftersales.cancel.list.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_list_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.list.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Query cancel order after-sales information（查询取消订单售后信息）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── pageSize (INTEGER, 否)\n ├── pageNo (INTEGER, 否)\n ├── parentOrderSnList[] (STRING[], 否)\n ├── parentAfterSalesSnList[] (STRING[], 否)\n └── afterSalesStatusGroup (INTEGER, 否)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pageSize | INTEGER | 否 | Page size for pagination，**默认 10**，**最大 200** |\n| pageNo | INTEGER | 否 | Page number for pagination，**默认 1** |\n| parentOrderSnList | STRING[] | 否 | Parent order number list；留空则不限制父订单号范围；**单次查询最多 200 条** |\n| parentAfterSalesSnList | STRING[] | 否 | Parent after-sales order number list；留空则不限制父售后单号范围；**单次查询最多 200 条** |\n| afterSalesStatusGroup | INTEGER | 否 | The cancel order after-sales status group（取消订单售后状态组），见下表 |\n\n#### `afterSalesStatusGroup`（入参筛选）\n\n| 值 | 说明 |\n|----|------|\n| `8` | Cancel order pending（取消订单待处理） |\n| `9` | Cancel order approved（取消订单已同意） |\n| `10` | Cancel order rejected（取消订单已拒绝） |\n| `11` | Cancel order revoked（取消订单已撤销） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8,\n \"parentOrderSnList\": [\"PO-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── total\n ├── pageNumber\n └── data[]\n ├── parentAfterSalesSn\n ├── parentAfterSalesStatus\n └── afterSalesInfoList[]\n ├── afterSalesSn\n ├── parentOrderSn\n ├── orderSn\n ├── productSkuId\n ├── applyGoodsNumber\n ├── goodsId\n ├── productList[]\n │ ├── productSkuId\n │ └── extCode\n └── createAtMillis\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Specific information |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| total | LONG | Total number of matching records（匹配记录总数） |\n| pageNumber | INTEGER | Current page number of the result（当前结果页码） |\n| data | OBJECT[] | The record data returned from this query（本次查询返回的记录） |\n\n> 入参分页字段为 **`pageNo`**，出参当前页为 **`pageNumber`**，勿混用。\n\n### `data[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentAfterSalesSn | STRING | Parent after-sales order number for the canceled order（取消订单的父售后单号） |\n| parentAfterSalesStatus | INTEGER | Current parent after-sales status（当前父售后状态），见下表 |\n| afterSalesInfoList | OBJECT[] | Cancel order after-sales information list（取消订单售后信息列表） |\n\n#### `parentAfterSalesStatus`（出参）\n\n| 值 | 说明 |\n|----|------|\n| `1` | Buyer has applied for a refund, pending processing（买家已申请退款，待处理） |\n| `4` | Refund has been initiated, being processed by the system（退款已发起，系统处理中） |\n| `5` | Refund has been issued（退款已发放） |\n| `6` | Buyer has cancelled the after-sales request（买家已撤销售后申请） |\n| `7` | After-sales request has been rejected（售后申请已被拒绝） |\n| `9` | Refund initiated, being processed by the system（退款已发起，系统处理中） |\n\n### `afterSalesInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| afterSalesSn | STRING | After-sales order number（售后单号） |\n| parentOrderSn | STRING | Parent order number（父订单号） |\n| orderSn | STRING | Order number（子订单号） |\n| productSkuId | LONG | Product SKU ID |\n| applyGoodsNumber | LONG | Quantity requested for cancellation（申请取消数量） |\n| goodsId | LONG | Goods ID |\n| productList | OBJECT[] | Product information list（产品信息列表） |\n| createAtMillis | LONG | After-sales order creation time, unit in milliseconds（售后单创建时间，毫秒） |\n\n### `productList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| productSkuId | LONG | Product SKU ID |\n| extCode | STRING | Product external code（商品外部编码） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8\n }\n}'\n```\n\n可与 `linkfox-temu-order-us` 的 `bg.order.list.v2.get` / `bg.order.detail.v2.get` 配合：先查订单 `pending_buyer_cancellation` 标签，再按 `parentOrderSnList` 拉取消售后明细。\n\nFile v1.0.6:references/apis/temu-order-cancel-appeal-apply.md\n\n# 卖家发起取消申请 — `temu.order.cancel.appeal.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** Support merchants to initiate cancellation requests through the interface（支持商家通过接口发起取消申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `reason.proofUrlList` 中的图片须先经 **`temu.order.query.signature`** 转为 URL 后再传入（该接口待接入时可先用 `temu_us_proxy.py` 试调）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── cancelType (INTEGER, 是)\n ├── applyOrder (OBJECT, 是)\n │ └── parentOrderSn (STRING, 是)\n └── reason (OBJECT, 是)\n ├── description (STRING, 是)\n └── proofUrlList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| cancelType | INTEGER | **是** | The types of application for cancellation（取消申请类型），见下表 |\n| applyOrder | OBJECT | **是** | Details of the application to cancel the order（取消订单申请详情） |\n| reason | OBJECT | **是** | Explanation of Application Reasons（申请原因说明） |\n\n#### `cancelType`\n\n| 值 | 说明 |\n|----|------|\n| `2` | Suspected batch refund（疑似批量退款） |\n| `3` | Incorrect address（地址错误） |\n\n### `applyOrder`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | Parent order sn（父订单号） |\n\n### `reason`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| description | STRING | **是** | Explanation of the reason for cancellation initiated（发起取消的原因说明） |\n| proofUrlList | STRING[] | **是** | Related screenshots serve as supplementary evidence to illustrate the rationality of the application（相关截图作为补充证据，说明申请的合理性）；图片须先通过 **`temu.order.query.signature`** 转为 URL 后传入 |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Customer provided incorrect shipping address\",\n \"proofUrlList\": [\n \"https://signed-url-from-temu.order.query.signature/...\"\n ]\n }\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── applySn\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | apply sn（取消申请单号） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Incorrect address confirmed with buyer\",\n \"proofUrlList\": [\"https://signed-url/...\"]\n }\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) 查询 `status`。\n\nFile v1.0.6:references/apis/temu-order-cancel-appeal-result-get.md\n\n# 查询取消申请结果 — `temu.order.cancel.appeal.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Merchant queries the status of cancellation order appeal records（商家查询取消订单申诉记录的状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `applySnList` 中的申请单号通常来自 [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) 返回的 `result.applySn`。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n └── applySnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| applySnList | STRING[] | **是** | Apply sn list（取消申请单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── itemList[]\n ├── applySn\n └── status\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| itemList | OBJECT[] | result item list（取消申请结果列表） |\n\n### `itemList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | Apply sn（取消申请单号） |\n| status | INTEGER | Apply cancel status（取消申请状态），见下表 |\n\n#### `status`\n\n| 值 | 说明 |\n|----|------|\n| `1` | Auditing（审核中） |\n| `2` | Approved（已通过） |\n| `3` | Rejected（已拒绝） |\n| `4` | Apply failed（申请失败） |\n| `5` | Canceled（已取消） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → 本接口轮询 `status`（`1` 审核中 → `2` 通过 / `3` 拒绝 / `4` 失败 / `5` 已取消）→ 可用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.6:references/apis/temu-order-cancel-outofstock-apply.md\n\n# 缺货取消申请 — `temu.order.cancel.outofstock.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** The user takes the initiative to initiate a stock-out situation, which will be submitted to the risk control department for review（商家主动发起缺货情况，提交风控部门审核）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock apply request\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock apply response\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── applyResult\n └── failReasonList[]\n ├── parentOrderSn\n ├── orderSn\n └── reasonList[]\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | lack stock apply result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResult | BOOLEAN | lack stock apply result（缺货申请结果）：`true` = apply success（申请成功）；`false` = apply fail（申请失败） |\n| failReasonList | OBJECT[] | apply fail reason list（申请失败原因列表）；`applyResult=true` 时通常为空或不返回 |\n\n### `failReasonList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentOrderSn | STRING | parent order sn（父订单号） |\n| orderSn | STRING | order sn（子订单号） |\n| reasonList | STRING[] | apply fail reason code list（申请失败原因码列表） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`linkfox-temu-order-us` 查 `parentOrderSn` / `orderSn` → 本接口提交缺货取消申请（风控审核）→ 根据 `applyResult` 与 `failReasonList` 确认是否受理。\n\nFile v1.0.6:references/apis/temu-order-cancel-outofstock-result-get.md\n\n# 查询缺货取消审核结果 — `temu.order.cancel.outofstock.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** After applying for out-of-stock, since out-of-stock itself is an asynchronous operation, you need to obtain the latest out-of-stock review status through the query interface（提交缺货取消申请后，由于缺货本身是异步操作，需要通过本查询接口获取最新的缺货审核状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口，或与 [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) 提交时使用的参数一致。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock query request from ams\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock query response from ams\n├── success (BOOLEAN)\n├── errorCode (INTEGER)\n├── errorMsg (STRING)\n└── result (OBJECT) — Specific information\n └── applyResultInfoList[] (OBJECT[]) — lack stock order apply result info list\n ├── orderSn (STRING)\n └── applyStatus (INTEGER)\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success（请求是否成功） |\n| errorCode | INTEGER | error code（错误码） |\n| errorMsg | STRING | error message（错误信息） |\n| result | OBJECT | Specific information（具体结果信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResultInfoList | OBJECT[] | lack stock order apply result info list（缺货取消申请结果信息列表） |\n\n### `applyResultInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| orderSn | STRING | order sn（子订单号） |\n| applyStatus | INTEGER | lack stock apply status（缺货申请审核状态） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.outofstock.apply` 提交缺货取消申请（风控审核）→ 本接口查询 `applyStatus` 获取最新审核状态 → 根据状态决定后续操作。\n\nFile v1.0.6:references/authorization-flow.md\n\n# Temu 授权流程\n\n```text\n用户确认店铺类型与用途\n ↓\ntemu_token_guide.py（输出后台操作步骤）\n ↓\n用户在 Temu 卖家后台复制 access_token\n ↓\nsave_temu_access_token.py（可选，写入本地 store）\n ↓\ntemu_proxy.py / temu_file_download.py\n - 直接传 accessToken，或\n - 传 storeKey + site + managementType + tokenPurpose\n```\n\n## 决策表\n\n| 用户需求 | shopType | tokenPurpose | site |\n|----------|----------|--------------|------|\n| 半托管查商品/库存 | semi-managed | product-inventory | cn / partner |\n| 半托管查订单/发货 | semi-managed | order-shipping | us / global / eu |\n| 全托管任意接口 | full-managed | full-managed | cn / partner |\n| 美欧本土店 | local-native | local-native | us 等 |\n\n## 与 API 调用的对应关系\n\n紫鸟转发路径：`/temu-proxy/{site}/{managementType}`\n\n- 全托管 CN：`cn` + `full-managed`\n- 半托管商品：`cn`/`partner` + `semi-managed` + 商品 token\n- 半托管订单：`us`/`global`/`eu` + `semi-managed` + 订单 token\n\n授权应用名称必须与后台一致：**酷鸟卖家助手** 或 **Cyber-ERP酷鸟助手** / **Cyber-ERP**。\n\nArchive v1.0.5: 36 files, 50411 bytes\n\nFiles: references/access-token.md (4527b), references/api.md (4358b), references/apis/bg-aftersales-cancel-agree.md (2732b), references/apis/bg-aftersales-cancel-list-get.md (5811b), references/apis/README.md (953b), references/apis/temu-order-cancel-appeal-apply.md (3922b), references/apis/temu-order-cancel-appeal-result-get.md (2818b), references/apis/temu-order-cancel-outofstock-apply.md (3192b), references/apis/temu-order-cancel-outofstock-result-get.md (3393b), references/authorization-flow.md (1186b), references/onboarding.md (2046b), references/partner-us-catalog.md (2853b), scripts/_temu_auth_guide.py (6198b), scripts/_temu_common.py (12430b), scripts/_temu_token_store.py (4273b), scripts/_temu_us_common.py (3199b), scripts/_us_cancel_order_script.py (504b), scripts/check_linkfox_token.py (1797b), scripts/get_temu_access_token.py (1843b), scripts/list_temu_access_tokens.py (652b), scripts/onboarding.py (24089b), scripts/save_temu_access_token.py (1377b), scripts/temu_file_download.py (1681b), scripts/temu_proxy.py (2124b), scripts/temu_token_guide.py (1594b), scripts/temu_us_file_download.py (719b), scripts/temu_us_proxy.py (956b), scripts/us_cancel_aftersales_cancel_agree.py (260b), scripts/us_cancel_aftersales_cancel_list_get.py (281b), scripts/us_seller_cancel_order_cancel_appeal_apply.py (283b), scripts/us_seller_cancel_order_cancel_appeal_result_get.py (304b), scripts/us_seller_cancel_order_cancel_outofstock_apply.py (289b), scripts/us_seller_cancel_order_cancel_outofstock_result_get.py (316b), skill-card.md (3143b), SKILL.md (6136b), _meta.json (147b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-temu-cancel-order-us\ndescription: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。\n---\n\n# Temu 美国站 — 取消订单（买家 + 卖家）\n\n本 skill（`linkfox-temu-cancel-order-us`）覆盖 Partner Platform for US **取消订单**相关接口：\n\n- **买家/消费者**：`bg.aftersales.cancel.list.get`、`bg.aftersales.cancel.agree`\n- **店家/卖家**：`temu.order.cancel.appeal.apply`、`temu.order.cancel.appeal.result.get`、`temu.order.cancel.outofstock.apply`、`temu.order.cancel.outofstock.result.get`\n\n详见 [partner-us-catalog.md](./references/partner-us-catalog.md)（**6** 个接口）。\n\n**网关（本 skill 内置）**：\n\n| 能力 | 方法 | 路径 |\n|------|------|------|\n| 取消单 OpenAPI（`us_cancel_*`、`us_seller_cancel_*`、`temu_us_proxy`） | POST | `https://tool-gateway.linkfox.com/temu/proxy` |\n| 加签文件下载 | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` |\n\n## 相关 skill\n\n| 场景 | skill |\n|------|--------|\n| 订单列表/详情/发货/地址/金额 | `linkfox-temu-order-us` |\n| 欧洲站取消订单 | `linkfox-temu-cancel-order-eu` |\n| 全球站（非 US/EU）取消订单 | `linkfox-temu-cancel-order-global` |\n| 履约/发货 | `linkfox-temu-fulfillment-us` |\n| 商品管理 | `linkfox-temu-manage-product-us` |\n| 退货与退款 | `linkfox-temu-returns-refunds-us` |\n| 网关与 Temu token | 本 skill `scripts/` |\n\n## 调用方式\n\n- **API 端点**：`POST /temu/proxy`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/<脚本名>.py '' [--inline]`（可用脚本见上文脚本一览）\n- **成本约束**：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-temu-cancel-order-us-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 默认参数\n\n| 字段 | 默认 | 说明 |\n|------|------|------|\n| site | `us` | Partner US |\n| managementType | `semi-managed` | 半托管 |\n| tokenPurpose | `order-shipping` | 订单/取消场景 token |\n\n## 鉴权\n\n1. **LinkFox**：`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token`\n2. **Temu**：`accessToken` 或 `storeKey`（建议 `tokenPurpose=order-shipping`）\n\n## Scripts（按 type）\n\n### 买家取消\n\n| 脚本 | type |\n|------|------|\n| `us_cancel_aftersales_cancel_list_get.py` | `bg.aftersales.cancel.list.get` |\n| `us_cancel_aftersales_cancel_agree.py` | `bg.aftersales.cancel.agree` |\n\n### 卖家取消\n\n| 脚本 | type |\n|------|------|\n| `us_seller_cancel_order_cancel_appeal_apply.py` | `temu.order.cancel.appeal.apply` |\n| `us_seller_cancel_order_cancel_appeal_result_get.py` | `temu.order.cancel.appeal.result.get` |\n| `us_seller_cancel_order_cancel_outofstock_apply.py` | `temu.order.cancel.outofstock.apply` |\n| `us_seller_cancel_order_cancel_outofstock_result_get.py` | `temu.order.cancel.outofstock.result.get` |\n\n### 通用\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_us_proxy.py` | 任意 `type` |\n| `temu_us_file_download.py` | 加签文件下载 |\n\n## 接入新接口（约定）\n\n1. 新增 `references/apis/.md`\n2. 新增 `scripts/us_cancel_*` 或 `us_seller_cancel_*`（调用 `_us_cancel_order_script.run_cli`）\n3. 更新 [partner-us-catalog.md](./references/partner-us-catalog.md)、[apis/README.md](./references/apis/README.md)\n\n## 示例\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\n\n# 买家取消 — 待处理列表\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": { \"pageNo\": 1, \"pageSize\": 20, \"afterSalesStatusGroup\": 8 }\n}'\n\n# 卖家 — 缺货取消申请\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n**Feedback：** `skillName`：`linkfox-temu-cancel-order-us`\n\n## 网关与授权脚本\n\n| 脚本 | 说明 |\n|------|------|\n| `check_linkfox_token.py` | 校验 LinkFox Token |\n| `save_temu_access_token.py` / `list_temu_access_tokens.py` / `get_temu_access_token.py` | 本地 token |\n| `temu_token_guide.py` | Temu 授权指引 |\n\n授权说明：[references/access-token.md](./references/access-token.md)\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.5:references/apis/README.md\n\n# Cancel Order — 接口文档索引\n\n每个 `type` 单独一份文档，经 `POST /temu/proxy` 调用。\n\n## 买家/消费者取消（2）\n\n| type | 文档 |\n|------|------|\n| `bg.aftersales.cancel.list.get` | [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) |\n| `bg.aftersales.cancel.agree` | [bg-aftersales-cancel-agree.md](./bg-aftersales-cancel-agree.md) |\n\n## 卖家/店家取消（4）\n\n| type | 文档 |\n|------|------|\n| `temu.order.cancel.appeal.apply` | [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) |\n| `temu.order.cancel.appeal.result.get` | [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) |\n| `temu.order.cancel.outofstock.apply` | [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) |\n| `temu.order.cancel.outofstock.result.get` | [temu-order-cancel-outofstock-result-get.md](./temu-order-cancel-outofstock-result-get.md) |\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-cancel-order-us\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1786101227747\n}\n\nFile v1.0.5:references/access-token.md\n\n# Temu accessToken 授权与获取\n\nTemu **没有** LinkFox 侧自动 OAuth；`accessToken` 须在 Temu 卖家后台「服务市场 → 授权管理」**手动复制**。与 `LINKFOXAGENT_API_KEY`（LinkFox 用户鉴权）是两套令牌。\n\n## 两种鉴权（勿混淆）\n\n| 令牌 | 用途 | 获取方式 |\n|------|------|----------|\n| **LinkFox 用户 Token** | 调用 `/temu/proxy`、`/temu/fileDownload` **必填** | `LINKFOXAGENT_API_KEY` 或请求 JSON 的 `token`；Header `Authorization` + `Token`（同 amazon-store-auth）（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\n| **Temu accessToken** | Temu 业务 API（经紫鸟转发） | Temu 卖家后台授权后复制 |\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/check_linkfox_token.py\n```\n\n## tokenPurpose 与场景\n\n| tokenPurpose | 店铺类型 | 推荐 site | 授权应用 |\n|--------------|----------|-----------|----------|\n| `product-inventory` | 半托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `order-shipping` | 半托管 | `us` / `global` / `eu` | Cyber-ERP酷鸟助手 |\n| `full-managed` | 全托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `local-native` | 本土（美/欧主体） | `us` 等 | Cyber-ERP |\n\n## 1. 半托管 — 商品/库存 Token\n\n1. 登录 [seller.kuajingmaihuo.com](https://seller.kuajingmaihuo.com) 或 [agentseller.temu.com](https://agentseller.temu.com)\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → 选择 **「酷鸟卖家助手」**\n4. 全选常规和特殊授权 → 确认 → **复制 access_token**\n5. 调用 API：`site=cn` 或 `partner`，`managementType=semi-managed`\n\n## 2. 半托管 — 订单/发货 Token\n\n1. 登录 Temu 卖家后台\n2. 右上角 **Seller Central** → 切换到目标区域（美区 / 欧区 / 全球）\n3. **服务市场** → **授权管理**\n4. **获取授权** → 选择 **「Cyber-ERP酷鸟助手」**\n5. 全选授权 → 确认 → 复制 token\n6. 调用 API：`site=us` / `global` / `eu`，`managementType=semi-managed`\n\n## 3. 全托管店铺\n\n1. 登录 Temu 平台\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → **「酷鸟卖家助手」** → 全选 → 复制 token\n4. 调用 API：`managementType=full-managed`，`site` 通常 `cn` 或 `partner`\n\n## 4. 本土店铺（美区、欧区主体）\n\n1. 登录 Temu\n2. **Apps And Services** → **Manage Your Apps**\n3. **Authorize a new app** → 搜索 **「Cyber-ERP」**\n4. 一般权限与敏感权限全选 → 确认 → 复制 token\n\n## 站点与 OpenAPI 网关\n\n| site | 说明 | Temu 网关 |\n|------|------|-----------|\n| cn | 中国站 | openapi.kuajingmaihuo.com |\n| partner | Partner 网关 | openapi-b-partner.temu.com |\n| us | 美国站 | openapi-b-us.temu.com |\n| global | 全球区 | openapi-b-global.temu.com |\n| eu | 欧洲站 | openapi-b-eu.temu.com |\n\n## 本地保存 Token（推荐）\n\n默认存储：`~/.linkfox/temu-access-tokens.json`（可用 `TEMU_TOKEN_STORE_PATH` 覆盖）。\n\n```bash\n# 查看授权步骤\npython scripts/temu_token_guide.py '{\"shopType\":\"semi-managed\",\"tokenPurpose\":\"product-inventory\",\"site\":\"cn\"}'\n\n# 保存 token\npython scripts/save_temu_access_token.py '{\n \"storeKey\": \"my-shop\",\n \"label\": \"中国半托管\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"accessToken\": \"PASTE_TOKEN\"\n}'\n\n# 列出已保存（脱敏）\npython scripts/list_temu_access_tokens.py\n\n# 用 storeKey 调 API（无需每次粘贴 token）\npython scripts/temu_proxy.py '{\n \"storeKey\": \"my-shop\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"type\": \"bg.goods.category.mapping\",\n \"params\": {\"goodsName\": \"测试\", \"goodsNameEn\": \"Test\"}\n}'\n```\n\n## 注意事项\n\n1. **子账号**：可能无法进入服务市场，需主账号授权。\n2. **多站点**：美国站、英国站等需分别登录对应后台获取 Token。\n3. **有效期**：Token 会过期，过期后重新在后台复制并 `save_temu_access_token.py`。\n4. **IP 白名单**：需联系紫鸟开放平台配置调用 IP。\n5. **参数小写**：`site`、`managementType` 必须小写。\n\n## 脚本一览\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_token_guide.py` | 按店铺类型/用途输出授权步骤 |\n| `save_temu_access_token.py` | 保存 accessToken 到本地 |\n| `list_temu_access_tokens.py` | 列出已保存 token（默认脱敏）|\n| `get_temu_access_token.py` | 读取指定 store 的 token |\n\nFile v1.0.5:references/api.md\n\n# linkfox-temu-cancel-order-us — API 参考\r\n\r\nTemu **美国站取消订单**（买家取消 + 卖家取消）（Partner US **Cancel Order** — 买家 `bg.aftersales.cancel.*` + 卖家 `temu.order.cancel.*`），经本 skill `temu_us_proxy`（`POST /temu/proxy`） 转发。Temu 的 `type` 写在 Body，**不是** URL 路径。\r\n\r\n> 网关与鉴权：本 skill `scripts/`（`LINKFOXAGENT_API_KEY`、`accessToken` / `storeKey`）。建议 token 见 `references/access-token.md`（`tokenPurpose=order-shipping`）。\r\n\r\n---\r\n\r\n## 调用规范\r\n\r\n| 项 | 说明 |\r\n|----|------|\r\n| 网关根地址 | `${LINKFOX_TOOL_GATEWAY}`（可用 `LINKFOX_TOOL_GATEWAY` / `TEMU_API_BASE_URL` / `STORE_API_BASE_URL` 覆盖） |\r\n| 卖家取消单 OpenAPI | `POST /temu/proxy` |\r\n| 加签文件下载 | `POST /temu/fileDownload`（`temu_us_file_download.py`） |\r\n| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**（同值）；或 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`；或 JSON `token`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\r\n| Temu 鉴权 | Body `accessToken`，或 `storeKey` + `site` + `managementType` + `tokenPurpose` |\r\n| 默认 | `site=us`，`managementType=semi-managed`，`tokenPurpose=order-shipping` |\r\n| 上游 OpenAPI（US） | `https://openapi-b-us.temu.com/openapi/router`（网关按 `site` 解析） |\r\n\r\n### 网关请求 Body（`/temu/proxy`）\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| site | string | 是 | `us`（本 skill 默认） |\r\n| managementType | string | 是 | `semi-managed` |\r\n| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌 |\r\n| storeKey | string | 与 accessToken 二选一 | `~/.linkfox/temu-access-tokens.json` 中的键 |\r\n| tokenPurpose | string | 否 | 建议 **`order-shipping`** |\r\n| type | string | 是 | Temu 接口名，如 Partner 文档中的 `bg.*` / `temu.*` |\r\n| params | object | 否 | 业务参数；多数接口业务块在 **`params.request`** |\r\n\r\n### 网关响应\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| body | string | Temu 原始 JSON 字符串；脚本解析为 `temuBody` |\r\n| code | integer | 网关错误码：`1002` 参数/Token，`1003` 转发失败 |\r\n\r\n解析顺序：**网关 `code`** → `JSON.parse(body)` → `success` / `errorCode` / `errorMsg` / `result`。\r\n\r\n### 脚本调用\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\npython scripts/temu_us_proxy.py '{\"accessToken\":\"TOKEN\",\"tokenPurpose\":\"order-shipping\",\"type\":\"\",\"params\":{\"request\":{}}}'\r\n```\r\n\r\n业务字段可放在顶层或嵌套 `params`；含 `request` 时通常整体作为 `params` 转发。\r\n\r\n---\r\n\r\n## 接口一览\r\n\r\n完整 `sub_menu_code` 与 Partner 文档 URL 见 [partner-us-catalog.md](./partner-us-catalog.md)。\r\n\r\n**每个接口单独一份文档**：[apis/README.md](./apis/README.md)（随接入递增）。\r\n\r\n> 已接入接口见 [apis/README.md](./apis/README.md)。\r\n\r\n---\r\n\r\n## 典型买家取消流程\r\n\r\n```text\r\n1. bg.aftersales.cancel.list.get（本 skill） → 查待处理买家取消售后（afterSalesStatusGroup=8 等）\r\n2. bg.aftersales.cancel.agree（本 skill） → 同意取消（parentAfterSalesSn + parentOrderSn）\r\n3. linkfox-temu-order-us → 刷新订单状态\r\n```\r\n\r\n## 典型卖家取消流程\r\n\r\n```text\r\n1. linkfox-temu-order-us → 查订单 parentOrderSn / orderSn、发货状态\r\n2a. temu.order.cancel.appeal.apply（本 skill） → 申诉类取消申请，返回 applySn\r\n2b. temu.order.cancel.outofstock.apply（本 skill） → 缺货取消申请（提交风控），返回 applyResult\r\n3. temu.order.cancel.appeal.result.get（本 skill） → 按 applySnList 查询申诉 status\r\n4. linkfox-temu-order-us → 取消后刷新订单状态（list/detail）\r\n```\r\n\r\n---\r\n\r\n## 网关错误码\r\n\r\n| code | 说明 | 处理 |\r\n|------|------|------|\r\n| 1002 | 参数或 LinkFox Token 无效 | 修正参数与 `LINKFOXAGENT_API_KEY` |\r\n| 1003 | 转发失败 | 检查 Temu token、`tokenPurpose`、白名单、网络 |\r\n| 402 | HTTP 402 | 按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- `skillName`: **`linkfox-temu-cancel-order-us`**\n\nFile v1.0.5:references/apis/bg-aftersales-cancel-agree.md\n\n# 同意取消订单 — `bg.aftersales.cancel.agree`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_agree.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.agree`，业务载荷放在 Body 的 `params` |\n\n**Description:** Agree cancel order（同意买家发起的取消订单申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentAfterSalesSn`、`parentOrderSn` 通常来自 [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) 列表接口返回（`afterSalesStatusGroup=8` 待处理）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── parentAfterSalesSn (STRING, 是)\n └── parentOrderSn (STRING, 是)\n```\n\n### `request` 内字段\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentAfterSalesSn | STRING | **是** | Parent after-sales order number（父售后单号），**不能为空** |\n| parentOrderSn | STRING | **是** | Parent order number（父订单号），**不能为空** |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── result (OBJECT)\n├── success\n├── errorCode\n└── errorMsg\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| result | OBJECT | Empty field（官方未展开子字段；成功时通常为空对象） |\n| success | BOOLEAN | Whether it was successful or not（是否成功） |\n| errorCode | INTEGER | Error code（错误码） |\n| errorMsg | STRING | Error message（错误信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| _(无子字段)_ | — | Partner 文档标注为 Empty field；若实际响应含其它字段，以 Temu 返回 JSON 为准 |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_agree.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}'\n```\n\n典型流程：`bg.aftersales.cancel.list.get`（`afterSalesStatusGroup=8`）取得 `parentAfterSalesSn` + `parentOrderSn` → 本接口**同意取消** → 可再查列表确认状态变为已同意（`9`）或用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.5:references/apis/bg-aftersales-cancel-list-get.md\n\n# 取消订单售后列表查询 — `bg.aftersales.cancel.list.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_list_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.list.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Query cancel order after-sales information（查询取消订单售后信息）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── pageSize (INTEGER, 否)\n ├── pageNo (INTEGER, 否)\n ├── parentOrderSnList[] (STRING[], 否)\n ├── parentAfterSalesSnList[] (STRING[], 否)\n └── afterSalesStatusGroup (INTEGER, 否)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pageSize | INTEGER | 否 | Page size for pagination，**默认 10**，**最大 200** |\n| pageNo | INTEGER | 否 | Page number for pagination，**默认 1** |\n| parentOrderSnList | STRING[] | 否 | Parent order number list；留空则不限制父订单号范围；**单次查询最多 200 条** |\n| parentAfterSalesSnList | STRING[] | 否 | Parent after-sales order number list；留空则不限制父售后单号范围；**单次查询最多 200 条** |\n| afterSalesStatusGroup | INTEGER | 否 | The cancel order after-sales status group（取消订单售后状态组），见下表 |\n\n#### `afterSalesStatusGroup`（入参筛选）\n\n| 值 | 说明 |\n|----|------|\n| `8` | Cancel order pending（取消订单待处理） |\n| `9` | Cancel order approved（取消订单已同意） |\n| `10` | Cancel order rejected（取消订单已拒绝） |\n| `11` | Cancel order revoked（取消订单已撤销） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8,\n \"parentOrderSnList\": [\"PO-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── total\n ├── pageNumber\n └── data[]\n ├── parentAfterSalesSn\n ├── parentAfterSalesStatus\n └── afterSalesInfoList[]\n ├── afterSalesSn\n ├── parentOrderSn\n ├── orderSn\n ├── productSkuId\n ├── applyGoodsNumber\n ├── goodsId\n ├── productList[]\n │ ├── productSkuId\n │ └── extCode\n └── createAtMillis\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Specific information |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| total | LONG | Total number of matching records（匹配记录总数） |\n| pageNumber | INTEGER | Current page number of the result（当前结果页码） |\n| data | OBJECT[] | The record data returned from this query（本次查询返回的记录） |\n\n> 入参分页字段为 **`pageNo`**，出参当前页为 **`pageNumber`**，勿混用。\n\n### `data[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentAfterSalesSn | STRING | Parent after-sales order number for the canceled order（取消订单的父售后单号） |\n| parentAfterSalesStatus | INTEGER | Current parent after-sales status（当前父售后状态），见下表 |\n| afterSalesInfoList | OBJECT[] | Cancel order after-sales information list（取消订单售后信息列表） |\n\n#### `parentAfterSalesStatus`（出参）\n\n| 值 | 说明 |\n|----|------|\n| `1` | Buyer has applied for a refund, pending processing（买家已申请退款，待处理） |\n| `4` | Refund has been initiated, being processed by the system（退款已发起，系统处理中） |\n| `5` | Refund has been issued（退款已发放） |\n| `6` | Buyer has cancelled the after-sales request（买家已撤销售后申请） |\n| `7` | After-sales request has been rejected（售后申请已被拒绝） |\n| `9` | Refund initiated, being processed by the system（退款已发起，系统处理中） |\n\n### `afterSalesInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| afterSalesSn | STRING | After-sales order number（售后单号） |\n| parentOrderSn | STRING | Parent order number（父订单号） |\n| orderSn | STRING | Order number（子订单号） |\n| productSkuId | LONG | Product SKU ID |\n| applyGoodsNumber | LONG | Quantity requested for cancellation（申请取消数量） |\n| goodsId | LONG | Goods ID |\n| productList | OBJECT[] | Product information list（产品信息列表） |\n| createAtMillis | LONG | After-sales order creation time, unit in milliseconds（售后单创建时间，毫秒） |\n\n### `productList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| productSkuId | LONG | Product SKU ID |\n| extCode | STRING | Product external code（商品外部编码） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8\n }\n}'\n```\n\n可与 `linkfox-temu-order-us` 的 `bg.order.list.v2.get` / `bg.order.detail.v2.get` 配合：先查订单 `pending_buyer_cancellation` 标签，再按 `parentOrderSnList` 拉取消售后明细。\n\nFile v1.0.5:references/apis/temu-order-cancel-appeal-apply.md\n\n# 卖家发起取消申请 — `temu.order.cancel.appeal.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** Support merchants to initiate cancellation requests through the interface（支持商家通过接口发起取消申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `reason.proofUrlList` 中的图片须先经 **`temu.order.query.signature`** 转为 URL 后再传入（该接口待接入时可先用 `temu_us_proxy.py` 试调）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── cancelType (INTEGER, 是)\n ├── applyOrder (OBJECT, 是)\n │ └── parentOrderSn (STRING, 是)\n └── reason (OBJECT, 是)\n ├── description (STRING, 是)\n └── proofUrlList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| cancelType | INTEGER | **是** | The types of application for cancellation（取消申请类型），见下表 |\n| applyOrder | OBJECT | **是** | Details of the application to cancel the order（取消订单申请详情） |\n| reason | OBJECT | **是** | Explanation of Application Reasons（申请原因说明） |\n\n#### `cancelType`\n\n| 值 | 说明 |\n|----|------|\n| `2` | Suspected batch refund（疑似批量退款） |\n| `3` | Incorrect address（地址错误） |\n\n### `applyOrder`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | Parent order sn（父订单号） |\n\n### `reason`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| description | STRING | **是** | Explanation of the reason for cancellation initiated（发起取消的原因说明） |\n| proofUrlList | STRING[] | **是** | Related screenshots serve as supplementary evidence to illustrate the rationality of the application（相关截图作为补充证据，说明申请的合理性）；图片须先通过 **`temu.order.query.signature`** 转为 URL 后传入 |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Customer provided incorrect shipping address\",\n \"proofUrlList\": [\n \"https://signed-url-from-temu.order.query.signature/...\"\n ]\n }\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── applySn\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | apply sn（取消申请单号） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Incorrect address confirmed with buyer\",\n \"proofUrlList\": [\"https://signed-url/...\"]\n }\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) 查询 `status`。\n\nFile v1.0.5:references/apis/temu-order-cancel-appeal-result-get.md\n\n# 查询取消申请结果 — `temu.order.cancel.appeal.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Merchant queries the status of cancellation order appeal records（商家查询取消订单申诉记录的状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `applySnList` 中的申请单号通常来自 [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) 返回的 `result.applySn`。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n └── applySnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| applySnList | STRING[] | **是** | Apply sn list（取消申请单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── itemList[]\n ├── applySn\n └── status\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| itemList | OBJECT[] | result item list（取消申请结果列表） |\n\n### `itemList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | Apply sn（取消申请单号） |\n| status | INTEGER | Apply cancel status（取消申请状态），见下表 |\n\n#### `status`\n\n| 值 | 说明 |\n|----|------|\n| `1` | Auditing（审核中） |\n| `2` | Approved（已通过） |\n| `3` | Rejected（已拒绝） |\n| `4` | Apply failed（申请失败） |\n| `5` | Canceled（已取消） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → 本接口轮询 `status`（`1` 审核中 → `2` 通过 / `3` 拒绝 / `4` 失败 / `5` 已取消）→ 可用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.5:references/apis/temu-order-cancel-outofstock-apply.md\n\n# 缺货取消申请 — `temu.order.cancel.outofstock.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** The user takes the initiative to initiate a stock-out situation, which will be submitted to the risk control department for review（商家主动发起缺货情况，提交风控部门审核）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock apply request\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock apply response\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── applyResult\n └── failReasonList[]\n ├── parentOrderSn\n ├── orderSn\n └── reasonList[]\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | lack stock apply result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResult | BOOLEAN | lack stock apply result（缺货申请结果）：`true` = apply success（申请成功）；`false` = apply fail（申请失败） |\n| failReasonList | OBJECT[] | apply fail reason list（申请失败原因列表）；`applyResult=true` 时通常为空或不返回 |\n\n### `failReasonList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentOrderSn | STRING | parent order sn（父订单号） |\n| orderSn | STRING | order sn（子订单号） |\n| reasonList | STRING[] | apply fail reason code list（申请失败原因码列表） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`linkfox-temu-order-us` 查 `parentOrderSn` / `orderSn` → 本接口提交缺货取消申请（风控审核）→ 根据 `applyResult` 与 `failReasonList` 确认是否受理。\n\nFile v1.0.5:references/apis/temu-order-cancel-outofstock-result-get.md\n\n# 查询缺货取消审核结果 — `temu.order.cancel.outofstock.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** After applying for out-of-stock, since out-of-stock itself is an asynchronous operation, you need to obtain the latest out-of-stock review status through the query interface（提交缺货取消申请后，由于缺货本身是异步操作，需要通过本查询接口获取最新的缺货审核状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口，或与 [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) 提交时使用的参数一致。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock query request from ams\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock query response from ams\n├── success (BOOLEAN)\n├── errorCode (INTEGER)\n├── errorMsg (STRING)\n└── result (OBJECT) — Specific information\n └── applyResultInfoList[] (OBJECT[]) — lack stock order apply result info list\n ├── orderSn (STRING)\n └── applyStatus (INTEGER)\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success（请求是否成功） |\n| errorCode | INTEGER | error code（错误码） |\n| errorMsg | STRING | error message（错误信息） |\n| result | OBJECT | Specific information（具体结果信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResultInfoList | OBJECT[] | lack stock order apply result info list（缺货取消申请结果信息列表） |\n\n### `applyResultInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| orderSn | STRING | order sn（子订单号） |\n| applyStatus | INTEGER | lack stock apply status（缺货申请审核状态） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.outofstock.apply` 提交缺货取消申请（风控审核）→ 本接口查询 `applyStatus` 获取最新审核状态 → 根据状态决定后续操作。\n\nFile v1.0.5:references/authorization-flow.md\n\n# Temu 授权流程\n\n```text\n用户确认店铺类型与用途\n ↓\ntemu_token_guide.py（输出后台操作步骤）\n ↓\n用户在 Temu 卖家后台复制 access_token\n ↓\nsave_temu_access_token.py（可选，写入本地 store）\n ↓\ntemu_proxy.py / temu_file_download.py\n - 直接传 accessToken，或\n - 传 storeKey + site + managementType + tokenPurpose\n```\n\n## 决策表\n\n| 用户需求 | shopType | tokenPurpose | site |\n|----------|----------|--------------|------|\n| 半托管查商品/库存 | semi-managed | product-inventory | cn / partner |\n| 半托管查订单/发货 | semi-managed | order-shipping | us / global / eu |\n| 全托管任意接口 | full-managed | full-managed | cn / partner |\n| 美欧本土店 | local-native | local-native | us 等 |\n\n## 与 API 调用的对应关系\n\n紫鸟转发路径：`/temu-proxy/{site}/{managementType}`\n\n- 全托管 CN：`cn` + `full-managed`\n- 半托管商品：`cn`/`partner` + `semi-managed` + 商品 token\n- 半托管订单：`us`/`global`/`eu` + `semi-managed` + 订单 token\n\n授权应用名称必须与后台一致：**酷鸟卖家助手** 或 **Cyber-ERP酷鸟助手** / **Cyber-ERP**。\n\nArchive v1.0.4: 34 files, 41435 bytes\n\nFiles: references/access-token.md (4527b), references/api.md (4358b), references/apis/bg-aftersales-cancel-agree.md (2732b), references/apis/bg-aftersales-cancel-list-get.md (5811b), references/apis/README.md (953b), references/apis/temu-order-cancel-appeal-apply.md (3922b), references/apis/temu-order-cancel-appeal-result-get.md (2818b), references/apis/temu-order-cancel-outofstock-apply.md (3192b), references/apis/temu-order-cancel-outofstock-result-get.md (3393b), references/authorization-flow.md (1186b), references/partner-us-catalog.md (2853b), scripts/_temu_auth_guide.py (6198b), scripts/_temu_common.py (12430b), scripts/_temu_token_store.py (4273b), scripts/_temu_us_common.py (3199b), scripts/_us_cancel_order_script.py (504b), scripts/check_linkfox_token.py (1797b), scripts/get_temu_access_token.py (1843b), scripts/list_temu_access_tokens.py (652b), scripts/save_temu_access_token.py (1377b), scripts/temu_file_download.py (1681b), scripts/temu_proxy.py (2124b), scripts/temu_token_guide.py (1594b), scripts/temu_us_file_download.py (719b), scripts/temu_us_proxy.py (956b), scripts/us_cancel_aftersales_cancel_agree.py (260b), scripts/us_cancel_aftersales_cancel_list_get.py (281b), scripts/us_seller_cancel_order_cancel_appeal_apply.py (283b), scripts/us_seller_cancel_order_cancel_appeal_result_get.py (304b), scripts/us_seller_cancel_order_cancel_outofstock_apply.py (289b), scripts/us_seller_cancel_order_cancel_outofstock_result_get.py (316b), skill-card.md (3082b), SKILL.md (6753b), _meta.json (147b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-temu-cancel-order-us\ndescription: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。\n---\n\n# Temu 美国站 — 取消订单（买家 + 卖家）\n\n本 skill（`linkfox-temu-cancel-order-us`）覆盖 Partner Platform for US **取消订单**相关接口：\n\n- **买家/消费者**：`bg.aftersales.cancel.list.get`、`bg.aftersales.cancel.agree`\n- **店家/卖家**：`temu.order.cancel.appeal.apply`、`temu.order.cancel.appeal.result.get`、`temu.order.cancel.outofstock.apply`、`temu.order.cancel.outofstock.result.get`\n\n详见 [partner-us-catalog.md](./references/partner-us-catalog.md)（**6** 个接口）。\n\n**网关（本 skill 内置）**：\n\n| 能力 | 方法 | 路径 |\n|------|------|------|\n| 取消单 OpenAPI（`us_cancel_*`、`us_seller_cancel_*`、`temu_us_proxy`） | POST | `https://tool-gateway.linkfox.com/temu/proxy` |\n| 加签文件下载 | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` |\n\n## 相关 skill\n\n| 场景 | skill |\n|------|--------|\n| 订单列表/详情/发货/地址/金额 | `linkfox-temu-order-us` |\n| 欧洲站取消订单 | `linkfox-temu-cancel-order-eu` |\n| 全球站（非 US/EU）取消订单 | `linkfox-temu-cancel-order-global` |\n| 履约/发货 | `linkfox-temu-fulfillment-us` |\n| 商品管理 | `linkfox-temu-manage-product-us` |\n| 退货与退款 | `linkfox-temu-returns-refunds-us` |\n| 网关与 Temu token | 本 skill `scripts/` |\n\n## 调用方式\n\n- **API 端点**：`POST /temu/proxy`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/<脚本名>.py '' [--inline]`（可用脚本见上文脚本一览）\n- **成本约束**：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-temu-cancel-order-us-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。\n- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。\n\n## 默认参数\n\n| 字段 | 默认 | 说明 |\n|------|------|------|\n| site | `us` | Partner US |\n| managementType | `semi-managed` | 半托管 |\n| tokenPurpose | `order-shipping` | 订单/取消场景 token |\n\n## 鉴权\n\n1. **LinkFox**：`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token`\n2. **Temu**：`accessToken` 或 `storeKey`（建议 `tokenPurpose=order-shipping`）\n\n## Scripts（按 type）\n\n### 买家取消\n\n| 脚本 | type |\n|------|------|\n| `us_cancel_aftersales_cancel_list_get.py` | `bg.aftersales.cancel.list.get` |\n| `us_cancel_aftersales_cancel_agree.py` | `bg.aftersales.cancel.agree` |\n\n### 卖家取消\n\n| 脚本 | type |\n|------|------|\n| `us_seller_cancel_order_cancel_appeal_apply.py` | `temu.order.cancel.appeal.apply` |\n| `us_seller_cancel_order_cancel_appeal_result_get.py` | `temu.order.cancel.appeal.result.get` |\n| `us_seller_cancel_order_cancel_outofstock_apply.py` | `temu.order.cancel.outofstock.apply` |\n| `us_seller_cancel_order_cancel_outofstock_result_get.py` | `temu.order.cancel.outofstock.result.get` |\n\n### 通用\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_us_proxy.py` | 任意 `type` |\n| `temu_us_file_download.py` | 加签文件下载 |\n\n## 接入新接口（约定）\n\n1. 新增 `references/apis/.md`\n2. 新增 `scripts/us_cancel_*` 或 `us_seller_cancel_*`（调用 `_us_cancel_order_script.run_cli`）\n3. 更新 [partner-us-catalog.md](./references/partner-us-catalog.md)、[apis/README.md](./references/apis/README.md)\n\n## 示例\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\n\n# 买家取消 — 待处理列表\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": { \"pageNo\": 1, \"pageSize\": 20, \"afterSalesStatusGroup\": 8 }\n}'\n\n# 卖家 — 缺货取消申请\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n**Feedback：** `skillName`：`linkfox-temu-cancel-order-us`\n\n## 网关与授权脚本\n\n| 脚本 | 说明 |\n|------|------|\n| `check_linkfox_token.py` | 校验 LinkFox Token |\n| `save_temu_access_token.py` / `list_temu_access_tokens.py` / `get_temu_access_token.py` | 本地 token |\n| `temu_token_guide.py` | Temu 授权指引 |\n\n授权说明：[references/access-token.md](./references/access-token.md)\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.4:references/apis/README.md\n\n# Cancel Order — 接口文档索引\n\n每个 `type` 单独一份文档，经 `POST /temu/proxy` 调用。\n\n## 买家/消费者取消（2）\n\n| type | 文档 |\n|------|------|\n| `bg.aftersales.cancel.list.get` | [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) |\n| `bg.aftersales.cancel.agree` | [bg-aftersales-cancel-agree.md](./bg-aftersales-cancel-agree.md) |\n\n## 卖家/店家取消（4）\n\n| type | 文档 |\n|------|------|\n| `temu.order.cancel.appeal.apply` | [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) |\n| `temu.order.cancel.appeal.result.get` | [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) |\n| `temu.order.cancel.outofstock.apply` | [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) |\n| `temu.order.cancel.outofstock.result.get` | [temu-order-cancel-outofstock-result-get.md](./temu-order-cancel-outofstock-result-get.md) |\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-cancel-order-us\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1783945855076\n}\n\nFile v1.0.4:references/access-token.md\n\n# Temu accessToken 授权与获取\n\nTemu **没有** LinkFox 侧自动 OAuth；`accessToken` 须在 Temu 卖家后台「服务市场 → 授权管理」**手动复制**。与 `LINKFOXAGENT_API_KEY`（LinkFox 用户鉴权）是两套令牌。\n\n## 两种鉴权（勿混淆）\n\n| 令牌 | 用途 | 获取方式 |\n|------|------|----------|\n| **LinkFox 用户 Token** | 调用 `/temu/proxy`、`/temu/fileDownload` **必填** | `LINKFOXAGENT_API_KEY` 或请求 JSON 的 `token`；Header `Authorization` + `Token`（同 amazon-store-auth）（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\n| **Temu accessToken** | Temu 业务 API（经紫鸟转发） | Temu 卖家后台授权后复制 |\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/check_linkfox_token.py\n```\n\n## tokenPurpose 与场景\n\n| tokenPurpose | 店铺类型 | 推荐 site | 授权应用 |\n|--------------|----------|-----------|----------|\n| `product-inventory` | 半托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `order-shipping` | 半托管 | `us` / `global` / `eu` | Cyber-ERP酷鸟助手 |\n| `full-managed` | 全托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `local-native` | 本土（美/欧主体） | `us` 等 | Cyber-ERP |\n\n## 1. 半托管 — 商品/库存 Token\n\n1. 登录 [seller.kuajingmaihuo.com](https://seller.kuajingmaihuo.com) 或 [agentseller.temu.com](https://agentseller.temu.com)\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → 选择 **「酷鸟卖家助手」**\n4. 全选常规和特殊授权 → 确认 → **复制 access_token**\n5. 调用 API：`site=cn` 或 `partner`，`managementType=semi-managed`\n\n## 2. 半托管 — 订单/发货 Token\n\n1. 登录 Temu 卖家后台\n2. 右上角 **Seller Central** → 切换到目标区域（美区 / 欧区 / 全球）\n3. **服务市场** → **授权管理**\n4. **获取授权** → 选择 **「Cyber-ERP酷鸟助手」**\n5. 全选授权 → 确认 → 复制 token\n6. 调用 API：`site=us` / `global` / `eu`，`managementType=semi-managed`\n\n## 3. 全托管店铺\n\n1. 登录 Temu 平台\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → **「酷鸟卖家助手」** → 全选 → 复制 token\n4. 调用 API：`managementType=full-managed`，`site` 通常 `cn` 或 `partner`\n\n## 4. 本土店铺（美区、欧区主体）\n\n1. 登录 Temu\n2. **Apps And Services** → **Manage Your Apps**\n3. **Authorize a new app** → 搜索 **「Cyber-ERP」**\n4. 一般权限与敏感权限全选 → 确认 → 复制 token\n\n## 站点与 OpenAPI 网关\n\n| site | 说明 | Temu 网关 |\n|------|------|-----------|\n| cn | 中国站 | openapi.kuajingmaihuo.com |\n| partner | Partner 网关 | openapi-b-partner.temu.com |\n| us | 美国站 | openapi-b-us.temu.com |\n| global | 全球区 | openapi-b-global.temu.com |\n| eu | 欧洲站 | openapi-b-eu.temu.com |\n\n## 本地保存 Token（推荐）\n\n默认存储：`~/.linkfox/temu-access-tokens.json`（可用 `TEMU_TOKEN_STORE_PATH` 覆盖）。\n\n```bash\n# 查看授权步骤\npython scripts/temu_token_guide.py '{\"shopType\":\"semi-managed\",\"tokenPurpose\":\"product-inventory\",\"site\":\"cn\"}'\n\n# 保存 token\npython scripts/save_temu_access_token.py '{\n \"storeKey\": \"my-shop\",\n \"label\": \"中国半托管\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"accessToken\": \"PASTE_TOKEN\"\n}'\n\n# 列出已保存（脱敏）\npython scripts/list_temu_access_tokens.py\n\n# 用 storeKey 调 API（无需每次粘贴 token）\npython scripts/temu_proxy.py '{\n \"storeKey\": \"my-shop\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"type\": \"bg.goods.category.mapping\",\n \"params\": {\"goodsName\": \"测试\", \"goodsNameEn\": \"Test\"}\n}'\n```\n\n## 注意事项\n\n1. **子账号**：可能无法进入服务市场，需主账号授权。\n2. **多站点**：美国站、英国站等需分别登录对应后台获取 Token。\n3. **有效期**：Token 会过期，过期后重新在后台复制并 `save_temu_access_token.py`。\n4. **IP 白名单**：需联系紫鸟开放平台配置调用 IP。\n5. **参数小写**：`site`、`managementType` 必须小写。\n\n## 脚本一览\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_token_guide.py` | 按店铺类型/用途输出授权步骤 |\n| `save_temu_access_token.py` | 保存 accessToken 到本地 |\n| `list_temu_access_tokens.py` | 列出已保存 token（默认脱敏）|\n| `get_temu_access_token.py` | 读取指定 store 的 token |\n\nFile v1.0.4:references/api.md\n\n# linkfox-temu-cancel-order-us — API 参考\r\n\r\nTemu **美国站取消订单**（买家取消 + 卖家取消）（Partner US **Cancel Order** — 买家 `bg.aftersales.cancel.*` + 卖家 `temu.order.cancel.*`），经本 skill `temu_us_proxy`（`POST /temu/proxy`） 转发。Temu 的 `type` 写在 Body，**不是** URL 路径。\r\n\r\n> 网关与鉴权：本 skill `scripts/`（`LINKFOXAGENT_API_KEY`、`accessToken` / `storeKey`）。建议 token 见 `references/access-token.md`（`tokenPurpose=order-shipping`）。\r\n\r\n---\r\n\r\n## 调用规范\r\n\r\n| 项 | 说明 |\r\n|----|------|\r\n| 网关根地址 | `${LINKFOX_TOOL_GATEWAY}`（可用 `LINKFOX_TOOL_GATEWAY` / `TEMU_API_BASE_URL` / `STORE_API_BASE_URL` 覆盖） |\r\n| 卖家取消单 OpenAPI | `POST /temu/proxy` |\r\n| 加签文件下载 | `POST /temu/fileDownload`（`temu_us_file_download.py`） |\r\n| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**（同值）；或 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`；或 JSON `token`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\r\n| Temu 鉴权 | Body `accessToken`，或 `storeKey` + `site` + `managementType` + `tokenPurpose` |\r\n| 默认 | `site=us`，`managementType=semi-managed`，`tokenPurpose=order-shipping` |\r\n| 上游 OpenAPI（US） | `https://openapi-b-us.temu.com/openapi/router`（网关按 `site` 解析） |\r\n\r\n### 网关请求 Body（`/temu/proxy`）\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| site | string | 是 | `us`（本 skill 默认） |\r\n| managementType | string | 是 | `semi-managed` |\r\n| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌 |\r\n| storeKey | string | 与 accessToken 二选一 | `~/.linkfox/temu-access-tokens.json` 中的键 |\r\n| tokenPurpose | string | 否 | 建议 **`order-shipping`** |\r\n| type | string | 是 | Temu 接口名，如 Partner 文档中的 `bg.*` / `temu.*` |\r\n| params | object | 否 | 业务参数；多数接口业务块在 **`params.request`** |\r\n\r\n### 网关响应\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| body | string | Temu 原始 JSON 字符串；脚本解析为 `temuBody` |\r\n| code | integer | 网关错误码：`1002` 参数/Token，`1003` 转发失败 |\r\n\r\n解析顺序：**网关 `code`** → `JSON.parse(body)` → `success` / `errorCode` / `errorMsg` / `result`。\r\n\r\n### 脚本调用\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\npython scripts/temu_us_proxy.py '{\"accessToken\":\"TOKEN\",\"tokenPurpose\":\"order-shipping\",\"type\":\"\",\"params\":{\"request\":{}}}'\r\n```\r\n\r\n业务字段可放在顶层或嵌套 `params`；含 `request` 时通常整体作为 `params` 转发。\r\n\r\n---\r\n\r\n## 接口一览\r\n\r\n完整 `sub_menu_code` 与 Partner 文档 URL 见 [partner-us-catalog.md](./partner-us-catalog.md)。\r\n\r\n**每个接口单独一份文档**：[apis/README.md](./apis/README.md)（随接入递增）。\r\n\r\n> 已接入接口见 [apis/README.md](./apis/README.md)。\r\n\r\n---\r\n\r\n## 典型买家取消流程\r\n\r\n```text\r\n1. bg.aftersales.cancel.list.get（本 skill） → 查待处理买家取消售后（afterSalesStatusGroup=8 等）\r\n2. bg.aftersales.cancel.agree（本 skill） → 同意取消（parentAfterSalesSn + parentOrderSn）\r\n3. linkfox-temu-order-us → 刷新订单状态\r\n```\r\n\r\n## 典型卖家取消流程\r\n\r\n```text\r\n1. linkfox-temu-order-us → 查订单 parentOrderSn / orderSn、发货状态\r\n2a. temu.order.cancel.appeal.apply（本 skill） → 申诉类取消申请，返回 applySn\r\n2b. temu.order.cancel.outofstock.apply（本 skill） → 缺货取消申请（提交风控），返回 applyResult\r\n3. temu.order.cancel.appeal.result.get（本 skill） → 按 applySnList 查询申诉 status\r\n4. linkfox-temu-order-us → 取消后刷新订单状态（list/detail）\r\n```\r\n\r\n---\r\n\r\n## 网关错误码\r\n\r\n| code | 说明 | 处理 |\r\n|------|------|------|\r\n| 1002 | 参数或 LinkFox Token 无效 | 修正参数与 `LINKFOXAGENT_API_KEY` |\r\n| 1003 | 转发失败 | 检查 Temu token、`tokenPurpose`、白名单、网络 |\r\n| 402 | HTTP 402 | 按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- `skillName`: **`linkfox-temu-cancel-order-us`**\n\nFile v1.0.4:references/apis/bg-aftersales-cancel-agree.md\n\n# 同意取消订单 — `bg.aftersales.cancel.agree`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_agree.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.agree`，业务载荷放在 Body 的 `params` |\n\n**Description:** Agree cancel order（同意买家发起的取消订单申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentAfterSalesSn`、`parentOrderSn` 通常来自 [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) 列表接口返回（`afterSalesStatusGroup=8` 待处理）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── parentAfterSalesSn (STRING, 是)\n └── parentOrderSn (STRING, 是)\n```\n\n### `request` 内字段\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentAfterSalesSn | STRING | **是** | Parent after-sales order number（父售后单号），**不能为空** |\n| parentOrderSn | STRING | **是** | Parent order number（父订单号），**不能为空** |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── result (OBJECT)\n├── success\n├── errorCode\n└── errorMsg\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| result | OBJECT | Empty field（官方未展开子字段；成功时通常为空对象） |\n| success | BOOLEAN | Whether it was successful or not（是否成功） |\n| errorCode | INTEGER | Error code（错误码） |\n| errorMsg | STRING | Error message（错误信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| _(无子字段)_ | — | Partner 文档标注为 Empty field；若实际响应含其它字段，以 Temu 返回 JSON 为准 |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_agree.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}'\n```\n\n典型流程：`bg.aftersales.cancel.list.get`（`afterSalesStatusGroup=8`）取得 `parentAfterSalesSn` + `parentOrderSn` → 本接口**同意取消** → 可再查列表确认状态变为已同意（`9`）或用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.4:references/apis/bg-aftersales-cancel-list-get.md\n\n# 取消订单售后列表查询 — `bg.aftersales.cancel.list.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_list_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.list.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Query cancel order after-sales information（查询取消订单售后信息）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── pageSize (INTEGER, 否)\n ├── pageNo (INTEGER, 否)\n ├── parentOrderSnList[] (STRING[], 否)\n ├── parentAfterSalesSnList[] (STRING[], 否)\n └── afterSalesStatusGroup (INTEGER, 否)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pageSize | INTEGER | 否 | Page size for pagination，**默认 10**，**最大 200** |\n| pageNo | INTEGER | 否 | Page number for pagination，**默认 1** |\n| parentOrderSnList | STRING[] | 否 | Parent order number list；留空则不限制父订单号范围；**单次查询最多 200 条** |\n| parentAfterSalesSnList | STRING[] | 否 | Parent after-sales order number list；留空则不限制父售后单号范围；**单次查询最多 200 条** |\n| afterSalesStatusGroup | INTEGER | 否 | The cancel order after-sales status group（取消订单售后状态组），见下表 |\n\n#### `afterSalesStatusGroup`（入参筛选）\n\n| 值 | 说明 |\n|----|------|\n| `8` | Cancel order pending（取消订单待处理） |\n| `9` | Cancel order approved（取消订单已同意） |\n| `10` | Cancel order rejected（取消订单已拒绝） |\n| `11` | Cancel order revoked（取消订单已撤销） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8,\n \"parentOrderSnList\": [\"PO-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── total\n ├── pageNumber\n └── data[]\n ├── parentAfterSalesSn\n ├── parentAfterSalesStatus\n └── afterSalesInfoList[]\n ├── afterSalesSn\n ├── parentOrderSn\n ├── orderSn\n ├── productSkuId\n ├── applyGoodsNumber\n ├── goodsId\n ├── productList[]\n │ ├── productSkuId\n │ └── extCode\n └── createAtMillis\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Specific information |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| total | LONG | Total number of matching records（匹配记录总数） |\n| pageNumber | INTEGER | Current page number of the result（当前结果页码） |\n| data | OBJECT[] | The record data returned from this query（本次查询返回的记录） |\n\n> 入参分页字段为 **`pageNo`**，出参当前页为 **`pageNumber`**，勿混用。\n\n### `data[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentAfterSalesSn | STRING | Parent after-sales order number for the canceled order（取消订单的父售后单号） |\n| parentAfterSalesStatus | INTEGER | Current parent after-sales status（当前父售后状态），见下表 |\n| afterSalesInfoList | OBJECT[] | Cancel order after-sales information list（取消订单售后信息列表） |\n\n#### `parentAfterSalesStatus`（出参）\n\n| 值 | 说明 |\n|----|------|\n| `1` | Buyer has applied for a refund, pending processing（买家已申请退款，待处理） |\n| `4` | Refund has been initiated, being processed by the system（退款已发起，系统处理中） |\n| `5` | Refund has been issued（退款已发放） |\n| `6` | Buyer has cancelled the after-sales request（买家已撤销售后申请） |\n| `7` | After-sales request has been rejected（售后申请已被拒绝） |\n| `9` | Refund initiated, being processed by the system（退款已发起，系统处理中） |\n\n### `afterSalesInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| afterSalesSn | STRING | After-sales order number（售后单号） |\n| parentOrderSn | STRING | Parent order number（父订单号） |\n| orderSn | STRING | Order number（子订单号） |\n| productSkuId | LONG | Product SKU ID |\n| applyGoodsNumber | LONG | Quantity requested for cancellation（申请取消数量） |\n| goodsId | LONG | Goods ID |\n| productList | OBJECT[] | Product information list（产品信息列表） |\n| createAtMillis | LONG | After-sales order creation time, unit in milliseconds（售后单创建时间，毫秒） |\n\n### `productList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| productSkuId | LONG | Product SKU ID |\n| extCode | STRING | Product external code（商品外部编码） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8\n }\n}'\n```\n\n可与 `linkfox-temu-order-us` 的 `bg.order.list.v2.get` / `bg.order.detail.v2.get` 配合：先查订单 `pending_buyer_cancellation` 标签，再按 `parentOrderSnList` 拉取消售后明细。\n\nFile v1.0.4:references/apis/temu-order-cancel-appeal-apply.md\n\n# 卖家发起取消申请 — `temu.order.cancel.appeal.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** Support merchants to initiate cancellation requests through the interface（支持商家通过接口发起取消申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `reason.proofUrlList` 中的图片须先经 **`temu.order.query.signature`** 转为 URL 后再传入（该接口待接入时可先用 `temu_us_proxy.py` 试调）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── cancelType (INTEGER, 是)\n ├── applyOrder (OBJECT, 是)\n │ └── parentOrderSn (STRING, 是)\n └── reason (OBJECT, 是)\n ├── description (STRING, 是)\n └── proofUrlList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| cancelType | INTEGER | **是** | The types of application for cancellation（取消申请类型），见下表 |\n| applyOrder | OBJECT | **是** | Details of the application to cancel the order（取消订单申请详情） |\n| reason | OBJECT | **是** | Explanation of Application Reasons（申请原因说明） |\n\n#### `cancelType`\n\n| 值 | 说明 |\n|----|------|\n| `2` | Suspected batch refund（疑似批量退款） |\n| `3` | Incorrect address（地址错误） |\n\n### `applyOrder`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | Parent order sn（父订单号） |\n\n### `reason`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| description | STRING | **是** | Explanation of the reason for cancellation initiated（发起取消的原因说明） |\n| proofUrlList | STRING[] | **是** | Related screenshots serve as supplementary evidence to illustrate the rationality of the application（相关截图作为补充证据，说明申请的合理性）；图片须先通过 **`temu.order.query.signature`** 转为 URL 后传入 |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Customer provided incorrect shipping address\",\n \"proofUrlList\": [\n \"https://signed-url-from-temu.order.query.signature/...\"\n ]\n }\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── applySn\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | apply sn（取消申请单号） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Incorrect address confirmed with buyer\",\n \"proofUrlList\": [\"https://signed-url/...\"]\n }\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) 查询 `status`。\n\nFile v1.0.4:references/apis/temu-order-cancel-appeal-result-get.md\n\n# 查询取消申请结果 — `temu.order.cancel.appeal.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Merchant queries the status of cancellation order appeal records（商家查询取消订单申诉记录的状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `applySnList` 中的申请单号通常来自 [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) 返回的 `result.applySn`。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n └── applySnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| applySnList | STRING[] | **是** | Apply sn list（取消申请单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── itemList[]\n ├── applySn\n └── status\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| itemList | OBJECT[] | result item list（取消申请结果列表） |\n\n### `itemList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | Apply sn（取消申请单号） |\n| status | INTEGER | Apply cancel status（取消申请状态），见下表 |\n\n#### `status`\n\n| 值 | 说明 |\n|----|------|\n| `1` | Auditing（审核中） |\n| `2` | Approved（已通过） |\n| `3` | Rejected（已拒绝） |\n| `4` | Apply failed（申请失败） |\n| `5` | Canceled（已取消） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → 本接口轮询 `status`（`1` 审核中 → `2` 通过 / `3` 拒绝 / `4` 失败 / `5` 已取消）→ 可用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.4:references/apis/temu-order-cancel-outofstock-apply.md\n\n# 缺货取消申请 — `temu.order.cancel.outofstock.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** The user takes the initiative to initiate a stock-out situation, which will be submitted to the risk control department for review（商家主动发起缺货情况，提交风控部门审核）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock apply request\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock apply response\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── applyResult\n └── failReasonList[]\n ├── parentOrderSn\n ├── orderSn\n └── reasonList[]\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | lack stock apply result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResult | BOOLEAN | lack stock apply result（缺货申请结果）：`true` = apply success（申请成功）；`false` = apply fail（申请失败） |\n| failReasonList | OBJECT[] | apply fail reason list（申请失败原因列表）；`applyResult=true` 时通常为空或不返回 |\n\n### `failReasonList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentOrderSn | STRING | parent order sn（父订单号） |\n| orderSn | STRING | order sn（子订单号） |\n| reasonList | STRING[] | apply fail reason code list（申请失败原因码列表） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`linkfox-temu-order-us` 查 `parentOrderSn` / `orderSn` → 本接口提交缺货取消申请（风控审核）→ 根据 `applyResult` 与 `failReasonList` 确认是否受理。\n\nFile v1.0.4:references/apis/temu-order-cancel-outofstock-result-get.md\n\n# 查询缺货取消审核结果 — `temu.order.cancel.outofstock.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** After applying for out-of-stock, since out-of-stock itself is an asynchronous operation, you need to obtain the latest out-of-stock review status through the query interface（提交缺货取消申请后，由于缺货本身是异步操作，需要通过本查询接口获取最新的缺货审核状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口，或与 [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) 提交时使用的参数一致。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock query request from ams\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock query response from ams\n├── success (BOOLEAN)\n├── errorCode (INTEGER)\n├── errorMsg (STRING)\n└── result (OBJECT) — Specific information\n └── applyResultInfoList[] (OBJECT[]) — lack stock order apply result info list\n ├── orderSn (STRING)\n └── applyStatus (INTEGER)\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success（请求是否成功） |\n| errorCode | INTEGER | error code（错误码） |\n| errorMsg | STRING | error message（错误信息） |\n| result | OBJECT | Specific information（具体结果信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResultInfoList | OBJECT[] | lack stock order apply result info list（缺货取消申请结果信息列表） |\n\n### `applyResultInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| orderSn | STRING | order sn（子订单号） |\n| applyStatus | INTEGER | lack stock apply status（缺货申请审核状态） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.outofstock.apply` 提交缺货取消申请（风控审核）→ 本接口查询 `applyStatus` 获取最新审核状态 → 根据状态决定后续操作。\n\nFile v1.0.4:references/authorization-flow.md\n\n# Temu 授权流程\n\n```text\n用户确认店铺类型与用途\n ↓\ntemu_token_guide.py（输出后台操作步骤）\n ↓\n用户在 Temu 卖家后台复制 access_token\n ↓\nsave_temu_access_token.py（可选，写入本地 store）\n ↓\ntemu_proxy.py / temu_file_download.py\n - 直接传 accessToken，或\n - 传 storeKey + site + managementType + tokenPurpose\n```\n\n## 决策表\n\n| 用户需求 | shopType | tokenPurpose | site |\n|----------|----------|--------------|------|\n| 半托管查商品/库存 | semi-managed | product-inventory | cn / partner |\n| 半托管查订单/发货 | semi-managed | order-shipping | us / global / eu |\n| 全托管任意接口 | full-managed | full-managed | cn / partner |\n| 美欧本土店 | local-native | local-native | us 等 |\n\n## 与 API 调用的对应关系\n\n紫鸟转发路径：`/temu-proxy/{site}/{managementType}`\n\n- 全托管 CN：`cn` + `full-managed`\n- 半托管商品：`cn`/`partner` + `semi-managed` + 商品 token\n- 半托管订单：`us`/`global`/`eu` + `semi-managed` + 订单 token\n\n授权应用名称必须与后台一致：**酷鸟卖家助手** 或 **Cyber-ERP酷鸟助手** / **Cyber-ERP**。\n\nArchive v1.0.3: 34 files, 40991 bytes\n\nFiles: references/access-token.md (4450b), references/api.md (4197b), references/apis/bg-aftersales-cancel-agree.md (2732b), references/apis/bg-aftersales-cancel-list-get.md (5811b), references/apis/README.md (953b), references/apis/temu-order-cancel-appeal-apply.md (3922b), references/apis/temu-order-cancel-appeal-result-get.md (2818b), references/apis/temu-order-cancel-outofstock-apply.md (3192b), references/apis/temu-order-cancel-outofstock-result-get.md (3393b), references/authorization-flow.md (1186b), references/partner-us-catalog.md (2853b), scripts/_temu_auth_guide.py (6198b), scripts/_temu_common.py (12430b), scripts/_temu_token_store.py (4273b), scripts/_temu_us_common.py (3199b), scripts/_us_cancel_order_script.py (504b), scripts/check_linkfox_token.py (1797b), scripts/get_temu_access_token.py (1843b), scripts/list_temu_access_tokens.py (652b), scripts/save_temu_access_token.py (1377b), scripts/temu_file_download.py (1681b), scripts/temu_proxy.py (2124b), scripts/temu_token_guide.py (1594b), scripts/temu_us_file_download.py (719b), scripts/temu_us_proxy.py (956b), scripts/us_cancel_aftersales_cancel_agree.py (260b), scripts/us_cancel_aftersales_cancel_list_get.py (281b), scripts/us_seller_cancel_order_cancel_appeal_apply.py (283b), scripts/us_seller_cancel_order_cancel_appeal_result_get.py (304b), scripts/us_seller_cancel_order_cancel_outofstock_apply.py (289b), scripts/us_seller_cancel_order_cancel_outofstock_result_get.py (316b), skill-card.md (3550b), SKILL.md (5746b), _meta.json (147b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: linkfox-temu-cancel-order-us\r\ndescription: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。\r\n---\r\n\r\n# Temu 美国站 — 取消订单（买家 + 卖家）\r\n\r\n本 skill（`linkfox-temu-cancel-order-us`）覆盖 Partner Platform for US **取消订单**相关接口：\r\n\r\n- **买家/消费者**：`bg.aftersales.cancel.list.get`、`bg.aftersales.cancel.agree`\r\n- **店家/卖家**：`temu.order.cancel.appeal.apply`、`temu.order.cancel.appeal.result.get`、`temu.order.cancel.outofstock.apply`、`temu.order.cancel.outofstock.result.get`\r\n\r\n详见 [partner-us-catalog.md](./references/partner-us-catalog.md)（**6** 个接口）。\r\n\r\n**网关（本 skill 内置）**：\r\n\r\n| 能力 | 方法 | 路径 |\r\n|------|------|------|\r\n| 取消单 OpenAPI（`us_cancel_*`、`us_seller_cancel_*`、`temu_us_proxy`） | POST | `https://tool-gateway.linkfox.com/temu/proxy` |\r\n| 加签文件下载 | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` |\r\n\r\n## 相关 skill\r\n\r\n| 场景 | skill |\r\n|------|--------|\r\n| 订单列表/详情/发货/地址/金额 | `linkfox-temu-order-us` |\r\n| 欧洲站取消订单 | `linkfox-temu-cancel-order-eu` |\r\n| 全球站（非 US/EU）取消订单 | `linkfox-temu-cancel-order-global` |\r\n| 履约/发货 | `linkfox-temu-fulfillment-us` |\r\n| 商品管理 | `linkfox-temu-manage-product-us` |\r\n| 退货与退款 | `linkfox-temu-returns-refunds-us` |\r\n| 网关与 Temu token | 本 skill `scripts/` |\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /temu/proxy`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/<脚本名>.py '' [--inline]`（可用脚本见上文脚本一览）\r\n- **成本约束**：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-temu-cancel-order-us-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## 默认参数\r\n\r\n| 字段 | 默认 | 说明 |\r\n|------|------|------|\r\n| site | `us` | Partner US |\r\n| managementType | `semi-managed` | 半托管 |\r\n| tokenPurpose | `order-shipping` | 订单/取消场景 token |\r\n\r\n## 鉴权\r\n\r\n1. **LinkFox**：`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token`\r\n2. **Temu**：`accessToken` 或 `storeKey`（建议 `tokenPurpose=order-shipping`）\r\n\r\n## Scripts（按 type）\r\n\r\n### 买家取消\r\n\r\n| 脚本 | type |\r\n|------|------|\r\n| `us_cancel_aftersales_cancel_list_get.py` | `bg.aftersales.cancel.list.get` |\r\n| `us_cancel_aftersales_cancel_agree.py` | `bg.aftersales.cancel.agree` |\r\n\r\n### 卖家取消\r\n\r\n| 脚本 | type |\r\n|------|------|\r\n| `us_seller_cancel_order_cancel_appeal_apply.py` | `temu.order.cancel.appeal.apply` |\r\n| `us_seller_cancel_order_cancel_appeal_result_get.py` | `temu.order.cancel.appeal.result.get` |\r\n| `us_seller_cancel_order_cancel_outofstock_apply.py` | `temu.order.cancel.outofstock.apply` |\r\n| `us_seller_cancel_order_cancel_outofstock_result_get.py` | `temu.order.cancel.outofstock.result.get` |\r\n\r\n### 通用\r\n\r\n| 脚本 | 说明 |\r\n|------|------|\r\n| `temu_us_proxy.py` | 任意 `type` |\r\n| `temu_us_file_download.py` | 加签文件下载 |\r\n\r\n## 接入新接口（约定）\r\n\r\n1. 新增 `references/apis/.md`\r\n2. 新增 `scripts/us_cancel_*` 或 `us_seller_cancel_*`（调用 `_us_cancel_order_script.run_cli`）\r\n3. 更新 [partner-us-catalog.md](./references/partner-us-catalog.md)、[apis/README.md](./references/apis/README.md)\r\n\r\n## 示例\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\n\r\n# 买家取消 — 待处理列表\r\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\r\n \"accessToken\": \"TOKEN\",\r\n \"tokenPurpose\": \"order-shipping\",\r\n \"request\": { \"pageNo\": 1, \"pageSize\": 20, \"afterSalesStatusGroup\": 8 }\r\n}'\r\n\r\n# 卖家 — 缺货取消申请\r\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\r\n \"accessToken\": \"TOKEN\",\r\n \"tokenPurpose\": \"order-shipping\",\r\n \"request\": {\r\n \"parentOrderSn\": \"PO-123456789\",\r\n \"orderSnList\": [\"O-111111111\"]\r\n }\r\n}'\r\n```\r\n\r\n**Feedback：** `skillName`：`linkfox-temu-cancel-order-us`\r\n\r\n## 网关与授权脚本\r\n\r\n| 脚本 | 说明 |\r\n|------|------|\r\n| `check_linkfox_token.py` | 校验 LinkFox Token |\r\n| `save_temu_access_token.py` / `list_temu_access_tokens.py` / `get_temu_access_token.py` | 本地 token |\r\n| `temu_token_guide.py` | Temu 授权指引 |\r\n\r\n授权说明：[references/access-token.md](./references/access-token.md)\n\nFile v1.0.3:references/apis/README.md\n\n# Cancel Order — 接口文档索引\n\n每个 `type` 单独一份文档，经 `POST /temu/proxy` 调用。\n\n## 买家/消费者取消（2）\n\n| type | 文档 |\n|------|------|\n| `bg.aftersales.cancel.list.get` | [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) |\n| `bg.aftersales.cancel.agree` | [bg-aftersales-cancel-agree.md](./bg-aftersales-cancel-agree.md) |\n\n## 卖家/店家取消（4）\n\n| type | 文档 |\n|------|------|\n| `temu.order.cancel.appeal.apply` | [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) |\n| `temu.order.cancel.appeal.result.get` | [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) |\n| `temu.order.cancel.outofstock.apply` | [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) |\n| `temu.order.cancel.outofstock.result.get` | [temu-order-cancel-outofstock-result-get.md](./temu-order-cancel-outofstock-result-get.md) |\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-cancel-order-us\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1783337967776\n}\n\nFile v1.0.3:references/access-token.md\n\n# Temu accessToken 授权与获取\n\nTemu **没有** LinkFox 侧自动 OAuth；`accessToken` 须在 Temu 卖家后台「服务市场 → 授权管理」**手动复制**。与 `LINKFOXAGENT_API_KEY`（LinkFox 用户鉴权）是两套令牌。\n\n## 两种鉴权（勿混淆）\n\n| 令牌 | 用途 | 获取方式 |\n|------|------|----------|\n| **LinkFox 用户 Token** | 调用 `/temu/proxy`、`/temu/fileDownload` **必填** | `LINKFOXAGENT_API_KEY` 或请求 JSON 的 `token`；Header `Authorization` + `Token`（同 amazon-store-auth） |\n| **Temu accessToken** | Temu 业务 API（经紫鸟转发） | Temu 卖家后台授权后复制 |\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/check_linkfox_token.py\n```\n\n## tokenPurpose 与场景\n\n| tokenPurpose | 店铺类型 | 推荐 site | 授权应用 |\n|--------------|----------|-----------|----------|\n| `product-inventory` | 半托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `order-shipping` | 半托管 | `us` / `global` / `eu` | Cyber-ERP酷鸟助手 |\n| `full-managed` | 全托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `local-native` | 本土（美/欧主体） | `us` 等 | Cyber-ERP |\n\n## 1. 半托管 — 商品/库存 Token\n\n1. 登录 [seller.kuajingmaihuo.com](https://seller.kuajingmaihuo.com) 或 [agentseller.temu.com](https://agentseller.temu.com)\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → 选择 **「酷鸟卖家助手」**\n4. 全选常规和特殊授权 → 确认 → **复制 access_token**\n5. 调用 API：`site=cn` 或 `partner`，`managementType=semi-managed`\n\n## 2. 半托管 — 订单/发货 Token\n\n1. 登录 Temu 卖家后台\n2. 右上角 **Seller Central** → 切换到目标区域（美区 / 欧区 / 全球）\n3. **服务市场** → **授权管理**\n4. **获取授权** → 选择 **「Cyber-ERP酷鸟助手」**\n5. 全选授权 → 确认 → 复制 token\n6. 调用 API：`site=us` / `global` / `eu`，`managementType=semi-managed`\n\n## 3. 全托管店铺\n\n1. 登录 Temu 平台\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → **「酷鸟卖家助手」** → 全选 → 复制 token\n4. 调用 API：`managementType=full-managed`，`site` 通常 `cn` 或 `partner`\n\n## 4. 本土店铺（美区、欧区主体）\n\n1. 登录 Temu\n2. **Apps And Services** → **Manage Your Apps**\n3. **Authorize a new app** → 搜索 **「Cyber-ERP」**\n4. 一般权限与敏感权限全选 → 确认 → 复制 token\n\n## 站点与 OpenAPI 网关\n\n| site | 说明 | Temu 网关 |\n|------|------|-----------|\n| cn | 中国站 | openapi.kuajingmaihuo.com |\n| partner | Partner 网关 | openapi-b-partner.temu.com |\n| us | 美国站 | openapi-b-us.temu.com |\n| global | 全球区 | openapi-b-global.temu.com |\n| eu | 欧洲站 | openapi-b-eu.temu.com |\n\n## 本地保存 Token（推荐）\n\n默认存储：`~/.linkfox/temu-access-tokens.json`（可用 `TEMU_TOKEN_STORE_PATH` 覆盖）。\n\n```bash\n# 查看授权步骤\npython scripts/temu_token_guide.py '{\"shopType\":\"semi-managed\",\"tokenPurpose\":\"product-inventory\",\"site\":\"cn\"}'\n\n# 保存 token\npython scripts/save_temu_access_token.py '{\n \"storeKey\": \"my-shop\",\n \"label\": \"中国半托管\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"accessToken\": \"PASTE_TOKEN\"\n}'\n\n# 列出已保存（脱敏）\npython scripts/list_temu_access_tokens.py\n\n# 用 storeKey 调 API（无需每次粘贴 token）\npython scripts/temu_proxy.py '{\n \"storeKey\": \"my-shop\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"type\": \"bg.goods.category.mapping\",\n \"params\": {\"goodsName\": \"测试\", \"goodsNameEn\": \"Test\"}\n}'\n```\n\n## 注意事项\n\n1. **子账号**：可能无法进入服务市场，需主账号授权。\n2. **多站点**：美国站、英国站等需分别登录对应后台获取 Token。\n3. **有效期**：Token 会过期，过期后重新在后台复制并 `save_temu_access_token.py`。\n4. **IP 白名单**：需联系紫鸟开放平台配置调用 IP。\n5. **参数小写**：`site`、`managementType` 必须小写。\n\n## 脚本一览\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_token_guide.py` | 按店铺类型/用途输出授权步骤 |\n| `save_temu_access_token.py` | 保存 accessToken 到本地 |\n| `list_temu_access_tokens.py` | 列出已保存 token（默认脱敏）|\n| `get_temu_access_token.py` | 读取指定 store 的 token |\n\nFile v1.0.3:references/api.md\n\n# linkfox-temu-cancel-order-us — API 参考\r\n\r\nTemu **美国站取消订单**（买家取消 + 卖家取消）（Partner US **Cancel Order** — 买家 `bg.aftersales.cancel.*` + 卖家 `temu.order.cancel.*`），经本 skill `temu_us_proxy`（`POST /temu/proxy`） 转发。Temu 的 `type` 写在 Body，**不是** URL 路径。\r\n\r\n> 网关与鉴权：本 skill `scripts/`（`LINKFOXAGENT_API_KEY`、`accessToken` / `storeKey`）。建议 token 见 `references/access-token.md`（`tokenPurpose=order-shipping`）。\r\n\r\n---\r\n\r\n## 调用规范\r\n\r\n| 项 | 说明 |\r\n|----|------|\r\n| 网关根地址 | `${LINKFOX_TOOL_GATEWAY}`（可用 `LINKFOX_TOOL_GATEWAY` / `TEMU_API_BASE_URL` / `STORE_API_BASE_URL` 覆盖） |\r\n| 卖家取消单 OpenAPI | `POST /temu/proxy` |\r\n| 加签文件下载 | `POST /temu/fileDownload`（`temu_us_file_download.py`） |\r\n| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**（同值）；或 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`；或 JSON `token` |\r\n| Temu 鉴权 | Body `accessToken`，或 `storeKey` + `site` + `managementType` + `tokenPurpose` |\r\n| 默认 | `site=us`，`managementType=semi-managed`，`tokenPurpose=order-shipping` |\r\n| 上游 OpenAPI（US） | `https://openapi-b-us.temu.com/openapi/router`（网关按 `site` 解析） |\r\n\r\n### 网关请求 Body（`/temu/proxy`）\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| site | string | 是 | `us`（本 skill 默认） |\r\n| managementType | string | 是 | `semi-managed` |\r\n| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌 |\r\n| storeKey | string | 与 accessToken 二选一 | `~/.linkfox/temu-access-tokens.json` 中的键 |\r\n| tokenPurpose | string | 否 | 建议 **`order-shipping`** |\r\n| type | string | 是 | Temu 接口名，如 Partner 文档中的 `bg.*` / `temu.*` |\r\n| params | object | 否 | 业务参数；多数接口业务块在 **`params.request`** |\r\n\r\n### 网关响应\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| body | string | Temu 原始 JSON 字符串；脚本解析为 `temuBody` |\r\n| code | integer | 网关错误码：`1002` 参数/Token，`1003` 转发失败 |\r\n\r\n解析顺序：**网关 `code`** → `JSON.parse(body)` → `success` / `errorCode` / `errorMsg` / `result`。\r\n\r\n### 脚本调用\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\npython scripts/temu_us_proxy.py '{\"accessToken\":\"TOKEN\",\"tokenPurpose\":\"order-shipping\",\"type\":\"\",\"params\":{\"request\":{}}}'\r\n```\r\n\r\n业务字段可放在顶层或嵌套 `params`；含 `request` 时通常整体作为 `params` 转发。\r\n\r\n---\r\n\r\n## 接口一览\r\n\r\n完整 `sub_menu_code` 与 Partner 文档 URL 见 [partner-us-catalog.md](./partner-us-catalog.md)。\r\n\r\n**每个接口单独一份文档**：[apis/README.md](./apis/README.md)（随接入递增）。\r\n\r\n> 已接入接口见 [apis/README.md](./apis/README.md)。\r\n\r\n---\r\n\r\n## 典型买家取消流程\r\n\r\n```text\r\n1. bg.aftersales.cancel.list.get（本 skill） → 查待处理买家取消售后（afterSalesStatusGroup=8 等）\r\n2. bg.aftersales.cancel.agree（本 skill） → 同意取消（parentAfterSalesSn + parentOrderSn）\r\n3. linkfox-temu-order-us → 刷新订单状态\r\n```\r\n\r\n## 典型卖家取消流程\r\n\r\n```text\r\n1. linkfox-temu-order-us → 查订单 parentOrderSn / orderSn、发货状态\r\n2a. temu.order.cancel.appeal.apply（本 skill） → 申诉类取消申请，返回 applySn\r\n2b. temu.order.cancel.outofstock.apply（本 skill） → 缺货取消申请（提交风控），返回 applyResult\r\n3. temu.order.cancel.appeal.result.get（本 skill） → 按 applySnList 查询申诉 status\r\n4. linkfox-temu-order-us → 取消后刷新订单状态（list/detail）\r\n```\r\n\r\n---\r\n\r\n## 网关错误码\r\n\r\n| code | 说明 | 处理 |\r\n|------|------|------|\r\n| 1002 | 参数或 LinkFox Token 无效 | 修正参数与 `LINKFOXAGENT_API_KEY` |\r\n| 1003 | 转发失败 | 检查 Temu token、`tokenPurpose`、白名单、网络 |\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- `skillName`: **`linkfox-temu-cancel-order-us`**\n\nFile v1.0.3:references/apis/bg-aftersales-cancel-agree.md\n\n# 同意取消订单 — `bg.aftersales.cancel.agree`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_agree.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.agree`，业务载荷放在 Body 的 `params` |\n\n**Description:** Agree cancel order（同意买家发起的取消订单申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentAfterSalesSn`、`parentOrderSn` 通常来自 [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) 列表接口返回（`afterSalesStatusGroup=8` 待处理）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── parentAfterSalesSn (STRING, 是)\n └── parentOrderSn (STRING, 是)\n```\n\n### `request` 内字段\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentAfterSalesSn | STRING | **是** | Parent after-sales order number（父售后单号），**不能为空** |\n| parentOrderSn | STRING | **是** | Parent order number（父订单号），**不能为空** |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── result (OBJECT)\n├── success\n├── errorCode\n└── errorMsg\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| result | OBJECT | Empty field（官方未展开子字段；成功时通常为空对象） |\n| success | BOOLEAN | Whether it was successful or not（是否成功） |\n| errorCode | INTEGER | Error code（错误码） |\n| errorMsg | STRING | Error message（错误信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| _(无子字段)_ | — | Partner 文档标注为 Empty field；若实际响应含其它字段，以 Temu 返回 JSON 为准 |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_agree.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}'\n```\n\n典型流程：`bg.aftersales.cancel.list.get`（`afterSalesStatusGroup=8`）取得 `parentAfterSalesSn` + `parentOrderSn` → 本接口**同意取消** → 可再查列表确认状态变为已同意（`9`）或用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.3:references/apis/bg-aftersales-cancel-list-get.md\n\n# 取消订单售后列表查询 — `bg.aftersales.cancel.list.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_list_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.list.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Query cancel order after-sales information（查询取消订单售后信息）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── pageSize (INTEGER, 否)\n ├── pageNo (INTEGER, 否)\n ├── parentOrderSnList[] (STRING[], 否)\n ├── parentAfterSalesSnList[] (STRING[], 否)\n └── afterSalesStatusGroup (INTEGER, 否)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pageSize | INTEGER | 否 | Page size for pagination，**默认 10**，**最大 200** |\n| pageNo | INTEGER | 否 | Page number for pagination，**默认 1** |\n| parentOrderSnList | STRING[] | 否 | Parent order number list；留空则不限制父订单号范围；**单次查询最多 200 条** |\n| parentAfterSalesSnList | STRING[] | 否 | Parent after-sales order number list；留空则不限制父售后单号范围；**单次查询最多 200 条** |\n| afterSalesStatusGroup | INTEGER | 否 | The cancel order after-sales status group（取消订单售后状态组），见下表 |\n\n#### `afterSalesStatusGroup`（入参筛选）\n\n| 值 | 说明 |\n|----|------|\n| `8` | Cancel order pending（取消订单待处理） |\n| `9` | Cancel order approved（取消订单已同意） |\n| `10` | Cancel order rejected（取消订单已拒绝） |\n| `11` | Cancel order revoked（取消订单已撤销） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8,\n \"parentOrderSnList\": [\"PO-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── total\n ├── pageNumber\n └── data[]\n ├── parentAfterSalesSn\n ├── parentAfterSalesStatus\n └── afterSalesInfoList[]\n ├── afterSalesSn\n ├── parentOrderSn\n ├── orderSn\n ├── productSkuId\n ├── applyGoodsNumber\n ├── goodsId\n ├── productList[]\n │ ├── productSkuId\n │ └── extCode\n └── createAtMillis\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Specific information |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| total | LONG | Total number of matching records（匹配记录总数） |\n| pageNumber | INTEGER | Current page number of the result（当前结果页码） |\n| data | OBJECT[] | The record data returned from this query（本次查询返回的记录） |\n\n> 入参分页字段为 **`pageNo`**，出参当前页为 **`pageNumber`**，勿混用。\n\n### `data[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentAfterSalesSn | STRING | Parent after-sales order number for the canceled order（取消订单的父售后单号） |\n| parentAfterSalesStatus | INTEGER | Current parent after-sales status（当前父售后状态），见下表 |\n| afterSalesInfoList | OBJECT[] | Cancel order after-sales information list（取消订单售后信息列表） |\n\n#### `parentAfterSalesStatus`（出参）\n\n| 值 | 说明 |\n|----|------|\n| `1` | Buyer has applied for a refund, pending processing（买家已申请退款，待处理） |\n| `4` | Refund has been initiated, being processed by the system（退款已发起，系统处理中） |\n| `5` | Refund has been issued（退款已发放） |\n| `6` | Buyer has cancelled the after-sales request（买家已撤销售后申请） |\n| `7` | After-sales request has been rejected（售后申请已被拒绝） |\n| `9` | Refund initiated, being processed by the system（退款已发起，系统处理中） |\n\n### `afterSalesInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| afterSalesSn | STRING | After-sales order number（售后单号） |\n| parentOrderSn | STRING | Parent order number（父订单号） |\n| orderSn | STRING | Order number（子订单号） |\n| productSkuId | LONG | Product SKU ID |\n| applyGoodsNumber | LONG | Quantity requested for cancellation（申请取消数量） |\n| goodsId | LONG | Goods ID |\n| productList | OBJECT[] | Product information list（产品信息列表） |\n| createAtMillis | LONG | After-sales order creation time, unit in milliseconds（售后单创建时间，毫秒） |\n\n### `productList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| productSkuId | LONG | Product SKU ID |\n| extCode | STRING | Product external code（商品外部编码） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8\n }\n}'\n```\n\n可与 `linkfox-temu-order-us` 的 `bg.order.list.v2.get` / `bg.order.detail.v2.get` 配合：先查订单 `pending_buyer_cancellation` 标签，再按 `parentOrderSnList` 拉取消售后明细。\n\nFile v1.0.3:references/apis/temu-order-cancel-appeal-apply.md\n\n# 卖家发起取消申请 — `temu.order.cancel.appeal.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** Support merchants to initiate cancellation requests through the interface（支持商家通过接口发起取消申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `reason.proofUrlList` 中的图片须先经 **`temu.order.query.signature`** 转为 URL 后再传入（该接口待接入时可先用 `temu_us_proxy.py` 试调）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── cancelType (INTEGER, 是)\n ├── applyOrder (OBJECT, 是)\n │ └── parentOrderSn (STRING, 是)\n └── reason (OBJECT, 是)\n ├── description (STRING, 是)\n └── proofUrlList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| cancelType | INTEGER | **是** | The types of application for cancellation（取消申请类型），见下表 |\n| applyOrder | OBJECT | **是** | Details of the application to cancel the order（取消订单申请详情） |\n| reason | OBJECT | **是** | Explanation of Application Reasons（申请原因说明） |\n\n#### `cancelType`\n\n| 值 | 说明 |\n|----|------|\n| `2` | Suspected batch refund（疑似批量退款） |\n| `3` | Incorrect address（地址错误） |\n\n### `applyOrder`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | Parent order sn（父订单号） |\n\n### `reason`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| description | STRING | **是** | Explanation of the reason for cancellation initiated（发起取消的原因说明） |\n| proofUrlList | STRING[] | **是** | Related screenshots serve as supplementary evidence to illustrate the rationality of the application（相关截图作为补充证据，说明申请的合理性）；图片须先通过 **`temu.order.query.signature`** 转为 URL 后传入 |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Customer provided incorrect shipping address\",\n \"proofUrlList\": [\n \"https://signed-url-from-temu.order.query.signature/...\"\n ]\n }\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── applySn\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | apply sn（取消申请单号） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"cancelType\": 3,\n \"applyOrder\": {\n \"parentOrderSn\": \"PO-123456789\"\n },\n \"reason\": {\n \"description\": \"Incorrect address confirmed with buyer\",\n \"proofUrlList\": [\"https://signed-url/...\"]\n }\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) 查询 `status`。\n\nFile v1.0.3:references/apis/temu-order-cancel-appeal-result-get.md\n\n# 查询取消申请结果 — `temu.order.cancel.appeal.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_appeal_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.appeal.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Merchant queries the status of cancellation order appeal records（商家查询取消订单申诉记录的状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `applySnList` 中的申请单号通常来自 [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) 返回的 `result.applySn`。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n └── applySnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| applySnList | STRING[] | **是** | Apply sn list（取消申请单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n └── itemList[]\n ├── applySn\n └── status\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| itemList | OBJECT[] | result item list（取消申请结果列表） |\n\n### `itemList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applySn | STRING | Apply sn（取消申请单号） |\n| status | INTEGER | Apply cancel status（取消申请状态），见下表 |\n\n#### `status`\n\n| 值 | 说明 |\n|----|------|\n| `1` | Auditing（审核中） |\n| `2` | Approved（已通过） |\n| `3` | Rejected（已拒绝） |\n| `4` | Apply failed（申请失败） |\n| `5` | Canceled（已取消） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_appeal_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"applySnList\": [\"APPLY-SN-123456789\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.appeal.apply` 提交申请取得 `applySn` → 本接口轮询 `status`（`1` 审核中 → `2` 通过 / `3` 拒绝 / `4` 失败 / `5` 已取消）→ 可用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.3:references/apis/temu-order-cancel-outofstock-apply.md\n\n# 缺货取消申请 — `temu.order.cancel.outofstock.apply`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_apply.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.apply`，业务载荷放在 Body 的 `params` |\n\n**Description:** The user takes the initiative to initiate a stock-out situation, which will be submitted to the risk control department for review（商家主动发起缺货情况，提交风控部门审核）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock apply request\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock apply response\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── applyResult\n └── failReasonList[]\n ├── parentOrderSn\n ├── orderSn\n └── reasonList[]\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | lack stock apply result |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResult | BOOLEAN | lack stock apply result（缺货申请结果）：`true` = apply success（申请成功）；`false` = apply fail（申请失败） |\n| failReasonList | OBJECT[] | apply fail reason list（申请失败原因列表）；`applyResult=true` 时通常为空或不返回 |\n\n### `failReasonList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| parentOrderSn | STRING | parent order sn（父订单号） |\n| orderSn | STRING | order sn（子订单号） |\n| reasonList | STRING[] | apply fail reason code list（申请失败原因码列表） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`linkfox-temu-order-us` 查 `parentOrderSn` / `orderSn` → 本接口提交缺货取消申请（风控审核）→ 根据 `applyResult` 与 `failReasonList` 确认是否受理。\n\nFile v1.0.3:references/apis/temu-order-cancel-outofstock-result-get.md\n\n# 查询缺货取消审核结果 — `temu.order.cancel.outofstock.result.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_seller_cancel_order_cancel_outofstock_result_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`temu.order.cancel.outofstock.result.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** After applying for out-of-stock, since out-of-stock itself is an asynchronous operation, you need to obtain the latest out-of-stock review status through the query interface（提交缺货取消申请后，由于缺货本身是异步操作，需要通过本查询接口获取最新的缺货审核状态）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentOrderSn`、`orderSnList` 通常来自 `linkfox-temu-order-us` 订单列表/详情接口，或与 [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) 提交时使用的参数一致。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填) — lack stock query request from ams\n ├── parentOrderSn (STRING, 是)\n └── orderSnList[] (STRING[], 是)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentOrderSn | STRING | **是** | parent order sn（父订单号） |\n| orderSnList | STRING[] | **是** | order sn list（子订单号列表） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\", \"O-222222222\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse — lack stock query response from ams\n├── success (BOOLEAN)\n├── errorCode (INTEGER)\n├── errorMsg (STRING)\n└── result (OBJECT) — Specific information\n └── applyResultInfoList[] (OBJECT[]) — lack stock order apply result info list\n ├── orderSn (STRING)\n └── applyStatus (INTEGER)\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success（请求是否成功） |\n| errorCode | INTEGER | error code（错误码） |\n| errorMsg | STRING | error message（错误信息） |\n| result | OBJECT | Specific information（具体结果信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| applyResultInfoList | OBJECT[] | lack stock order apply result info list（缺货取消申请结果信息列表） |\n\n### `applyResultInfoList[]`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| orderSn | STRING | order sn（子订单号） |\n| applyStatus | INTEGER | lack stock apply status（缺货申请审核状态） |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_seller_cancel_order_cancel_outofstock_result_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'\n```\n\n典型流程：`temu.order.cancel.outofstock.apply` 提交缺货取消申请（风控审核）→ 本接口查询 `applyStatus` 获取最新审核状态 → 根据状态决定后续操作。\n\nFile v1.0.3:references/authorization-flow.md\n\n# Temu 授权流程\n\n```text\n用户确认店铺类型与用途\n ↓\ntemu_token_guide.py（输出后台操作步骤）\n ↓\n用户在 Temu 卖家后台复制 access_token\n ↓\nsave_temu_access_token.py（可选，写入本地 store）\n ↓\ntemu_proxy.py / temu_file_download.py\n - 直接传 accessToken，或\n - 传 storeKey + site + managementType + tokenPurpose\n```\n\n## 决策表\n\n| 用户需求 | shopType | tokenPurpose | site |\n|----------|----------|--------------|------|\n| 半托管查商品/库存 | semi-managed | product-inventory | cn / partner |\n| 半托管查订单/发货 | semi-managed | order-shipping | us / global / eu |\n| 全托管任意接口 | full-managed | full-managed | cn / partner |\n| 美欧本土店 | local-native | local-native | us 等 |\n\n## 与 API 调用的对应关系\n\n紫鸟转发路径：`/temu-proxy/{site}/{managementType}`\n\n- 全托管 CN：`cn` + `full-managed`\n- 半托管商品：`cn`/`partner` + `semi-managed` + 商品 token\n- 半托管订单：`us`/`global`/`eu` + `semi-managed` + 订单 token\n\n授权应用名称必须与后台一致：**酷鸟卖家助手** 或 **Cyber-ERP酷鸟助手** / **Cyber-ERP**。\n\nArchive v1.0.2: 33 files, 39272 bytes\n\nFiles: references/access-token.md (4450b), references/api.md (4197b), references/apis/bg-aftersales-cancel-agree.md (2732b), references/apis/bg-aftersales-cancel-list-get.md (5811b), references/apis/README.md (953b), references/apis/temu-order-cancel-appeal-apply.md (3922b), references/apis/temu-order-cancel-appeal-result-get.md (2818b), references/apis/temu-order-cancel-outofstock-apply.md (3192b), references/apis/temu-order-cancel-outofstock-result-get.md (3393b), references/authorization-flow.md (1186b), references/partner-us-catalog.md (2853b), scripts/_temu_auth_guide.py (6198b), scripts/_temu_common.py (12430b), scripts/_temu_token_store.py (4273b), scripts/_temu_us_common.py (3199b), scripts/_us_cancel_order_script.py (504b), scripts/check_linkfox_token.py (1797b), scripts/get_temu_access_token.py (1843b), scripts/list_temu_access_tokens.py (652b), scripts/save_temu_access_token.py (1377b), scripts/temu_file_download.py (1681b), scripts/temu_proxy.py (2124b), scripts/temu_token_guide.py (1594b), scripts/temu_us_file_download.py (719b), scripts/temu_us_proxy.py (956b), scripts/us_cancel_aftersales_cancel_agree.py (260b), scripts/us_cancel_aftersales_cancel_list_get.py (281b), scripts/us_seller_cancel_order_cancel_appeal_apply.py (283b), scripts/us_seller_cancel_order_cancel_appeal_result_get.py (304b), scripts/us_seller_cancel_order_cancel_outofstock_apply.py (289b), scripts/us_seller_cancel_order_cancel_outofstock_result_get.py (316b), SKILL.md (5746b), _meta.json (147b)\n\nFile v1.0.2:SKILL.md\n\n---\r\nname: linkfox-temu-cancel-order-us\r\ndescription: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。\r\n---\r\n\r\n# Temu 美国站 — 取消订单（买家 + 卖家）\r\n\r\n本 skill（`linkfox-temu-cancel-order-us`）覆盖 Partner Platform for US **取消订单**相关接口：\r\n\r\n- **买家/消费者**：`bg.aftersales.cancel.list.get`、`bg.aftersales.cancel.agree`\r\n- **店家/卖家**：`temu.order.cancel.appeal.apply`、`temu.order.cancel.appeal.result.get`、`temu.order.cancel.outofstock.apply`、`temu.order.cancel.outofstock.result.get`\r\n\r\n详见 [partner-us-catalog.md](./references/partner-us-catalog.md)（**6** 个接口）。\r\n\r\n**网关（本 skill 内置）**：\r\n\r\n| 能力 | 方法 | 路径 |\r\n|------|------|------|\r\n| 取消单 OpenAPI（`us_cancel_*`、`us_seller_cancel_*`、`temu_us_proxy`） | POST | `https://tool-gateway.linkfox.com/temu/proxy` |\r\n| 加签文件下载 | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` |\r\n\r\n## 相关 skill\r\n\r\n| 场景 | skill |\r\n|------|--------|\r\n| 订单列表/详情/发货/地址/金额 | `linkfox-temu-order-us` |\r\n| 欧洲站取消订单 | `linkfox-temu-cancel-order-eu` |\r\n| 全球站（非 US/EU）取消订单 | `linkfox-temu-cancel-order-global` |\r\n| 履约/发货 | `linkfox-temu-fulfillment-us` |\r\n| 商品管理 | `linkfox-temu-manage-product-us` |\r\n| 退货与退款 | `linkfox-temu-returns-refunds-us` |\r\n| 网关与 Temu token | 本 skill `scripts/` |\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /temu/proxy`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/<脚本名>.py '' [--inline]`（可用脚本见上文脚本一览）\r\n- **成本约束**：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-temu-cancel-order-us-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## 默认参数\r\n\r\n| 字段 | 默认 | 说明 |\r\n|------|------|------|\r\n| site | `us` | Partner US |\r\n| managementType | `semi-managed` | 半托管 |\r\n| tokenPurpose | `order-shipping` | 订单/取消场景 token |\r\n\r\n## 鉴权\r\n\r\n1. **LinkFox**：`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token`\r\n2. **Temu**：`accessToken` 或 `storeKey`（建议 `tokenPurpose=order-shipping`）\r\n\r\n## Scripts（按 type）\r\n\r\n### 买家取消\r\n\r\n| 脚本 | type |\r\n|------|------|\r\n| `us_cancel_aftersales_cancel_list_get.py` | `bg.aftersales.cancel.list.get` |\r\n| `us_cancel_aftersales_cancel_agree.py` | `bg.aftersales.cancel.agree` |\r\n\r\n### 卖家取消\r\n\r\n| 脚本 | type |\r\n|------|------|\r\n| `us_seller_cancel_order_cancel_appeal_apply.py` | `temu.order.cancel.appeal.apply` |\r\n| `us_seller_cancel_order_cancel_appeal_result_get.py` | `temu.order.cancel.appeal.result.get` |\r\n| `us_seller_cancel_order_cancel_outofstock_apply.py` | `temu.order.cancel.outofstock.apply` |\r\n| `us_seller_cancel_order_cancel_outofstock_result_get.py` | `temu.order.cancel.outofstock.result.get` |\r\n\r\n### 通用\r\n\r\n| 脚本 | 说明 |\r\n|------|------|\r\n| `temu_us_proxy.py` | 任意 `type` |\r\n| `temu_us_file_download.py` | 加签文件下载 |\r\n\r\n## 接入新接口（约定）\r\n\r\n1. 新增 `references/apis/.md`\r\n2. 新增 `scripts/us_cancel_*` 或 `us_seller_cancel_*`（调用 `_us_cancel_order_script.run_cli`）\r\n3. 更新 [partner-us-catalog.md](./references/partner-us-catalog.md)、[apis/README.md](./references/apis/README.md)\r\n\r\n## 示例\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\n\r\n# 买家取消 — 待处理列表\r\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\r\n \"accessToken\": \"TOKEN\",\r\n \"tokenPurpose\": \"order-shipping\",\r\n \"request\": { \"pageNo\": 1, \"pageSize\": 20, \"afterSalesStatusGroup\": 8 }\r\n}'\r\n\r\n# 卖家 — 缺货取消申请\r\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\r\n \"accessToken\": \"TOKEN\",\r\n \"tokenPurpose\": \"order-shipping\",\r\n \"request\": {\r\n \"parentOrderSn\": \"PO-123456789\",\r\n \"orderSnList\": [\"O-111111111\"]\r\n }\r\n}'\r\n```\r\n\r\n**Feedback：** `skillName`：`linkfox-temu-cancel-order-us`\r\n\r\n## 网关与授权脚本\r\n\r\n| 脚本 | 说明 |\r\n|------|------|\r\n| `check_linkfox_token.py` | 校验 LinkFox Token |\r\n| `save_temu_access_token.py` / `list_temu_access_tokens.py` / `get_temu_access_token.py` | 本地 token |\r\n| `temu_token_guide.py` | Temu 授权指引 |\r\n\r\n授权说明：[references/access-token.md](./references/access-token.md)\n\nFile v1.0.2:references/apis/README.md\n\n# Cancel Order — 接口文档索引\n\n每个 `type` 单独一份文档，经 `POST /temu/proxy` 调用。\n\n## 买家/消费者取消（2）\n\n| type | 文档 |\n|------|------|\n| `bg.aftersales.cancel.list.get` | [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) |\n| `bg.aftersales.cancel.agree` | [bg-aftersales-cancel-agree.md](./bg-aftersales-cancel-agree.md) |\n\n## 卖家/店家取消（4）\n\n| type | 文档 |\n|------|------|\n| `temu.order.cancel.appeal.apply` | [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) |\n| `temu.order.cancel.appeal.result.get` | [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) |\n| `temu.order.cancel.outofstock.apply` | [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) |\n| `temu.order.cancel.outofstock.result.get` | [temu-order-cancel-outofstock-result-get.md](./temu-order-cancel-outofstock-result-get.md) |\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-cancel-order-us\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1783071552838\n}\n\nFile v1.0.2:references/access-token.md\n\n# Temu accessToken 授权与获取\n\nTemu **没有** LinkFox 侧自动 OAuth；`accessToken` 须在 Temu 卖家后台「服务市场 → 授权管理」**手动复制**。与 `LINKFOXAGENT_API_KEY`（LinkFox 用户鉴权）是两套令牌。\n\n## 两种鉴权（勿混淆）\n\n| 令牌 | 用途 | 获取方式 |\n|------|------|----------|\n| **LinkFox 用户 Token** | 调用 `/temu/proxy`、`/temu/fileDownload` **必填** | `LINKFOXAGENT_API_KEY` 或请求 JSON 的 `token`；Header `Authorization` + `Token`（同 amazon-store-auth） |\n| **Temu accessToken** | Temu 业务 API（经紫鸟转发） | Temu 卖家后台授权后复制 |\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/check_linkfox_token.py\n```\n\n## tokenPurpose 与场景\n\n| tokenPurpose | 店铺类型 | 推荐 site | 授权应用 |\n|--------------|----------|-----------|----------|\n| `product-inventory` | 半托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `order-shipping` | 半托管 | `us` / `global` / `eu` | Cyber-ERP酷鸟助手 |\n| `full-managed` | 全托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `local-native` | 本土（美/欧主体） | `us` 等 | Cyber-ERP |\n\n## 1. 半托管 — 商品/库存 Token\n\n1. 登录 [seller.kuajingmaihuo.com](https://seller.kuajingmaihuo.com) 或 [agentseller.temu.com](https://agentseller.temu.com)\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → 选择 **「酷鸟卖家助手」**\n4. 全选常规和特殊授权 → 确认 → **复制 access_token**\n5. 调用 API：`site=cn` 或 `partner`，`managementType=semi-managed`\n\n## 2. 半托管 — 订单/发货 Token\n\n1. 登录 Temu 卖家后台\n2. 右上角 **Seller Central** → 切换到目标区域（美区 / 欧区 / 全球）\n3. **服务市场** → **授权管理**\n4. **获取授权** → 选择 **「Cyber-ERP酷鸟助手」**\n5. 全选授权 → 确认 → 复制 token\n6. 调用 API：`site=us` / `global` / `eu`，`managementType=semi-managed`\n\n## 3. 全托管店铺\n\n1. 登录 Temu 平台\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → **「酷鸟卖家助手」** → 全选 → 复制 token\n4. 调用 API：`managementType=full-managed`，`site` 通常 `cn` 或 `partner`\n\n## 4. 本土店铺（美区、欧区主体）\n\n1. 登录 Temu\n2. **Apps And Services** → **Manage Your Apps**\n3. **Authorize a new app** → 搜索 **「Cyber-ERP」**\n4. 一般权限与敏感权限全选 → 确认 → 复制 token\n\n## 站点与 OpenAPI 网关\n\n| site | 说明 | Temu 网关 |\n|------|------|-----------|\n| cn | 中国站 | openapi.kuajingmaihuo.com |\n| partner | Partner 网关 | openapi-b-partner.temu.com |\n| us | 美国站 | openapi-b-us.temu.com |\n| global | 全球区 | openapi-b-global.temu.com |\n| eu | 欧洲站 | openapi-b-eu.temu.com |\n\n## 本地保存 Token（推荐）\n\n默认存储：`~/.linkfox/temu-access-tokens.json`（可用 `TEMU_TOKEN_STORE_PATH` 覆盖）。\n\n```bash\n# 查看授权步骤\npython scripts/temu_token_guide.py '{\"shopType\":\"semi-managed\",\"tokenPurpose\":\"product-inventory\",\"site\":\"cn\"}'\n\n# 保存 token\npython scripts/save_temu_access_token.py '{\n \"storeKey\": \"my-shop\",\n \"label\": \"中国半托管\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"accessToken\": \"PASTE_TOKEN\"\n}'\n\n# 列出已保存（脱敏）\npython scripts/list_temu_access_tokens.py\n\n# 用 storeKey 调 API（无需每次粘贴 token）\npython scripts/temu_proxy.py '{\n \"storeKey\": \"my-shop\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"type\": \"bg.goods.category.mapping\",\n \"params\": {\"goodsName\": \"测试\", \"goodsNameEn\": \"Test\"}\n}'\n```\n\n## 注意事项\n\n1. **子账号**：可能无法进入服务市场，需主账号授权。\n2. **多站点**：美国站、英国站等需分别登录对应后台获取 Token。\n3. **有效期**：Token 会过期，过期后重新在后台复制并 `save_temu_access_token.py`。\n4. **IP 白名单**：需联系紫鸟开放平台配置调用 IP。\n5. **参数小写**：`site`、`managementType` 必须小写。\n\n## 脚本一览\n\n| 脚本 | 说明 |\n|------|------|\n| `temu_token_guide.py` | 按店铺类型/用途输出授权步骤 |\n| `save_temu_access_token.py` | 保存 accessToken 到本地 |\n| `list_temu_access_tokens.py` | 列出已保存 token（默认脱敏）|\n| `get_temu_access_token.py` | 读取指定 store 的 token |\n\nFile v1.0.2:references/api.md\n\n# linkfox-temu-cancel-order-us — API 参考\r\n\r\nTemu **美国站取消订单**（买家取消 + 卖家取消）（Partner US **Cancel Order** — 买家 `bg.aftersales.cancel.*` + 卖家 `temu.order.cancel.*`），经本 skill `temu_us_proxy`（`POST /temu/proxy`） 转发。Temu 的 `type` 写在 Body，**不是** URL 路径。\r\n\r\n> 网关与鉴权：本 skill `scripts/`（`LINKFOXAGENT_API_KEY`、`accessToken` / `storeKey`）。建议 token 见 `references/access-token.md`（`tokenPurpose=order-shipping`）。\r\n\r\n---\r\n\r\n## 调用规范\r\n\r\n| 项 | 说明 |\r\n|----|------|\r\n| 网关根地址 | `${LINKFOX_TOOL_GATEWAY}`（可用 `LINKFOX_TOOL_GATEWAY` / `TEMU_API_BASE_URL` / `STORE_API_BASE_URL` 覆盖） |\r\n| 卖家取消单 OpenAPI | `POST /temu/proxy` |\r\n| 加签文件下载 | `POST /temu/fileDownload`（`temu_us_file_download.py`） |\r\n| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**（同值）；或 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`；或 JSON `token` |\r\n| Temu 鉴权 | Body `accessToken`，或 `storeKey` + `site` + `managementType` + `tokenPurpose` |\r\n| 默认 | `site=us`，`managementType=semi-managed`，`tokenPurpose=order-shipping` |\r\n| 上游 OpenAPI（US） | `https://openapi-b-us.temu.com/openapi/router`（网关按 `site` 解析） |\r\n\r\n### 网关请求 Body（`/temu/proxy`）\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| site | string | 是 | `us`（本 skill 默认） |\r\n| managementType | string | 是 | `semi-managed` |\r\n| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌 |\r\n| storeKey | string | 与 accessToken 二选一 | `~/.linkfox/temu-access-tokens.json` 中的键 |\r\n| tokenPurpose | string | 否 | 建议 **`order-shipping`** |\r\n| type | string | 是 | Temu 接口名，如 Partner 文档中的 `bg.*` / `temu.*` |\r\n| params | object | 否 | 业务参数；多数接口业务块在 **`params.request`** |\r\n\r\n### 网关响应\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| body | string | Temu 原始 JSON 字符串；脚本解析为 `temuBody` |\r\n| code | integer | 网关错误码：`1002` 参数/Token，`1003` 转发失败 |\r\n\r\n解析顺序：**网关 `code`** → `JSON.parse(body)` → `success` / `errorCode` / `errorMsg` / `result`。\r\n\r\n### 脚本调用\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\npython scripts/temu_us_proxy.py '{\"accessToken\":\"TOKEN\",\"tokenPurpose\":\"order-shipping\",\"type\":\"\",\"params\":{\"request\":{}}}'\r\n```\r\n\r\n业务字段可放在顶层或嵌套 `params`；含 `request` 时通常整体作为 `params` 转发。\r\n\r\n---\r\n\r\n## 接口一览\r\n\r\n完整 `sub_menu_code` 与 Partner 文档 URL 见 [partner-us-catalog.md](./partner-us-catalog.md)。\r\n\r\n**每个接口单独一份文档**：[apis/README.md](./apis/README.md)（随接入递增）。\r\n\r\n> 已接入接口见 [apis/README.md](./apis/README.md)。\r\n\r\n---\r\n\r\n## 典型买家取消流程\r\n\r\n```text\r\n1. bg.aftersales.cancel.list.get（本 skill） → 查待处理买家取消售后（afterSalesStatusGroup=8 等）\r\n2. bg.aftersales.cancel.agree（本 skill） → 同意取消（parentAfterSalesSn + parentOrderSn）\r\n3. linkfox-temu-order-us → 刷新订单状态\r\n```\r\n\r\n## 典型卖家取消流程\r\n\r\n```text\r\n1. linkfox-temu-order-us → 查订单 parentOrderSn / orderSn、发货状态\r\n2a. temu.order.cancel.appeal.apply（本 skill） → 申诉类取消申请，返回 applySn\r\n2b. temu.order.cancel.outofstock.apply（本 skill） → 缺货取消申请（提交风控），返回 applyResult\r\n3. temu.order.cancel.appeal.result.get（本 skill） → 按 applySnList 查询申诉 status\r\n4. linkfox-temu-order-us → 取消后刷新订单状态（list/detail）\r\n```\r\n\r\n---\r\n\r\n## 网关错误码\r\n\r\n| code | 说明 | 处理 |\r\n|------|------|------|\r\n| 1002 | 参数或 LinkFox Token 无效 | 修正参数与 `LINKFOXAGENT_API_KEY` |\r\n| 1003 | 转发失败 | 检查 Temu token、`tokenPurpose`、白名单、网络 |\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- `skillName`: **`linkfox-temu-cancel-order-us`**\n\nFile v1.0.2:references/apis/bg-aftersales-cancel-agree.md\n\n# 同意取消订单 — `bg.aftersales.cancel.agree`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_agree.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.agree`，业务载荷放在 Body 的 `params` |\n\n**Description:** Agree cancel order（同意买家发起的取消订单申请）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。 \n> `parentAfterSalesSn`、`parentOrderSn` 通常来自 [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) 列表接口返回（`afterSalesStatusGroup=8` 待处理）。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── parentAfterSalesSn (STRING, 是)\n └── parentOrderSn (STRING, 是)\n```\n\n### `request` 内字段\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| parentAfterSalesSn | STRING | **是** | Parent after-sales order number（父售后单号），**不能为空** |\n| parentOrderSn | STRING | **是** | Parent order number（父订单号），**不能为空** |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── result (OBJECT)\n├── success\n├── errorCode\n└── errorMsg\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| result | OBJECT | Empty field（官方未展开子字段；成功时通常为空对象） |\n| success | BOOLEAN | Whether it was successful or not（是否成功） |\n| errorCode | INTEGER | Error code（错误码） |\n| errorMsg | STRING | Error message（错误信息） |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| _(无子字段)_ | — | Partner 文档标注为 Empty field；若实际响应含其它字段，以 Temu 返回 JSON 为准 |\n\n---\n\n## 示例\n\n```bash\npython scripts/us_cancel_aftersales_cancel_agree.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}'\n```\n\n典型流程：`bg.aftersales.cancel.list.get`（`afterSalesStatusGroup=8`）取得 `parentAfterSalesSn` + `parentOrderSn` → 本接口**同意取消** → 可再查列表确认状态变为已同意（`9`）或用 `linkfox-temu-order-us` 刷新订单状态。\n\nFile v1.0.2:references/apis/bg-aftersales-cancel-list-get.md\n\n# 取消订单售后列表查询 — `bg.aftersales.cancel.list.get`\n\n| 项 | 值 |\n|----|-----|\n| **脚本** | `scripts/us_cancel_aftersales_cancel_list_get.py` |\n| **Partner 文档** | https://partner-us.temu.com/documentation（`menu_code` / `sub_menu_code` 以 Partner 后台该接口页为准） |\n| **网关** | `POST /temu/proxy`，`type`=`bg.aftersales.cancel.list.get`，业务载荷放在 Body 的 `params` |\n\n**Description:** Query cancel order after-sales information（查询取消订单售后信息）。\n\n> **网关鉴权字段**由本 skill 网关脚本处理；业务参数见下方 `request`。建议使用 **`tokenPurpose=order-shipping`**。\n\n---\n\n## Request 结构（官方业务参数）\n\n```text\nparams\n└── request (OBJECT, 选填)\n ├── pageSize (INTEGER, 否)\n ├── pageNo (INTEGER, 否)\n ├── parentOrderSnList[] (STRING[], 否)\n ├── parentAfterSalesSnList[] (STRING[], 否)\n └── afterSalesStatusGroup (INTEGER, 否)\n```\n\n### `request`\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pageSize | INTEGER | 否 | Page size for pagination，**默认 10**，**最大 200** |\n| pageNo | INTEGER | 否 | Page number for pagination，**默认 1** |\n| parentOrderSnList | STRING[] | 否 | Parent order number list；留空则不限制父订单号范围；**单次查询最多 200 条** |\n| parentAfterSalesSnList | STRING[] | 否 | Parent after-sales order number list；留空则不限制父售后单号范围；**单次查询最多 200 条** |\n| afterSalesStatusGroup | INTEGER | 否 | The cancel order after-sales status group（取消订单售后状态组），见下表 |\n\n#### `afterSalesStatusGroup`（入参筛选）\n\n| 值 | 说明 |\n|----|------|\n| `8` | Cancel order pending（取消订单待处理） |\n| `9` | Cancel order approved（取消订单已同意） |\n| `10` | Cancel order rejected（取消订单已拒绝） |\n| `11` | Cancel order revoked（取消订单已撤销） |\n\n### 网关 `params` 写法\n\n```json\n{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"pageNo\": 1,\n \"pageSize\": 20,\n \"afterSalesStatusGroup\": 8,\n \"parentOrderSnList\": [\"PO-123456789\"]\n }\n}\n```\n\n---\n\n## Response（Temu `body` 解析后）\n\n```text\nresponse\n├── success\n├── errorCode\n├── errorMsg\n└── result\n ├── total\n ├── pageNumber\n └── data[]\n ├── parentAfterSalesSn\n ├── parentAfterSalesStatus\n └── afterSalesInfoList[]\n ├── afterSalesSn\n ├── parentOrderSn\n ├── orderSn\n ├── productSkuId\n ├── applyGoodsNumber\n ├── goodsId\n ├── productList[]\n │ ├── productSkuId\n │ └── extCode\n └── createAtMillis\n```\n\n### `response` 顶层字段\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| success | BOOLEAN | success |\n| errorCode | INTEGER | error code |\n| errorMsg | STRING | error message |\n| result | OBJECT | Specific information |\n\n### `result`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| total | LONG | Total number of matching rec\n\nArchive v1.0.0: 34 files, 37671 bytes\n\nFiles: references/access-token.md (4450b), references/api.md (4060b), references/apis/bg-aftersales-cancel-agree.md (2732b), references/apis/bg-aftersales-cancel-list-get.md (5811b), references/apis/README.md (953b), references/apis/temu-order-cancel-appeal-apply.md (3922b), references/apis/temu-order-cancel-appeal-result-get.md (2818b), references/apis/temu-order-cancel-outofstock-apply.md (3192b), references/apis/temu-order-cancel-outofstock-result-get.md (3393b), references/authorization-flow.md (1186b), references/partner-us-catalog.md (2853b), scripts/_temu_auth_guide.py (6198b), scripts/_temu_common.py (5593b), scripts/_temu_token_store.py (4237b), scripts/_temu_us_common.py (3082b), scripts/_us_cancel_order_script.py (504b), scripts/check_linkfox_token.py (1797b), scripts/get_temu_access_token.py (1843b), scripts/list_temu_access_tokens.py (652b), scripts/save_temu_access_token.py (1377b), scripts/temu_file_download.py (1595b), scripts/temu_proxy.py (2027b), scripts/temu_token_guide.py (1594b), scripts/temu_us_file_download.py (650b), scripts/temu_us_proxy.py (879b), scripts/us_cancel_aftersales_cancel_agree.py (260b), scripts/us_cancel_aftersales_cancel_list_get.py (281b), scripts/us_seller_cancel_order_cancel_appeal_apply.py (283b), scripts/us_seller_cancel_order_cancel_appeal_result_get.py (304b), scripts/us_seller_cancel_order_cancel_outofstock_apply.py (289b), scripts/us_seller_cancel_order_cancel_outofstock_result_get.py (316b), skill-card.md (2713b), SKILL.md (4640b), _meta.json (147b)","readmeExcerpt":"Skill: Temu美国站-取消订单 Owner: linkfox-ai Summary: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。 Tags: latest:1.0.6 Version history: v1.0.6 | 2026-08-","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"\"\n\n# 买家取消 — 待处理列表\npython scripts/us_cancel_aftersales_cancel_list_get.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": { \"pageNo\": 1, \"pageSize\": 20, \"afterSalesStatusGroup\": 8 }\n}'\n\n# 卖家 — 缺货取消申请\npython scripts/us_seller_cancel_order_cancel_outofstock_apply.py '{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentOrderSn\": \"PO-123456789\",\n \"orderSnList\": [\"O-111111111\"]\n }\n}'"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"\"\npython scripts/check_linkfox_token.py"},{"language":"bash","snippet":"# 查看授权步骤\npython scripts/temu_token_guide.py '{\"shopType\":\"semi-managed\",\"tokenPurpose\":\"product-inventory\",\"site\":\"cn\"}'\n\n# 保存 token\npython scripts/save_temu_access_token.py '{\n \"storeKey\": \"my-shop\",\n \"label\": \"中国半托管\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"accessToken\": \"PASTE_TOKEN\"\n}'\n\n# 列出已保存（脱敏）\npython scripts/list_temu_access_tokens.py\n\n# 用 storeKey 调 API（无需每次粘贴 token）\npython scripts/temu_proxy.py '{\n \"storeKey\": \"my-shop\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"type\": \"bg.goods.category.mapping\",\n \"params\": {\"goodsName\": \"测试\", \"goodsNameEn\": \"Test\"}\n}'"},{"language":"text","snippet":"params\n└── request (OBJECT, 选填)\n ├── parentAfterSalesSn (STRING, 是)\n └── parentOrderSn (STRING, 是)"},{"language":"json","snippet":"{\n \"accessToken\": \"TOKEN\",\n \"tokenPurpose\": \"order-shipping\",\n \"request\": {\n \"parentAfterSalesSn\": \"PAS-123456789\",\n \"parentOrderSn\": \"PO-123456789\"\n }\n}"},{"language":"text","snippet":"response\n├── result (OBJECT)\n├── success\n├── errorCode\n└── errorMsg"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-temu-cancel-order-us\ndescription: Temu 美国站取消订单 API（买家+卖家合一），经 LinkFox 网关转发 Partner US：买家售后取消列表/同意(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.appeal/outofstock.*)等。当用户提到 Temu US 取消订单、买家取消、卖家取消、缺货取消、afterSalesStatusGroup、applySn、order-shipping 时触发。订单用 linkfox-temu-order-us；欧洲站用 linkfox-temu-cancel-order-eu；全球站用 linkfox-temu-cancel-order-global。\n---\n\n# Temu 美国站 — 取消订单（买家 + 卖家）\n\n本 skill（`linkfox-temu-cancel-order-us`）覆盖 Partner Platform for US **取消订单**相关接口：\n\n- **买家/消费者**：`bg.aftersales.cancel.list.get`、`bg.aftersales.cancel.agree`\n- **店家/卖家**：`temu.order.cancel.appeal.apply`、`temu.order.cancel.appeal.result.get`、`temu.order.cancel.outofstock.apply`、`temu.order.cancel.outofstock.result.get`\n\n详见 [partner-us-catalog.md](./references/partner-us-catalog.md)（**6** 个接口）。\n\n**网关（本 skill 内置）**：\n\n| 能力 | 方法 | 路径 |\n|------|------|------|\n| 取消单 OpenAPI（`us_cancel_*`、`us_seller_cancel_*`、`temu_us_proxy`） | POST | `https://tool-gateway.linkfox.com/temu/proxy` |\n| 加签文件下载 | POST | `https://tool-gateway.linkfox.com/temu/fileDownload` |\n\n## 相关 skill\n\n| 场景 | skill |\n|------|--------|\n| 订单列表/详情/发货/地址/金额 | `linkfox-temu-order-us` |\n| 欧洲站取消订单 | `linkfox-temu-cancel-order-eu` |\n| 全球站（非 US/EU）取消订单 | `linkfox-temu-cancel-order-global` |\n| 履约/发货 | `linkfox-temu-fulfillment-us` |\n| 商品管理 | `linkfox-temu-manage-product-us` |\n| 退货与退款 | `linkfox-temu-returns-refunds-us` |\n| 网关与 Temu token | 本 skill `scripts/` |\n\n## 调用方式\n\n- **API 端点**：`POST /temu/proxy`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/<脚本名>.py '' [--inline]`（可用脚本见上文脚本一览）\n- **成本约束**：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-temu-cancel-order-us-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 默认参数\n\n| 字段 | 默认 | 说明 |\n|------|------|------|\n| site | `us` | Partner US |\n| managementType | `semi-managed` | 半托管 |\n| tokenPurpose | `order-shipping` | 订单/取消场景 token |\n\n## 鉴权\n\n1. **LinkFox**：`LINKFOXAGENT_API_KEY` → Header `Authorization` + `Token`\n2. **Temu**：`accessToken` 或 `storeKey`（建议 `tokenPurpose=order-shipping`）\n\n## Scripts（按 type）\n\n### 买家取消\n\n| 脚本 | type |\n|------|------|\n| `us_cancel_aftersales_cancel_list_get.py` | `bg.aftersales.cancel.list.get` |\n| `us_cancel_aftersales_cancel_agree.py` | `bg.aftersales.cancel.agree` |\n\n### 卖家取消\n\n| 脚本 | type |\n|------|------|\n| `us_seller_c"},{"path":"references/apis/README.md","content":"# Cancel Order — 接口文档索引\n\n每个 `type` 单独一份文档，经 `POST /temu/proxy` 调用。\n\n## 买家/消费者取消（2）\n\n| type | 文档 |\n|------|------|\n| `bg.aftersales.cancel.list.get` | [bg-aftersales-cancel-list-get.md](./bg-aftersales-cancel-list-get.md) |\n| `bg.aftersales.cancel.agree` | [bg-aftersales-cancel-agree.md](./bg-aftersales-cancel-agree.md) |\n\n## 卖家/店家取消（4）\n\n| type | 文档 |\n|------|------|\n| `temu.order.cancel.appeal.apply` | [temu-order-cancel-appeal-apply.md](./temu-order-cancel-appeal-apply.md) |\n| `temu.order.cancel.appeal.result.get` | [temu-order-cancel-appeal-result-get.md](./temu-order-cancel-appeal-result-get.md) |\n| `temu.order.cancel.outofstock.apply` | [temu-order-cancel-outofstock-apply.md](./temu-order-cancel-outofstock-apply.md) |\n| `temu.order.cancel.outofstock.result.get` | [temu-order-cancel-outofstock-result-get.md](./temu-order-cancel-outofstock-result-get.md) |"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-temu-cancel-order-us\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1786720371776\n}"},{"path":"references/access-token.md","content":"# Temu accessToken 授权与获取\n\nTemu **没有** LinkFox 侧自动 OAuth；`accessToken` 须在 Temu 卖家后台「服务市场 → 授权管理」**手动复制**。与 `LINKFOXAGENT_API_KEY`（LinkFox 用户鉴权）是两套令牌。\n\n## 两种鉴权（勿混淆）\n\n| 令牌 | 用途 | 获取方式 |\n|------|------|----------|\n| **LinkFox 用户 Token** | 调用 `/temu/proxy`、`/temu/fileDownload` **必填** | `LINKFOXAGENT_API_KEY` 或请求 JSON 的 `token`；Header `Authorization` + `Token`（同 amazon-store-auth）（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\n| **Temu accessToken** | Temu 业务 API（经紫鸟转发） | Temu 卖家后台授权后复制 |\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"\"\npython scripts/check_linkfox_token.py\n```\n\n## tokenPurpose 与场景\n\n| tokenPurpose | 店铺类型 | 推荐 site | 授权应用 |\n|--------------|----------|-----------|----------|\n| `product-inventory` | 半托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `order-shipping` | 半托管 | `us` / `global` / `eu` | Cyber-ERP酷鸟助手 |\n| `full-managed` | 全托管 | `cn` / `partner` | 酷鸟卖家助手 |\n| `local-native` | 本土（美/欧主体） | `us` 等 | Cyber-ERP |\n\n## 1. 半托管 — 商品/库存 Token\n\n1. 登录 [seller.kuajingmaihuo.com](https://seller.kuajingmaihuo.com) 或 [agentseller.temu.com](https://agentseller.temu.com)\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → 选择 **「酷鸟卖家助手」**\n4. 全选常规和特殊授权 → 确认 → **复制 access_token**\n5. 调用 API：`site=cn` 或 `partner`，`managementType=semi-managed`\n\n## 2. 半托管 — 订单/发货 Token\n\n1. 登录 Temu 卖家后台\n2. 右上角 **Seller Central** → 切换到目标区域（美区 / 欧区 / 全球）\n3. **服务市场** → **授权管理**\n4. **获取授权** → 选择 **「Cyber-ERP酷鸟助手」**\n5. 全选授权 → 确认 → 复制 token\n6. 调用 API：`site=us` / `global` / `eu`，`managementType=semi-managed`\n\n## 3. 全托管店铺\n\n1. 登录 Temu 平台\n2. **系统管理** → **服务市场** → **授权管理**\n3. **获取授权** → **「酷鸟卖家助手」** → 全选 → 复制 token\n4. 调用 API：`managementType=full-managed`，`site` 通常 `cn` 或 `partner`\n\n## 4. 本土店铺（美区、欧区主体）\n\n1. 登录 Temu\n2. **Apps And Services** → **Manage Your Apps**\n3. **Authorize a new app** → 搜索 **「Cyber-ERP」**\n4. 一般权限与敏感权限全选 → 确认 → 复制 token\n\n## 站点与 OpenAPI 网关\n\n| site | 说明 | Temu 网关 |\n|------|------|-----------|\n| cn | 中国站 | openapi.kuajingmaihuo.com |\n| partner | Partner 网关 | openapi-b-partner.temu.com |\n| us | 美国站 | openapi-b-us.temu.com |\n| global | 全球区 | openapi-b-global.temu.com |\n| eu | 欧洲站 | openapi-b-eu.temu.com |\n\n## 本地保存 Token（推荐）\n\n默认存储：`~/.linkfox/temu-access-tokens.json`（可用 `TEMU_TOKEN_STORE_PATH` 覆盖）。\n\n```bash\n# 查看授权步骤\npython scripts/temu_token_guide.py '{\"shopType\":\"semi-managed\",\"tokenPurpose\":\"product-inventory\",\"site\":\"cn\"}'\n\n# 保存 token\npython scripts/save_temu_access_token.py '{\n \"storeKey\": \"my-shop\",\n \"label\": \"中国半托管\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"accessToken\": \"PASTE_TOKEN\"\n}'\n\n# 列出已保存（脱敏）\npython scripts/list_temu_access_tokens.py\n\n# 用 storeKey 调 API（无需每次粘贴 token）\npython scripts/temu_proxy.py '{\n \"storeKey\": \"my-shop\",\n \"site\": \"cn\",\n \"managementType\": \"semi-managed\",\n \"tokenPurpose\": \"product-inventory\",\n \"type\": \"bg.goods.category.mapping\",\n \"params\": {\"goodsName\": \"测试\", \"goodsNameEn\": \"Test\"}\n}'\n```\n\n## 注意事项\n\n1. **子账号**：可能无法进入服务市场，需主账号授权。\n2. **多站点**：美国站、英国站等需分别登录对应后台获取 Token。\n3. **有效期**：Token 会过期，过期后重新在后台复制并 `save_"},{"path":"references/api.md","content":"# linkfox-temu-cancel-order-us — API 参考\r\n\r\nTemu **美国站取消订单**（买家取消 + 卖家取消）（Partner US **Cancel Order** — 买家 `bg.aftersales.cancel.*` + 卖家 `temu.order.cancel.*`），经本 skill `temu_us_proxy`（`POST /temu/proxy`） 转发。Temu 的 `type` 写在 Body，**不是** URL 路径。\r\n\r\n> 网关与鉴权：本 skill `scripts/`（`LINKFOXAGENT_API_KEY`、`accessToken` / `storeKey`）。建议 token 见 `references/access-token.md`（`tokenPurpose=order-shipping`）。\r\n\r\n---\r\n\r\n## 调用规范\r\n\r\n| 项 | 说明 |\r\n|----|------|\r\n| 网关根地址 | `${LINKFOX_TOOL_GATEWAY}`（可用 `LINKFOX_TOOL_GATEWAY` / `TEMU_API_BASE_URL` / `STORE_API_BASE_URL` 覆盖） |\r\n| 卖家取消单 OpenAPI | `POST /temu/proxy` |\r\n| 加签文件下载 | `POST /temu/fileDownload`（`temu_us_file_download.py`） |\r\n| LinkFox 鉴权 | Header **`Authorization`** 与 **`Token`**（同值）；或 `LINKFOX_AGENT_API_KEY` / `LINKFOXAGENT_API_KEY`；或 JSON `token`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |\r\n| Temu 鉴权 | Body `accessToken`，或 `storeKey` + `site` + `managementType` + `tokenPurpose` |\r\n| 默认 | `site=us`，`managementType=semi-managed`，`tokenPurpose=order-shipping` |\r\n| 上游 OpenAPI（US） | `https://openapi-b-us.temu.com/openapi/router`（网关按 `site` 解析） |\r\n\r\n### 网关请求 Body（`/temu/proxy`）\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| site | string | 是 | `us`（本 skill 默认） |\r\n| managementType | string | 是 | `semi-managed` |\r\n| accessToken | string | 与 storeKey 二选一 | Temu 店铺令牌 |\r\n| storeKey | string | 与 accessToken 二选一 | `~/.linkfox/temu-access-tokens.json` 中的键 |\r\n| tokenPurpose | string | 否 | 建议 **`order-shipping`** |\r\n| type | string | 是 | Temu 接口名，如 Partner 文档中的 `bg.*` / `temu.*` |\r\n| params | object | 否 | 业务参数；多数接口业务块在 **`params.request`** |\r\n\r\n### 网关响应\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| body | string | Temu 原始 JSON 字符串；脚本解析为 `temuBody` |\r\n| code | integer | 网关错误码：`1002` 参数/Token，`1003` 转发失败 |\r\n\r\n解析顺序：**网关 `code`** → `JSON.parse(body)` → `success` / `errorCode` / `errorMsg` / `result`。\r\n\r\n### 脚本调用\r\n\r\n```bash\r\nexport LINKFOXAGENT_API_KEY=\"\"\r\npython scripts/temu_us_proxy.py '{\"accessToken\":\"TOKEN\",\"tokenPurpose\":\"order-shipping\",\"type\":\"\",\"params\":{\"request\":{}}}'\r\n```\r\n\r\n业务字段可放在顶层或嵌套 `params`；含 `request` 时通常整体作为 `params` 转发。\r\n\r\n---\r\n\r\n## 接口一览\r\n\r\n完整 `sub_menu_code` 与 Partner 文档 URL 见 [partner-us-catalog.md](./partner-us-catalog.md)。\r\n\r\n**每个接口单独一份文档**：[apis/README.md](./apis/README.md)（随接入递增）。\r\n\r\n> 已接入接口见 [apis/README.md](./apis/README.md)。\r\n\r\n---\r\n\r\n## 典型买家取消流程\r\n\r\n```text\r\n1. bg.aftersales.cancel.list.get（本 skill） → 查待处理买家取消售后（afterSalesStatusGroup=8 等）\r\n2. bg.aftersales.cancel.agree（本 skill） → 同意取消（parentAfterSalesSn + parentOrderSn）\r\n3. linkfox-temu-order-us → 刷新订单状态\r\n```\r\n\r\n## 典型卖家取消流程\r\n\r\n```text\r\n1. linkfox-temu-order-us → 查订单 parentOrderSn / orderSn、发货状态\r\n2a. temu.order.cancel.appeal.apply（本 skill） → 申诉类取消申请，返回 applySn\r\n2b. temu.order.cancel.outofstock.apply（本 skill） → 缺货取消申请（提交风控），返回 applyResult\r\n3. temu.order.cancel.appeal.result.get（本 skill） → 按 applySnList 查询申诉 status\r\n4. linkfox-temu-order-us → 取消后"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1120,"uniquenessScore":35,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T17:03:00.745Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T17:03:00.745Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T21:53:01.477Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}