TikTok Shop ERP 售后（Return & Refund）
本 skill 调用 TikTok Shop 卖家 ERP 售后开放接口。统一经 LinkFox 网关：
linkfox-tiktok-shop-auth → openId（选店）
↓
POST /tiktokShop/developerProxy
appType = erp
openId = <ERP openId>
path / method / queryString
↓
401 或 token 失效 → 网关自动 refresh 并重试一次
📌 前置依赖：
linkfox-tiktok-shop-auth📌 勿手动刷新 token 📌 官方入口：Get Reject Reasons 📌 完整参考：references/apis/<api>.md
Prerequisites
python scripts/check_auth_dependency.py；exit 42 → 先完成linkfox-tiktok-shop-auth。- 需要有效的
return_or_cancel_id（退货单或取消单 ID）。
Core Concepts
| 概念 | 说明 |
|---|---|
| path 白名单 | return_refund/、authorization/ |
| Get Reject Reasons | Query：return_or_cancel_id（必填）+ shop_cipher；可选 locale |
| 用途 | 拒绝退货/取消前，先拉可选拒因列表 |
Available Scripts
| 脚本 | 作用 |
|---|---|
check_auth_dependency.py |
检测 auth skill |
return_refund_api.py |
具名 API |
return_refund_proxy.py |
通用 path/method |
get_authorized_shops.py |
取 shop_cipher |
get_reject_reasons.py |
拒因列表 |
Usage Examples
python scripts/get_reject_reasons.py '{
"openId": "...",
"return_or_cancel_id": "4035633471902223141"
}'
python scripts/return_refund_api.py '{
"api": "get_reject_reasons",
"openId": "...",
"return_or_cancel_id": "4035..."
}'
Important Limitations
- 当前以 Get Reject Reasons 为主；搜索退货/同意拒绝等可后续扩展。
- 不含订单 list/detail（
linkfox-tiktok-shop-order）。
Feedback：skillName = linkfox-tiktok-shop-return-refund。