Odoo会计对账原理、操作说明及常见问题

会计对账操作说明

本文档梳理 Odoo 17 银行对账（account.bank.statement.line）的操作步骤、注意事项及常见问题处理办法，帮助会计在遇到报错或异常状态时快速定位原因。

---

主要概念

• 银行对账行（Statement line）：导入或手工录入的银行流水行。
• 银行行（Liquidity line）：凭证中使用日记账默认银行/现金科目的分录行，account_type=asset_cash。
• 暂记科目行（Suspense line）：凭证中用于暂存、待确认的对方科目行，通常 不 勾选“可对账”。
• 部分核销（Partial reconcile）：account.move.line 上的 matched_debit_ids / matched_credit_ids，表示已与其他凭证行发生匹配。
• 验证（Validate）：在对账小部件中点击“验证/确认”按钮后，系统会重写对应凭证行，将暂记科目替换为实际科目并完成核销。

---

标准对账流程

1. 定位待处理的银行对账行

   • 列表视图中筛选“未匹配（Not matched）”。
   • 在开发者模式下，可查看 is_reconciled 字段确认真实状态。

2. 检查是否存在历史核销

   • 若银行凭证行 matched_debit_ids / matched_credit_ids 有值，说明之前已经建立过部分核销。
   • 可以在对账界面点右上角“调试操作 ▸ 取消对账”，或在凭证表单页签勾选该行后选择“操作 ▸ 取消匹配”；如界面无此按钮，可在 shell 中执行 remove_move_reconcile()。务必在重新验证前清理残留核销。

3. 在对账小部件中选择要匹配的单据

   • 只选择应收/应付、费用、收入等非银行科目的分录。
   • 如需调整金额或科目，可在界面中修改新增行的 account_id，务必避免再次选择银行科目。

4. 验证

   • 点击“验证”后，系统会：
     1. 先创建/更新 partial reconcile（银行行与选中单据挂钩）。
     2. 清空原凭证行 [Command.clear()] 并按照界面行重建。
     3. 确保仅保留 一 条银行科目行，其余行改为真正的对方科目。
     4. 执行 _reconcile_plan 完成核销，is_reconciled 变为 True。

5. 验证结果

   • 列表刷新后，该对账行将从“未匹配”过滤器中消失。
   • 若仍在“未匹配”，说明暂记行未被替换或残值未归零，需要检查错误处理部分。

---

暂记科目替换逻辑

1. 用户在小部件中确认行内容

   • 第一行始终是银行科目（flag='liquidity'），系统会保留。
   • 其余行由用户选择的发票/费用等分录或手工新增行组成（flag='new_aml'、flag='manual' 等）。
   • 这些行的 account_id 决定了替换暂记科目后要使用的真实科目。

2. 验证时重写凭证

   • bank.rec.widget._action_validate()（account_accountant/models/bank_rec_widget.py）会将上述行转换为 Command.create(...)，写回原凭证：

     move_ctx.write({
         'partner_id': partner_to_set.id,
         'line_ids': [Command.clear()] + line_ids_create_command_list,
     })
     

   • Command.clear() 先删除原来的两条默认行（银行 + 暂记）。
   • 随后的 Command.create 会逐条创建新行：第一条仍为银行科目，其余行的 account_id 承袭界面设置，相当于直接把“暂记科目”替换掉。

3. 替换成功的前提

   • 满足只有一条行使用银行科目；其它行必须是非 asset_cash 科目（如应收、应付、费用）。
   • 如果用户在界面上把第二行又选成了银行科目，写回后仍会得到两条银行行，导致 _seek_for_lines() 判定无效，后续取消或再对账都会失败。

4. 如何确认替换结果

   • 验证后打开凭证，检查非银行行的 account_id 是否正确。
   • 确认 journal_entry.line_ids 中只有一条科目属于 asset_cash 且等于日记账默认银行科目。

