Common Servisi Kullanım Kılavuzu

Aşağıda, common modülünde kullanılan tüm alanlar, açıklamaları ve (varsa) zorunluluk bilgileriyle birlikte listelenmiştir.

👉 Önemli Daha kapsamlı açıklama için ilgili Common Servisi Danışmanlık Dokümanı sayfasına bakabilirsiniz.

Ülke Tanımları

Sistem üzerinde kullanılacak ülkelerin kod, ad, gümrük kodu gibi temel bilgilerinin tanımlandığı ve yönetildiği alandır. Ülkeler aktif/pasif duruma alınabilir, onay süreçleri takip edilebilir.

Alanlar	Alan Açıklamaları
Kod	Ülkenin tanımlandığı alandır. Her ülkeye özgü bir kod bilgisi içerir. Zorunlu alandır.
Adı	Ülkenin açıklayıcı ismidir. Zorunlu alandır. Örneğin, “Türkiye”, “Almanya” gibi ülke isimleri burada yer alır.
Gümrük Kodu	Ülke için kullanılan sayısal koddur. Genellikle gümrük işlemlerinde kullanılır. Örneğin, 792 Türkiye için olabilir.
Pasif Mi?	Bu alan, ülke bilgisinin aktif olarak kullanılıp kullanılmadığını belirtir.
Pasiflendirme Tarihi	Ülke kaydının ne zaman pasifleştirildiğini gösterir. Eğer ülke bilgisi kullanım dışı bırakılmışsa, bu alanda tarih bilgisi yer alır.
Onay Durumu	Ülke kaydı ile ilgili sürecin onaylanıp onaylanmadığını belirtir.
Proses Bilgisi	Ülke kaydının bağlı olduğu iş sürecine ait bilgidir. Hangi sürece dahil olduğunu gösterir.

İl Tanımları

İllerin sisteme tanımlandığı ve yönetildiği alandır. Her ile ait kod, isim, bağlı olduğu ülke bilgisi gibi veriler girilir. İller aktif veya pasif duruma alınabilir, onay süreçleri takip edilebilir.

Alanlar	Alan Açıklamaları
Ülke Kodu	İlin bağlı olduğu ülkenin sistemdeki tanımıdır. Ülke seçimi buradan yapılır. Zorunlu alandır.
Kodu	İl için tanımlanan özel koddur. Her il için benzersiz bir kod girilir. Zorunlu alandır.
Adı	İlin tam adıdır. Zorunlu alandır. Örneğin, “İstanbul”, “Ankara” gibi.
Pasif Mi?	İl kaydının sistemde aktif olarak kullanılıp kullanılmadığını gösterir.
Pasiflendirme Tarihi	İl bilgisinin ne zaman pasif hale getirildiğini gösterir.
Onay Durumu	İl kaydına ait işlem sürecinin onay durumudur.
Proses Bilgisi	İlin dahil olduğu iş sürecini tanımlar. Kayıt hangi süreçle ilişkiliyse burada belirtilir.

İlçe Tanımları

İlçelerin sisteme tanımlandığı ve yönetildiği alandır. Her ilçeye ait kod, isim, bağlı olduğu il ve ülke bilgileri girilir. İlçeler aktif/pasif duruma getirilebilir ve onay süreçleri izlenebilir.

Alanlar	Alan Açıklamaları
Ülke Kodu	İlçenin bağlı olduğu ülkenin sistemdeki tanımıdır. Ülke seçimi buradan yapılır. Zorunlu alandır.
İl Kodu	İlçenin bağlı olduğu ilin sistemdeki tanımıdır. İl seçimi bu alan üzerinden yapılır. Zorunlu alandır.
Kodu	İlçeye özel tanımlanan koddur. Zorunlu alandır. Her ilçeye ait benzersiz bir kod girilir.
Adı	İlçenin tam ismidir. Zorunlu alandır. Örneğin, “Kadıköy”, “Kartal” gibi.
Pasif Mi?	İlçe kaydının sistemde aktif olarak kullanılıp kullanılmadığını gösterir.
Pasiflendirme Tarihi	İlçe bilgisinin ne zaman pasif duruma getirildiğini belirtir.
Onay Durumu	İlçeyle ilgili tanım sürecinin onay durumudur.
Proses Bilgisi	İlçenin dahil olduğu iş sürecini tanımlar. Hangi işlem süreci ile bağlantılı olduğu bu alanda yer alır.

