Odoo 15 送货单地址显示错误：深入解析与解决方案

Odoo送货单地址显示异常问题解析

在Odoo 15企业版中，用户可能会遇到一个令人困扰的问题：为销售订单打印送货单时，生成的PDF有时会错误地显示客户的主地址（Customer Address），而非实际指定的送货地址（Delivery Address）。这种现象看似随机发生，给业务运营带来了不便。本教程将详细解析这一问题的根源，并提供调试思路。

1. Odoo送货单报表结构概述

Odoo的送货单（Delivery Slip）通常由stock模块中的report_deliveryslip.xml报表模板生成。理解此模板的结构是解决问题的关键。该模板包含多个标签块，用于定义报表的不同部分。

起初，许多用户可能会关注以下代码段，认为它是控制送货地址显示的部分：

    

        

            Delivery Address:
            

        
        

            Warehouse Address:
            

        
    

然而，这个块实际上定义的是“发货方地址”（Outgoing Address），即货物从哪个仓库或设施发出的地址。它与客户的收货地址无关。

2. 识别客户地址的正确XML段落

真正控制客户收货地址显示的是报表中的另一个标签块，通常名为information_block，其中包含一个div_incoming_address：

    

        

            
            

                Vendor Address:
                
            
            

                Customer Address:
                
            
            

                

                
: 
            
        
    

请注意其中的关键条件判断行：

这个条件判断决定了何时显示“Customer Address”标签。当o.picking_type_id.code为'outgoing'（出库单）且partner存在，并且partner不等于partner.commercial_partner_id时，才会显示此块。更重要的是，它显示的是partner.commercial_partner_id的地址，而不是partner本身的地址。

3. 理解 commercial_partner_id 字段

要彻底理解上述条件，我们需要深入了解Odoo中res.partner模型上的commercial_partner_id字段。

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

从计算方法中我们可以看出：

• 如果一个联系人（partner）被标记为“公司”（is_company为True），或者它没有父级联系人（parent_id为False），那么它的commercial_partner_id就是它自身。
• 否则（即它是一个“个人”类型，并且有一个父级联系人），它的commercial_partner_id将是其父级联系人的commercial_partner_id。

简而言之，commercial_partner_id代表了联系人层级结构中最顶层的“商业实体”或“公司”。

4. 问题根源：合作伙伴类型与层级结构

结合以上分析，送货单地址显示错误的根本原因浮出水面： 当一个送货地址的res.partner记录被创建为“个人”类型，并且它被关联到一个“公司”类型的父级联系人时，就会出现问题。

在这种情况下：

Khroma

AI调色盘生成工具

下载

1. 送货地址的res.partner记录（我们称之为delivery_partner）的is_company为False，且parent_id不为空。
2. 根据_compute_commercial_partner方法，delivery_partner.commercial_partner_id将指向其父级公司的commercial_partner_id（最终就是父级公司本身）。
3. 因此，delivery_partner != delivery_partner.commercial_partner_id 这个条件将为True。
4. Odoo的送货单模板会执行条件为True的代码块，并显示partner.commercial_partner_id的地址，这实际上是父级公司的地址，而不是实际的送货地址。

5. 调试方法与Odoo Shell实践

要验证上述推断，可以使用Odoo Shell进行调试：

1. 查找相关销售订单和调拨单：

   so = self.env['sale.order'].search([('name', '=', 'S12345')]) # 替换为你的销售订单号
   pick = self.env['stock.picking'].search([('origin', '=', so.name)])

2. 检查关键合作伙伴信息：

   print(f"销售订单客户: {so.partner_id.display_name}")
   print(f"销售订单送货伙伴: {so.partner_shipping_id.display_name}")
   print(f"调拨单伙伴: {pick.partner_id.display_name}")
   delivery_partner = pick.move_lines[0].partner_id
   print(f"调拨单移动行伙伴 (实际送货伙伴): {delivery_partner.display_name}")

   通常，pick.partner_id和pick.move_lines[0].partner_id应该指向正确的送货地址。

3. 检查 commercial_partner_id 及其与 delivery_partner 的关系：

   print(f"送货伙伴是否为公司: {delivery_partner.is_company}")
   print(f"送货伙伴的父级: {delivery_partner.parent_id.display_name if delivery_partner.parent_id else '无'}")
   print(f"送货伙伴的商业实体: {delivery_partner.commercial_partner_id.display_name}")
   print(f"送货伙伴 == 商业实体? {delivery_partner == delivery_partner.commercial_partner_id}")

如果delivery_partner == delivery_partner.commercial_partner_id返回False，那么就证实了问题所在。这意味着Odoo将尝试显示delivery_partner.commercial_partner_id的地址，而不是delivery_partner自身的地址。

6. 解决方案与注意事项

目前，对于此问题的解决方案需要根据具体的业务场景进行权衡：

• 修改送货地址的合作伙伴类型： 将受影响的送货地址res.partner记录的is_company字段设置为True。这将使其commercial_partner_id指向自身，从而满足partner == partner.commercial_partner_id的条件。

  • 注意事项： 这种做法可能会打破现有的联系人层级结构，如果这些地址在其他地方被视为某个公司的下属联系人，可能会引入新的问题。

• 修改报表模板： 这是一个更具侵入性但可能更灵活的解决方案。您可以继承report_deliveryslip.xml模板，并修改相关的条件判断或直接显示partner的地址，而不是partner.commercial_partner_id的地址。例如，您可以将：

  
      Customer Address:
      
  
  

  修改为：

  
      Delivery Address:
      
   
  

  • 注意事项： 修改Odoo核心报表模板需要专业的Odoo开发知识，并确保在升级Odoo版本时兼容性。

• 调整数据录入流程： 审查送货地址的创建和管理流程，确保送货地址的res.partner记录被正确地配置为“公司”类型（如果它们在逻辑上代表一个独立的收货实体）或在层级结构中以其他方式避免触发上述条件。

总结

Odoo 15送货单地址显示错误的问题，其核心在于res.partner模型的commercial_partner_id字段的计算逻辑与送货单报表模板的条件判断相结合。当送货地址的合作伙伴被配置为具有父级的“个人”类型时，Odoo会错误地显示其父级公司的地址。通过理解commercial_partner_id的机制和送货单XML模板的结构，用户可以有效地诊断并选择合适的解决方案，以确保送货单上始终显示正确的收货地址。在实施任何更改之前，务必在测试环境中充分验证，以避免引入新的业务问题。