テンプレートでの書類番号

書類の番号付けを有効にすると、Foliant は請求書、クレジットノート、見積書にそれぞれ INV-0042 のような連番を付けます。テンプレートでは {{ document_number }} で番号を印刷します。ビジュアルエディタでは 書類番号 ブロックを使います。

始める前に

設定 › 書類と印刷 › 書類の番号付け で番号付けを有効にしてください。書類の番号付けを設定するをご覧ください。
テンプレートの設定ページで、書類の種類 を 請求書、クレジットノート、見積書 のいずれかに設定してください。種類が その他（番号なし） のテンプレートには番号が付きません。

ビジュアルエディタの場合

書類番号 ブロック（法令対応 内）を追加します。このブロックは番号と書類の日付を、「請求書番号」「請求日」（クレジットノートでは「クレジットノート日付」、見積書では「見積日」）などのラベル付きで、書類の言語で印刷します。番号付きの書類にのみ表示されます。 ヘッダー ブロックの タイトルの下の詳細 に 書類番号 と 書類の日付 を追加することもできます。また、バーコード / QR ブロックでエンコードする内容として 書類番号 を使うこともできます。

コードの場合

変数	内容
`{{ document_number }}`	書類の番号です。番号がない書類では空になります。
`{{ document_issued_at }}`	番号が発行された日時です。番号がない書類では空になります。`date` で書式を設定します。
`{{ document_date }}`	書類の日付で、常に値があります。番号が発行された日時、番号がない場合は注文日（クレジットノートでは返金日）です。請求日として使います。`date` で書式を設定します。
`{{ document_voided }}`	書類が取り消された場合に true になります。その番号は使用済みのままで、再び割り当てられることはありません。
`{{ document_kind }}`	`invoice`、`credit_note`、`quote` のいずれかです。番号付きでないテンプレートでは空になります。

番号がある場合にのみ印刷するには、次のようにします。

{% 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 コードをご覧ください。
選択したすべての注文を対象とするテンプレートには、番号は付きません。

ようこそ

はじめに

印刷