摘要
通过销售合作伙伴 API 访问 Amazon Vendor Central:零售采购订单、确认、发货确认、发票、带标签的直接履行订单、装箱单和库存、交易状态及供应商报告。使用私有供应商应用的 Amazon 刷新令牌登录。
引导式设置
2 分钟将 Amazon Vendor Central 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Amazon Vendor Central,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Amazon Vendor Central (SP-API) 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Amazon Vendor Central,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Amazon Vendor Central
通过销售合作伙伴 API 访问 Amazon Vendor Central:零售采购订单、确认、发货确认、发票、带标签的直接履行订单、装箱单和库存、交易状态及供应商报告。使用私有供应商应用的 Amazon 刷新令牌登录。
设置
设置大约需要 20 分钟。你需要加上 Amazon 对开发者资料的审核。
- 在 Vendor Central 中打开 Integration,然后选择 API Integration,并完成 Developer Profile。在 Data Access 下选择 Private Developer: I build application(s) that integrate my own company with Amazon Services APIs,选择你需要的角色,然后选择 Register。Amazon 会审核该资料并开启后续步骤。
- 在同一页面选择 Add new app client,填写表单,勾选 Amazon 提供选择的 Vendors,并选择角色。然后在 LWA credentials 下选择 View,将客户端标识符复制到
SPAPI_CLIENT_ID,将客户端密钥复制到SPAPI_CLIENT_SECRET。 - 为你的供应商账户选择 Authorize app。Amazon 会显示一个 refresh token(以
Atzr|开头):将其粘贴到SPAPI_REFRESH_TOKEN。 - 在
SPAPI_ENDPOINT中选择你的区域(北美、欧洲或远东),并在SPAPI_MARKETPLACE_ID中输入你的 Amazon 商店的市场 ID,例如ATVPDKIKX0DER(美国)、A1PA6795UKMFR9(德国)、A1F83G8C2ARO7P(英国)、APJ6JRA9NG5V4(意大利)、A13V1IB3VIYZZH(法国)、A1RKKUPIHCS9HS(西班牙)、A1VC38T7YXB528(日本)。
角色:零售工具需要角色 Amazon Fulfillment。直接履行工具需要 Direct-to-Consumer Shipping (Restricted),这是一个受限角色,因为订单包含客户地址;Amazon 在授予之前会要求提供更多关于数据保护的信息。供应商报告需要 Brand Analytics。没有角色的调用会返回 403。
从哪里开始:amazon_vendor_list_purchase_orders 和 purchase_order_state New 显示 Amazon 订购的内容;amazon_vendor_get_purchase_order 提供完整的订单信息。
零售采购:amazon_vendor_list_purchase_orders、amazon_vendor_get_purchase_order、amazon_vendor_list_purchase_order_statuses(接受和接收的数量)。使用 amazon_vendor_submit_acknowledgements 回复订单,使用 amazon_vendor_submit_shipment_confirmations 通知发货,然后使用 amazon_vendor_list_shipments 和 amazon_vendor_list_transport_labels 跟踪。确认和发货确认是对 Amazon 的约束性回复,因此 amazon_vendor_submit_acknowledgements 和 amazon_vendor_submit_shipment_confirmations 默认关闭,amazon_vendor_submit_invoices 也是:当 AI 应该发送它们时,请在连接器页面上打开它们;系统会要求你确认每一个。
直接履行(你直接向 Amazon 的客户发货):amazon_vendor_list_df_orders、amazon_vendor_get_df_order、amazon_vendor_acknowledge_df_orders、amazon_vendor_list_df_packing_slips、amazon_vendor_get_df_packing_slip、amazon_vendor_list_df_customer_invoices、amazon_vendor_list_df_shipping_labels、amazon_vendor_get_df_shipping_label、amazon_vendor_submit_df_shipment_confirmations 和 amazon_vendor_update_df_inventory。创建标签的运输:amazon_vendor_request_df_shipping_labels 和 amazon_vendor_create_df_shipping_labels 默认关闭,amazon_vendor_acknowledge_df_orders、amazon_vendor_submit_df_shipment_confirmations 和 amazon_vendor_submit_df_invoices 也是。
提交是异步的:每个提交工具的回复包含一个 transactionId,没有其他信息。使用 amazon_vendor_get_transaction_status(零售)或 amazon_vendor_get_df_transaction_status(直接履行)读取结果:处理、成功或失败及错误。在结果显示成功之前,不要报告提交已完成。
报告(3 个步骤):amazon_vendor_create_report,然后 amazon_vendor_get_report 直到 DONE,然后 amazon_vendor_download_report_document。
字段说明:列表调用每次最多覆盖 7 天;直接履行列表需要同时提供 created_after 和 created_before。时间格式为 ISO 8601。数量带有单位(零售为 Cases 或 Eaches,直接履行为 Each);货币为带有货币代码的小数字符串。partyId 是你的销售方供应商代码和发货方及收货方的仓库代码。列表页面带有 pagination.nextToken。
速率限制:每个操作每秒 10 次调用,突发 10 次(交易状态:突发 20 次)。在 429 时稍等片刻再调用。
先决条件:SPAPI_CLIENT_ID、SPAPI_CLIENT_SECRET、SPAPI_REFRESH_TOKEN、SPAPI_ENDPOINT、SPAPI_MARKETPLACE_ID
在本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 Amazon Vendor Central 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
amazon_vendor_list_purchase_orders | 列出 Amazon 向你下的零售采购订单,在最多 7 天的时间窗口内创建或更改的:purchaseOrderNumber… |
amazon_vendor_get_purchase_order | 读取一份零售采购订单:状态、订单日期、采购订单类型、交货窗口、支付方式、购买、销售、发货地址等… |
amazon_vendor_list_purchase_order_statuses | 列出最多 7 天内零售采购订单的履行状态:purchaseOrderStatus(OPEN, CLOSED)及每个项目的… |
amazon_vendor_submit_acknowledgements | 确认零售采购订单:接受、缺货或拒绝每个项目及其数量和承诺的日期。确认… |
amazon_vendor_submit_shipment_confirmations | 发送零售采购订单的发货确认(提前发货通知):发货内容、发货地点、承运人及… |
amazon_vendor_list_shipments | 列出 Amazon 知道的零售发货,包含承运人详细信息、当前状态、容器及其中的采购订单。按你的… |
amazon_vendor_list_transport_labels | 列出 Amazon 已为零售发货创建的小包运输标签:每个包裹的标签数据及追踪号码,还有… |
amazon_vendor_submit_invoices | 向 Amazon 提交零售采购订单的发票或信用票据。发票是法律和财务文件:Amazon 通过它支付… |
amazon_vendor_get_transaction_status | 通过其 transactionId 读取零售提交(确认、发货确认或发票)的结果:状态为处理、成功… |
amazon_vendor_list_df_orders | 列出直接履行采购订单(你直接向 Amazon 客户发货的订单),在最多 7 天的时间窗口内创建… |
amazon_vendor_get_df_order | 读取一份直接履行采购订单:状态、订单日期、客户发货地址、发货详情(发货方式、优先级、承诺… |
amazon_vendor_acknowledge_df_orders | 确认直接履行采购订单:确认或拒绝每个项目的数量。拒绝会取消客户订单… |
amazon_vendor_list_df_shipping_labels | 列出最多 7 天内创建的直接履行订单的现有运输标签:purchaseOrderNumber、标签… |
amazon_vendor_get_df_shipping_label | 读取一份直接履行订单的现有运输标签:标签格式及每个包裹的追踪号码、承运人、发货方式… |
amazon_vendor_request_df_shipping_labels | 请求 Amazon 为直接履行订单创建运输标签,使用 Amazon 支付的承运人。这为包裹预定运输。Amazon… |
amazon_vendor_create_df_shipping_labels | 为一份直接履行订单创建运输标签,并立即返回(标签内容为 Base64 格式,包含追踪号码)。这… |
amazon_vendor_submit_df_shipment_confirmations | 确认直接履行订单已发货(或未能发货:FLOOR_DENIAL),每个项目的发货数量及包裹… |
amazon_vendor_list_df_packing_slips | 列出 Amazon 为最多 7 天内创建的直接履行订单准备的装箱单:purchaseOrderNumber、内容… |
amazon_vendor_get_df_packing_slip | 读取一份直接履行订单的装箱单:内容类型及装箱单内容(PDF 的 Base64)放入包裹中。限制:10… |
amazon_vendor_list_df_customer_invoices | 列出 Amazon 为最多 7 天内创建的直接履行订单准备的客户发票(发票存储的商店… |
amazon_vendor_update_df_inventory | 发送你在一个仓库中可用于直接履行的库存。若 is_full_update 为 false,仅列出的项目会更改… |
amazon_vendor_submit_df_invoices | 向 Amazon 提交直接履行订单的发票。发票是法律和财务文件:Amazon 通过它支付。Amazon 处理… |
amazon_vendor_get_df_transaction_status | 通过其 transactionId 读取直接履行提交(确认、发货确认、库存更新、标签请求或发票)的结果… |
amazon_vendor_create_report | 通过报告 API 请求供应商报告(第 1 步,共 3 步),用于此连接器的市场。供应商报告类型… |
amazon_vendor_get_report | 检查报告(第 2 步,共 3 步):processingStatus 为 IN_QUEUE、IN_PROGRESS、DONE、CANCELLED 或 FATAL。轮询直到 DONE,然后传递… |
amazon_vendor_download_report_document | 读取完成报告的内容(第 3 步,共 3 步)。服务器获取文件,解压缩并返回:供应商分析报告… |
示例提示
- “本周有哪些新的 Amazon 采购订单进来,它们要求的数量是多少?”
- “显示采购订单 2JK3S9VC 及其项目和发货窗口。”
- “哪些直接履行订单仍需运输标签?”
- “检查交易 12345-abcde:Amazon 是否接受了我提交的发票?”
- “请求上周的供应商销售报告,并告诉我何时准备好。”
下一步
这份指南对你有帮助吗?