5. 替换失败的常见场景

   • 验证阶段报错（例如 _check_reconciliation()），导致暂记行未被删除，却已创建 partial reconcile，需先取消核销再重试。
   • 自定义对账模型返回了银行科目，或脚本在写入时覆盖了本应替换的科目。

掌握这一机制后，只要确保在验证前界面上的“新分录”行科目正确，系统就会自动将暂记科目替换为真实科目。若需重新指定，可在对账窗口直接编辑该行的科目字段，再执行验证。

---

常见错误与处理

1. “You cannot do this modification on a reconciled journal entry.”

• 触发原因
  • 在验证阶段需要修改银行行的字段（account_id、balance 等），但该行已存在 matched_debit_ids/matched_credit_ids。
• 解决步骤
  1. 在凭证界面或 shell 中执行：

     env['account.move.line'].browse([银行行ID]).remove_move_reconcile()
     

  2. 返回对账界面重新匹配并验证。
• 预防建议
  • 验证前如已手工匹配过，需要先取消原核销。
  • 自定义脚本不要只创建 partial 而未走完整验证流程。

2. “日记账分录 XXX 在其相关对账单行达到无效状态。…必须始终有涉及银行/现金科目的日记账项目。”

• 触发原因
  • 凭证中包含 多条 asset_cash 类型的分录（例如暂记科目也配置成现金类、或被手工改成银行科目）。
  • _seek_for_lines() 找到超过一条银行行时会抛出该错误。
• 解决步骤
  1. 手工编辑凭证，将非银行的对方行修正为应收/应付/费用等非 asset_cash 科目。
  2. 保存后再尝试取消对账或重新验证。
• 预防建议
  • 对账模型、人工新增行务必选择非银行科目。
  • 暂记科目建议使用 asset_current 等非现金类型，并保持 reconcile=False。

3. 对账后仍显示“未匹配”

• 通常是暂记行未成功替换，残值仍不为零。amount_residual 仍由暂记行决定时，is_reconciled 会一直是 False。
• 请确认是否存在残留 partial、是否报错中断、或是否误将对方科目设置成银行科目。必要时使用“取消对账”恢复默认两行后重新匹配。

---

操作注意事项清单

• ✅ 仅保留 一条 银行科目行（银行日记账默认科目）。
• ✅ 暂记科目默认不勾选“可对账”，也不应属于 asset_cash。
• ✅ 验证前若发现银行行已有历史 partial，先行“取消对账”。
• ✅ 对账模型返回的科目必须是实际对方科目，切勿返回银行科目。
• ✅ 报错后务必撤销残留的 partial，避免多次验证失败。
• ❌ 不要直接在数据库或脚本中只写入 account.partial.reconcile 而未走完整流程。

---

流程图（Mermaid）

flowchart TD A[开始：列表筛选未匹配] --> B{银行行存在\nmatched_*?} B -- 否 --> C[正常选择要匹配的发票/费用行] B -- 是 --> D[取消对账\n(remove_move_reconcile)] D --> C C --> E{界面行科目选择正确？\n(非银行科目)} E -- 否 --> F[调整科目到应收/应付/费用等] F --> E E -- 是 --> G[点击验证] G --> H{报错?} H -- 是 --> I[根据错误信息处理\n(常见见上文)] I --> B H -- 否 --> J[验证成功\n凭证仅剩一条银行行] J --> K{列表仍显示未匹配?} K -- 是 --> L[检查暂记行残值/科目\n并修正] L --> B K -- 否 --> M[结束：对账完成]

---

附：常用 Shell 命令片段

# 查看某银行对账行的凭证及核销情况
st_line = env['account.bank.statement.line'].browse(64061)
for line in st_line.move_id.line_ids:
    print(line.id, line.account_id.code, line.matched_debit_ids.ids, line.matched_credit_ids.ids)

# 撤销银行行已有的 partial reconcile
env['account.move.line'].browse([411956]).remove_move_reconcile()

---

若按照上述步骤仍无法完成对账，请记录报错信息、相关凭证行 ID，并联系系统管理员或实施顾问进一步排查。祝对账顺利。