Bölge Tanımları

Sistemde kullanılacak bölgelerin tanımlandığı ve yönetildiği alandır. Her bölgeye ait kod ve ad bilgileri girilir. Bölgeler aktif/pasif duruma alınabilir ve onay süreçleri izlenebilir.

Alanlar	Alan Açıklamaları
Kodu	Bölgeye özel olarak tanımlanan kod bilgisidir. Her bölge için benzersiz bir kod girilir. Zorunlu alandır.
Adı	Bölgenin tam adıdır. Örneğin, “Ege Bölgesi”, “Marmara Bölgesi” gibi isimler burada yer alır. Zorunlu alandır.
Pasif Mi?	Bölge kaydının sistemde aktif olarak kullanılıp kullanılmadığını belirtir.
Pasiflendirme Tarihi	Bölge bilgisinin pasif duruma getirildiği tarihi gösterir.
Onay Durumu	Bölge kaydının tanım sürecinin onay durumudur.
Proses Bilgisi	Bölge kaydının dahil olduğu iş sürecini gösterir. İlgili işlemle bağlantılı süreç bilgisini içerir.

Departman Tanımları

Departmanlara ait temel bilgilerin tanımlandığı ve yönetildiği sayfadır. Her departmanın kodu, adı ve durumu bu alandan kontrol edilir. Gerekirse pasif hale getirilebilir ve onay süreci izlenebilir.

Alanlar	Alan Açıklamaları
Kodu	Departmana özel olarak tanımlanan kod bilgisidir. Her departman için benzersiz bir kod girilir. Zorunlu alandır.
Adı	Departmanın tam adıdır. Zorunlu alandır. Örneğin, “İnsan Kaynakları”, “Muhasebe” gibi.
Pasif Mi?	Departman bilgisinin sistemde aktif olarak kullanılıp kullanılmadığını belirtir.
Pasiflendirme Tarihi	Departmanın ne zaman pasif duruma alındığını gösterir.
Onay Durumu	Departman bilgisine ait işlem sürecinin onay durumudur.
Proses Bilgisi	Departman tanımıyla ilişkili işlem sürecini gösteren alandır. İlgili süreç bilgisi burada tutulur.

Döviz Tanımları

Sistemde kullanılacak para birimlerinin tanımlandığı ve yönetildiği alandır. Her dövize ait kod, ad ve numara bilgileri bu sayfada girilir. Döviz kayıtları gerektiğinde pasifleştirilebilir ve onay süreci takip edilebilir.

Alanlar	Alan Açıklamaları
Kodu	Dövize ait uluslararası kısa kod bilgisidir. Zorunlu alandır. Örneğin: USD, EUR, GBP gibi.
Adı	Döviz biriminin tam adıdır. Zorunlu alandır. Örneğin: Amerikan Doları, Euro, İngiliz Sterlini gibi.
No	Dövize ait 3 haneli uluslararası numaradır. Örneğin: USD için 840, EUR için 978 gibi.
Pasif Mi?	Döviz bilgisinin sistemde aktif veya pasif olduğunu belirten alandır.
Pasiflendirme Tarihi	Döviz tanımının ne zaman pasif duruma alındığını gösterir.
Onay Durumu	Döviz kaydına ait işlem sürecinin onay durumunu gösterir.
Proses Bilgisi	Döviz kaydının ilişkili olduğu işlem sürecini belirten alandır.

Firma Sabitleri

