用途:管理 Amazon FBA 入仓全流程,覆盖 Fulfillment Inbound v2024-03-20 的 45 个 operation,以及 6 个 v0 查询/文档 operation。按分组文档覆盖入库计划、装箱、分仓、货件、货件内容变更、送达窗口、India 自配送预约、运输方案、预处理与合规标签、异步状态与 v0 遗留能力。
依赖与授权:依赖 linkfox-amazon-store-auth,先运行 python scripts/check_auth_dependency.py,若 exit code 42 且 stderr 含 DEPENDENCY_MISSING: 需先安装或加载依赖。通过 auth 技能选定店铺取得 sellerId 与 region,region 仅允许 NA、EU、FE。不接收、存储或透传 amzAccessToken、accessToken、refreshToken,也不允许覆盖 Amazon path、method 或网关 queryString。
用法:API 端点 POST /spApi/developerProxy;脚本形式 python scripts/<operation_script>.py '<JSON 参数>' [--inline] [--no-cache]。公共参数含 sellerId、region,path/query 参数与 requestBody 条件使用,提交类操作需 confirmWrite=true。示例:python scripts/get_inbound_plan.py '{"sellerId":"A1...","region":"NA","inboundPlanId":"..."}'。
输出与限制:完整响应写入 linkfox/<日期>/<session>/data/ 下的 JSON;响应 ≤8 KB 打印完整 JSON,>8 KB 仅输出摘要,--inline 强制全量。同一会话同一参数默认只调用一次,带 24h 缓存。失败或空结果不得自动换参数、翻页或连续试探,需经用户同意。写操作前需确认意图;8 个确定性提交操作必须取得明确确认,涉及费用时需展示 option、费用、币种、时效与过期时间,不得默认选择收费项。19 个异步 operation 需用 get_inbound_operation_status.py 查询状态,IN_PROGRESS 应停止,FAILED 展示 operationProblems,仅 SUCCESS 可继续。触发 450/453/454/459 保护时须停止重试并等待冷却。绑定 getLabels / getBillOfLading 需使用 getShipment 返回的 shipmentConfirmationId,下载 URL 可能很快过期,应立即下载。市场限制与完整流程详见对应 references 文档。