（14696期）Shopee-店铺物流 – Shopee 一站式智能物流发货管家

Shopee 一站式智能物流发货管家 LinkFox 官方出品，封装 Shopee Open API Logistics 模块 46 个接口，支持授权店铺的发货、面单、运单追踪全流程自动化，助力跨境卖家高效履约。 使用说明 核心用法 本技能为 LinkFox 官方开发的 Shopee 店铺物流管理工具，通过 POST /shopee/developerProxy 端点代理转发 Shopee Open Platform Logistics 模块的全部 46 个 API。使用前必须先完成 linkfox-shopee-store-auth 的店铺授权流程，获取有效的 shopId 或 merchantId。典型发货流程为：调用 getshippingparameter 获取物流参数 → shiporder 执行发货 → gettrackingnumber 获取运单号 → createshippingdocument 创建面单 → downloadshipping_document 下载打印。技能提供 Python 脚本调用和 JSON API 两种模式，支持单订单发货、批量发货、Booking 预约发货、面单管理、物流轨迹查询、揽收地址配置等全链路操作。 显著优点 官方生态闭环：与 LinkFox 店铺授权体系深度集成，token 由服务端自动注入，开发者无需处理 OAuth 刷新逻辑。 46 接口全覆盖：从发货参数获取、运单号分配到面单下载，完整覆盖 Shopee Logistics 模块能力，满足多样化履约场景。 自动化脚本封装：提供开箱即用的 Python 脚本，内置智能输出策略（≤8KB 全量输出，>8KB 摘要输出），并支持 --inline 强制全量打印。 数据持久化：所有响应自动落盘到 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 目录，便于后续审计和数据分析。 零积分消耗：明确标注不消耗积分，降低中小卖家的使用门槛。 潜在缺点与局限性 强依赖前置授权：必须先安装并运行 linkfox-shopee-store-auth，exit code 42 时需完成授权，无法独立使用。 平台绑定限制：仅支持 Shopee 平台，无法跨平台复用；且需通过紫鸟 shopee-proxy 转发，链路多一层依赖。 响应体大小限制：默认 >8KB 仅输出摘要，复杂查询需手动使用 jq 或 ConvertFrom-Json 二次处理，增加使用门槛。 地区版本差异：Shopee 各站点（东南亚、台湾、巴西等）API 存在差异，部分接口如 FBS/SBS/FirstMile 需使用独立技能，不在本模块内。 调试成本：代理转发模式下，问题定位需排查 LinkFox 服务端、紫鸟代理、Shopee 官方三层链路，故障排查复杂度较高。 适合的目标群体 跨境电商运营人员：日常处理 Shopee 店铺订单发货、面单打印、物流跟踪的操盘手。 Shopee 多店铺卖家：需要批量管理多个店铺物流履约的中小商家。 ERP/WMS 系统集成开发者：需要将 Shopee 物流能力接入自有系统的技术团队。 物流自动化团队：追求发货流程自动化、减少人工操作的跨境电商企业。 使用风险 认证失效风险：Shopee 授权 token 有过期机制，未及时处理会导致 401/402 错误，需按 references/onboarding.md 重新引导授权。 网络链路稳定性：依赖紫鸟代理转发，跨境网络波动可能导致请求延迟或失败。 数据存储合规：响应数据默认写入本地文件系统，需确保执行目录可写且符合数据安全规范，禁止写入 /tmp 已做限制。 API 变更风险：Shopee Open Platform 接口版本迭代（当前 v2），字段变更可能导致脚本兼容性断裂。 并发与限流：虽然未明确标注限流策略，但高并发调用 Shopee 官方 API 可能触发平台级流控，建议合理控制请求频率。 原始说明 Shopee（虾皮）店铺物流发货（与 linkfox-shopee-store-auth 同系列），经 /shopee/developerProxy 转发 Shopee Open API Logistics 模块全部 46 个接口：get_shipping_parameter、ship_order、get_tracking_number、create_shipping_document、download_shipping_document、get_channel_list 等。当用户提到 Shopee 物流、发货、ship_order、运单号、面单、tracking、揽收地址、物流渠道、READY_TO_SHIP 发货 时触发。即使未明确提及"物流"，只要涉及已授权 Shopee 店铺的发货、面单或物流轨迹查询，也应触发。