亚马逊卖家合作伙伴（Amazon Seller Partner）

此页面包含亚马逊卖家合作伙伴 (Amazon Seller Partner / Amazon SP) 的设置指南和参考信息。

前提条件

• 亚马逊卖家后台账号
• 至少一个卖家账号已参与的 Amazon SP-API marketplace

设置指南

1. 从数据源列表中选择亚马逊卖家合作伙伴（Amazon Seller Partner）。

2. 填写数据源名称。

3. 选择 Authorization Marketplace，用于决定从哪个 Seller Central marketplace 发起 OAuth 授权。

4. 验证您的亚马逊卖家后台账号。

5. OAuth 完成后，在 Available Amazon Marketplaces 中加载 SP-API Sellers getMarketplaceParticipations 对这个已授权卖家账号返回的 marketplace，并选择要同步的 marketplace ID。如果日本或其他跨区域 marketplace 没有返回，需要从对应 Seller Central 区域重新授权，或确认该卖家账号已参与对应 marketplace。

   当 Amazon 对该授权账号返回对应 marketplace 时，Available Amazon Marketplaces 会包含以下销售区域的 marketplace ID：

   • 北美：美国（US），加拿大（CA），墨西哥（MX），巴西（BR）
   • 欧洲：比利时（BE），德国（DE），西班牙（ES），法国（FR），爱尔兰（IE），意大利（IT），英国（UK），荷兰（NL），瑞典（SE），波兰（PL），土耳其（TR），南非（ZA）
   • 中东：阿联酋（AE），沙特阿拉伯（SA），埃及（EG）
   • 亚太地区：日本（JP），印度（IN），澳大利亚（AU），新加坡（SG）

6. 报告等待时限是接口等待生成报告的最大秒数。

7. 期间天数在支持切片增量同步的报告没有更新状态时，将用于初始完全刷新同步的数据流切片。它不控制使用 Acquisition Method 的报告，包括 GET_EPR_MONTHLY_REPORTS。

8. Acquisition Method 是 connection 级别的周期配置。对使用固定自然月采集窗口的报告，选择 Cycle Acquisition，并设置 Cycle = 上一个已结束的自然月。

9. 结束日期（可选） - 不会复制此日期之后的任何数据。

10. 开始日期 - 此日期之前的任何数据都不会被复制。

11. 复制跨度周期（可选）会按天数生成复制窗口；如果配置了开始日期，窗口以开始日期为结束点。如果未配置开始日期，窗口以当前 UTC 时间为结束点。

12. 点击保存并测试。

保存并测试时，Daspire 会校验 Login with Amazon refresh token 换取 access token，并对每个已选择的 Amazon marketplace 发送低成本 SP-API Orders 请求。错误信息会区分 LWA 凭证、marketplace 不匹配、SP-API 权限不足、限流和亚马逊服务器错误。

支持的同步模式

亚马逊卖家合作伙伴（Amazon SP）数据源支持以下同步模式：

• 完全复制
• 增量复制

支持的数据流

此数据源能够同步以下数据流：

• FBA库存报告（FBA Inventory Reports）
• FBA订单报告（FBA Orders Reports）
• FBA发货报告（FBA Shipments Reports）
• FBA换货报告（FBA Replacements Report）
• FBA仓储费报告（FBA Storage Fees Report）
• FBA 管理库存报告（GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA）
• 补充库存报告（Restock Inventory Reports）
• 文件打开列表报告（Flat File Open Listings Reports）
• 文件订单报告（Flat File Orders Reports）
• 文件订单报告最近更新（Flat File Orders Reports By Last Update）（增量）
• FBA发货报告（Amazon-Fulfilled Shipments Report）
• 商家列表报告（Merchant Listings Reports）
• 供应商直接履行配送（Vendor Direct Fulfillment Shipping）
• 供应商库存健康报告（Vendor Inventory Health Reports）
• 订单（Orders）（增量）
• 卖家反馈报告（Seller Feedback Report）（增量）
• 品牌分析替代购买报告（Brand Analytics Alternate Purchase Report）
• 品牌分析项目比较报告（Brand Analytics Item Comparison Report）
• 品牌分析市场购物车报告（Brand Analytics Market Basket Report）
• 品牌分析重复购买报告（Brand Analytics Repeat Purchase Report）
• 品牌分析搜索词报告（Brand Analytics Search Terms Report）
• 浏览记录报告（Browse tree report）
• 财务事件组（Financial Event Groups）
• 财务事件（Financial Events）
• EPR 月报（GET_EPR_MONTHLY_REPORTS）
• 优惠券表现报告（Coupon Performance Report）
• 促销表现报告（Promotion Performance Report）

报告选项

在连接的 Replication settings 表格中配置报告请求选项。Amazon Seller 中支持报告参数的数据流，会在同步模式旁显示 Report settings 控件。

• GET_SALES_AND_TRAFFIC_REPORT 支持日期聚合（每日、每周、每月）和商品聚合（Parent、Child、SKU）。
• Brand Analytics 报告数据流支持 Brand Analytics 报告周期（每日、每周、每月、每季度），但具体可用值取决于所选 Amazon 报告类型。 如果还没有保存过周期，Brand Analytics 默认使用每日；GET_BRAND_ANALYTICS_REPEAT_PURCHASE_REPORT 默认使用每周，因为 Amazon 不支持该报告类型的每日周期。
• GET_EPR_MONTHLY_REPORTS 使用 connection 级别的 Acquisition Method 周期，目前支持 Cycle = 上一个已结束的自然月。source settings 会把该周期和期间天数分开显示。若该数据流需要每月只运行一次，请将对应 connection 调度为每月 2 日运行。

故障排除

单次可同步的最大表数为6千张。如果由于达到最大表数而无法获取数据架构，我们建议您调整数据源设置。

数据类型映射

集成类型	Daspire类型
string	string
int, float, number	number
date	date
datetime	datetime
array	array
object	object