0

0

Odoo 15 送货单地址显示错误排查与解决方案

碧海醫心

碧海醫心

发布时间:2025-09-25 10:41:31

|

628人浏览过

|

来源于php中文网

原创

Odoo 15 送货单地址显示错误排查与解决方案

本文深入探讨了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的代码块,它看起来负责打印地址信息:



    

这段代码中,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')])           

# 销售订单的客户ID
In [2]: so.partner_id                                                           
Out[2]: res.partner(XXXXXX,) # 客户主地址

# 销售订单的送货地址ID
In [3]: so.partner_shipping_id                                                  
Out[3]: res.partner(YYYYYY,) # 期望的送货地址

# 关联的拣货单
In [4]: pick = self.env['stock.picking'].search([('origin', '=', so.name)])     

# 拣货单的关联伙伴ID
In [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 Name
123 Correct Street
Unit 456
New York NY 01234
United 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),并且该“个人”记录设置了父级联系人,而这个父级联系人通常就是客户的“公司”主记录。

在这种情况下:

  1. 送货地址partner(“个人”类型,有父级)的commercial_partner_id会指向其父级(“公司”类型)的commercial_partner_id,也就是父级公司本身。
  2. 因此,partner != partner.commercial_partner_id这个条件会评估为True。
  3. 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报告模板,我们可以精确控制地址的显示逻辑,确保送货单始终显示正确的送货地址,从而避免业务流程中的混淆和错误。在进行任何修改之前,务必在测试环境中充分验证,以避免引入新的问题。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1897

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2091

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1052

2024.11.28

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

0

2026.01.27

拼多多赚钱的5种方法 拼多多赚钱的5种方法
拼多多赚钱的5种方法 拼多多赚钱的5种方法

在拼多多上赚钱主要可以通过无货源模式一件代发、精细化运营特色店铺、参与官方高流量活动、利用拼团机制社交裂变,以及成为多多进宝推广员这5种方法实现。核心策略在于通过低成本、高效率的供应链管理与营销,利用平台社交电商红利实现盈利。

98

2026.01.26

edge浏览器怎样设置主页 edge浏览器自定义设置教程
edge浏览器怎样设置主页 edge浏览器自定义设置教程

在Edge浏览器中设置主页,请依次点击右上角“...”图标 > 设置 > 开始、主页和新建标签页。在“Microsoft Edge 启动时”选择“打开以下页面”,点击“添加新页面”并输入网址。若要使用主页按钮,需在“外观”设置中开启“显示主页按钮”并设定网址。

12

2026.01.26

苹果官方查询网站 苹果手机正品激活查询入口
苹果官方查询网站 苹果手机正品激活查询入口

苹果官方查询网站主要通过 checkcoverage.apple.com/cn/zh/ 进行,可用于查询序列号(SN)对应的保修状态、激活日期及技术支持服务。此外,查找丢失设备请使用 iCloud.com/find,购买信息与物流可访问 Apple (中国大陆) 订单状态页面。

76

2026.01.26

npd人格什么意思 npd人格有什么特征
npd人格什么意思 npd人格有什么特征

NPD(Narcissistic Personality Disorder)即自恋型人格障碍,是一种心理健康问题,特点是极度夸大自我重要性、需要过度赞美与关注,同时极度缺乏共情能力,背后常掩藏着低自尊和不安全感,影响人际关系、工作和生活,通常在青少年时期开始显现,需由专业人士诊断。

5

2026.01.26

windows安全中心怎么关闭 windows安全中心怎么执行操作
windows安全中心怎么关闭 windows安全中心怎么执行操作

关闭Windows安全中心(Windows Defender)可通过系统设置暂时关闭,或使用组策略/注册表永久关闭。最简单的方法是:进入设置 > 隐私和安全性 > Windows安全中心 > 病毒和威胁防护 > 管理设置,将实时保护等选项关闭。

6

2026.01.26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

AngularJS教程
AngularJS教程

共24课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 24.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号