SuperAPI AI 工具集

linkfox-shopee-store-orders

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:面向 Shopee(虾皮)店铺订单管理,封装 Shopee Open Platform Order 模块全部 22 个 API,经 POST /shopee/developerProxy 转发,由服务端解析 token 并注入,path 须为 api/v2/order/...。依赖 linkfox-shopee-store-auth 完成选店与授权,本技能不实现授权/令牌逻辑。

主要能力:订单列表与详情(get_order_list、get_order_detail)、包裹视图(search_package_list、get_package_detail、get_shipment_list)、拆单与合单(split_order、unsplit_order)、取消与买家取消处理(cancel_order、handle_buyer_cancellation)、备注(set_note)、发票相关(get_pending_buyer_invoice_order_list、get_buyer_invoice_info、upload_invoice_doc、download_invoice_doc、generate_fbs_invoices、get_fbs_invoices_result、download_fbs_invoices)、处方审核、仓库筛选配置、预约单(get_booking_list、get_booking_detail)、取消金额估算等。

使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装并授权 linkfox-shopee-store-auth。调用可用 python scripts/<脚本名>.py '<JSON 参数>' [--inline],或通用入口 order_api.py(JSON 含 api 字段)。GET 业务参数作为脚本 JSON 顶层字段,POST 传 body 对象。响应默认写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/,≤8 KB 全量打印,>8 KB 只输出摘要,--inline 强制全量打印;建议用 jq 或 ConvertFrom-Json 从落盘文件按需抽取。

限制:get_order_list 与 get_booking_list 的 time_from/time_to 最大 15 天;get_order_detail 每次最多 50 个 order_sn;发票类 API 限 PH/BR,get_buyer_invoice_info 限 VN/TH/PH,FBS 发票限 BR;upload_invoice_doc 官方为 multipart,若网关不支持需注意限制;path 白名单错误码 1005;token 过期需回到 auth 技能重新授权。失败或空结果不得自动换关键词、翻页或连续试探,继续检索前需向用户说明会产生额外消耗。本技能不消耗算力。物流发货、退货退款、支付结算等由同系列其他技能处理。