> ## 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.

# Số chứng từ trong mẫu

> In số hóa đơn, số phiếu ghi có và số báo giá bằng {{ document_number }}, ngày hóa đơn bằng {{ document_date }} và thông báo hủy.

Khi bật đánh số chứng từ, Foliant cấp cho hóa đơn, phiếu ghi có và báo giá số thứ tự riêng, ví dụ `INV-0042`. Mẫu in số này bằng `{{ document_number }}`, hoặc bằng khối **Số chứng từ** trong trình chỉnh sửa trực quan.

## Trước khi bắt đầu

* Bật đánh số trong **Cài đặt › Tài liệu & in ấn › Đánh số chứng từ**. Xem [Thiết lập đánh số chứng từ](https://foliant-help.iforiti.com/vi/invoices-and-numbering/document-numbering.md).
* Đặt **Loại chứng từ** của mẫu thành **Hóa đơn**, **Phiếu ghi có** hoặc **Báo giá** trên trang cài đặt của mẫu. Mẫu thuộc loại **Khác (không đánh số)** không được đánh số.

## Trong trình chỉnh sửa trực quan

Thêm khối **Số chứng từ** (trong **Tuân thủ**). Khối này in số và ngày của chứng từ kèm nhãn, ví dụ "Số hóa đơn" và "Ngày hóa đơn" ("Ngày phiếu ghi có" trên phiếu ghi có, "Ngày báo giá" trên báo giá), theo ngôn ngữ của chứng từ. Khối chỉ hiện trên chứng từ có đánh số.

Bạn cũng có thể thêm **Số chứng từ** và **Ngày chứng từ** vào **Chi tiết dưới tiêu đề** của khối **Phần đầu**, hoặc dùng **Số chứng từ** làm nội dung mà khối **Mã vạch / QR** mã hóa.

## Trong mã

| Biến | Ý nghĩa |
| - | - |
| `{{ document_number }}` | Số của chứng từ. Để trống khi chứng từ không có số. |
| `{{ document_issued_at }}` | Thời điểm cấp số. Để trống khi chứng từ không có số. Định dạng bằng `date`. |
| `{{ document_date }}` | Ngày của chứng từ, luôn có giá trị: thời điểm cấp số, nếu không thì là ngày của đơn hàng (với phiếu ghi có là ngày hoàn tiền). Dùng biến này làm ngày hóa đơn. Định dạng bằng `date`. |
| `{{ document_voided }}` | Đúng khi chứng từ đã bị hủy. Số của chứng từ vẫn được coi là đã dùng và không bao giờ được cấp lại. |
| `{{ document_kind }}` | `invoice`, `credit_note` hoặc `quote`; để trống khi mẫu không được đánh số. |

Chỉ in số khi có số:

```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` in ra "Ngày hóa đơn" theo ngôn ngữ của chứng từ; dùng `document_date.credit_note` hoặc `document_date.quote` cho các loại khác.

## Ngày hóa đơn

Ngày của hóa đơn là ngày phát hành: ngày hóa đơn được cấp số. Đó không phải ngày đặt hàng, cũng không phải ngày hôm nay, vì ngày hôm nay thay đổi mỗi lần bạn in lại. `{{ document_date }}` cho bạn đúng ngày đó:

* Trên chứng từ có đánh số, đó là ngày cấp số, theo múi giờ của cửa hàng bạn. In lại chứng từ vào tháng sau cũng không làm thay đổi ngày này.
* Trên chứng từ không có số, đó là ngày của đơn hàng. Với đơn hàng nhập từ nơi khác, đó là ngày đơn hàng được xử lý. Phiếu ghi có dùng ngày hoàn tiền.

Vì vậy, một mẫu dùng được dù bạn bật hay tắt đánh số. Các mẫu hóa đơn, phiếu ghi có và báo giá có sẵn đã in ngày này, với nhãn "Ngày hóa đơn", "Ngày phiếu ghi có" hoặc "Ngày báo giá". Nếu mẫu của bạn in ngày bằng `'now' | date`, hãy thay bằng `{{ document_date | date: '%d %B %Y' }}`.

## Nếu mẫu của bạn không in số

Khi mẫu của một chứng từ có đánh số không dùng `document_number` ở đâu cả, Foliant thêm một dòng nhỏ ở cuối với số và ngày cấp số, ví dụ "Số hóa đơn: INV-0042 · 4 tháng 10, 2026", để số không bao giờ bị thiếu. Thêm `{{ document_number }}` vào chỗ bạn muốn, dòng thêm này sẽ biến mất. Nếu mẫu của bạn đã in `document_date` hoặc `document_issued_at`, dòng này chỉ hiện số.

## Lưu ý

* Chứng từ được cấp số vào lần đầu tiên được tải xuống, in hoặc xuất, và giữ số đó.
* Bản xem trước trong trình chỉnh sửa hiện số mà chứng từ tiếp theo của bạn sẽ nhận, nhưng không dùng mất số đó.
* Mã vạch của số: `{{ document_number | barcode }}`. Xem [Mã vạch và mã QR](https://foliant-help.iforiti.com/vi/template-editor/liquid-barcodes-and-qr-codes.md).
* Mẫu cho tất cả đơn hàng đã chọn không bao giờ được đánh số.

## Bài viết liên quan

* [Thiết lập đánh số chứng từ](https://foliant-help.iforiti.com/vi/invoices-and-numbering/document-numbering.md)
* [Tham khảo khối](https://foliant-help.iforiti.com/vi/template-editor/block-catalogue.md)
* [Mã vạch và mã QR](https://foliant-help.iforiti.com/vi/template-editor/liquid-barcodes-and-qr-codes.md)
* [Ngày, ngôn ngữ và bản dịch](https://foliant-help.iforiti.com/vi/template-editor/liquid-dates-and-languages.md)


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