Coding

Temu全球站-退货退款

Try it

Temu 全球站电商退货与退款 API,经 LinkFox 网关转发 Partner Global Returns & Refunds / 售后退货退款 相关 bg/temu 接口(退货申请、退款、售后单查询与处理等,接口将按 Partner 文档逐条接入)。当用户提到 Temu Global 退货、退款、售后退货、return、refund、aftersales return、parentAfterSalesSn、退货单、退款单、order-shipping 售后 时触发。买家/卖家取消订单用 linkfox-temu-cancel-order-global / linkfox-temu-cancel-order-global;订单用 linkfox-temu-order-global。

What it does

Temu 全球站电商退货与退款 API,经 LinkFox 网关转发 Partner Global Returns & Refunds / 售后退货退款 相关 bg/temu 接口(退货申请、退款、售后单查询与处理等,接口将按 Partner 文档逐条接入)。当用户提到 Temu Global 退货、退款、售后退货、return、refund、aftersales return、parentAfterSalesSn、退货单、退款单、order-shipping 售后 时触发。买家/卖家取消订单用 linkfox-temu-cancel-order-global / linkfox-temu-cancel-order-global;订单用 linkfox-temu-order-global。

The skill document

Temu 全球站 — 退货与退款(Returns & Refunds)

本 skill(linkfox-temu-returns-refunds-global)覆盖 Partner Platform for Global Returns & Refunds / 电商退货与退款(及关联 After-sales 退货退款类)相关 bg.* / temu.* 接口(menu_code 与各 sub_menu_code 以 Partner 后台为准,见 partner-global-catalog.md)。

已接入 9 条 Partner Return and Refund 接口,清单见 partner-global-catalog.md

网关(本 skill 内置)

