Amazon 店铺 FBA 履约
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-store-fba-101。
技能介绍
要解决什么问题
做多站点 Amazon 自营发货(FBA)时,入仓资格、库存快照、InboundPlan 状态机和 MCF 出库往往分散在 Seller Central 与多套 SP-API 文档里。人工对照容易把 Inbound 2024-03-20 与旧版 v0 货件接口混用,也会在异步步骤(generate*Options)上盲轮询,徒增 429 与网关消耗。
本技能与 linkfox-amazon-store-auth 同属 Amazon Store 系列:先完成选店(sellerId + region),再经 POST /spApi/developerProxy 转发 FBA 相关 SP-API——调用侧勿传 amzAccessToken(除非兼容旧链路)。
核心能力与工作方式
按「方案 A」覆盖四类模块,共 70 个 operation:
- Inbound Eligibility v1:
getItemEligibilityPreview,预览 ASIN 入仓/混装资格(program=INBOUND需marketplaceIds) - FBA Inventory v1:汇总与增减仓内库存(
getInventorySummaries等) - Fulfillment Inbound:现行 v2024-03-20 InboundPlan 全流程(45 个接口),并保留 v0 查询(prep / labels / BOL / shipments)
- Fulfillment Outbound 2020-07-01:MCF 多渠道履约(14 个接口)
统一入口为 python scripts/fba_api.py,复杂写操作建议用 requestBody 按官方 schema 传完整 JSON;path 参数(如 inboundPlanId、shipmentId)与 query 字段可与业务字段并列。响应完整落盘到 linkfox/.../data/,大于 8KB 默认摘要,--inline 可全量打印。未配置 Key、401/402 或积分问题时,按 references/onboarding.md 处理。
边界与注意点
- 不包含:FBA Small and Light(已弃用)、External Fulfillment(见独立 skill)、MFN 自发货;Outbound 2026-07-04 亦未纳入本包。
- Inbound 状态机需按官方顺序调用,409/422 冲突常见;Eligibility 等接口限速约 1 rps。
- 失败/空结果不得自动翻页或连续试探;异步状态用
getInboundOperationStatus轮询前应先征得同意,避免额外消耗。 - 与 linkfox-amazon-store-orders、linkfox-amazon-store-external-fulfillment 职责分离,勿混用接口。
使用场景
- 新品入仓前用 getItemEligibilityPreview 核对 ASIN 在指定 marketplace 的 INBOUND 资格
- 按 marketplaceId 拉 getInventorySummaries,核对 FBA 仓内 SKU 数量与细节字段
- 按 2024-03-20 工作流创建/推进 InboundPlan,并在 generate 步骤后用 getInboundOperationStatus 查状态
- 对已售订单创建 MCF Fulfillment Outbound,跟踪 sellerFulfillmentOrderId 相关出库操作
适合人员
- 负责北美/欧洲多站点 FBA 入仓计划的运营,需要脚本化资格预览与货件流程
- 对接 Seller Partner API 的内部工程师,要把 Inbound 2024 与 v0 查询拆成可维护的调用清单
- 仓储与供应链同事,需定期导出 FBA Inventory 汇总并与 ERP 对账
- 客服或发货主管,在自仓缺货时用 MCF 接口发起多渠道履约并查履行状态