Alan Şablonu: Yerleşimi Bir Kez Kurun, Her Belgeye Uygulayın

Bazı işlerde belge her seferinde değişir ama alanların yeri değişmez: her ay farklı bir hizmet sözleşmesi, her müşteriye ayrı bir teklif, her personele farklı bir tutanak. Böyle durumlarda Alan Şablonu kullanın. Şablonda belge saklanmaz, yalnızca alanların nereye düşeceğini anlatan kurallar saklanır.

İki şablon türü var:

	Belgeli Şablon	Alan Şablonu
Belge	Şablonun içinde saklanır, her gönderimde aynı belge kullanılır	Her gönderimde siz yüklersiniz, farklı olabilir
Alanlar	Belgenin üzerinde sabit koordinatta durur	Kurala göre yeni belgeye yeniden yerleştirilir
Kullanım	Metni değişmeyen sözleşmeler	Metni değişen, düzeni benzer belgeler

Belgeniz her seferinde aynıysa Alan Şablonu’na gerek yok: Şablon Oluşturma ve Yönetimi sayfasındaki normal şablon akışı daha az adımdır.

1. Alan Şablonu oluşturma

Sol menüden Şablonlar sayfasına gidin, “Yeni Şablon” düğmesine basın. Açılan “Yeni Şablon Oluştur” penceresinde iki seçenek çıkar; “Alan Şablonu” seçeneğini seçin.

Sonraki adımlar normal şablonla aynıdır: belge yükleme, roller, editör. Fark, yüklediğiniz belgenin ne işe yaradığındadır.

2. Referans belge

Alan Şablonunda yüklediğiniz belge referans belgedir. Ekranda yalnızca alanları görerek yerleştirebilmeniz için durur, hiçbir imzacıya gönderilmez.

Editörde bu bilgi bir bilgi şeridiyle hatırlatılır. İki noktaya dikkat edin:

• Mümkünse boş veya kişisel bilgileri çıkarılmış bir örnek yükleyin.
• Yüklediğiniz belgede üçüncü kişilerin verisi varsa, aydınlatma ve hukuki sebep sorumluluğu size aittir.

Şablon detay sayfasındaki Referans belge kartından belgeyi kaldırabilirsiniz. Kaldırma kalıcıdır ve geri alınamaz: belge ve sayfa görüntüleri silinir. Alan yerleşiminiz çalışmaya devam eder, ancak alanları bir daha belge üzerinde göremeyeceğiniz için görsel düzenleme yapamazsınız.

3. Alan konumu kuralı

Alan Şablonunda her alan için “Alan Konumu Kuralı” seçersiniz. Dört kural var:

• Belirli sayfa: Alan her belgede aynı sayfa numarasına yerleşir (örneğin 1. sayfa).
• Sondan sayarak sayfa: Sayfa sayısı değişen belgeler için. 0 son sayfa, 1 sondan bir önceki sayfa demektir.
• Her sayfa: Alan belgenin her sayfasına kopyalanır. Sayfa başına iz almak için kullanılır.
• Metin çapası: Alan, belgede aradığınız metnin bulunduğu noktaya yerleşir.

Metin çapası kullanırken

Çapa metni şablonda saklanır ve her yeni belgede aranır. Bu yüzden belgede sabit kalan bir başlık veya etiket seçin (örneğin TARAFLARIN İMZALARI). Kişiye özgü ifadeler (ad, soyad, kimlik numarası, e-posta) bir sonraki belgede bulunamaz; editör bu tür bir satır seçtiğinizde sizi uyarır.

Çapa metnini elle yazabilir ya da “Belgeden satır seç” ile referans belgedeki satırlara tıklayarak seçebilirsiniz. Metin birden çok kez geçiyorsa hangi eşleşme kullanılacağını seçersiniz: İlk eşleşme, Son eşleşme veya Her eşleşme.

İmza alanlarına özel kurallar

İmza alanı, diğer alanlardan daha katı kurallara tabidir:

• Her sayfa kuralıyla kopyalanamaz. Sayfa başına iz istiyorsanız paraf alanı kullanın.
• Çapa metninin her eşleşmesine kopyalanamaz.
• Çapa bulunamazsa işlem durur. İmza alanında “alanı atla” veya “yedek konuma koy” seçeneği yoktur; imza alanı yanlış yere düşmektense hiç düşmemelidir.

4. Yeni bir sözleşmede uygulama

Sözleşme oluştururken belgenizi yükleyin, Taraflar adımını tamamlayın ve editör adımına geçin. Sağ panelde “Alan şablonu uygula” düğmesi vardır.

1. Kayıtlı alan şablonunu seçin.
2. Şablondaki rolleri bu sözleşmenin taraflarıyla eşleştirin.
3. “Uygula” deyin.

Alanlar sunucuda belgeye yerleştirilir ve editör yeniden yüklenir.

