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

碧海醫心
发布: 2025-09-25 10:41:31
原创
615人浏览过

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的代码块,它看起来负责打印地址信息:

<?xml version="1.0" encoding="UTF-8" ?>
<odoo>
    <template id="report_delivery_document">
        <t t-call="web.html_container">
            <t t-call="web.external_layout">
                <t t-set="o" t-value="o.with_context(lang=o._get_report_lang())" />
                <t t-set="partner" t-value="o.partner_id or (o.move_lines and o.move_lines[0].partner_id) or False"/>

                <t t-set="address">
                    <div name="div_outgoing_address">
                        <div t-if="o.should_print_delivery_address()">
                            <span><strong>Delivery Address:</strong></span>
                            <div t-field="o.move_lines[0].partner_id"
                                t-options='{"widget": "contact", "fields": ["address", "name", "phone"], "no_marker": True, "phone_icons": True}'/>
                        </div>
                        <!-- ... 其它地址逻辑 ... -->
                    </div>
                </t>
                <!-- ... 其它报告内容 ... -->
            </t>
        </t>
    </template>
</odoo>
登录后复制

这段代码中,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:

<t t-set="information_block">
    <div class="row">
        <div class="col-7" name="div_incoming_address">
            <t t-set="show_partner" t-value="False" />
            <!-- ... 其他条件 ... -->
            <div t-if="o.picking_type_id.code=='outgoing' and partner and partner != partner.commercial_partner_id">
                <span><strong>Customer Address:</strong></span>
                <t t-set="show_partner" t-value="True" />
            </div>
            <div t-if="show_partner" name="partner_header">
                <div t-field="partner.commercial_partner_id"
                    t-options='{"widget": "contact", "fields": ["address", "name", "phone"], "no_marker": True, "phone_icons": True}'/>
                <!-- ... 其他信息 ... -->
            </div>
        </div>
    </div>
</t>
登录后复制

关键在于这一行:

<div t-if="o.picking_type_id.code=='outgoing' and partner and partner != partner.commercial_partner_id">
登录后复制

当拣货单类型为“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自身,用于表示该联系人的“商业实体”。

挖错网
挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

挖错网 28
查看详情 挖错网

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,并优先显示其地址。

    <!-- 示例:在原有逻辑前添加一个优先显示送货地址的逻辑 -->
    <div t-if="o.picking_type_id.code=='outgoing' and o.should_print_delivery_address() and o.move_lines[0].partner_id">
        <span><strong>Delivery Address:</strong></span>
        <div t-field="o.move_lines[0].partner_id"
            t-options='{"widget": "contact", "fields": ["address", "name", "phone"], "no_marker": True, "phone_icons": True}'/>
    </div>
    <div t-elif="o.picking_type_id.code=='outgoing' and partner and partner != partner.commercial_partner_id">
        <span><strong>Customer Address:</strong></span>
        <t t-set="show_partner" t-value="True" />
    </div>
    <!-- ... 原有逻辑继续 ... -->
    登录后复制

    这个示例只是一个思路,具体实现需要根据业务需求和模板结构进行精细调整。目标是确保当存在明确的送货地址时,优先显示该地址,而不是回退到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 送货单地址显示错误排查与解决方案的详细内容,更多请关注php中文网其它相关文章!

相关标签:
最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

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