Firmanın sistemde kullanacağı sabit dil, döviz ve alternatif para birimi ayarlarının tanımlandığı bölümdür. Bu bilgiler, işlem belgelerinde varsayılan olarak kullanılır ve bazı alanlar kullanıcı tarafından değiştirilemez şekilde sabitlenmiştir.

Alanlar	Alan Açıklamaları
Firma Varsayılan Dili	Firma için sistemde kullanılacak sabit dil bilgisidir. Değiştirilemez.
Firma Döviz Kodu	Firma için belirlenmiş sabit para birimidir. Sistem işlemlerinde temel para birimi olarak kullanılır. Değiştirilemez.
Alternatif Döviz Kodu-1	Belge üzerindeki döviz kodu dışında, fiyat ve tutar bilgisinin ayrıca tutulacağı ilk alternatif para birimidir.
Alternatif Döviz Kodu-2	İkinci alternatif para birimidir. Farklı versiyonlar veya ihtiyaçlar için kullanılabilir.
Alternatif Döviz Kodu-3	Üçüncü alternatif para birimidir. Genişletilmiş finansal raporlama ya da özel hesaplamalar için kullanılabilir.
Alternatif Döviz Kodu-4	Dördüncü alternatif para birimidir. Gerekli durumlarda tanımlanabilir ve sistemsel karşılığı olan para birimleriyle eşleştirilir.
Döviz Çevrim Türü	Döviz işlemlerinde fiyatın hangi tür kur üzerinden çevrileceğini belirten alandır. Alış, satış, efektif ya da serbest kur seçenekleri içinden seçim yapılır.
Kod Değişim Kontrolü	Kullanıcının sistemde kodları değiştirip değiştiremeyeceğini belirleyen kontrol alanıdır.

Günlük Kur Girişi

Günlük döviz kurlarının sisteme tanımlandığı alandır. Merkez Bankası verilerine göre döviz alış, satış ve efektif kurlar buraya girilir. Ayrıca serbest piyasa kurları da ayrı alanlarda takip edilebilir.

Alanlar	Alan Açıklamaları
Tarih	Kur girişlerinin eklendiği veya güncellendiği tarihi gösterir. Zorunlu alandır.
Döviz Kodu	Kura ait para biriminin seçildiği alandır. İlgili döviz kodu ve adı bu alan üzerinden gelir. Zorunlu alandır.
Döviz Alış	Merkez Bankası'nın günlük döviz kuru alış değeridir. Sistem işlemlerinde döviz alış fiyatı olarak kullanılır.
Döviz Satış	Merkez Bankası'nın günlük döviz kuru satış değeridir. Sistem işlemlerinde döviz satış fiyatı olarak kullanılır.
Efektif Alış	Merkez Bankası'nın belirlediği nakit döviz alış kuru değeridir. Nakit işlemlerde kullanılır.
Efektif Satış	Merkez Bankası'nın belirlediği nakit döviz satış kuru değeridir. Nakit işlemlerde kullanılır.
Serbest Alış	Serbest piyasadaki döviz alış kuru değeridir. Merkez Bankası dışında belirlenen piyasa verilerine göre girilir.
Serbest Satış	Serbest piyasadaki döviz satış kuru değeridir. Piyasa koşullarına göre girilen satış değeridir.

Lisan Tanımları

Firma tipi, adres ve iletişim bilgilerinin tanımlandığı alandır.

Alanlar	Alan Açıklamaları
Local Kodu	Global lisan tanımlarına ait 3 veya daha fazla karakterden oluşan kısa kod bilgisidir. Zorunlu alandır.
Kodu	Global lisan tanımlarına ait 2 karakterli standart koddur. Zorunlu alandır. Örnek: TR, EN, FR, DE gibi.
Adı	Dil koduna karşılık gelen açıklayıcı isimdir. Zorunlu alandır. Örnek: Türkçe, İngilizce, Fransızca, Almanca gibi.
Pasif Mi?	Lisan bilgisinin sistemde aktif olarak kullanılıp kullanılmadığını belirtir.
Pasiflendirme Tarihi	Dil tanımının ne zaman pasif duruma getirildiğini gösterir.
Onay Durumu	Lisan tanımına ait işlem sürecinin onay durumunu belirtir.
Proses Bilgisi	Dil kaydının ilişkili olduğu işlem sürecine ait bilgidir.

