Files
ledgerly-docs/guide/bills/taobao.md
T

44 lines
2.1 KiB
Markdown

# 淘宝账单
淘宝支持导出「订单数据」,系统以 **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 的订单,因金额无效标记为不可导入,待订单完成后重新导出即可。
- **去重**:系统按「用户 + 订单号」去重,重复导入同一订单会被自动跳过。