> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Teklif şablonları

> Teklif PDF'inin görünümünü belirleyen şablonları listeleme, canlı önizlemeli editörle hazırlama, sistem şablonu koruması ve PDF oluştururken şablon seçme.

Teklif şablonu, teklif PDF'inin HTML içeriğidir. Şablondaki değişkenler PDF oluşturulurken teklifin hasta, kalem ve toplam bilgileriyle dolar. Bu sayfa şablonları nasıl listelediğinizi, düzenlediğinizi ve PDF oluştururken nasıl seçtiğinizi anlatır. Teklifin kendisi için [Teklifler](https://docs.flextell.ai/panel/teklifler/genel-bakis.md) sayfasına bakın.

Listeye **Lead & Satış Yönetimi → Teklifler → Teklif Şablonları** menüsünden ulaşırsınız. Ekranı görmek için rolünüzde **Teklif Şablonları** grubunda **Görüntüleme** izni (`View:OfferTemplate`) olmalıdır.

## Şablon listesi

Üstteki **Şablon adı ara** kutusu ada göre arar. **Yenile** düğmesi listeyi yeniler. **Yeni Şablon** düğmesi, rolünüzde **Oluşturma** izni varsa görünür.

| Sütun | Açıklama |
| - | - |
| **Şablon Adı** | Şablonun adı. Kliniğin sistem şablonu yanında **Sistem** etiketi taşır. |
| **Varsayılan** | Varsayılan şablonda **Varsayılan** etiketi görünür, diğerlerinde `—` yazar. |
| **Aktiflik** | **Aktif** veya **Pasif**. Sütun başlığından filtreleyebilirsiniz. |
| **Oluşturulma Tarihi** | Şablonun açıldığı tarih. |
| **Güncellenme Tarihi** | Şablonun son değiştirildiği tarih. |

Sütun başlıklarına tıklayarak sıralayabilirsiniz. Hiç şablon yoksa liste **Henüz teklif şablonu yok** yazar. Liste yüklenemezse **Teklif şablonları yüklenemedi.** uyarısı görürsünüz.

Satırın sonundaki menüde **Düzenle** ve **Sil** işlemleri bulunur. Satıra tıklarsanız, düzenleme izniniz varsa editör açılır. İzni olmayan işlem menüde görünmez.

## Şablon oluşturma ve düzenleme

**1. Editörü açın**

Yeni şablon için **Yeni Şablon**'a, mevcut şablon için satırdaki **Düzenle**'ye tıklayın.

**2. Genel bölümünü doldurun**

**Şablon Adı** alanına bir ad yazın. **Aktif** ve **Varsayılan** anahtarlarını ihtiyacınıza göre ayarlayın.

**3. İçeriği hazırlayın**

**HTML İçerik** alanına teklif PDF'inin HTML'ini yazın. Sağdaki **Değişkenler** listesinden değişken ekleyin.

**4. Önizlemeyi kontrol edin**

Yazdıkça **Önizleme** bölümü güncellenir. İsterseniz **Örnek Teklif** listesinden gerçek bir teklif seçin.

**5. Kaydedin**

Yeni şablonda **Oluştur**'a, mevcut şablonda **Değişiklikleri Kaydet**'e tıklayın. Vazgeçmek için **İptal**'i kullanın.

### Alanlar

| Alan | Zorunlu | Açıklama |
| - | - | - |
| **Şablon Adı** | Evet | En çok 255 karakter. |
| **Aktif** | Hayır | Yeni şablonda açıktır. Pasif şablonlar PDF oluştururken listelenmez. |
| **Varsayılan** | Hayır | PDF oluştururken önce bu şablon seçilir. |
| **HTML İçerik** | Evet | Teklif PDF'inin HTML içeriği. |

> [!NOTE]
>
> Klinikte tek bir varsayılan şablon olur. Bir şablonu **Varsayılan** yaptığınızda öncekinin işareti otomatik kalkar.

### Değişkenler

**Değişkenler** listesinde bir değişkene tıklarsanız `%customer_name%` gibi yer tutucu, imlecin bulunduğu yere eklenir. Satırdaki kopyalama düğmesiyle yer tutucuyu panoya da alabilirsiniz. Liste yüklenemezse **Değişken listesi yüklenemedi.** yazar; bu durumda yer tutucuları elle de yazabilirsiniz.

| Grup | Değişkenler |
| - | - |
| Teklif | **Teklif Tarihi** (`%offer_date%`), **Teklif Geçerlilik Tarihi** (`%offer_valid_until%`), **Teklif Notu** (`%notes%`) |
| Şirket | **Şirket Adı** (`%company_name%`), **Şirket Adresi** (`%company_address%`), **Şirket E-posta** (`%company_email%`), **Şirket Telefon Numarası** (`%company_phone_number%`) |
| Hasta | **Müşteri Adı** (`%customer_name%`), **Müşteri Adresi** (`%customer_address%`), **Müşteri E-posta** (`%customer_email%`), **Müşteri Telefon Numarası** (`%customer_phone_number%`) |
| Kalem | **Ürün Adı** (`%product_name%`), **Ürün Açıklaması** (`%product_description%`), **Ürün Miktarı** (`%product_quantity%`), **Ürün Birim Fiyatı** (`%product_price%`), **Ürün İndirim Oranı** (`%product_discount_rate%`), **Ürün İndirim Tutarı** (`%product_discount%`), **Ürün Vergi Oranı** (`%product_tax_rate%`), **Ürün Vergi Tutarı** (`%product_tax%`), **Ürün Toplam Tutarı** (`%product_total%`) |
| Toplam | **Ara Toplam** (`%sub_total_price%`), **Toplam İndirim** (`%total_discount%`), **Toplam Vergi** (`%total_tax%`), **Genel Toplam** (`%total_price%`) |