Şirket Tanımları

Sistemde kullanılacak dillerin tanımlandığı alandır. Her bir dil için kısa kodlar ve açıklayıcı adlar girilir. Bu bilgiler, çok dilli içerik yönetimi ve kullanıcı arayüzü gibi alanlarda kullanılır.

Alanlar	Alan Açıklamaları
Firma Tipi	Firmanın şahıs şirketi mi, tüzel şirket mi olduğunu belirtir. Şahıs şirketi ise TCKN, tüzel şirket ise VKN numarası girilir. Zorunlu alandır.
Şirket Adı	Firma tipi tüzel şirket ise girilen şirketin tam adıdır.
Adı	Firma tipi şahıs şirketi ise kişinin adı. Zorunlu alandır.
Soyadı	Firma tipi şahıs şirketi ise kişinin soyadı. Zorunlu alandır.
Şirket Kısa Adı	Şirketin belgelerde kullandığı kısa adıdır.
Vergi Numarası	Şirketin vergi kimlik numarasıdır. Şahıs şirketi için TCKN, tüzel şirket için VKN girilir. Zorunlu alandır.
Vergi Dairesi	Şirketin bağlı olduğu vergi dairesi bilgisidir. Zorunlu alandır.
Tabela Ünvanı	Şirketin ticari işletmesinde kullandığı unvandır.
Ülke	Şirketin adresinin bağlı olduğu ülke. Zorunlu alandır.
İl	Şirketin adresinin bağlı olduğu il. Zorunlu alandır.
İlçe	Şirketin adresinin bağlı olduğu ilçe. Zorunlu alandır.
Bölge	Şirketin adresinin bağlı olduğu bölge.
Sokak Adı	Şirketin adres bilgisi (cadde, mahalle, sokak vb.). Zorunlu alandır.
Bina Numarası	Şirketin bulunduğu binanın kapı numarası. Zorunlu alandır.
Bina Adı	Şirketin bulunduğu binanın adı.
Posta Kodu	Şirketin bulunduğu lokasyonun posta kodu.
Bina İç Kapı Numarası	Şirketin bulunduğu binanın iç kapı numarası.
Telefon Numarası	Şirkete ait telefon numarası. Zorunlu alandır.
Sabit Telefon Numarası	Şirkete ait sabit telefon numarası.
E-posta	Şirkete ait e-posta adresi. Zorunlu alandır.
Faks	Şirkete ait faks numarası.
Web Sitesi	Şirkete ait web sitesi adresi.
NACE Kodu	Şirketin faaliyet alanını belirten altı haneli kod.
Mersis No	Şirketin ticaret sicil dijital kayıt numarası.
Ticaret Sicil No	Şirketin ticaret sicil kayıt numarası.
Şirket Logosu	Şirket logosunun dosya yolu bilgisi.
Onay Durumu	Firma bilgileri için işlem onay durumudur.
Proses Bilgisi	Firma kaydına ilişkin işlem süreç bilgisidir.

Grup Kaynak Tanımları

Grup kaynakları, verilerin hangi iş alanı, departman veya süreç için kullanıldığını belirlemek amacıyla oluşturulan sınıflandırmalardır. Bu tanımlar, stok, satış, üretim veya maliyetlendirme gibi farklı kaynakların ayrı ayrı takip edilmesini ve raporlanmasını sağlar.

