Back to Details

linkfox-amazon-store-fba

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Amazon 店铺 Fulfillment by Amazon (FBA)

亚马逊店铺Fulfillment by Amazon (FBA)

本 skill 与 
linkfox-amazon-store-auth
 同属 Amazon Store 系列：依赖授权选店（
sellerId
+
region
）；经 
POST /spApi/developerProxy
 转发 SP-API（勿传 
amzAccessToken
，除非兼容旧调用）。
覆盖 方案 A 模块：
  1. Inbound Eligibility v1（入仓/混装资格预览）
  2. FBA Inventory v1（仓内库存）
  3. Fulfillment Inbound v2024-03-20（现行入仓工作流）+ v0 保留查询
  4. Fulfillment Outbound 2020-07-01（MCF 多渠道履约）
不包含：FBA Small and Light（已弃用）、External Fulfillment（见 
linkfox-amazon-store-external-fulfillment
）、Merchant Fulfillment（MFN）。
本Skill与**
linkfox-amazon-store-auth
同属Amazon Store系列：依赖授权选店（
sellerId
+
region
）；通过
POST /spApi/developerProxy
**转发SP-API请求（请勿传递
amzAccessToken
，除非需要兼容旧调用方式）。
覆盖方案A模块：
  1. Inbound Eligibility v1（入仓/混装资质预览）
  2. FBA Inventory v1（仓内库存管理）
  3. Fulfillment Inbound v2024-03-20（现行入仓工作流）+ v0版本保留查询功能
  4. Fulfillment Outbound 2020-07-01（MCF多渠道履约）
不包含：已弃用的FBA Small and Light、External Fulfillment（详见
linkfox-amazon-store-external-fulfillment
）、Merchant Fulfillment（MFN）。

调用方式

调用方式

  • 统一入口：
    python scripts/fba_api.py '{"api":"<operationId>","sellerId":"...","region":"NA",...}' [--inline]
  • 单接口脚本：
    python scripts/<脚本名>.py '<JSON>' [--inline]
    （完整对照见 
    references/capabilities.md
    ）
  • 写操作 body：优先传 
    requestBody
    ；也可把业务字段平铺在 JSON 中（脚本会排除 sellerId/region/path/query 后组装 body）
  • Query：声明字段直接传；或用 
    query
     对象 / 
    queryString
     覆盖
  • 成本约束：失败/空结果不得自动翻页或连续试探；继续前先说明可能产生额外消耗
输出策略：完整响应落盘到 
linkfox/<date>/<session>/data/linkfox-amazon-store-fba-*.json
；>8KB 默认摘要；
--inline
全量打印。
  • 统一入口：
    python scripts/fba_api.py '{"api":"<operationId>","sellerId":"...","region":"NA",...}' [--inline]
  • 单接口脚本：
    python scripts/<脚本名>.py '<JSON>' [--inline]
    （完整对照见
    references/capabilities.md
    ）
  • 写操作请求体：优先传递**
    requestBody
    **；也可将业务字段平铺在JSON中（脚本会排除sellerId/region/path/query字段后组装请求体）
  • 查询参数：直接声明字段传递；或使用**
    query
    **对象 / **
    queryString
    **覆盖原有参数
  • 成本约束：请求失败或返回空结果时，不得自动翻页或连续试探；继续操作前需告知用户可能产生额外消耗
输出策略：完整响应结果将保存到
linkfox/<date>/<session>/data/linkfox-amazon-store-fba-*.json
；响应内容大于8KB时默认返回摘要；使用
--inline
参数则全量打印结果。

解决认证和积分问题

解决认证和积分问题

发生未配置 API Key、401/402、积分不足时，采用 
references/onboarding.md
引导。
当出现未配置API Key、401/402错误、积分不足等情况时，按照
references/onboarding.md
中的指引处理。

Prerequisites