能力方法路径
退货退款 OpenAPI(global_returns_refunds_*temu_global_proxyPOSThttps://tool-gateway.linkfox.com/temu/proxy
加签文件下载POSThttps://tool-gateway.linkfox.com/temu/fileDownload

相关 skill

场景skill
退货与退款(本 skill)linkfox-temu-returns-refunds-global
买家发起取消订单(非退货退款全流程)linkfox-temu-cancel-order-global
卖家发起取消订单 / 缺货取消 / 申诉linkfox-temu-cancel-order-global
订单列表/详情/金额/售后上下文linkfox-temu-order-global
商品管理linkfox-temu-manage-product-global
履约/发货linkfox-temu-fulfillment-global
网关与 Temu token本 skill scripts/

调用方式

  • API 端点POST /temu/proxy(不同操作通过请求体区分;完整参数/响应/错误码见 references/api.md
  • Python 脚本python scripts/<脚本名>.py '' [--inline](可用脚本见上文脚本一览)
  • 成本约束:本工具会消耗积分;失败/空结果不得自动换关键词、翻页或连续试探;需要继续检索时先向用户说明会产生额外消耗。

输出策略(脚本默认行为)

  • 始终将完整响应写入 /linkfox///data/linkfox-temu-returns-refunds-global-.json 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录; 取自环境变量 SESSION_ID,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错)
  • 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本)
  • --inline 强制全量打印到 stdout(同样落盘)

读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jqConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。

解决认证和积分问题

发生以下异常情况时,采用 references/onboarding.md 引导解决问题:

异常情况

  • 未配置API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY
  • 响应401或402状态码
  • 响应提示积分或余额不足:消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。

默认参数

字段默认说明
siteglobalPartner Global
managementTypesemi-managed半托管(具体接口以 Partner 文档为准)
tokenPurposeorder-shipping订单/售后场景 token(见 access-token.md

鉴权

  1. LinkFoxLINKFOXAGENT_API_KEY → Header Authorization + Token
  2. TemuaccessTokenstoreKeystoreKey 时建议带 tokenPurpose=order-shipping

Scripts

脚本说明
temu_global_proxy.py任意 type 通用转发
temu_global_file_download.py加签文件下载
global_returns_refunds_aftersales_parentaftersales_list_get.pybg.aftersales.parentaftersales.list.get
global_returns_refunds_aftersales_aftersales_list_get.pybg.aftersales.aftersales.list.get
global_returns_refunds_aftersales_parentaftersales_detail_get.pytemu.aftersales.parentaftersales.detail.get
global_returns_refunds_aftersales_parentreturnorder_get.pybg.aftersales.parentreturnorder.get
global_returns_refunds_aftersales_returnaddress_get.pytemu.aftersales.returnaddress.get
global_returns_refunds_aftersales_returnlabel_prepare_get.pytemu.aftersales.returnlabel.prepare.get
global_returns_refunds_aftersales_signature_get.pytemu.aftersales.signature.get
global_returns_refunds_aftersales_upload_returnlabel.pytemu.aftersales.upload.returnlabel
global_returns_refunds_aftersales_carrier_get.pytemu.aftersales.carrier.get

接入更多接口(约定)

你每提供一条 Partner 文档(type + sub_menu_code + URL + Request/Response 参数表),将:

  1. 新增 references/apis/.md(完整入参/出参层级)
  2. 新增 scripts/global_returns_refunds_.py(调用 _global_returns_refunds_script.run_cli
  3. 更新 partner-global-catalog.mdapis/README.md 与本表

示例(通用代理)

export LINKFOXAGENT_API_KEY=""

python scripts/temu_global_proxy.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "type": "",
  "params": {
    "request": {}
  }
}'

Feedback: skillNamelinkfox-temu-returns-refunds-global

网关与授权脚本

脚本说明
check_linkfox_token.py校验 LinkFox 用户 Token
temu_token_guide.pyTemu accessToken 后台授权步骤
save_temu_access_token.py保存 accessToken 到本地
list_temu_access_tokens.py列出已保存 token
get_temu_access_token.py读取已保存 token
temu_proxy.py通用网关转发(多 site)
temu_file_download.py加签文件下载(多 site)

授权说明:references/access-token.md

积分消耗规则

不消耗积分。

Related skills

Temu 美国站电商退货与退款 API,经 LinkFox 网关转发 Partner US Returns & Refunds / 售后退货退款 相关 bg/temu 接口(退货申请、退款、售后单查询与处理等,接口将按 Partner 文档逐条接入)。当用户提到 Temu US 退货、退款、售后退货、return、refund、aftersales return、parentAfterSalesSn、退货单、退款单、order-shipping 售后 时触发。买家/卖家取消订单用 linkfox-temu-cancel-order-us / linkfox-temu-cancel-order-us;订单用 linkfox-temu-order-us。

12 installs

Temu 欧洲站电商退货与退款 API,经 LinkFox 网关转发 Partner EU Returns & Refunds / 售后退货退款 相关 bg/temu 接口(退货申请、退款、售后单查询与处理等,接口将按 Partner 文档逐条接入)。当用户提到 Temu EU 退货、退款、售后退货、return、refund、aftersales return、parentAfterSalesSn、退货单、退款单、order-shipping 售后 时触发。取消订单用 linkfox-temu-cancel-order-eu;订单用 linkfox-temu-order-eu。

13 installs

Temu 全球站(非 US/EU)取消订单 API(买家+卖家合一),经 LinkFox 网关转发 6 个接口:买家售后取消(bg.aftersales.cancel.*)、卖家申诉/缺货取消(temu.order.cancel.*)等,默认 site=global、tokenPurpose=order-shipping。当用户提到 Temu Global 取消订单、全球站买家取消、卖家缺货取消、afterSalesStatusGroup、applySn 时触发。美国站用 linkfox-temu-cancel-order-us;欧洲站用 linkfox-temu-cancel-order-eu;订单用 linkfox-temu-order-global。

11 installs

Temu 全球站(非 US/EU)订单管理 API,经 LinkFox 网关转发 9 个 bg.order.* / temu.order.* / temu.local.order.* 接口,默认 site=global、tokenPurpose=order-shipping。当用户提到 Temu Global 订单、全球站订单列表、parentOrderSn、订单金额 V2、temu.order.amount.v2.query、合并发货、SN鉴真、verification upload 时触发。美国站用 linkfox-temu-order-us;欧洲站用 linkfox-temu-order-eu;商品用 linkfox-temu-manage-product-global;价格用 linkfox-temu-price-global。

12 installs

Temu 全球站电商促销 API,经 LinkFox 网关转发 Partner Global Promotion / 促销活动 相关 bg/temu 接口(活动创建、报名、查询、优惠券/秒杀等,接口将按 Partner 文档逐条接入)。当用户提到 Temu Global 促销、促销活动、优惠券、秒杀、活动报名、promotion campaign、product-inventory 促销 时触发。商品管理用 linkfox-temu-manage-product-global;价格用 linkfox-temu-price-global;订单用 linkfox-temu-order-global。

12 installs

Temu 全球站(非 US/EU)电商履行/发货 API(合一):Buy-Shipping购标面单、合作仓履约、卖家自发货、物流跟踪等23个接口(不含 Scan Form)。当用户提到 Temu Global 发货、购标、Buy-Shipping、合作仓、自发货、tracking、shipment.create、site=global order-shipping 时触发。订单用 linkfox-temu-order-global。Scan Form 请用 linkfox-temu-fulfillment-us。

11 installs