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

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

前提条件

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

设置指南

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

2. 填写数据源名称。

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

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

5. 期间天数持切片增量同步的报告没有更新状态时，将用于初始完全刷新同步的数据流切片。

6. OAuth 完成后，在 Amazon Marketplaces 中加载 SP-API Sellers getMarketplaceParticipations 返回的 marketplace，并选择要同步的 marketplace ID。

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）

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

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

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

10. 点击保存并测试。

保存并测试时，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）
• 补充库存报告（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）
• 优惠券表现报告（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 报告类型。
• 数据源级 Advanced Amazon Report JSON 仅作为旧版高级兜底，用于连接级控件没有覆盖的 report-specific 参数。它会影响所有复用该数据源的连接。

故障排除

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

数据类型映射

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