前置条件

  1. 依赖 
    linkfox-amazon-store-auth
    ：
    python scripts/check_auth_dependency.py
    （exit 42 → 先装 auth）
  2. 应用需具备 Amazon Fulfillment 等相关角色（以 Amazon 控制台为准）
  3. 网关需放行路径前缀：
    fba/
    、
    inbound/fba/
    （遇 1005 找后端加白）
  1. 依赖**
    linkfox-amazon-store-auth
    **：执行
    python scripts/check_auth_dependency.py
    检查（返回exit 42则需先安装认证工具）
  2. 应用需具备Amazon Fulfillment等相关权限（以亚马逊控制台显示为准）
  3. 网关需放行以下路径前缀：
    fba/
    、
    inbound/fba/
    （遇到1005错误时联系后端添加白名单）

Current Capabilities

当前功能

共 70 个 operation。模块表：
模块数量说明
eligibility1getItemEligibilityPreview
inventory4summaries / create / delete / add
inbound_v06prep / labels / BOL / shipments / items
inbound (2024-03-20)45InboundPlan 全流程
outbound (2020-07-01)14MCF 履约
完整 Operation ↔ path ↔ 脚本表：见 
references/capabilities.md

机器可读注册表：
scripts/_fba_endpoints.py
、
references/operations.json
共包含70个操作接口。模块详情表：
模块数量说明
eligibility1getItemEligibilityPreview
inventory4库存汇总 / 创建 / 删除 / 新增
inbound_v06预处理 / 面单 / BOL / 货件 / 商品
inbound (2024-03-20)45InboundPlan全流程操作
outbound (2020-07-01)14MCF履约操作
完整操作接口↔路径↔脚本对照表：见
references/capabilities.md

机器可读注册表：
scripts/_fba_endpoints.py
、
references/operations.json

Quick Parameters

快速参数说明

getItemEligibilityPreview

getItemEligibilityPreview

  • 必填：
    asin
    、
    program
    （
    INBOUND
    |
    COMMINGLING
    ）
  • program=INBOUND
    时必填 
    marketplaceIds
    （或 
    marketplaceId
    ，最多 1 个）
bash
python scripts/get_item_eligibility_preview.py '{"sellerId":"A1...","region":"NA","asin":"B0...","program":"INBOUND","marketplaceId":"ATVPDKIKX0DER"}'
  • 必填参数：
    asin
    、
    program
    （可选值
    INBOUND
    |
    COMMINGLING
    ）
  • 当
    program=INBOUND
    时，必填
    marketplaceIds
    （或
    marketplaceId
    ，最多传1个）
bash
python scripts/get_item_eligibility_preview.py '{"sellerId":"A1...","region":"NA","asin":"B0...","program":"INBOUND","marketplaceId":"ATVPDKIKX0DER"}'

getInventorySummaries

getInventorySummaries

  • 必填：
    granularityType
    （通常 
    Marketplace
    ）、
    granularityId
    （marketplaceId）、
    marketplaceIds
  • 可选：
    details
    、
    sellerSkus
    、
    startDateTime
    、
    nextToken
  • 必填参数：
    granularityType
    （通常为
    Marketplace
    ）、
    granularityId
    （对应marketplaceId）、
    marketplaceIds
  • 可选参数：
    details
    、
    sellerSkus
    、
    startDateTime
    、
    nextToken

Inbound / Outbound 写操作

入库/出库写操作

复杂 schema 请用 
requestBody
 按官方模型传完整 JSON；path 参数（如 
inboundPlanId
、
shipmentId
、
sellerFulfillmentOrderId
）与 query 字段并列在入参中。
异步步骤（generate*Options 等）返回后用 
getInboundOperationStatus
 轮询（勿擅自高频轮询，先征得用户同意）。
复杂数据结构请通过**
requestBody
**按照官方模型传递完整JSON；路径参数（如
inboundPlanId
、
shipmentId
、
sellerFulfillmentOrderId
）与查询字段并列在入参中。
异步步骤（如generate*Options等）返回后，使用**
getInboundOperationStatus
**轮询状态（请勿擅自高频轮询，需先征得用户同意）。

