Install
openclaw skills install @linkfox-ai/linkfox-shopee-store-ordersShopee(虾皮)店铺订单(与 linkfox-shopee-store-auth 同系列),经 /shopee/developerProxy 转发 Shopee Open API Order 模块全部 22 个接口:get_order_list、get_order_detail、get_shipment_list、search_package_list、cancel_order、ship 相关 booking/invoice/FBS 等。当用户提到 Shopee 订单、虾皮订单列表、订单详情、包裹、拆单、取消订单、买家取消、订单备注、booking、FBS 发票、order_sn、READY_TO_SHIP、Shopee order processing 时触发。即使未明确提及"订单",只要涉及已授权 Shopee 店铺的订单查询或订单处理,也应触发。
openclaw skills install @linkfox-ai/linkfox-shopee-store-ordersShopee Open Platform Order 模块(22 个 API)。依赖 linkfox-shopee-store-auth:先取 accessToken,再经 POST /shopee/developerProxy 转发(path 须 api/v2/order/...)。
POST /shopee/developerProxy(不同操作通过请求体区分;完整参数/响应/错误码见 references/api.md)python scripts/<脚本名>.py '<JSON 参数>' [--inline](可用脚本见上文脚本一览)输出策略(脚本默认行为):
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json(<cwd> 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录;<session> 取自环境变量 SESSION_ID,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错)total/costToken、最大列表字段的长度 + 前 3 条样本)--inline 强制全量打印到 stdout(同样落盘)读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。
Order 模块索引:Shopee Open Platform — Order
python scripts/check_auth_dependency.py;exit code 42 → 先安装 linkfox-shopee-store-auth 并授权店铺。storeTokens → developerProxy → 紫鸟 shopee-proxy → Shopee API(partner_id/sign 由代理自动处理)get_order_list 得 order_sn → get_order_detail 拉全量字段(≤50 个/次)search_package_list / get_package_detail / get_shipment_list 用于发货前包裹视图split_order、cancel_order、set_note 等为 POST JSON bodyget_order_list / get_booking_list 的 time_from/time_to 最大 15 天| 脚本 | API | Method |
|---|---|---|
get_order_list.py | get_order_list | GET |
get_order_detail.py | get_order_detail | GET |
get_shipment_list.py | get_shipment_list | GET |
search_package_list.py | search_package_list | POST |
get_package_detail.py | get_package_detail | GET |
split_order.py | split_order | POST |
unsplit_order.py | unsplit_order | POST |
cancel_order.py | cancel_order | POST |
handle_buyer_cancellation.py | handle_buyer_cancellation | POST |
set_note.py | set_note | POST |
get_pending_buyer_invoice_order_list.py | get_pending_buyer_invoice_order_list | GET |
get_buyer_invoice_info.py | get_buyer_invoice_info | POST |
upload_invoice_doc.py | upload_invoice_doc | POST |
download_invoice_doc.py | download_invoice_doc | GET |
handle_prescription_check.py | handle_prescription_check | POST |
get_warehouse_filter_config.py | get_warehouse_filter_config | GET |
get_booking_list.py | get_booking_list | GET |
get_booking_detail.py | get_booking_detail | GET |
generate_fbs_invoices.py | generate_fbs_invoices | POST |
get_fbs_invoices_result.py | get_fbs_invoices_result | POST |
download_fbs_invoices.py | download_fbs_invoices | POST |
get_estimiate_cancel_value.py | get_estimiate_cancel_value | POST |
order_api.py | 通用入口(JSON 含 api 字段) | — |
共享:_shopee_orders_common.py、_order_endpoints.py、_order_api_runner.py。入参详见 references/api.md。
shopIdget_order_list.py:order_status=READY_TO_SHIP,time_range_field=update_time,15 天内时间戳get_order_detail.py:传入 order_sn_listsearch_package_list.py:传 pagination.page_size 及可选 filter/sort(或整体 body)get_package_detail.py:package_number_listcancel_order.py(order_sn + cancel_reason)handle_buyer_cancellation.py(ACCEPT/REJECT)set_note.pysplit_order.py / unsplit_order.py| 用户上下文 | Agent 动作 |
|---|---|
| 只授权 1 家 | 直接用 shopId |
| 多家 + 店名 | auth skill authorized_stores.py 澄清 |
| 已给 order_sn | 直接详情/写操作脚本 |
developerProxy.httpStatus,再读 *Response 解析字段queryString)body 对象,或按 api.md 传顶层 body 字段upload_invoice_doc 官方为 multipart;若网关不支持,需在文档中说明限制get_order_list 用 cursor/next_cursor;search_package_list 用 pagination.cursor确认 path 为 api/v2/order/...。
发票类 API 限 PH/BR;get_buyer_invoice_info 限 VN/TH/PH;FBS 发票限 BR。见 references/api.md。
回到 linkfox-shopee-store-auth 重新授权。
linkfox-shopee-store-authlinkfox-shopee-store-merchantlinkfox-shopee-store-shoplinkfox-shopee-store-productlinkfox-shopee-store-account-healthlinkfox-shopee-store-global-productlinkfox-shopee-store-logisticslinkfox-shopee-store-first-milelinkfox-shopee-store-returnslinkfox-shopee-store-paymentlinkfox-youying-shopee-product-searchFeedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.