PDF 报价生成器¶

Odoo 销售 中的 PDF 报价生成器 提供了向客户发送完全定制的 PDF 文件进行报价的机会，该文件可以展示公司和产品信息，包含各种内容和设计元素，而不仅仅是显示价格和总金额。

PDF报价生成器将页眉页面、产品描述、价格以及页脚页面组合在一起，以创建详细的报价单。它还可以在PDF中插入动态文本或自定义备注，以根据客户需求个性化报价。

在报价中使用定制化的PDF可以为客户提供更完善的购物体验，并为公司增添一份优雅的专业水准。

另请参见

Odoo 快速技巧 - 创建 PDF 报价 [视频]

注解

建议使用 Adobe 软件编辑 PDF 表单。页眉和页脚 PDF 模板上的表单字段是用于从 Odoo 获取动态值所必需的。

配置¶

In order to add custom PDF files for quotes, the PDF Quote builder feature must be configured.

要执行此操作，请导航至销售应用 ‣ 配置 ‣ 设置。然后，在设置页面上，滚动到报价与订单部分，并找到 PDF 报价生成器功能。

添加 PDF 作为页眉/页脚¶

在 Odoo 销售模块中，可以添加自定义的 PDF 文件，该文件可以用作页眉或页脚。当在报价中激活 PDF 报价生成器时，您可以选择任意数量的页眉和页脚来使用，这些 PDF 文件也将被插入到最终的 PDF 文件中。

要添加自定义的 PDF 作为页眉或页脚，请首先导航至：销售应用 ‣ 配置 ‣ 页眉/页脚。从该页面，单击新建或上传。

点击上传可立即提供上传所需文档的机会。然后，可以在文档卡片上进一步配置该文档，或通过点击文档卡片右上角的三个点图标，再点击编辑。

点击新建将显示一个空白的文档表单，在该表单中可以通过表单中的上传您的文件按钮上传所需的 PDF 文件，该按钮位于文件内容字段中。

此处可以修改与上传的文档相关的各种信息和配置。

文档表单中的第一个字段用于输入文档的名称，在上传文档之前该字段为灰色（不可点击）。一旦上传了 PDF 文件，名称字段将自动填充为 PDF 文件的名称，之后即可进行编辑。

然后，在文档类型字段中，点击下拉菜单，选择页眉或页脚，以定义这些文件是否可被选择为报价的开头或结尾。

在此处，在报价模板部分，您可以将此 PDF 仅限制为某些报价模板。

注解

或者，您也可以导航至销售应用 ‣ 配置 ‣ 报价模板，选择一个模板，并在报价构建器选项卡中直接添加或上传一个 PDF 文件。

最后，除了文件内容字段外，您还可以使用配置动态字段。

PDF 中的动态文本¶

在为报价单创建自定义 PDF 时，使用 动态文本 使 Odoo 能够自动将与报价单相关的数据（如名称、价格等）填充到 PDF 内容中。

动态文本值是表单组件（文本输入框），可以在 PDF 文件中添加，Odoo 会自动将与报价相关的信息填充到这些值中。

动态文本值¶

以下是自定义 PDF 中常用的动态文本值，它们已映射到正确的字段，并代表以下含义。

对于页眉和页脚的 PDF：

名称: 销售订单编号
partner_id__name: 客户名称
user_id__name: 销售人员姓名
不含税金额: 未含税金额
总金额: 总金额
送达日期: 送达日期
validity_date: 有效期截止日期
客户订单编号: 客户参考

产品 PDF：

描述: 产品描述
数量: 数量
单位: 计量单位 (UoM)
单价: 单价
折扣: 折扣
产品销售价格: 产品列表价格
税项: 用逗号（,）分隔的税项名称
tax_excl_price: 税前价格
tax_incl_price: 含税价格

上传 PDF 后，您可以点击配置动态字段。这将允许您将 PDF 中找到的任何字段名称映射到您希望显示的字段，只需输入任何现有的路径即可。页眉和页脚从当前的销售订单模型开始，而产品文档则从其销售订单行的路径中继承。留空该路径允许您直接从需要它的特定报价单中填写自定义备注。

Example

当生成 PDF 时，最佳做法是使用通用的动态文本值（名称和合作伙伴编号）。当上传到数据库时，Odoo 会自动将这些字段填充为相应字段中的信息。

在这种情况下，Odoo 会自动在 name 动态文本字段中填写销售订单编号，并在 partner_id_name 字段中填写客户名称。

一旦PDF文件完成，请将其保存到计算机的硬盘中，然后通过销售应用 ‣ 配置 ‣ 页眉/页脚将其上传到Odoo。

Example

在上传包含表单字段 invoice_partner_country 的 PDF 文件时，该信息可在销售订单中获取，请将表单字段名称的路径配置为： n- :guilabel:`partner_invoice_id.country_id.name`（用于页眉或页脚文档） n- :guilabel:`order_id.partner_invoice_id.country_id.name`（用于产品文档） nn在生成 PDF 时，该配置会使用发票业务伙伴的国家名称填充表单。

Example

当上传包含表单字段 custom_note 的任何 PDF 文件时，留空 path 允许卖家在该文档中该表单字段所在的位置填写任何备注，并在生成 PDF 时显示。