Scripts

脚本示例

bash
export LINKFOXAGENT_API_KEY="<your-key>"
bash
export LINKFOXAGENT_API_KEY="<your-key>"

统一入口

统一入口调用示例

python scripts/fba_api.py '{"api":"getItemEligibilityPreview","sellerId":"A1...","region":"NA","asin":"B0...","program":"INBOUND","marketplaceIds":["ATVPDKIKX0DER"]}'
python scripts/fba_api.py '{"api":"getInventorySummaries","sellerId":"A1...","region":"NA","granularityType":"Marketplace","granularityId":"ATVPDKIKX0DER","marketplaceIds":["ATVPDKIKX0DER"],"details":true}'
python scripts/fba_api.py '{"api":"listInboundPlans","sellerId":"A1...","region":"NA","pageSize":10}'

共享模块：`_spapi_fba_common.py`、`_fba_endpoints.py`、`_fba_runner.py`（非独立 CLI）。
python scripts/fba_api.py '{"api":"getItemEligibilityPreview","sellerId":"A1...","region":"NA","asin":"B0...","program":"INBOUND","marketplaceIds":["ATVPDKIKX0DER"]}'
python scripts/fba_api.py '{"api":"getInventorySummaries","sellerId":"A1...","region":"NA","granularityType":"Marketplace","granularityId":"ATVPDKIKX0DER","marketplaceIds":["ATVPDKIKX0DER"],"details":true}'
python scripts/fba_api.py '{"api":"listInboundPlans","sellerId":"A1...","region":"NA","pageSize":10}'

共享模块：`_spapi_fba_common.py`、`_fba_endpoints.py`、`_fba_runner.py`（非独立CLI工具）。

Display Rules

展示规则

  1. 先看 
    developerProxy.errcode
    / 
    httpStatus
    ，再看解析字段 
    payload
  2. 202/204 可能无 body；以状态码判断成功
  3. Inbound 2024 与 v0 的 
    getShipments
    /
    getShipment
    勿混淆：v0 脚本为 
    get_shipments_v0.py
    ；2024 货件为 
    get_inbound_shipment.py
  4. 与 
    linkfox-amazon-store-orders
    、
    linkfox-amazon-store-external-fulfillment
     边界清晰，勿混用
  1. 优先查看
    developerProxy.errcode
    /
    httpStatus
    ，再查看解析字段**
    payload
    **
  2. 202/204状态码可能无响应体；以状态码判断请求是否成功
  3. 请勿混淆Inbound 2024版与v0版的
    getShipments
    /
    getShipment
    接口：v0版本对应脚本为
    get_shipments_v0.py
    ；2024版货件对应脚本为
    get_inbound_shipment.py
  4. 与**
    linkfox-amazon-store-orders
    、
    linkfox-amazon-store-external-fulfillment
    **工具边界清晰，请勿混用

Important Limitations

重要限制

  • Outbound 2026-07-04 未纳入本 skill（方案 A）
  • Small and Light 已弃用，不实现
  • Inbound 状态机复杂，需按官方工作流顺序调用；冲突常见 409/422
  • 限速因接口而异（Eligibility 约 1 rps），注意 429
  • 出库履约2026-07-04版未纳入本Skill（方案A）
  • Small and Light已弃用，未实现相关功能
  • 入库状态逻辑复杂，需按照官方工作流顺序调用；常见冲突错误码为409/422
  • 各接口限速不同（Eligibility接口约1次/秒），注意429限流错误

积分消耗规则

积分消耗规则

不消耗积分（以网关实际计费为准）。
Feedback： 
skillName
：
linkfox-amazon-store-fba
更多跨境 skill：LinkFox Skills
不消耗积分（以网关实际计费规则为准）。
反馈渠道：Skill名称：
linkfox-amazon-store-fba
更多跨境电商Skill：LinkFox Skills