> ## 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/ko/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 }}`. [바코드 및 QR 코드](https://foliant-help.iforiti.com/ko/template-editor/liquid-barcodes-and-qr-codes.md)를 참조하세요.
* 선택한 모든 주문을 위한 템플릿에는 번호가 매겨지지 않습니다.

## 관련 문서

* [문서 번호 매기기 설정](https://foliant-help.iforiti.com/ko/invoices-and-numbering/document-numbering.md)
* [블록 참조](https://foliant-help.iforiti.com/ko/template-editor/block-catalogue.md)
* [바코드 및 QR 코드](https://foliant-help.iforiti.com/ko/template-editor/liquid-barcodes-and-qr-codes.md)
* [날짜, 언어 및 번역](https://foliant-help.iforiti.com/ko/template-editor/liquid-dates-and-languages.md)


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