Bu eylem masaüstü ekranlarda görünür. Uygulamadan sonra alanların yerini gözle kontrol etmeniz gerekir ve bu kontrol dar bir telefon ekranında güvenilir biçimde yapılamaz. Gönderim adımı telefonda da açıktır, yalnız bu toplu yerleştirme eylemi masaüstündedir.

5. Göndermeden önce kontrol edin

Uygulama sonrası ekranda bir hatırlatma çıkar: alanların yerini göndermeden önce kontrol edin, gerekirse elle düzeltin. Sistem yerleşimi hesaplar, doğru yere düştüğünü doğrulamaz. Yerleşimin belgenize uygunluğunun kontrolü size aittir.

İmzala, gördüğü sorunları uyarı ve hata olarak listeler. Sık karşılaşılanlar:

• Belirlenen sayfa bu belgede yok (belge daha kısa).
• Çapa metni belgede bulunamadı.
• Sayfada metin katmanı yok, belge taranmış görüntü olabilir. Böyle sayfalarda metin çapası çalışmaz, sayfa çapasına geçin.
• Alan sayfa dışına düştü veya kenara taştığı için kırpıldı.
• İki alan üst üste biniyor ya da alan belge metninin üzerine geliyor.
• Alan, belgedeki mevcut bir form alanı veya bağlantının üzerine geliyor. İmza bu konuma yerleştirilemez.
• İmza kutusu hedef belgeye sığması için küçültüldü ya da okunamayacak kadar küçük kaldı.
• Bir tarafa hiç imza alanı yerleşmedi. Bu bir hatadır, belge gönderilemez.
• Belge parola korumalı. Korumayı kaldırıp yeniden yükleyin.

Hata varsa gönderim durur. Uyarıda gönderim mümkündür, ama önce bakın.

6. Alan Şablonu ile toplu gönderim

Bu şablon türünde toplu gönderim, Excel satırlarından değil yüklediğiniz belgelerden üretilir: her belge ayrı bir sözleşme olur.

Şablon detay sayfasındaki Toplu Sözleşme sekmesinden “Yeni toplu gönderim” ile başlayın.

1. Belgeleri yükleyin. Yalnızca PDF kabul edilir.
2. Alıcıları belirleyin. İki yol var:
   • Excel listesi: Örnek dosyayı indirin, doldurun, geri yükleyin. İlk sütun dosya_adi olmalıdır; her satır o adı taşıyan belgeye bağlanır.
   • Yeni alıcı listesi: Tüm belgeler aynı taraflara gider.
3. Önizlemeyi çalıştırın. Her belge için durum çıkar: Uygulandı, Uyarı, Hata. Alıcısı eşleşmeyen belgeler ve hiçbir belgeye eşleşmeyen alıcı satırları ayrıca listelenir. Sorunlu belgeler gönderilmez.
4. Önizlemeyi onaylayın. “Önizlemeyi inceledim; belgelerin ve alıcıların doğru olduğunu onaylıyorum” kutusunu işaretlemeden gönderim oluşturulmaz.
5. Gönderimi oluşturun. Bir gönderim adı ve gönderim aralığı (5 ile 300 saniye arası) verin.

Kredi, gönderim oluşturulurken ve yalnızca gönderilecek belgeler için ayrılır. Atlanan belgeler kredi harcamaz. Bakiye yetmezse gönderim oluşturulmaz.

Belgesi sabit bir şablondan Excel satırlarıyla toplu gönderim yapmak istiyorsanız: Toplu Belge Gönderimi.

7. Sınırlar

• Bir toplu gönderimde en fazla 1.000 belge.
• Günlük 2.000 belge (kullanıcı başına).
• Toplu gönderimde yalnızca PDF. Word ve benzeri formatlar bu yolda kabul edilmez, çünkü PDF’e çevrilirken sayfa düzeni değişebilir ve sayfa numarasına dayanan kurallar yanlış sayfaya düşebilir.
• Alıcı listesi (Excel) en fazla 10 MB.
• Onaylanmayan yüklemeler 48 saat sonra temizlenir.

8. API ile kullanım

Alan Şablonu, dış API’den de kullanılabilir:

• Uygulayarak sözleşme oluşturma: POST /api/v1/demands/upload çağrısına field_template_id ekleyin. Yüklenen dosya PDF olmalı ve her taraf template_party_id (şablon rolü) taşımalıdır.
• Kuru koşum (önizleme): POST /api/v1/field-templates/{id}/preview-layout yerleşimin bir PDF’e nasıl uygulanacağını döner. Sözleşme oluşturmaz, kredi düşmez.

Yerleşim çözülemezse çağrı 422 döner ve sözleşme oluşturulmaz, kredi düşülmez. Alan Şablonları GET /api/v1/templates listesinde görünmez ve POST /api/v1/demands ile kullanılamaz; bu şablon türünün belgesi yoktur, belge her çağrıda yüklenir.

Uçların tam sözleşmesi, hata kodları ve örnek gövdeler için: API Dokümantasyonu.

---

Alan Şablonu oluşturmak için: Şablonlar sayfası.