# 淘宝账单

淘宝支持导出「订单数据」，系统以 **xlsx** 形式导入。

## 如何获取

1. 打开**淘宝网页版**（电脑浏览器），登录后进入 **我的淘宝 → 我的订单 → 已买到的宝贝**。
2. 点击「**导出订单**」，选择需要导出的时间范围。
3. 导出为 **xlsx** 文件（通常命名为 `订单数据.xlsx`），按页面提示下载。

::: tip 以实际界面为准
淘宝导出入口可能随网页版本调整，如界面有差异，可在淘宝帮助中心搜索「导出订单」。
:::

## 导入

在[账单导入](/guide/transactions)页选择账单类型「淘宝」，上传 xlsx 文件。

- 支持格式：`.xlsx`
- 淘宝订单均为购买支出，导入时固定记为支出（`EXPENSE`）。

## 字段映射

系统以「订单号」定位表头，读取以下列：

| 源字段（xlsx 列） | 落库字段 | 处理说明 |
|---|---|---|
| 订单号 | `external_no` | 导入去重键；多商品订单共用同一订单号 |
| 订单提交时间 | `transaction_time` | 兼容文本时间与 Excel 日期序列号 |
| 店铺名称 | `remark` | 与商品名称拼接为备注 |
| 商品名称 | `remark` | 多商品订单以「、」拼接 |
| 实付金额 | `amount` | 订单级合计；为空时回退「Σ(商品金额×数量)+运费」 |
| 订单状态 | 仅推断/预览 | 「交易关闭」标记为不可导入 |
| — | `type` | 固定为 `EXPENSE`（支出） |
| — | `channel` | 固定为 `TAOBAO` |
| — | `category_id` | 取导入面板默认分类；未选为 NULL |

## 注意事项

- **多商品订单会合并为一条**：淘宝订单数据中，一个订单包含多个商品时会占用多行（订单级列以合并单元格展示），系统按订单号聚合，每个订单只生成一条记录。
- **交易关闭不导入**：订单状态为「交易关闭」的记录标记为不可导入，默认不勾选。
- **未完成订单**：如「卖家已发货」且实付金额为 0 的订单，因金额无效标记为不可导入，待订单完成后重新导出即可。
- **去重**：系统按「用户 + 订单号」去重，重复导入同一订单会被自动跳过。