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

# Şablonlarda belge numaraları

> Fatura, alacak dekontu ve teklif numaralarını {{ document_number }} ile, fatura tarihini {{ document_date }} ile yazdırın ve bir iptal notu ekleyin.

Belge numaralandırma açık olduğunda Foliant; faturalara, alacak dekontlarına ve tekliflere `INV-0042` gibi kendi sıralı numaralarını verir. Şablon bu numarayı `{{ document_number }}` ile, görsel düzenleyicide ise **Belge numarası** bloğuyla yazdırır.

## Başlamadan önce

* Numaralandırmayı **Ayarlar › Belgeler ve yazdırma › Belge numaralandırma** bölümünden açın. [Belge numaralandırmayı ayarlama](https://foliant-help.iforiti.com/tr/invoices-and-numbering/document-numbering.md) sayfasına bakın.
* Şablonun ayarlar sayfasında **Belge türü** alanını **Fatura**, **Alacak dekontu** veya **Teklif** olarak ayarlayın. **Diğer (numarasız)** türündeki şablonlar numara almaz.

## Görsel düzenleyicide

**Belge numarası** bloğunu ekleyin (**Uyumluluk** altında). Bu blok, numarayı ve belgenin tarihini "Fatura numarası" ve "Fatura tarihi" gibi etiketleriyle (alacak dekontunda "Alacak dekontu tarihi", teklifte "Teklif tarihi") belgenin dilinde yazdırır. Yalnızca numaralı belgelerde görünür.

**Belge numarası** ve **Belge tarihi** alanlarını bir **Üst bilgi** bloğunun **Başlığın altındaki bilgiler** bölümüne de ekleyebilirsiniz. **Belge numarası** alanını bir **Barkod / QR** bloğunun kodladığı değer olarak da kullanabilirsiniz.

## Kodda

| Değişken | Nedir |
| - | - |
| `{{ document_number }}` | Belgenin numarası. Belgenin numarası yoksa boştur. |
| `{{ document_issued_at }}` | Numaranın verildiği zaman. Belgenin numarası yoksa boştur. `date` ile biçimlendirin. |
| `{{ document_date }}` | Belgenin tarihi, her zaman doludur: numarasının verildiği zaman, numara yoksa siparişin tarihi (alacak dekontunda iade tarihi). Bunu fatura tarihi olarak kullanın. `date` ile biçimlendirin. |
| `{{ document_voided }}` | Belge iptal edildiyse true olur. Numarası kullanılmış sayılır ve bir daha hiç verilmez. |
| `{{ document_kind }}` | `invoice`, `credit_note` veya `quote`; şablon numaralı değilse boştur. |

Numarayı yalnızca varsa yazdırın:

```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`, belgenin dilinde "Fatura tarihi" yazdırır. Diğer türler için `document_date.credit_note` veya `document_date.quote` kullanın.

## Fatura tarihi

Bir faturanın tarihi, düzenlendiği gündür: numarasının verildiği gün. Bu, sipariş tarihi değildir. Bugünün tarihi de değildir, çünkü o tarih faturayı her yeniden yazdırdığınızda değişir. `{{ document_date }}` size bu tarihi verir:

* Numaralı bir belgede, numaranın verildiği gündür ve mağazanızın saat dilimine göredir. Belgeyi gelecek ay yeniden yazdırmanız bu tarihi değiştirmez.
* Numarası olmayan bir belgede, siparişin tarihidir. Başka yerden içe aktarılan siparişlerde bu, siparişin işlendiği tarihtir. Alacak dekontunda iadenin tarihi kullanılır.

Böylece tek bir şablon, numaralandırma açık da olsa kapalı da olsa çalışır. Yerleşik fatura, alacak dekontu ve teklif şablonları bu tarihi zaten "Fatura tarihi", "Alacak dekontu tarihi" veya "Teklif tarihi" etiketiyle yazdırır. Kendi şablonunuz tarih olarak `'now' | date` yazdırıyorsa bunu `{{ document_date | date: '%d %B %Y' }}` ile değiştirin.

## Şablonunuz numarayı yazdırmıyorsa

Numaralı bir belgenin şablonu `document_number` değişkenini hiçbir yerde kullanmıyorsa Foliant, numaranın hiç eksik kalmaması için sona numarayı ve verildiği tarihi içeren küçük bir satır ekler. Örneğin: "Fatura numarası: INV-0042 · 4 Ekim 2026". `{{ document_number }}` değişkenini istediğiniz yere eklediğinizde bu ek satır kaybolur. Şablonunuz zaten `document_date` veya `document_issued_at` yazdırıyorsa satırda yalnızca numara görünür.

## Bilmeniz gerekenler

* Belge, ilk kez indirildiğinde, yazdırıldığında veya dışa aktarıldığında numarasını alır ve bu numarayı korur.
* Düzenleyicinin önizlemesi, sonraki belgenizin alacağı numarayı gösterir ama bu numarayı kullanmaz.
* Numaranın barkodu: `{{ document_number | barcode }}`. [Barkodlar ve QR kodları](https://foliant-help.iforiti.com/tr/template-editor/liquid-barcodes-and-qr-codes.md) sayfasına bakın.
* Seçili tüm siparişler için hazırlanan şablonlar hiçbir zaman numaralandırılmaz.

## İlgili makaleler

* [Belge numaralandırmayı ayarlama](https://foliant-help.iforiti.com/tr/invoices-and-numbering/document-numbering.md)
* [Blok başvurusu](https://foliant-help.iforiti.com/tr/template-editor/block-catalogue.md)
* [Barkodlar ve QR kodları](https://foliant-help.iforiti.com/tr/template-editor/liquid-barcodes-and-qr-codes.md)
* [Tarihler, diller ve çeviriler](https://foliant-help.iforiti.com/tr/template-editor/liquid-dates-and-languages.md)


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