> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 模板中的单据编号

> 使用 `{{ document_number }}` 打印发票、贷记单和报价单编号，使用 `{{ document_date }}` 打印发票日期，并打印作废提示。

开启单据编号后，Foliant 会为发票、贷记单和报价单分别分配连续编号，例如 `INV-0042`。模板使用 `{{ document_number }}` 打印编号，在可视化编辑器中则使用 **单据编号** 区块。

## 开始之前

* 在 **设置 › 文档与打印 › 单据编号** 中开启编号。请参阅[设置单据编号](https://foliant-help.iforiti.com/cn/invoices-and-numbering/document-numbering.md)。
* 在模板的设置页面中，将模板的 **单据类型** 设为 **发票**、**贷记单** 或 **报价单**。类型为 **其他（不编号）** 的模板不会获得编号。

## 在可视化编辑器中

添加 **单据编号** 区块（位于 **合规** 中）。它会以单据的语言打印编号和单据日期，并附带标签，例如“发票编号”和“发票日期”（贷记单上为“贷记单日期”，报价单上为“报价单日期”）。该区块只在有编号的单据上显示。

您也可以将 **单据编号** 和 **单据日期** 添加到 **页眉** 区块的 **标题下的详情** 中，或将 **单据编号** 用作 **条形码 / QR** 区块编码的内容。

## 在代码中

| 变量 | 说明 |
| - | - |
| `{{ document_number }}` | 单据的编号。单据没有编号时为空。 |
| `{{ document_issued_at }}` | 编号的生成时间。单据没有编号时为空。请使用 `date` 设置格式。 |
| `{{ document_date }}` | 单据的日期，始终有值：有编号时为编号生成的时间，否则为订单日期（贷记单为退款日期）。请将它用作发票日期。请使用 `date` 设置格式。 |
| `{{ document_voided }}` | 单据已取消时为 true。其编号仍视为已使用，不会再次分配。 |
| `{{ document_kind }}` | `invoice`、`credit_note` 或 `quote`；模板不编号时为空。 |

仅在有编号时打印编号：

```liquid theme={null}
{% if document_number %}
  <p>{{ 'document_number.invoice' | t }}: {{ document_number }}</p>
  <p>{{ 'document_date.invoice' | t }}: {{ document_date | date: '%d %B %Y' }}</p>
  {% if document_voided %}<p>{{ 'document_number.void' | t }}</p>{% endif %}
{% endif %}
```

`'document_date.invoice' | t` 会以单据的语言打印“发票日期”；其他类型请使用 `document_date.credit_note` 或 `document_date.quote`。

## 发票日期

发票日期是发票的开具日期，即分配编号的那一天。它不是订单日期，也不是当天日期，因为当天日期会在您每次重新打印时改变。`{{ document_date }}` 会提供这个日期：

* 在有编号的单据上，它是编号生成的日期，按您商店的时区计算。下个月再次打印该单据，日期也不会改变。
* 在没有编号的单据上，它是订单日期。对于从其他地方导入的订单，则是订单的处理日期。贷记单使用其退款日期。

因此，无论是否开启编号，同一个模板都能使用。内置的发票、贷记单和报价单模板已经会打印该日期，标签为“发票日期”、“贷记单日期”或“报价单日期”。如果您自己的模板使用 `'now' | date` 作为日期，请将其替换为 `{{ document_date | date: '%d %B %Y' }}`。

## 如果您的模板没有打印编号

如果有编号的单据所用模板中没有任何地方使用 `document_number`，Foliant 会在末尾添加一小行，显示编号及其生成日期，例如“发票编号：INV-0042 · 2026年10月4日”，确保编号不会缺失。在您希望显示的位置添加 `{{ document_number }}`，这一行就会消失。如果您的模板已经打印了 `document_date` 或 `document_issued_at`，这一行只显示编号。

## 须知

* 单据在首次被下载、打印或导出时获得编号，此后保持不变。
* 编辑器的预览会显示您下一份单据将获得的编号，但不会占用该编号。
* 编号的条形码：`{{ document_number | barcode }}`。请参阅[条形码和二维码](https://foliant-help.iforiti.com/cn/template-editor/liquid-barcodes-and-qr-codes.md)。
* 用于所有选定订单的模板永远不会编号。

## 相关文章

* [设置单据编号](https://foliant-help.iforiti.com/cn/invoices-and-numbering/document-numbering.md)
* [区块参考](https://foliant-help.iforiti.com/cn/template-editor/block-catalogue.md)
* [条形码和二维码](https://foliant-help.iforiti.com/cn/template-editor/liquid-barcodes-and-qr-codes.md)
* [日期、语言和翻译](https://foliant-help.iforiti.com/cn/template-editor/liquid-dates-and-languages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.