Odoo送货单地址显示异常问题解析
在Odoo 15企业版中，用户可能会遇到一个令人困扰的问题：为销售订单打印送货单时，生成的PDF有时会错误地显示客户的主地址（Customer Address），而非实际指定的送货地址（Delivery Address）。这种现象看似随机发生，给业务运营带来了不便。本教程将详细解析这一问题的根源，并提供调试思路。
1. Odoo送货单报表结构概述
Odoo的送货单（Delivery Slip）通常由stock模块中的report_deliveryslip.xml报表模板生成。理解此模板的结构是解决问题的关键。该模板包含多个<t>标签块，用于定义报表的不同部分。
起初，许多用户可能会关注以下代码段，认为它是控制送货地址显示的部分：
<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-elif="o.picking_type_id.code != 'internal' and o.picking_type_id.warehouse_id.partner_id">
<span><strong>Warehouse Address:</strong></span>
<div t-field="o.picking_type_id.warehouse_id.partner_id"
t-options='{"widget": "contact", "fields": ["address", "name", "phone"], "no_marker": True, "phone_icons": True}'/>
</div>
</div>
</t>然而，这个<t t-set="address">块实际上定义的是“发货方地址”（Outgoing Address），即货物从哪个仓库或设施发出的地址。它与客户的收货地址无关。
2. 识别客户地址的正确XML段落
真正控制客户收货地址显示的是报表中的另一个<t>标签块，通常名为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=='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">
这个条件判断决定了何时显示“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记录被创建为“个人”类型，并且它被关联到一个“公司”类型的父级联系人时，就会出现问题。
在这种情况下：
- 送货地址的res.partner记录（我们称之为delivery_partner）的is_company为False，且parent_id不为空。
- 根据_compute_commercial_partner方法，delivery_partner.commercial_partner_id将指向其父级公司的commercial_partner_id（最终就是父级公司本身）。
- 因此，delivery_partner != delivery_partner.commercial_partner_id 这个条件将为True。
- Odoo的送货单模板会执行条件为True的代码块，并显示partner.commercial_partner_id的地址，这实际上是父级公司的地址，而不是实际的送货地址。
5. 调试方法与Odoo Shell实践
要验证上述推断，可以使用Odoo Shell进行调试：
-
查找相关销售订单和调拨单：
so = self.env['sale.order'].search([('name', '=', 'S12345')]) # 替换为你的销售订单号 pick = self.env['stock.picking'].search([('origin', '=', so.name)]) -
检查关键合作伙伴信息：
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应该指向正确的送货地址。
-
检查 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的地址。例如，您可以将：
<div t-if="o.picking_type_id.code=='outgoing' and partner and partner != partner.commercial_partner_id"> <span><strong>Customer Address:</strong></span> <div t-field="partner.commercial_partner_id" .../> </div>修改为：
<div t-if="o.picking_type_id.code=='outgoing' and partner"> <span><strong>Delivery Address:</strong></span> <div t-field="partner" .../> <!-- 直接使用 partner 字段 --> </div>- 注意事项： 修改Odoo核心报表模板需要专业的Odoo开发知识，并确保在升级Odoo版本时兼容性。
调整数据录入流程： 审查送货地址的创建和管理流程，确保送货地址的res.partner记录被正确地配置为“公司”类型（如果它们在逻辑上代表一个独立的收货实体）或在层级结构中以其他方式避免触发上述条件。
总结
Odoo 15送货单地址显示错误的问题，其核心在于res.partner模型的commercial_partner_id字段的计算逻辑与送货单报表模板的条件判断相结合。当送货地址的合作伙伴被配置为具有父级的“个人”类型时，Odoo会错误地显示其父级公司的地址。通过理解commercial_partner_id的机制和送货单XML模板的结构，用户可以有效地诊断并选择合适的解决方案，以确保送货单上始终显示正确的收货地址。在实施任何更改之前，务必在测试环境中充分验证，以避免引入新的业务问题。
