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

64 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 支付宝账单
支付宝支持导出「交易记录明细」,系统以 **CSV** 或 **zip** 形式导入。
## 如何获取
### 手机 App(推荐)
1. 打开支付宝 App,进入 **我的 → 账单**。
2. 点击账单页面右上角的「**…**」,选择「**开具交易流水证明**」(部分版本显示为「开具银行流水证明」)。
3. 选择证明用途(如「用于材料证明」),点击「申请」,输入支付密码完成验证。
4. 设置交易流水范围(全部 / 收入 / 支出)与时间范围:可选 1 个月、3 个月或自定义,**最长支持 1 年**,跨年度需分多次申请。
5. 填写接收账单的**电子邮箱**并确认发送,账单会以压缩包形式发送到邮箱。
### 电脑网页版
访问支付宝官网(www.alipay.com)→ 服务大厅 → 自助服务 → 应用服务 → 收支明细证明,按提示申请。
> 支付宝导出的压缩包通常未加密,可直接交给系统解析;若设置了密码,在导入时输入。
## 导入
在[账单导入](/guide/transactions)页选择账单类型「支付宝」,上传 CSV 或 zip 文件。
- 支持格式:`.csv`、`.zip`
- 编码:自动识别 UTF-8 / UTF-8 BOM / GBK
## 字段映射
解析器以「交易号」开头的表头行定位数据区,读取以下关键字段:
| 源字段(CSV 列) | 落库字段 | 处理说明 |
|---|---|---|
| 交易号 | `external_no` | 导入去重键(`uk_user_external`) |
| 付款时间 | `transaction_time` | 交易时间;为空时回退「交易创建时间」 |
| 交易创建时间 | `transaction_time` | 仅作付款时间缺失时的兜底 |
| 金额(元) | `amount` | 去除千分位逗号后解析 |
| 收/支 | `type` | 支出→EXPENSE,收入→INCOME |
| 交易对方 | `remark` | 与商品名称拼接为「交易对方 · 商品名称」,截断至 255 字符 |
| 商品名称 | `remark` | 同上 |
| 交易状态 | 仅推断/预览 | 参与类型推断与预览展示,不落库 |
| 资金状态 | 仅推断 | 用于「不计收支」行的类型推断 |
| 收/支=不计收支 | `include_in_stats` | 默认不计入统计 |
| — | `channel` | 固定为 `ALIPAY` |
| — | `category_id` | 取导入面板默认分类;未选为 NULL |
以下列**完全丢弃**:商家订单号、最近修改时间、交易来源地、类型、服务费(元)、成功退款(元)、备注(支付宝自带备注)。
### 类型推断
| 收/支 | 交易状态 / 资金状态 | 推断类型 |
|---|---|---|
| 支出 | — | EXPENSE |
| 收入 | — | INCOME |
| 不计收支 | 含「退款」 | INCOME |
| 不计收支 | 资金状态为「已收入」 | INCOME |
| 不计收支 | 其他(如交易关闭) | EXPENSE |
## 注意事项
- 支付宝 CSV 中自带的「备注」列不会被导入,系统备注由「交易对方 · 商品名称」拼接生成。
- 建议按年或按季度导出,避免单文件过大。
- 重复导入同一文件时,相同交易号的记录会被跳过。