linkfox-amazon-store-fba

Amazon Store Fulfillment by Amazon (FBA)

本スキルは 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 を指定すると全量を出力します。

認証と計算リソースの問題を解決する

API Key が未設定の場合、401/402 が発生した場合、または計算リソースが不足している場合は、references/onboarding.md の案内に従ってください。

前提条件

1. linkfox-amazon-store-auth に依存します：python scripts/check_auth_dependency.py（exit 42 → 先に auth をインストールしてください）
2. アプリに Amazon Fulfillment などの関連ロールが必要です（Amazon コンソールで確認してください）
3. ゲートウェイで次のパスプレフィックスを許可する必要があります：fba/、inbound/fba/（1005 が発生した場合は、バックエンド担当者に許可リストへの追加を依頼してください）

現在の機能

合計 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 フルフィルメント

Operation ↔ path ↔ スクリプトの完全な対応表：references/capabilities.md を参照
機械可読レジストリ：scripts/_fba_endpoints.py、references/operations.json

クイックパラメーター

getItemEligibilityPreview

• 必須：asin、program（INBOUND|COMMINGLING）
• program=INBOUND の場合は marketplaceIds（または marketplaceId、最大 1 件）も必須です

python scripts/get_item_eligibility_preview.py '{"sellerId":"A1...","region":"NA","asin":"B0...","program":"INBOUND","marketplaceId":"ATVPDKIKX0DER"}'

getInventorySummaries

• 必須：granularityType（通常は Marketplace）、granularityId（marketplaceId）、marketplaceIds
• 任意：details、sellerSkus、startDateTime、nextToken

Inbound / Outbound の書き込み操作

複雑な schema には、公式モデルに従った完全な JSON を requestBody で渡してください。path パラメーター（inboundPlanId、shipmentId、sellerFulfillmentOrderId など）と query フィールドは、入力パラメーターに並べて指定します。

非同期ステップ（generate*Options など）の結果が返された後は、getInboundOperationStatus でポーリングしてください（許可なく高頻度でポーリングしないでください。まずユーザーの同意を得てください）。

スクリプト

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 ではありません）。

表示ルール

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 とは明確に区別し、混用しないでください

重要な制限事項

• Outbound 2026-07-04 は本スキルに含まれません（方案 A）
• Small and Light は非推奨のため、実装されていません
• Inbound の状態遷移は複雑です。公式ワークフローの順序に従って呼び出してください。409/422 が頻繁に発生します
• レート制限はインターフェースによって異なります（Eligibility は約 1 rps）。429 に注意してください

Amazon SP-API 接口保护与重试指引

同一店铺连续收到 Amazon SP-API 的 400、403、404 或 429 时，网关会返回 450、453、454 或 459 并短暂冷却。这些自定义状态码不是 Amazon 原生状态，也不表示封号；目的是避免持续异常或高频调用扩大店铺风险。

状态与 message	范围	触发与冷却	处理
450：400，请求异常，请优化您的参数	店铺+接口	60 秒内超过 3 次：5 分钟；10 分钟内超过 4 次：20 分钟	停止原参数重试，检查必填字段、marketplace、ID、日期和请求体
453：403，店铺未授权，请先授权	店铺全部接口	60 秒内超过 2 次：5 分钟；10 分钟内超过 4 次：30 分钟	停止该店铺调用，检查授权、权限、店铺归属和区域
454：404，资源不存在，请优化您的参数	店铺+接口	60 秒内超过 3 次：5 分钟；10 分钟内超过 4 次：30 分钟	确认资源 ID、所属店铺/站点、资源状态和接口路径
459：429限流中，请降低频率	店铺+接口	首次：15 秒；2 分钟内超过 2 次：30 秒；3 分钟内超过 4 次：2 分钟	降低并发、分页和轮询频率并逐级退避

• 立即停止自动或并发重试，不得通过换脚本或重复创建任务绕过保护；优先遵循 retryAfter、blockedUntil，没有时按表中时长说明。
• 450/453/454 必须先修正参数、授权或资源标识，冷却后最多谨慎重试一次；再次触发则停止调用。453 期间停止该店铺全部 SP-API。
• 保留已有 reportId、feedId 等任务 ID；写操作结果不确定时先查询状态，不直接重放。
• 向用户先说明店铺保护，再给原因、处理和等待时间。可回复：“为保护您的亚马逊店铺安全，检测到 Amazon SP-API 连续返回{原因}，当前已进入短暂保护。请先{处理动作}，预计{等待时间}后再试；这不代表封号，也不是套餐或算力限制。”不要只说“LinkFox 限流”或“服务器繁忙”。

算力消耗规则

不消耗算力（以网关实际计费为准）。

Feedback： skillName：linkfox-amazon-store-fba

---

更多跨境 skill：LinkFox Skills