Odoo 15 配送单地址显示错误的根源与排查指南-Python教程-PHP中文网

Odoo 15 配送单地址显示错误的根源与排查指南

本文深入探讨Odoo 15配送单错误显示客户地址而非实际送货地址的问题。通过分析报告模板report_deliveryslip.xml和res.partner模型的commercial_partner_id字段计算逻辑，揭示了根源在于送货地址伙伴记录的类型及其父子关系。文章提供了详细的排查步骤和代码示例，旨在帮助用户理解并解决此类地址显示异常。

1. 问题描述

在odoo 15企业版中，部分用户反映在打印销售订单的配送单时，生成的pdf文件会随机显示客户主地址（customer address）而非实际的送货地址（delivery address）。这一问题具有间歇性，且难以找到明确的共同点，给发货流程带来了困扰。

2. 初步排查与常见误区

当遇到配送单地址错误时，首先会检查负责生成配送单的XML报告文件。Odoo中配送单的报告模板位于stock模块的report_deliveryslip.xml。

报告模板片段（report_deliveryslip.xml）：

<?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>
</odoo>

登录后复制

这段XML代码中的<t t-set="address">块及其内部的div_outgoing_address通常被认为是用于显示送货地址。然而，这部分代码实际上负责显示发货方（即仓库或公司自身）的地址，而非客户的收货地址。这是排查时一个常见的误区。

为了验证Odoo系统内部数据是否正确，可以通过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,) # 实际送货地址伙伴

# 关联发货单的伙伴ID
In [4]: pick = self.env['stock.picking'].search([('origin', '=', so.name)])     
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系统内部的partner_shipping_id和发货单的partner_id都指向了正确的送货地址伙伴记录。这表明数据本身是正确的，问题出在报告渲染逻辑上。

3. 定位核心问题区域

经过深入分析，问题最终被定位在report_deliveryslip.xml中另一个关键的t-set块：information_block。这个块负责渲染客户或供应商的地址信息。

报告模板片段（report_deliveryslip.xml）：

<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=='incoming' and partner">
                <span><strong>Vendor Address:</strong></span>
                <t t-set="show_partner" t-value="True" />
            </div>
            <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}'/>
                <p t-if="partner.sudo().commercial_partner_id.vat"><t t-esc="o.company_id.country_id.vat_label or 'Tax ID'"/>: <span t-field="partner.sudo().commercial_partner_id.vat"/></p>
            </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时，Odoo会显示“Customer Address”，并使用partner.commercial_partner_id来渲染地址信息。

4. 深入理解 commercial_partner_id

commercial_partner_id是Odoo res.partner模型中的一个重要字段，它代表了业务伙伴的“商业实体”或“主公司”。这个字段的计算逻辑决定了在上述条件下会显示哪个地址。

commercial_partner_id 字段定义：

commercial_partner_id = fields.Many2one('res.partner', string='Commercial Entity',
                                        compute='_compute_commercial_partner', recursive=True,
                                        store=True, index=True)

登录后复制

_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

登录后复制

该计算方法的逻辑如下：

挖错网

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

查看详情

如果一个伙伴记录被标记为“公司”（is_company为True），或者它没有父级伙伴（parent_id为False），那么它自己的commercial_partner_id就是它自身。
否则（即它是一个非公司的个体，并且有父级伙伴），它的commercial_partner_id将是其父级伙伴的commercial_partner_id。

5. 根本原因分析

结合上述信息，配送单地址错误的根本原因在于：

当送货地址对应的res.partner记录被设置为“个体”（而非“公司”）类型，并且它拥有一个父级伙伴（通常是主公司）时，partner != partner.commercial_partner_id这个条件就会成立。

具体来说：

partner变量此时指向的是实际的送货地址伙伴（类型为“个体”）。
由于该伙伴是“个体”且有parent_id，根据_compute_commercial_partner的逻辑，partner.commercial_partner_id会指向其父级伙伴的commercial_partner_id（最终通常是父级主公司本身）。
因此，partner（个体送货地址）与partner.commercial_partner_id（父级主公司）不相等，条件partner != partner.commercial_partner_id为True。
Odoo报告模板随后会打印partner.commercial_partner_id的地址，这实际上是客户的主公司地址，而非实际的送货地址。

Odoo Shell 验证 commercial_partner_id 行为：

