---
description: "自动从 Amazon 卖家中心下载结算报表，省去重复登录与手工导出。"
---

# Amazon 结算报表自动下载

帮你从 Amazon 卖家中心自动申请并下载结算报表（Settlement），保存为 Excel 文件，并记录每次下载结果。

---

## 这个技能能帮你做什么

- 按你指定的日期范围，自动申请结算报表
- 等待报表生成完成后自动下载，保存到本地
- 记录每次下载是否成功、文件路径与失败原因
- 适合跨境财务实训中定期拉取 Amazon 结算数据

---

## 适合什么场景

- 月末或周度需要从 Amazon 导出结算报表做对账
- 实训/教学中反复练习「登录 → 选日期 → 下载报表」流程
- 希望 Agent 代为完成重复性的报表下载操作

---

## 使用前需要准备什么

- 已在账号管理中添加 **Amazon 仿真卖家** 账号（平台标识 `amazon_sim`），且状态为可用
- 账号已完成登录（或具备自动登录凭据）
- 确认要下载的**起止日期**（例如 2025-12-01 至 2025-12-31）
- 可选：指定店铺代码；不指定时使用页面默认第一个店铺

### 添加 Amazon 仿真账号（若尚未配置）

若 `amazon_sim` 平台尚未在 account-manager 中注册，需由运维先注册平台；然后执行：

```text
python D:\OpenClaw\client-commons\account-manager\scripts\main.py account add-web \
  --platform amazon_sim \
  --login-id <邮箱> \
  --url https://sandbox.jc2009.com/industries/ecommerce/amazon/login \
  --environment simulator \
  --auth-strategy password_auto
```

建议 `extra_json`：`{"logged_in_url_pattern": "/seller"}`

联调前须存在 **active** 账号且带 **profile_dir**（浏览器登录态目录）。

---

## 你可以这样告诉 Agent

> 「帮我下载 2025 年 12 月的 Amazon 结算报表。」

> 「从 Amazon 卖家中心导出 12 月 1 日到 12 月 31 日的结算单。」

> 「用 AMA1OF6T 店铺下载上周的 settlement 报表。」

---

## 执行后你会得到什么

- 成功时：本地 xlsx 文件路径、任务编号、日期范围（JSON 摘要）
- 失败时：错误说明；必要时可在数据目录查看失败截图
- 任务日志中可查询历史下载记录

---

## 注意事项

- 请确认日期范围正确，避免下载错期间的数据
- 仿真环境与真实 Amazon 卖家中心界面类似，但数据为实训用途
- 本技能仅下载报表文件，**不会**自动解析 Excel 内容或入账