chore: 初始化文档站仓库

2026-09-21 13:38:20 +08:00
commit a4ae7ac979
58 changed files with 4622 additions and 0 deletions
@@ -0,0 +1,43 @@
+# 淘宝账单
+
+淘宝支持导出「订单数据」，系统以 **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 的订单，因金额无效标记为不可导入，待订单完成后重新导出即可。
+- **去重**：系统按「用户 + 订单号」去重，重复导入同一订单会被自动跳过。