ENGINEERING NOTE 45 / 50 · CARD
卡片CSV对账应选择哪些稳定键
行顺序、商户名称和格式化金额不是可靠匹配键。应尽量使用稳定交易引用与明确生命周期关联。
本文由 OPEN RAMBO 发布。工程方案和伪代码用于说明设计,不是现有产品 API 文档;示例数字均为演示。
匹配前规范化
解析时间时保留时区,金额按币种精度。调试需要时在工作区保留原文本与规范值。编号不能作为数字导入而丢失有意义前导零。
采用证据层级
精确处理方引用优先于商户日期模糊匹配。不明确时进入复核。同日两笔同金额交易很正常,不能据此合并。
让重复运行结果确定
用文件标识和交易事件键去重。重复导入不能产生新账本流水。保存已匹配、未匹配、歧义数量及各币种总额。
示意流程
match_key = (processor_reference, event_type, currency)
# Ambiguous fallbacks require review, never automatic merging.如何验收
重复导入并打乱行顺序,匹配数量和资金总额应不变。