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

# Nomor dokumen di template

> Cetak nomor faktur, nota kredit, dan penawaran dengan `document_number`, tanggal faktur dengan `document_date`, serta pemberitahuan batal.

Saat penomoran dokumen aktif, Foliant memberi faktur, nota kredit, dan penawaran nomor urutnya sendiri, seperti `INV-0042`. Template mencetak nomor tersebut dengan `{{ document_number }}`, atau di editor visual dengan blok **Nomor dokumen**.

## Sebelum Anda mulai

* Aktifkan penomoran di **Pengaturan › Dokumen & pencetakan › Penomoran dokumen**. Lihat [Menyiapkan penomoran dokumen](https://foliant-help.iforiti.com/id/invoices-and-numbering/document-numbering.md).
* Atur **Jenis dokumen** template ke **Faktur**, **Nota kredit**, atau **Penawaran** di halaman pengaturannya. Template dengan jenis **Lainnya (tanpa nomor)** tidak mendapat nomor.

## Di editor visual

Tambahkan blok **Nomor dokumen** (di **Kepatuhan**). Blok ini mencetak nomor dan tanggal dokumen beserta labelnya, seperti "Nomor faktur" dan "Tanggal faktur" ("Tanggal nota kredit" pada nota kredit, "Tanggal penawaran" pada penawaran), dalam bahasa dokumen. Blok ini hanya muncul pada dokumen bernomor.

Anda juga dapat menambahkan **Nomor dokumen** dan **Tanggal dokumen** ke **Detail di bawah judul** pada blok **Header**, atau menggunakan **Nomor dokumen** sebagai isi yang dienkode oleh blok **Barcode / QR**.

## Di kode

| Variabel | Artinya |
| - | - |
| `{{ document_number }}` | Nomor dokumen. Kosong jika dokumen tidak memiliki nomor. |
| `{{ document_issued_at }}` | Waktu nomor diterbitkan. Kosong jika dokumen tidak memiliki nomor. Format dengan `date`. |
| `{{ document_date }}` | Tanggal dokumen, selalu terisi: waktu nomornya diterbitkan, atau jika tidak ada, tanggal pesanan (tanggal pengembalian dana untuk nota kredit). Gunakan sebagai tanggal faktur. Format dengan `date`. |
| `{{ document_voided }}` | Bernilai true jika dokumen dibatalkan. Nomornya tetap terpakai dan tidak pernah diberikan lagi. |
| `{{ document_kind }}` | `invoice`, `credit_note`, atau `quote`; kosong jika template tidak bernomor. |

Cetak nomor hanya jika ada:

```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` mencetak "Tanggal faktur" dalam bahasa dokumen; gunakan `document_date.credit_note` atau `document_date.quote` untuk jenis lainnya.

## Tanggal faktur

Tanggal faktur adalah hari faktur diterbitkan: hari nomornya diberikan. Itu bukan tanggal pesanan, dan bukan tanggal hari ini, yang berubah setiap kali Anda mencetaknya ulang. `{{ document_date }}` memberi Anda tanggal tersebut:

* Pada dokumen bernomor, tanggalnya adalah hari nomor diterbitkan, dalam zona waktu toko Anda. Mencetak ulang dokumen bulan depan tidak mengubahnya.
* Pada dokumen tanpa nomor, tanggalnya adalah tanggal pesanan. Untuk pesanan yang diimpor dari tempat lain, itu adalah tanggal pesanan diproses. Nota kredit menggunakan tanggal pengembalian dananya.

Jadi satu template berfungsi baik penomoran aktif maupun tidak. Template bawaan faktur, nota kredit, dan penawaran sudah mencetaknya, dengan label "Tanggal faktur", "Tanggal nota kredit", atau "Tanggal penawaran". Jika template Anda sendiri mencetak `'now' | date` sebagai tanggalnya, ganti dengan `{{ document_date | date: '%d %B %Y' }}`.

## Jika template Anda tidak mencetak nomor

Jika template dokumen bernomor tidak menggunakan `document_number` di mana pun, Foliant menambahkan baris kecil di bagian akhir berisi nomor dan tanggal penerbitannya, seperti "Nomor faktur: INV-0042 · 4 Oktober 2026", sehingga nomornya tidak pernah hilang. Tambahkan `{{ document_number }}` di tempat yang Anda inginkan, dan baris tambahan itu akan hilang. Jika template Anda sudah mencetak `document_date` atau `document_issued_at`, baris tersebut hanya menampilkan nomornya.

## Perlu diketahui

* Dokumen mendapat nomornya saat pertama kali diunduh, dicetak, atau diekspor, dan nomor itu tetap dipakai.
* Pratinjau editor menampilkan nomor yang akan didapat dokumen Anda berikutnya, tanpa memakainya.
* Barcode dari nomor: `{{ document_number | barcode }}`. Lihat [Barcode dan kode QR](https://foliant-help.iforiti.com/id/template-editor/liquid-barcodes-and-qr-codes.md).
* Template untuk semua pesanan yang dipilih tidak pernah diberi nomor.

## Artikel terkait

* [Menyiapkan penomoran dokumen](https://foliant-help.iforiti.com/id/invoices-and-numbering/document-numbering.md)
* [Referensi blok](https://foliant-help.iforiti.com/id/template-editor/block-catalogue.md)
* [Barcode dan kode QR](https://foliant-help.iforiti.com/id/template-editor/liquid-barcodes-and-qr-codes.md)
* [Tanggal, bahasa, dan terjemahan](https://foliant-help.iforiti.com/id/template-editor/liquid-dates-and-languages.md)


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