SuperAPI AI 工具集

linkfox-shopee-store-logistics

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:处理 Shopee 店铺物流发货,覆盖 Shopee Open Platform Logistics 模块的 46 个 API,属 linkfox-shopee-store-auth 同系列。选店依赖 linkfox-shopee-store-auth,运行前先执行 python scripts/check_auth_dependency.py,退出码 42 表示需先安装该 auth 技能并授权店铺;本技能内不实现授权与令牌逻辑。

主要能力:发货类 get_shipping_parameter、ship_order、mass_ship_order、batch_ship_order、update_shipping_order;运单轨迹 get_tracking_number、get_tracking_info、update_tracking_status;面单 get_shipping_document_parameter、create_shipping_document、download_shipping_document、create_shipping_document_job;地址渠道 get_address_list、get_channel_list、update_address、set_address_config;Booking(get_booking_shipping_parameter、ship_booking 及面单系列);通用入口 logistics_api.py。典型发货流程为 get_shipping_parameter → ship_order → get_tracking_number → 面单。订单查询、退货退款、店铺信息等由其他同系列技能负责。

使用方式:接口为 POST /shopee/developerProxy,传入 shopId(或 merchantId)由服务端解析 token 转发,path 须为 api/v2/logistics/...。可用 python scripts/logistics_api.py '<JSON 参数>' [--inline] 调用,完整参数与错误码见 references/api.md,各 API 文档见 references/apis/。响应默认写入当前工作目录 linkfox/<日期>/<session>/data/ 下 json(不写 /tmp,目录不可写则报错);≤8 KB 全量打印,>8 KB 只输出摘要,--inline 强制全量。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需抽字段。GET 业务参数放 JSON 顶层,POST 复杂接口传 body;先看 developerProxy.httpStatus 再读 *Response。

限制:会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探,需继续检索应先告知用户将产生额外消耗;未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、返回 401/402 或提示余额不足等时,按 references/onboarding.md 处理。授权、订单、退货退款、店铺信息、商品 listing、头程、仓储等不在本技能范围。