Alanlar	Alan Açıklamaları
Grup Kaynak Kodu:	Grup kaynak tanımlarının yapıldığı, kod bilgisinin tutulduğu alandır. Zorunlu alandır.
Grup Kaynak Adı:	Grup bilgilerinin hangi kaynaktan oluşturulduğu bilgisidir. Örneğin stoklar satış için ayrı, üretim için ayrı gibi farklı gruplara ayrılabilir. Zorunlu alandır.
Ana Grup Kaynak Adı:	Birden fazla grup kaynağı olduğunda, bunların üst grup adı ile daha kolay takip edilmesi için kullanılan yardımcı üst grup adıdır.
Pasif Mi?:	Grup kaynak aktif değilse pasif olarak işaretlenir. “0=Hayır” aktif, “1=Evet” pasif anlamına gelir.
Pasiflendirme Tarihi	Grup kaynak tanımının ne zaman pasif duruma getirildiğini gösterir.
Onay Durumu	Grup kaynak tanımları için işlem onay durumudur.
Proses Bilgisi:	İşlemle ilişkili proses bilgisi.

Grup Kod Tanımları

Bu yapılar, farklı ana tanımları (örneğin stok kartı, cari kartı vb.) kaynak bazında sınıflandırmak ve hiyerarşik ağaç yapısı içinde organize etmek için kullanılır. Grup kaynakları sayesinde, veriler ilgili programlarda kaynaklarına göre ayrılır, gruplanır ve yetkilendirme süreçleri tamamlanır. Gruplar, kendi içinde üst-alt ilişkileriyle ağaç yapısı oluşturur; böylece detaylı ve katmanlı raporlama ve takip sağlanabilir. Her grup benzersiz bir kod ve isimle tanımlanır, aynı grup kodu birden fazla kullanılamaz.

Alanlar	Alan Açıklamaları
Grup Kaynak Bilgisi	Grup kaynağının benzersiz kimlik numarasıdır. Grupları kaynağa bağlayarak istenildiği kadar grup oluşturulabilir. Bu bilgi yetkilendirme sürecinde de kullanılır. Zorunlu alandır.
Grup Kodu	Grubun sınıflandırılması için kullanılan kod bilgisidir. Boş bırakılamaz ve aynı kod başka bir grup için kullanılamaz. Zorunlu alandır.
Grup Adı	Grubun adı olarak kullanılır. Zorunlu alandır.
Bağlı Olduğu Üst Grup	Bu grubun bağlı olduğu üst grubun kimlik numarasıdır. Ağaç yapısında üst kayıt bilgisini tutar.
Sol Node	Grubun alt kırılımlarında kapsadığı en küçük sıra numarasıdır.
Sağ Node	Grubun alt kırılımlarında kapsadığı en büyük sıra numarasıdır.
Ağaç Kimliği	Grubun ait olduğu ağaç yapısının kimlik numarasıdır. Master node bazında verilir.
Üst Grup ID-1	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-2	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
**Üst Grup ID-3 **	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-4	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-5	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-6	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-7	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-8	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-9	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.
Üst Grup ID-10	Grubun bağlı olduğu üst grup bilgilerinin sırasıyla tutulduğu alanlardır.

Format Tanımları

Kullanıcının kaydettiği formatın hangi sayfaya ait olduğunu belirtir. Örneğin, bir modül veya ekran için özel format tanımıdır.

Alanlar	Alan Açıklamalar
Kullanıcı Bilgisi	Json web token üzerinden kullanıcıya ait benzersiz kimlik numarasıdır.
Sayfa Bilgisi	Kaydedilen formatın hangi sayfaya ait olduğunu belirtir.
Format Adı	Kullanıcının formatı kaydederken verdiği isimdir.
Varsayılan Format	Formatın varsayılan olarak seçilip seçilmediği bilgisi tutulur.
Opsiyon Json1	Gönderilen json format bilgisinin ilk 4000 karakteri metin olarak saklanır.
Opsiyon Json2	Gönderilen json format bilgisinin ikinci 4000 karakteri metin olarak saklanır.
Opsiyon Json3	Gönderilen json format bilgisinin üçüncü 4000 karakteri metin olarak saklanır.

