TikTok Shop ERP 订单（Order）

本 skill 调用 TikTok Shop 卖家 ERP 订单开放接口。统一经 LinkFox 网关：

linkfox-tiktok-shop-auth  →  openId（选店）
        ↓
POST /tiktokShop/developerProxy
  appType = erp
  openId  = <ERP openId>     # 网关从库取 token；ttsAccessToken 已废弃
  path / method / queryString / body
        ↓
401 或 token 失效 → 网关自动 refresh 并重试一次
        ↓
TikTok Open API → 网关透传 httpStatus + body

📌 前置依赖：linkfox-tiktok-shop-auth（固定 ERP）。 📌 勿手动刷新 token：业务调用只需 openId；网关遇 401/过期会自动续签。 📌 转发说明 + 索引：references/api.md 📌 完整官方参数/响应：references/apis/<api>.md 📌 官方入口：Get Order List

Prerequisites

python scripts/check_auth_dependency.py；exit 42 → 先安装并完成 linkfox-tiktok-shop-auth。
本 skill 不实现授权；也不必在调用前手动 /refreshToken。

Core Concepts

概念	说明
转发入口	仅 `POST /tiktokShop/developerProxy`，固定 `appType=erp`
path	相对路径，如 `order/202309/orders/search`；白名单 `order/`、`authorization/`
shop_cipher	来自 `get_authorized_shops`；单店可自动解析
Get Order List	筛选条件在 body；分页在 query（`page_size`/`page_token`）
Get Order Detail	Query `ids`（可数组，脚本拼逗号）

Available Scripts

脚本	作用
`check_auth_dependency.py`	检测 `linkfox-tiktok-shop-auth`
`order_api.py`	具名 API
`order_proxy.py`	通用 path/method
`get_authorized_shops.py`	取 `shop_cipher`
`get_order_list.py`	订单列表（202309）
`get_order_detail.py`	订单详情（202507，推荐）
`get_order_detail_202309.py`	订单详情（202309）

共享模块：_shop_order_common.py、_order_endpoints.py、_order_api_runner.py。

标准流程

linkfox-tiktok-shop-auth 选 ERP 店 → openId
get_authorized_shops → shop_cipher（多店必传）
get_order_list 按状态/时间筛选
get_order_detail 用返回的 order id 查详情

Usage Examples

python scripts/get_authorized_shops.py '{"openId":"..."}'

python scripts/get_order_list.py '{
  "openId": "...",
  "page_size": 20,
  "order_status": "AWAITING_SHIPMENT",
  "create_time_ge": 1690000000
}'

python scripts/get_order_detail.py '{"openId":"...","ids":["5764..."]}'

python scripts/order_api.py '{"api":"get_order_list","openId":"...","page_size":20}'

Display Rules

勿输出完整 accessToken。
列表展示订单号、状态、金额、创建/更新时间等关键字段；细节从 detail 再取。
网关 errcode=1005 → 需放行 order/、authorization/。

Important Limitations

仅 ERP 订单查询（list/detail）。
不含履约拆单/发货（fulfillment/）→ 用 linkfox-tiktok-shop-fulfillment。
不含取消/退款（return_refund/）— 另开 skill。
不含授权。

积分消耗规则

不消耗积分（以网关实际为准）。

Feedback：skillName = linkfox-tiktok-shop-order。

More skills: LinkFox Skills

TikTok官方-店铺订单

安装到 Tokeny（自动）

SKILL.md