ledgerly-docs/guide/bills/cmb.md

招商银行账单

招商银行支持导出「交易流水」，系统以 CSV、PDF 或 zip 形式导入。

如何获取

招商银行提供多种导出渠道，格式与可查询时间范围各不相同，可按需选择。

手机 App（个人，常用）

• 打开招商银行 App，在首页搜索「流水打印」或「打印流水」，或在 我的 → 全部 中找到「流水打印」。
• 选择账户与时间范围，输入接收邮箱提交。
• 通过 App 导出的通常是带电子印章的 PDF，适用于个人对账或证明材料。
• App 可查询较长时间范围（最长近 5 年），但单次申请跨度一般不超过 1 年，更早记录需分次申请。
• 导出的文件为加密压缩包，解压密码在 App 的「申请记录」页查看。

个人网银专业版 / 个人银行 PC 版（可导出 Excel）

• 登录个人银行 PC 版（专业版），进入 账户管理 → 活期交易查询。
• 选择时间段查询后点击「保存」，文件类型选择 Excel(.xls)。
• 仅支持查询近 13 个月的交易记录，且仅支持中文活期交易记录；更早的流水需改用 App 或前往网点。

营业网点

• 携带有效身份证件与一卡通，可打印开户至今的流水；13 个月以内通常免费，13 个月以上部分网点可能收费。
• 如需要更早时间且为 Excel 格式，可向柜员明确提出「定制导出电子表格」的需求。

企业网银 / 企业手机 App

• 企业网银：账务管理 → 账务查询 → 交易查询 → 导出 → Excel 快速导出（可查近 5 年，单次跨度不超过 366 天）。
• 企业手机 App：首页 → 收支明细 → 右上角下载 → 选择账号与起止日期 → 输入邮箱接收 Excel。

导入

在账单导入页选择账单类型「招商银行」，上传 CSV、PDF 或 zip 文件。

• 支持格式：.csv、.pdf、.zip
• CSV 与 PDF 使用同一套去重键，两种格式可以混用而不重复导入。

字段映射

CSV

源字段（CSV 列）	落库字段	处理说明
交易日期	transaction_time	与交易时间组合为完整时间
交易时间	transaction_time	同上
交易备注	remark	作为备注
交易类型	remark / 预览	作为商品名称或交易状态
收入金额	amount + type	有值时 type=INCOME
支出金额	amount + type	有值时 type=EXPENSE
余额	生成去重键	参与 CMB_日期_类型_金额_余额
—	channel	固定为 CMB
—	category_id	取导入面板默认分类；未选为 NULL

# 开头的行视为元信息/合计并结束解析。

PDF

PDF 为文本型「交易流水」，系统按字符坐标还原表格，读取列：

源字段	落库字段	处理说明
记账日期	transaction_time	取零点
交易金额	amount + type	带符号单列：负数为支出、正数为收入
联机余额	生成去重键 + 校验	参与去重键；按余额连续性校验（误差 0.005），不连续则标记为不可导入
交易摘要 / 对手信息	remark	作为备注
—	channel	固定为 CMB
—	category_id	取导入面板默认分类；未选为 NULL

去重

银行流水通常没有交易号，系统会以「日期 + 类型 + 金额 + 余额」生成稳定的去重键（如 CMB_20260916_支出_3406.50_43233.20），因此重复导入同一账单不会产生重复记录。

注意事项

• 系统支持导入招商银行的 CSV 与 PDF（文本型），优先推荐 CSV。
• 若导出为加密压缩包，导入时需输入密码（密码见 App「申请记录」页）。
• PDF 账单请使用招商银行 App 导出的文本型 PDF，扫描件无法解析。
• 个人网银专业版导出的 .xls 暂不支持直接导入：可在 Excel 中另存为 CSV 后再导入，或改用 App 导出 PDF。
• 招行 CSV 与 PDF 使用同一套去重键，两种格式可混用而不重复导入。