PDF 报价构建器
Odoo 销售 应用中的 PDF 报价构建器 提供了向客户发送完全自定义的 PDF 报价文件的机会，可展示公司和产品的各种信息与设计元素，而不仅仅是价格和总计。
PDF 报价构建器将页眉、产品描述、价格以及页脚组合成详细的报价。它还能在 PDF 中注入动态文本或自定义备注，以实现对客户的个性化报价。
使用自定义 PDF 报价可以为客户的购物体验提供更高层次的结束感，并为公司增添专业与优雅的形象。
::: seealso
Odoo 快速技巧 – 创建 PDF 报价 [视频]
:::
:::: note
::: title
注意
:::
建议使用 Adobe 软件编辑 PDF 表单。页眉和页脚模板中的表单字段是获取 Odoo 动态值的必要条件。
::::
配置
要为报价添加自定义 PDF 文件，必须先 配置 PDF 报价构建器 功能。
操作路径：销售应用 --> 配置 --> 设置，滚动至 报价 & 订单 部分，勾选 PDF 报价构建器 复选框后点击 保存。
启用后，会在其下方出现一个 oi-arrow-right（右箭头）图标，用于 页眉/页脚。
添加 PDF 作为页眉/页脚
:::: important
::: title
重要
:::
Odoo 不允许 PDF 表单字段名称包含空格。只能使用字母、数字、连字符或下划线。
::::
在 Odoo 销售 应用中，可以添加自定义 PDF 作为页眉或页脚。激活报价中的 PDF 报价构建器后，可选择多个页眉和页脚，它们会被插入到最终的 PDF 中。
添加步骤
- 前往
销售应用 --> 配置。点击oi-arrow-right（右箭头）图标进入 页眉/页脚，默认以看板视图展示所有可用模板。 - 点击 新建 或 上传。选择 上传 可立即弹出文件选择框，上传所需文档。
- 上传后，可在文档卡片上进一步配置，或点击卡片右上角的
fa-ellipsis-v（垂直省略号）图标后选择 编辑。
新建空白文档
点击 新建 会出现空白的文档表单，可通过 上传你的文件 按钮在 文件内容 字段上传 PDF。随后可以设置以下信息：
- 名称：上传后自动填充 PDF 文件名，可自行编辑。
- 文档类型：下拉选择
页眉或页脚，决定文件在报价的开头或结尾出现。 - 报价模板：可限定仅在特定报价模板中使用此 PDF。
:::: note
::: title
注意
:::
也可以直接在 销售应用 --> 配置 --> 报价模板 中，选中模板后在 报价构建器 选项卡里 添加 或 上传 PDF。
::::
在 文件内容 字段旁，还提供 配置动态字段 选项。
PDF 中的动态文本
创建自定义 PDF 报价时，可使用 动态文本 让 Odoo 自动填充与报价相关的信息，如名称、价格等。
动态文本值是表单组件（文本输入框），可在 PDF 中添加，Odoo 会自动用对应的报价数据填充。
常用动态文本值
页眉/页脚 PDF
name：销售订单参考号partner_id__name：客户名称user_id__name：业务员名称amount_untaxed：未税金额amount_total：含税总额delivery_date：交货日期validity_date：有效期至client_order_ref：客户参考号
产品 PDF
description：产品描述quantity：数量uom：计量单位price_unit：单价discount：折扣product_sale_price：产品列表价taxes：税名（逗号分隔）tax_excl_price：不含税价格tax_incl_price：含税价格
上传 PDF 后，点击 配置动态字段，即可将 PDF 中的任意字段名映射到相应的 Odoo 字段路径。页眉/页脚以 sale_order 为起点，产品文档则以 sale_order_line 为起点。若路径留空，则会在生成的报价中出现可手动填写的自定义备注框。
::: example
最佳实践是使用通用的动态文本值（如 name、partner_id_name）。上传后，Odoo 会自动把销售订单参考号填入 name 字段，客户名称填入 partner_id_name 字段。
:::
完成 PDF 配置后，保存至本地硬盘。随后前往 销售应用 --> 配置 --> 页眉/页脚，点击 上传，选择文件并确认，PDF 即会出现在看板的第一张卡片中。
:::: note
::: title
注意
:::
看板卡片可通过拖拽重新排序，以决定在模板列表中的显示顺序。
::::
::: example
若上传的 PDF 包含表单字段 invoice_partner_country，可将其路径设为：
partner_invoice_id.country_id.name（用于页眉/页脚）order_id.partner_invoice_id.country_id.name（用于产品文档）
这样在生成 PDF 时会自动填入开票方国家名称。
:::
:::: tip
::: title
技巧
:::
若上传的 PDF 包含表单字段 custom_note，将路径留空即可在生成的报价中出现可自行填写的备注框。
::::
为产品添加 PDF
在 Odoo 销售 应用中，也可以为产品表单添加自定义 PDF。产品被引用到报价时，该 PDF 会自动插入到最终的报价 PDF 中。
添加步骤
- 前往
销售应用 --> 产品 --> 产品，选中目标产品。 - 点击页面顶部的 文档 智能按钮，进入该产品的 文档 页面。
- 在文档页面点击 新建 或 上传，按照前文描述的方式上传 PDF。
:::: note
::: title
注意
:::
文档也可以添加到产品变体上。如果同一产品和其变体都有文档，仅显示变体上的文档。
::::
PDF 表单配置
- 名称：上传后自动填充 PDF 文件名，可编辑。
- 类型：上传 PDF 时会自动设为
File，不可更改。 - 可见范围（Visible at）下拉框可选：
在报价时：文档随时对客户可见。在确认订单时：订单确认后发送，适合用户手册等。在报价 PDF 中：文档会被插入到报价 PDF 的 价格 部分之前。
::: example
选择 在报价 PDF 中 并上传 Corner Desk.pdf 后，客户门户的报价页面会在 文档 区块中展示该 PDF。
:::
- 配置动态字段：同页眉/页脚一样，只是起始模型为
sale_order_line。 - 在电商网站发布（Publish on Website）：勾选后，PDF 链接会出现在产品的在线店铺页面的 文档 区块下。
::: example
开启 在网站发布 后，产品页面会显示一个指向 Corner Desk.pdf 的链接，位于 文档 标题下方。
:::
PDF 报价
在销售订单的 报价构建器 选项卡中，可选择额外文档合并进最终的 PDF。如果选中的文档包含自定义字段，这些字段会以可编辑的文本框形式出现，供用户填写。
完成预配置的 PDF 报价确认后，可在订单的 操作（fa-cog）菜单中选择 打印 → PDF 报价，系统会立即下载生成的 PDF。该 PDF 包含所有已配置的页眉、页脚、产品文档等，可直接查看或打印存档。
:::: note
::: title
注意
:::
可下载 PDF 报价构建器示例 <pdf_quote_builder/pdfquotebuilderexamples.zip> 或 示例报价 <pdf_quote_builder/sample_quotation.pdf> 以作参考。
::::
::: seealso
quote_template
:::