> [!WARNING]
>
> Kalem değişkenleri yalnızca `<!-- product_lines_start -->` ile `<!-- product_lines_end -->` arasındaki tekrar eden blokta doldurulur. Blok, teklifteki her kalem için bir kez yinelenir. Kalem değişkenini bu bloğun dışında kullanırsanız dolmaz.

Değişken adlarındaki "Müşteri" etiketi arayüzde böyle yazar; değişken teklifin hastasının bilgisini getirir.

### Canlı önizleme

**Önizleme** bölümü, içeriği yazmayı bıraktıktan kısa süre sonra kendini yeniler. İçerik boşsa **İçerik girdiğinizde önizleme burada görünecek.** yazar. Önizleme hazırlanamazsa **Önizleme oluşturulamadı.** uyarısı çıkar.

* **Örnek Teklif** seçmezseniz içerik değişkenler doldurulmadan, yazdığınız hâliyle gösterilir.
* Bir teklif seçerseniz değişkenler o teklifin bilgileriyle dolar. Listede teklifler `#12 · Ayşe Yılmaz` gibi numara ve hasta adıyla görünür. Bu seçim için `Görüntüle: Teklif` izniniz olmalıdır; yoksa seçim kutusu görünmez.
* Önizleme güvenli, yalıtılmış bir çerçevede çizilir. İçerideki komut dosyaları (script) çalışmaz.

## Sistem şablonu koruması

Her klinikte hazır gelen bir sistem şablonu vardır ve listede **Sistem** etiketi taşır. Sistem şablonunu düzenleyebilirsiniz ama silemezsiniz.

* Sistem şablonunun satır menüsünde **Sil** görünmez.
* Silme yine de denenirse (örneğin API üzerinden) sunucu isteği reddeder ve `OFFER_TEMPLATE_SYSTEM_PROTECTED` hata kodunu (HTTP 422) döndürür. Panelde bu durum **Sistem şablonu silinemez.** uyarısıyla gösterilir.

Sistem olmayan bir şablonu silmek için satır menüsünden **Sil**'i seçip onay penceresinde **Şablonu sil** başlığıyla açılan onayı verin. Silinemezse **Teklif şablonu silinemedi.** uyarısı çıkar.

> [!TIP]
>
> Sistem şablonunu doğrudan değiştirmek yerine içeriğini kopyalayıp yeni bir şablon oluşturabilirsiniz. Böylece hazır şablon, ihtiyaç olduğunda başvuracağınız bir kaynak olarak kalır.

## PDF oluştururken şablon seçme

Teklifin **PDF Oluştur** işlemi bir şablon kullanır.

1. Teklif satırının menüsünden ya da teklif detay sayfasından **PDF Oluştur**'a tıklayın.
2. Açılan pencerede **Şablon** listesinden bir şablon seçin. Yalnızca **Aktif** şablonlar listelenir, varsayılan şablon `(Varsayılan)` ekiyle görünür ve önceden seçilidir.
3. **PDF Oluştur**'a tıklayın. PDF arka planda hazırlanır; hazır olunca bildirim alırsınız ve dosya teklifin **PDF'ler** bölümünde görünür.

Aktif şablon yoksa pencere `Aktif şablon bulunamadı; klinik varsayılanı kullanılacak.` der. Şablon listesini görmeniz için `Görüntüle: Teklif Şablonu` izni gerekir; izniniz yoksa **Şablon** listesi hiç görünmez ve klinik varsayılanı kullanılır. Adımların ayrıntısı için [Teklif PDF'i oluşturma](https://docs.flextell.ai/panel/teklifler/olusturma-ve-satisa-donusturme.md#teklif-pdfi-oluşturma) bölümüne bakın.

> [!NOTE]
>
> Kliniğinizde aktif bir şablon tanımlı değilse PDF oluşturulamaz. Bir şablonu **Pasif** yapmadan önce başka bir aktif şablonunuz olduğundan emin olun.

## İzinler

Şablon izinleri rol editöründe **Teklif Şablonları** grubunda durur. Rolleri düzenlemek için [Roller](https://docs.flextell.ai/panel/sistem/roller.md), tüm izinlerin listesi için [İzin kataloğu](https://docs.flextell.ai/panel/sistem/izin-katalogu.md) sayfasına bakın.

| İzin | Açtığı ekran veya işlem |
| - | - |
| **Görüntüleme** (`View:OfferTemplate`) | **Teklif Şablonları** menüsü ve listesi. PDF oluştururken **Şablon** listesi de bu izne bağlıdır. |
| **Oluşturma** (`Create:OfferTemplate`) | **Yeni Şablon**. Editör için **Görüntüleme** ile birlikte gerekir. |
| **Güncelleme** (`Update:OfferTemplate`) | **Düzenle** ve editörde değişiklik kaydetme. Editör için **Görüntüleme** ile birlikte gerekir. |
| **Silme** (`Delete:OfferTemplate`) | **Sil**. Sistem şablonu için hiçbir rolde görünmez. |

## İlgili sayfalar

> [card] [Teklifler](https://docs.flextell.ai/panel/teklifler/genel-bakis.md)
>
> Teklif listesi, durumlar ve filtreler.

> [card] [Teklif oluşturma ve satışa dönüştürme](https://docs.flextell.ai/panel/teklifler/olusturma-ve-satisa-donusturme.md)
>
> Kalemler, PDF oluşturma ve satışa dönüştürme.


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