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

3.0 KiB
Raw Blame History

支付宝账单

支付宝支持导出「交易记录明细」,系统以 CSV 或 zip 形式导入。

如何获取

手机 App(推荐)

  1. 打开支付宝 App,进入 我的 → 账单。
  2. 点击账单页面右上角的「…」,选择「开具交易流水证明」(部分版本显示为「开具银行流水证明」)。
  3. 选择证明用途(如「用于材料证明」),点击「申请」,输入支付密码完成验证。
  4. 设置交易流水范围(全部 / 收入 / 支出)与时间范围:可选 1 个月、3 个月或自定义,最长支持 1 年,跨年度需分多次申请。
  5. 填写接收账单的电子邮箱并确认发送,账单会以压缩包形式发送到邮箱。

电脑网页版

访问支付宝官网(www.alipay.com)→ 服务大厅 → 自助服务 → 应用服务 → 收支明细证明,按提示申请。

支付宝导出的压缩包通常未加密,可直接交给系统解析;若设置了密码,在导入时输入。

导入

在账单导入页选择账单类型「支付宝」,上传 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 中自带的「备注」列不会被导入,系统备注由「交易对方 · 商品名称」拼接生成。
  • 建议按年或按季度导出,避免单文件过大。
  • 重复导入同一文件时,相同交易号的记录会被跳过。