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）：在对账小部件中点击“验证/确认”按钮后，系统会重写对应凭证行，将暂记科目替换为实际科目并完成核销。
标准对账流程
[*]定位待处理的银行对账行
[*]列表视图中筛选“未匹配（Not matched）”。
[*]在开发者模式下，可查看 is_reconciled 字段确认真实状态。
[*]检查是否存在历史核销
[*]若银行凭证行 matched_debit_ids / matched_credit_ids 有值，说明之前已经建立过部分核销。
[*]可以在对账界面点右上角“调试操作 ▸ 取消对账”，或在凭证表单页签勾选该行后选择“操作 ▸ 取消匹配”；如界面无此按钮，可在 shell 中执行 remove_move_reconcile()。务必在重新验证前清理残留核销。
[*]在对账小部件中选择要匹配的单据
[*]只选择应收/应付、费用、收入等非银行科目的分录。
[*]如需调整金额或科目，可在界面中修改新增行的 account_id，务必避免再次选择银行科目。
[*]验证
[*]点击“验证”后，系统会：
[*]先创建/更新 partial reconcile（银行行与选中单据挂钩）。
[*]清空原凭证行 并按照界面行重建。
[*]确保仅保留 一 条银行科目行，其余行改为真正的对方科目。
[*]执行 _reconcile_plan 完成核销，is_reconciled 变为 True。
[*]验证结果
[*]列表刷新后，该对账行将从“未匹配”过滤器中消失。
[*]若仍在“未匹配”，说明暂记行未被替换或残值未归零，需要检查错误处理部分。
暂记科目替换逻辑
[*]用户在小部件中确认行内容
[*]第一行始终是银行科目（flag='liquidity'），系统会保留。
[*]其余行由用户选择的发票/费用等分录或手工新增行组成（flag='new_aml'、flag='manual' 等）。
[*]这些行的 account_id 决定了替换暂记科目后要使用的真实科目。
[*]验证时重写凭证
[*]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': + line_ids_create_command_list,
})
[*]Command.clear() 先删除原来的两条默认行（银行 + 暂记）。
[*]随后的 Command.create 会逐条创建新行：第一条仍为银行科目，其余行的 account_id 承袭界面设置，相当于直接把“暂记科目”替换掉。
[*]替换成功的前提
[*]满足只有一条行使用银行科目；其它行必须是非 asset_cash 科目（如应收、应付、费用）。
[*]如果用户在界面上把第二行又选成了银行科目，写回后仍会得到两条银行行，导致 _seek_for_lines() 判定无效，后续取消或再对账都会失败。
[*]如何确认替换结果
[*]验证后打开凭证，检查非银行行的 account_id 是否正确。
[*]确认 journal_entry.line_ids 中只有一条科目属于 asset_cash 且等于日记账默认银行科目。
[*]替换失败的常见场景
[*]验证阶段报错（例如 _check_reconciliation()），导致暂记行未被删除，却已创建 partial reconcile，需先取消核销再重试。
[*]自定义对账模型返回了银行科目，或脚本在写入时覆盖了本应替换的科目。
掌握这一机制后，只要确保在验证前界面上的“新分录”行科目正确，系统就会自动将暂记科目替换为真实科目。若需重新指定，可在对账窗口直接编辑该行的科目字段，再执行验证。
常见错误与处理
1. “You cannot do this modification on a reconciled journal entry.”
[*]触发原因
[*]在验证阶段需要修改银行行的字段（account_id、balance 等），但该行已存在 matched_debit_ids/matched_credit_ids。
[*]解决步骤
[*]在凭证界面或 shell 中执行：env['account.move.line'].browse([银行行ID]).remove_move_reconcile()
[*]返回对账界面重新匹配并验证。
[*]预防建议
[*]验证前如已手工匹配过，需要先取消原核销。
[*]自定义脚本不要只创建 partial 而未走完整验证流程。
2. “日记账分录 XXX 在其相关对账单行达到无效状态。…必须始终有涉及银行/现金科目的日记账项目。”
[*]触发原因
[*]凭证中包含 多条 asset_cash 类型的分录（例如暂记科目也配置成现金类、或被手工改成银行科目）。
[*]_seek_for_lines() 找到超过一条银行行时会抛出该错误。
[*]解决步骤
[*]手工编辑凭证，将非银行的对方行修正为应收/应付/费用等非 asset_cash 科目。
[*]保存后再尝试取消对账或重新验证。
[*]预防建议
[*]对账模型、人工新增行务必选择非银行科目。
[*]暂记科目建议使用 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().remove_move_reconcile()若按照上述步骤仍无法完成对账，请记录报错信息、相关凭证行 ID，并联系系统管理员或实施顾问进一步排查。祝对账顺利。
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！ 用心讨论，共获提升！ 前排留名，哈哈哈 感谢分享
页:
[1]