
本文深入探讨了Odoo 15企业版中送货单地址显示错误的复杂问题。当送货单PDF偶尔错误地显示客户主地址而非实际送货地址时,通常是由于QWeb报告模板中对commercial_partner_id的判断逻辑与res.partner记录类型(公司或个人)配置不符所致。文章通过详细的排查步骤、代码分析和数据模型解释,揭示了这一问题的根本原因,并提供了解决思路。
1. 问题描述
在odoo 15企业版中,部分用户反馈在打印销售订单的送货单时,生成的pdf文档有时会错误地显示客户的默认地址(通常是账单地址或主要联系地址),而不是实际指定的送货地址。这个问题具有随机性,难以复现,且常规的调试方法难以定位其根源,甚至第三方咨询机构也未能有效解决。
2. 初步排查与分析
为了解决这一问题,首先需要对Odoo的送货单报告(report_deliveryslip.xml)及其相关数据模型进行深入分析。
2.1 检查送货单报告模板
送货单报告的核心模板位于stock模块的report_deliveryslip.xml文件中。初步检查发现一个名为div_outgoing_address的代码块,它看起来负责打印地址信息:
Delivery Address:
这段代码中,t-field=”o.move_lines[0].partner_id”似乎是获取送货地址的关键。然而,经过进一步分析,发现这个div_outgoing_address实际上是用于显示发货方(即我们自己的仓库或公司)的地址,而非客户的送货地址。这是一个容易引起混淆的命名。
2.2 Odoo Shell 调试验证
为了确认销售订单和拣货单中的地址信息是否正确,我们可以在Odoo Shell中对一个出现问题的销售订单进行测试:
# 假设销售订单编号为 'S12345'In [1]: so = self.env['sale.order'].search([('name', '=', 'S12345')]) # 销售订单的客户IDIn [2]: so.partner_id Out[2]: res.partner(XXXXXX,) # 客户主地址# 销售订单的送货地址IDIn [3]: so.partner_shipping_id Out[3]: res.partner(YYYYYY,) # 期望的送货地址# 关联的拣货单In [4]: pick = self.env['stock.picking'].search([('origin', '=', so.name)]) # 拣货单的关联伙伴IDIn [5]: pick.partner_id Out[5]: res.partner(YYYYYY,) # 期望的送货地址# 拣货单移动行的伙伴ID (通常是实际送货地址)In [6]: pick.move_lines[0].partner_id Out[6]: res.partner(YYYYYY,) # 期望的送货地址# 打印该伙伴的地址,确认其显示正确In [7]: print(pick.move_lines[0].partner_id._display_address()) Correct Contact Name123 Correct StreetUnit 456New York NY 01234United States # 显示为正确的送货地址# 检查是否应该打印送货地址In [8]: pick.should_print_delivery_address() Out[8]: True
从Odoo Shell的测试结果可以看出,so.partner_shipping_id、pick.partner_id和pick.move_lines[0].partner_id都正确地指向了预期的送货地址(YYYYYY)。这表明数据本身是正确的,问题可能出在QWeb报告的渲染逻辑上。即使手动调用_render_qweb_html等方法,生成的PDF依然显示错误的客户地址,进一步印证了这一点。
3. 根源定位:深入理解QWeb模板逻辑
经过进一步的模板分析,我们发现真正负责渲染客户地址的XML片段位于information_block中,特别是div_incoming_address:
Customer Address:
关键在于这一行:
当拣货单类型为“outgoing”且partner存在时,如果partner与partner.commercial_partner_id不相等,则会显示“Customer Address”,并且更重要的是,它会打印partner.commercial_partner_id的地址,而不是partner本身的地址。
这意味着,如果我们的送货地址partner(即pick.move_lines[0].partner_id)与它的商业伙伴ID不一致,报告就会显示商业伙伴的地址。
4. commercial_partner_id 字段解析
为了理解partner != partner.commercial_partner_id为何会为真,我们需要查看res.partner模型中commercial_partner_id字段的定义和计算方法。
4.1 字段定义
commercial_partner_id = fields.Many2one('res.partner', string='Commercial Entity', compute='_compute_commercial_partner', recursive=True, store=True, index=True)commercial_partner_id是一个Many2one字段,指向res.partner自身,用于表示该联系人的“商业实体”。
4.2 计算方法 _compute_commercial_partner
@api.depends('is_company', 'parent_id.commercial_partner_id')def _compute_commercial_partner(self): for partner in self: if partner.is_company or not partner.parent_id: partner.commercial_partner_id = partner else: partner.commercial_partner_id = partner.parent_id.commercial_partner_id这个计算方法逻辑如下:
如果联系人是“公司”类型(is_company为True),或者它没有父级联系人(parent_id为False),那么它本身就是商业实体,commercial_partner_id就指向自己。否则(即联系人是“个人”类型且有父级),它的commercial_partner_id会继承自其父级联系人的commercial_partner_id。
5. 最终发现与结论
结合QWeb模板的逻辑和commercial_partner_id的计算规则,问题的原因浮出水面:
对于那些送货单地址显示错误的销售订单,其对应的送货地址res.partner记录(即pick.move_lines[0].partner_id)被配置为“个人”类型(is_company为False),并且该“个人”记录设置了父级联系人,而这个父级联系人通常就是客户的“公司”主记录。
在这种情况下:
送货地址partner(“个人”类型,有父级)的commercial_partner_id会指向其父级(“公司”类型)的commercial_partner_id,也就是父级公司本身。因此,partner != partner.commercial_partner_id这个条件会评估为True。QWeb模板就会渲染partner.commercial_partner_id的地址,而这个地址正是客户的“公司”主地址,而非实际的“个人”送货地址。
简而言之,当送货地址的联系人被设置为“个人”类型,且隶属于一个父级公司时,Odoo的默认送货单模板会错误地显示该父级公司的地址。
6. 潜在解决方案与注意事项
理解了问题的根源,我们可以考虑以下几种解决方案:
6.1 修改QWeb报告模板(推荐)
这是最直接且风险最低的解决方案。我们可以继承并修改report_deliveryslip.xml模板中的相关逻辑。
方案一:调整条件判断修改div_incoming_address中判断是否显示“Customer Address”的条件,使其更精确地识别送货地址。例如,可以添加一个额外的条件,检查partner是否是o.partner_shipping_id或o.move_lines[0].partner_id,并优先显示其地址。
Delivery Address:Customer Address:这个示例只是一个思路,具体实现需要根据业务需求和模板结构进行精细调整。目标是确保当存在明确的送货地址时,优先显示该地址,而不是回退到commercial_partner_id。
方案二:引入自定义字段如果业务逻辑复杂,可以考虑在stock.picking或res.partner模型上添加一个自定义字段,明确标记某个联系人是否应该作为最终的送货地址,并在QWeb模板中根据这个字段进行判断。
6.2 调整res.partner数据配置(需谨慎)
修改送货地址记录类型将作为送货地址的res.partner记录的is_company字段设置为True,并移除其parent_id。这样,这些送货地址记录本身就会被视为“公司”,其commercial_partner_id将指向自身,从而满足partner == partner.commercial_partner_id的条件。注意事项: 这种做法可能会破坏原有的联系人层级结构,影响CRM或其他模块的逻辑,需要仔细评估其副作用。
修改父公司地址直接修改父级公司记录的地址。但这并非解决送货地址显示错误的根本方法,因为送货地址和公司主地址可能需要保持不同。
6.3 确保数据一致性
定期审查和清理res.partner数据,确保送货地址的设置符合预期。例如,如果一个送货地址是公司的分支机构,可以将其设置为“公司”类型;如果是公司内部的一个特定收货人,则可以考虑将其作为主公司的子联系人,但要确保报告模板能正确处理。
总结
解决Odoo 15送货单地址显示错误的问题,关键在于深入理解Odoo的QWeb报告渲染机制以及res.partner模型中commercial_partner_id字段的计算逻辑。当送货地址被配置为带有父级公司的“个人”类型联系人时,默认模板会错误地显示其父级公司的地址。通过调整QWeb报告模板,我们可以精确控制地址的显示逻辑,确保送货单始终显示正确的送货地址,从而避免业务流程中的混淆和错误。在进行任何修改之前,务必在测试环境中充分验证,以避免引入新的问题。
以上就是Odoo 15 送货单地址显示错误排查与解决方案的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1373621.html
微信扫一扫
支付宝扫一扫