ledgerly-docs/guide/bills/taobao.md

淘宝账单

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

如何获取

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

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

导入

在账单导入页选择账单类型「淘宝」，上传 xlsx 文件。

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

字段映射

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

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

注意事项

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