Ekran Tasarımı

Bu sayfa, programların ekran tasarımlarında kullanılan alanların detaylı tanımlarının yapıldığı alandır. Her program için alanlar, isimleri, açıklamaları, görünürlük ve yetki bilgileri, veri giriş kuralları gibi özellikler bu sayfada belirlenir. Böylece programlarda yer alan formlar ve tablolar dinamik ve kontrollü bir şekilde yapılandırılır. Kullanıcı yetkilerine göre hangi alanların görüntülenip düzenlenebileceği, zorunlu alanların hangileri olduğu ve alanların nasıl görüneceği bu alanda tanımlanır. Ayrıca, form içindeki sekmelerin isimleri ve sıralamaları da buradan yönetilir.

Alanlar	Alan Açıklaması
Program Adı	Ekran tasarımı yapılacak programın adı. Örneğin stok kartı, cari kartı gibi.
Alan ID	Programdaki alanın benzersiz kimlik numarası.
Tip	Programdaki alanın tipi, örneğin stok tipi ya da cari tipi.
Alan Adı	Programda yer alan alanın adı. Veritabanındaki başlıklar kullanılır.
Alan Açıklaması	Alanla ilgili uzun ve anlaşılır açıklama.
Grid Başlığı	Ekranda tablolarda alanın başlığı. Dinamik olarak gösterilir.
Giriş/Düzeltme Yetki Grubu	Bu alan üzerinde veri girişi veya düzeltme yapma yetkisi olan grup.
Görme Yetkisi Grubu	Bu alanı görüntüleme yetkisi olan grup.
Pop-up Görünme Sırası	Pop-up ya da form açıldığında alanın hangi sırada görüneceği.
Tab Başlığı	Form içinde yer alan sekmelerin başlıkları.
Tab Sırası	Sekmelerin formda hangi sırada görüneceği.
Gösterilmesin	Bu alan formda ya da tabloda gösterilmesin mi?
Zorunlu Alan mı?	Bir alana zorunluluk özelliği verebilir bu özelliği ondan geri alabilmeyi sağlar.
Eksi Veri Girişine İzin Ver	Bu alana “negatif (eksi) değer girilebilir mi?” yetkisinin verildiği alandır.
Kayıt Sonrası Alan Verisi Kalsın	Yeni kayıt girildiğinde önceki seçilen veri temizlenmesin mi?
Düzeltmede Değiştirilemesin	Veri düzenleme modunda bu alan değiştirilemez olsun mu?
Filtreleme Açık mı?	Bu alan üzerinde filtreleme yapılabilir mi?
Birincil Alan mı?	Bu alan kayıtları benzersiz şekilde tanımlayan alan mı?
Hizalama	Alan içeriği nasıl hizalansın? (Ortala, sola yasla, sağa yasla)
Format	Alan verisi ekranda nasıl biçimlendirilsin?
Genişlik	Alan genişliği (piksel ya da yüzde olarak).
Mesaj Anahtarı	Doğrulama hatalarında çıkacak mesaj.
Arama URL'si	Arama alanlarında seçilebilecek değerleri kısıtlayan adres.
Bilgiyi Gösterim Yeri	Alan bilgisi nerede görünsün?
Bağlanacak Tab Adı	Formdaki sekme adı.
Bağlanacak Tab Sırası	Sekmenin formdaki gösterim sırası.
Veri Uzunluğu	Alan için izin verilen maksimum karakter sayısı.
Sütun Sırası	Tabloda bu alanın kaçıncı sütun olduğu.
Varsayılan Sıralama	Tabloda hangi alana göre varsayılan sıralama yapılacak.
Değişikliğe İzin Verme (Listede Değer Varsa)	Listede seçili alanda veri varsa, bu alan değiştirilemesin.
Minimum Karakter Uzunluğu	Bu alan için girilecek minimum karakter sayısı.
Maksimum Karakter Uzunluğu	Bu alan için girilecek maksimum karakter sayısı.