跳到正文
G1-03账务核心1 分钟更新于 2026-11

凭证与分录

一句话

凭证是记账的原子单位,一张凭证内的分录必须自平衡,要么全记、要么全不记。

本文目录7 节

凭证与分录

一张凭证长什么样

stack凭证的结构
凭证头
凭证号、业务日期、摘要、幂等键(业务单号 + 事件类型)
分录 1
借:备付金 100.00
分录 2
贷:应付商户款 99.00
分录 3
贷:手续费收入 1.00
约束
借方合计 = 贷方合计;同一凭证的分录必须同批写入

为什么必须成组

一笔业务涉及多个科目,任何一条漏记,账就不平。 如果按条写入数据库,网络抖动或进程崩溃就会留下「半张凭证」。

所以记账接口的语义是整张凭证的原子写,不是「一条分录一个请求」。

幂等键放在凭证头上

  • 幂等键 = 业务单号 + 事件类型(如 order_123:payment_success)
  • 重复提交时返回第一次的凭证号,不重复记账
  • 索引建在幂等键上,由数据库兜底

一个反例

某系统按「一条分录一个请求」写入,进程崩溃留下半张凭证,月结不平。现在凭证整张原子写入。

常见误判

  • 一条分录单独落库(半张凭证)
  • 用自增 ID 当幂等键(重试时 ID 不同)
  • 凭证号用时间戳生成(并发冲突)

自查清单

  • 凭证是原子写入吗
  • 幂等键设计在凭证头还是分录上
  • 凭证号生成规则能防并发吗
  • 一张凭证最多允许多少条分录
  • 借贷不平衡时会拒绝写入吗

依据

相关阅读