上次更新时间： 2026年10月28日
需要权限 要创建 自定义明细行 ，必须具备“超级管理员 ”或 “创建自定义明细行”权限 。
明细行是指在配置 信用凭证、 交易、 发票、 支付链接、 报价单、 旧版报价单和 订阅时生成的单个 产品 实例或自定义明细行条目。使用行项目编辑器配置基于产品的行项目和自定义行项目的详细信息，例如价格、折扣和计费条款。
请注意： 如果您拥有 企业版 订阅，您可以 限制哪些用户可以查看特定明细行的属性。
开发者资源
了解有关如何使用 “明细项目”API 构建自定义解决方案的更多信息。
项目行为
使用细列项目时，请注意以下行为：
- 添加产品： 当从产品库将产品添加到 合同、商机、 发票、 支付链接、 报价、 旧版报价或 订阅时，该产品将成为该记录的特定行项目，并拥有自己的 行项目记录 ID。
- 自定义细列项目： 添加自定义细列项目时，它对添加记录是唯一的，并且有自己的 细列项目记录 ID。
- 明细项转换： 每个 合同、 交易、 发票、 支付链接、 报价、 历史报价或 订阅对应的明细项都是唯一的。每当在工具之间进行转换时（例如， 将交易转换为报价 ，或根据合同、支付链接、报价或订阅自动生成发票），明细项目都会被克隆到新记录中。克隆的细列项目保持相同的详细信息，但成为自己的细列项目实例，并有自己的 记录 ID。例如，如果您在交易中添加了一个细列项目，并据此创建了一个报价，那么该细列项目就会克隆到报价中。交易行项目记录 ID 将与报价行项目记录 ID 不同。
- 从商机生成报价单： 当您从商机生成报价单时，HubSpot 会将商机的明细行复制到报价单中，作为新的、独立的明细行。当您 确认报价时， 报价的明细项会同步回交易，两者之间共享的任何明细项都会被更新（仅当它们通过 API 关联时才可能发生），并删除报价中未出现的交易明细项。
- 关联行为： 每个克隆的项目仅与其新的父记录（报价单、发票、付款链接或订阅）相关联，而非原始交易。报价一经发布，其明细项目即被锁定。后续对该交易明细项目的修改不会影响报价。
- 无持续同步： 各记录之间的明细项目不会保持持续同步。唯一会自动更新的情况是报价 最终确定时。分别编辑每条记录的明细项目，并使用原生自动化功能。例如，在 发票设置中开启 自动生成发票 功能，以减少重复工作。
折扣、费用和税金四舍五入
在 HubSpot 中输入折扣、费用和税费时，可存储的小数位数取决于值类型。HubSpot 还会根据数值的应用位置采用不同的四舍五入方法。下表总结了每种折扣、费用和税种的最大精度、舍入方法及存储值。
舍入方法
-
银行四舍五入： 四舍五入到最接近的数值。如果被舍弃的位数恰好是5，则该数值将四舍五入到最接近的偶数位。
-
HALF_UP： 四舍五入到最接近的数值。5及以上位数的数值向上取整。
-
两步舍入： 先使用“银行家舍入法”舍入至小数点后三位，然后根据“0–5向下舍，6–9向上舍”的规则舍入至小数点后两位。
折扣类型
| 类型 | 适用范围 | 小数位数上限 | 舍入方法 | 输入示例 | 预存金额 |
|---|---|---|---|---|---|
| 单位折扣（金额） | 细列项目 | 6 | 银行四舍五入法。添加折扣后，结账时的金额将根据 该货币的精确度 进行四舍五入。 | 10.5555555 | 10.555556（简体中文（大陆）） |
| 单位折扣（百分比） | 细列项目 | 3 | 银行四舍五入法。添加折扣后，结账时的金额将根据 该货币的精确度 进行四舍五入。 | 10.5555% | 10.556% |
| 税率 | 税务资料库 | 4 | HALF_UP | 10.55555% | 10.5556% |
| 一次性折扣 | 信用备忘录、 发票、 付款链接、 旧版报价单 |
2 | 先按银行四舍五入规则将数值四舍五入至小数点后3位，然后对该小数点后3位的数值，按照“0–5向下舍入，6–9向上取整”的规则进行四舍五入。如果小数点后第三位数字在0到5之间，则小数点后第二位数字保持不变，且所有后续数字均被删除。 | 10.5555% | 10.56% |
| 一次性费用 | 信用备忘录、 发票、 付款链接、 旧版报价单 |
2 | 先按银行四舍五入规则将数值四舍五入至小数点后3位，然后对该小数点后3位的数值，按照“0–5向下舍入，6–9向上取整”的规则进行四舍五入。如果小数点后第三位数字在0到5之间，则小数点后第二位数字保持不变，且所有后续数字均被删除。 | 10.555% | 10.55% |
| 一次性税款（金额） | 信用备忘录、 发票、 付款链接、 旧版报价单 |
2 | HALF_UP | 10.555 | 10.56 |
| 一次性税款（百分比） | 信用备忘录、 发票、 付款链接、 旧版报价单 |
4 | HALF_UP | 10.55555% | 10.5556% |
折扣、费用和税费的适用顺序
在 HubSpot 中处理时，折扣、费用和税金的应用如下：
- 先适用折扣（单位折扣、一次性折扣）。
- 接下来需要付费。
- 最后是纳税。
在每个相关步骤中：
- 折扣遵守 货币精确度四舍五入规则。
- 这种顺序意味着与外部系统之间可能会出现微小的差异，这取决于这些系统何时舍入（例如，如果会计工具在每一行之后舍入，而不是只在末尾舍入）。
交易项目
了解如何为交易添加细列项目。
报价项目
向报价单添加明细项的方式取决于您使用的是 HubSpot CPQ 中的 报价功能，还是 旧版报价单。
- 了解如何 在报价中添加细列项目。
- 了解如何向 旧版报价单中添加明细行。
请注意： 如果您可以访问旧版报价，并且已被分配了一个 Revenue Hub 席位，您将无法再访问旧版报价和旧版报价模板。如果 允许创建遗留报价的设置 已打开，则可以选择要创建的报价类型。或者，要重新获得对传统报价和传统报价模板的访问权限，请 将席位更 改为核心席位或仅查看席位。
合同明细项目
需要订阅 除非您已注册 “直接创建、编辑和续签 HubSpot 合同” 测试版，否则必须订阅 Revenue Hub 才能使用合同功能。
了解如何 在合同中添加明细行。
发票细列项目
了解如何 在发票中添加细列项目。
信用备忘录的细列项目
了解如何 在信用备忘录中添加细列项目。
付款链接的细列项目
了解如何 在付款链接中添加细列项目。
订阅的细列项目
当买家使用付款链接或报价购买具有固定计费频率的细列项目（也称为周期性细列项目），或您手动创建订阅时，HubSpot 会创建订阅记录，按指定频率自动向买家收取费用或开具发票。这意味着您无需手动创建多个付款链接、报价或发票，即可向定期更新的产品或服务的买家收取费用。
- 了解如何 为订阅添加细列项目。
- 了解如何 在付款链接中添加定期项目。
- 了解如何 在报价中添加经常性细列项目。
请注意： 如果启用了 “计费”功能 以及 “根据已接受的报价自动创建合同” 设置，则持续计费将通过 合同进行管理。进一步了解 该场景。
自定义对象的行项目
行项目可以添加到自定义对象中，添加方式与添加到其他对象中的方式相同：
进一步了解 自定义对象。
编辑项目编辑器的列
需要权限 需要超级管理员 权限才能设置在所有用户的明细项编辑器中默认显示哪些列。
您可以编辑在信用备忘录、交易、发票、付款链接、报价、传统报价和订阅的行项目编辑器中显示的列。超级管理员 可以定义一组默认列，在所有工具中显示给账户的所有用户。
编辑栏
- 导航至信用备忘录、交易、发票、付款链接、报价、传统报价或订阅。
- 在项目编辑器右上方，选择一个选项：
- 编辑栏： 为您正在使用的工具编辑您自己账户的栏。所做更改不会影响其他用户。
- 为每个人编辑默认列： 如果您是 超级管理员，可设置向所有用户显示的列。用户仍然可以选择 "编辑 "列来 定制自己的视图。
请注意： 在一个工具中为所有用户设置默认列会将更改应用于所有工具。例如，如果在贷方备忘行项目编辑器中设置列默认值，则更改将适用于贷方备忘、交易、发票、付款链接、报价、传统报价和订阅。
- 在对话框中，选择要添加的属性旁边的 复选框 。
- 要删除列，请单击 " 选定列 "部分中属性右侧的 X 。
- 要重新排列列的顺序，请使用 拖动柄拖动属性。
- 要将列移到顶部，请将鼠标悬停在 " 选定列 "部分的属性上，然后单击 "移到顶部"。
- 要将列恢复到默认状态，请单击 恢复默认列。
- 要冻结列，使其在滚动项目表时始终显示，请单击右上角的冻结 列 下拉菜单，选择要冻结的列数 。您最多可以冻结三列。
- 更改后，在左下角单击 " 应用"。
下一步工作
-
了解 有关如何使用报表生成器生成明细项目报表的更多信息。
