> ## 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/jp/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 }}` でこの日付を取得できます。

* 番号付きの書類では、ストアのタイムゾーンでの番号発行日です。翌月に再印刷しても変わりません。
* 番号のない書類では、注文日です。ほかから取り込んだ注文では、注文が処理された日です。クレジットノートでは返金日を使います。

そのため、番号付けの有効・無効にかかわらず、1 つのテンプレートで対応できます。標準の請求書、クレジットノート、見積書のテンプレートでは、「請求日」「クレジットノート日付」「見積日」のラベル付きですでに印刷されます。独自のテンプレートで日付として `'now' | date` を印刷している場合は、`{{ document_date | date: '%d %B %Y' }}` に置き換えてください。

## テンプレートで番号を印刷していない場合

番号付き書類のテンプレートで `document_number` がどこにも使われていない場合、Foliant は番号と発行日を記載した短い行を末尾に追加します（例：「請求書番号: INV-0042 · October 4, 2026」）。これにより番号が欠けることはありません。表示したい場所に `{{ document_number }}` を追加すると、この行は表示されなくなります。テンプレートですでに `document_date` または `document_issued_at` を印刷している場合、この行には番号のみが表示されます。

## 補足

* 書類には、初めてダウンロード、印刷、エクスポートされたときに番号が付き、その番号は変わりません。
* エディタのプレビューには、次の書類に付く番号が表示されます。プレビューで番号が消費されることはありません。
* 番号のバーコード：`{{ document_number | barcode }}`。[バーコードと QR コード](https://foliant-help.iforiti.com/jp/template-editor/liquid-barcodes-and-qr-codes.md)をご覧ください。
* 選択したすべての注文を対象とするテンプレートには、番号は付きません。

## 関連記事

* [書類の番号付けを設定する](https://foliant-help.iforiti.com/jp/invoices-and-numbering/document-numbering.md)
* [ブロックリファレンス](https://foliant-help.iforiti.com/jp/template-editor/block-catalogue.md)
* [バーコードと QR コード](https://foliant-help.iforiti.com/jp/template-editor/liquid-barcodes-and-qr-codes.md)
* [日付、言語、翻訳](https://foliant-help.iforiti.com/jp/template-editor/liquid-dates-and-languages.md)


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