用途:面向亚马逊卖家的 FBA 综合管理技能,与 linkfox-amazon-store-auth 同属 Amazon Store 系列,依赖授权选店(sellerId+region),经 POST /spApi/developerProxy 转发 SP-API(勿传 amzAccessToken,除非兼容旧调用)。
主要能力(共 70 个 operation):eligibility 1 个(getItemEligibilityPreview);inventory 4 个(summaries/create/delete/add);inbound_v0 6 个(prep/labels/BOL/shipments/items);inbound 2024-03-20 共 45 个(InboundPlan 全流程);outbound 2020-07-01 共 14 个(MCF 履约)。不包含 FBA Small and Light(已弃用)、External Fulfillment、Merchant Fulfillment(MFN)。
使用方式:统一入口 python scripts/fba_api.py '{"api":"<operationId>","sellerId":"...","region":"NA",...}' [--inline];也可用单接口脚本 python scripts/<脚本名>.py '<JSON>' [--inline]。写操作 body 优先传 requestBody,也可平铺业务字段;Query 可直接传字段或用 query 对象/queryString 覆盖。异步步骤(generateOptions 等)返回后用 getInboundOperationStatus 轮询,勿擅自高频轮询。输出完整响应落盘到 linkfox/<date>/<session>/data/linkfox-amazon-store-fba-.json,>8KB 默认摘要,--inline 全量打印。
前置条件:依赖 linkfox-amazon-store-auth(python scripts/check_auth_dependency.py,exit 42 需先装 auth);应用需具备 Amazon Fulfillment 等相关角色;网关需放行 fba/、inbound/fba/ 路径前缀。
限制:Outbound 2026-07-04 未纳入;Inbound 状态机复杂,需按官方工作流顺序调用,冲突常见 409/422;限速因接口而异(Eligibility 约 1 rps),注意 429。失败/空结果不得自动翻页或连续试探。网关对连续 400/403/404/429 返回 450/453/454/459 并短暂冷却,需停止自动重试、按 retryAfter/blockedUntil 退避,先修正参数、授权或资源标识。算力消耗以网关实际计费为准。