Odoo 15继承PoS的OrderReceipt.xml修改收银员显示失败求助

1. 核对QWeb继承的准确性 #

• 确认继承的模板ID完全匹配：POS原生订单收据模板的ID为PointOfSale.OrderReceipt，自定义XML的inherit_id必须精准指向该ID，示例代码：

<template id="orderReceipt_inherited" inherit_id="point_of_sale.OrderReceipt">

• 确保xpath定位正确：针对收银员名称的节点（通常是<t t-esc="cashier.name"/>），需用xpath精准匹配原结构，比如替换显示格式的写法：

<xpath expr="//t[@t-esc='cashier.name']" position="replace">
    <t t-esc="'收银员: ' + cashier.name"/>
</xpath>

若原节点存在嵌套，xpath需对应调整，避免定位失效。

2. 验证manifest文件的QWeb配置 #

• 检查qweb字段的文件路径是否与实际位置一致，示例配置：

'qweb': [
    'static/src/xml/orderReceipt_inherited.xml',
],

注意Linux环境下路径区分大小写，不要写错文件名或目录层级。

3. 清除缓存并重新加载POS #

• 后台进入设置 > 技术 > 用户界面 > 视图，搜索OrderReceipt，确认自定义继承模板已加载且状态有效。
• 点击后台右上角的刷新缓存，勾选"包括资产和静态文件"，之后完全关闭POS页面并重新开启会话。
• 本地开发环境需强制刷新浏览器缓存（Ctrl+Shift+R），避免加载旧的静态资源。

4. 检查模块依赖与加载顺序 #

• 确保自定义模块的depends字段包含point_of_sale，保证POS模块优先加载：

'depends': ['point_of_sale'],

• 进入应用模块找到自定义模块，点击"升级"，确保所有改动被应用。

5. 调试POS前端代码 #

• 打开POS页面开发者工具（F12），在Sources标签搜索OrderReceipt相关代码，确认自定义修改是否被加载。
• 若未找到自定义代码，排查manifest路径与模块安装状态；若已加载但未生效，检查xpath定位是否正确，或是否有其他模块继承该模板并覆盖了你的修改（可在视图管理中查看继承顺序）。

内容的提问来源于stack exchange，提问作者Matija Amondi