In [1]: partner_delivery = self.env['res.partner'].search([('id', '=', YYYYYY)]) # YYYYYY是送货地址伙伴ID

In [2]: partner_delivery.is_company
Out[2]: False # 送货地址伙伴是“个体”

In [3]: partner_delivery.parent_id
Out[3]: res.partner(XXXXXX,) # 送货地址伙伴有父级（主公司）

In [4]: partner_delivery.commercial_partner_id
Out[4]: res.partner(XXXXXX,) # 其商业伙伴ID指向父级主公司

In [5]: partner_delivery == partner_delivery.commercial_partner_id
Out[5]: False # 验证了条件为False，导致报告使用commercial_partner_id

登录后复制

6. 解决方案与注意事项

由于这个问题的根源在于Odoo的伙伴（res.partner）模型设计及其commercial_partner_id的计算逻辑，以及报告模板对该字段的使用，解决起来需要权衡。

潜在的解决方案方向：

修改伙伴数据结构（需谨慎）：
- 将作为送货地址的res.partner记录类型改为“公司”，但这可能会破坏现有的联系人层级结构，并可能对其他模块产生未知影响。
- 修改父级公司记录的地址，但这显然不合理，因为它会影响所有关联的地址。

定制报告模板（推荐）：

这是最直接且风险较低的解决方案。可以继承stock.report_delivery_document模板，并修改information_block部分，使其在特定条件下直接使用partner（即o.move_lines[0].partner_id）来显示送货地址，而不是partner.commercial_partner_id。
例如，可以添加一个更精细的条件判断，或者在满足特定业务需求时，直接覆盖该部分的渲染逻辑。

示例（修改思路，非完整代码）：

<xpath expr="//div[@name='div_incoming_address']//div[hasclass('partner_header')]" position="replace">
    <div t-if="show_partner" name="partner_header">
        <!-- 根据业务逻辑判断是显示 partner 还是 partner.commercial_partner_id -->
        <t t-if="o.picking_type_id.code=='outgoing' and partner and partner.is_delivery_address"> <!-- 假设有一个is_delivery_address字段或通过其他方式判断 -->
            <div t-field="partner"
                t-options='{"widget": "contact", "fields": ["address", "name", "phone"], "no_marker": True, "phone_icons": True}'/>
            <p t-if="partner.sudo().vat"><t t-esc="o.company_id.country_id.vat_label or 'Tax ID'"/>: <span t-field="partner.sudo().vat"/></p>
        </t>
        <t t-else="">
            <div t-field="partner.commercial_partner_id"
                t-options='{"widget": "contact", "fields": ["address", "name", "phone"], "no_marker": True, "phone_icons": True}'/>
            <p t-if="partner.sudo().commercial_partner_id.vat"><t t-esc="o.company_id.country_id.vat_label or 'Tax ID'"/>: <span t-field="partner.sudo().commercial_partner_id.vat"/></p>
        </t>
    </div>
</xpath>

登录后复制

在上述示例中，partner.is_delivery_address是一个假设的自定义字段或判断逻辑，用于区分是否是需要显示具体送货地址的伙伴。你需要根据实际业务场景定义这个判断条件。

修改_compute_commercial_partner方法（不推荐）：
- 虽然技术上可行，但修改Odoo核心模型的计算方法风险极高，可能影响系统其他部分，导致不可预测的副作用。通常不建议采取此方案。

注意事项：

在进行任何修改前，务必在开发或测试环境中充分验证。
理解Odoo res.partner模型中“公司”、“个体”、“父子关系”以及commercial_partner_id的含义至关重要。
定制报告时，应遵循Odoo的继承机制，避免直接修改核心模块文件，以确保未来升级的兼容性。

通过对Odoo res.partner模型及其报告渲染逻辑的深入理解，可以准确诊断并解决配送单地址显示错误的问题。选择合适的解决方案，既能满足业务需求，又能保证系统的稳定性和可维护性。

以上就是Odoo 15 配送单地址显示错误的根源与排查指南的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

Scrapy CSS选择器失效：深入理解浏览器与爬虫获取HTML内容的差异使用Python通过IMAPlib在Gmail中创建HTML邮件草稿 Python爬虫怎样解析HTML_Python爬虫解析HTML数据的常用方法高效解析HTML：按类型分组提取段落与表格内容 HTML内容解析：如何高效分离与整合P标签与Table标签