Amazon 店铺订单
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-store-orders-107。
技能介绍
要解决什么问题
在多店铺、多区域的亚马逊运营里,订单往往分散在 Seller Central 与各类报表中;若要在 Agent 或脚本里做对账、履约跟进、合规核验,需要稳定调用 Orders API,又不能在每个项目里重复处理 OAuth、区域端点与 RDT 等细节。本技能把授权后的店铺上下文(sellerId + region)交给 LinkFox 网关,由服务端解析 token,你在本地只需选操作、看结构化结果。
技能如何工作
与 linkfox-amazon-store-auth、报表、Listing、定价等同属 Amazon Store 系列:必须先完成选店授权,再对本技能执行 python scripts/check_auth_dependency.py;若返回依赖缺失,应先安装授权技能,禁止在本技能内自造令牌逻辑。
调用统一走 POST /spApi/developerProxy,用 path/method 区分 SP-API 操作(完整参数见 references/api.md)。常用脚本包括:
search_orders.py:orders/2026-01-01/orders,按createdAfter或lastUpdatedAfter、市场 ID 等条件搜单get_order.py:单笔订单详情,可用includedData拉齐买家、履约、包裹等字段get_order_items.py等 v0 脚本:行项目、地址、买家信息(官方已标 deprecated,新集成优先 v2026-01-01 +includedData)- 写操作:
update_shipment_status.py、confirm_shipment.py、update_verification_status.py等,POST/PATCH JSON 体;stdout 会附带组装后的requestBody便于排查
默认输出策略:完整响应写入当前工作目录下 data/linkfox-amazon-store-orders-*.json(禁止写 /tmp);响应 ≤8KB 时全量打印到 stdout,更大则只打摘要,可用 --inline 强制全量。大结果建议用 jq 从落盘 JSON 按需抽取,避免整份进上下文。失败或空结果时不得自动换词、翻页或连续试探;若需继续检索应先说明可能产生的额外消耗。401/402、API Key 未配置、积分不足等按 references/onboarding.md 处理。
边界与注意点
- 权限:需 Orders 相关角色;部分读取可能需 Restricted Data Token,本技能不实现 RDT 申请流程,PII 以亚马逊数据保护政策为准
- 网关:若返回 1005 等路径拒绝,需后端放行
orders/v0/...与orders/2026-01-01/...前缀 searchOrders速率很低(约 0.0056 req/s),注意 429- 解析时先看网关
developerProxy.errcode/httpStatus,再读业务字段
使用场景
- 每周按 lastUpdatedAfter 拉取各站点新变更订单,落盘 JSON 后与 ERP 发货状态逐单比对
- 客服工单提供 orderId 时,用 get_order 与 includedData 核对买家、包裹与履约字段,少打 Seller Central
- FBA/自发货混营时,对超时未发货订单批量查 fulfillmentStatuses,再决定是否 updateShipmentStatus
- 售药或受限品类订单需 regulatedInfo,拉取后走 updateVerificationStatus 或 confirmShipment 完成合规闭环
适合人员
- 管理多区域 Seller 账号、要把订单查询写进内部 Agent 工作流的跨境运营负责人
- 负责 SP-API 对接、希望用现成脚本覆盖搜单/发货/合规写接口的后端或集成工程师
- 每日处理异常单与物流状态、需要结构化订单与行项目数据做工单备注的客服或履约专员
- 合规与品类经理,需对受限订单做核验状态更新并保留 confirmShipment 请求体备查