TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ -...
Transcript of TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ -...
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ TEKNĐK DOKÜMANI
Değişiklik Numarası: 1.6
26/12/2012
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
2/47 HĐZMETE ÖZEL
ĐÇĐNDEKĐLER1 TABLO LĐSTESĐ .................................................................................................................... 4
TANIMLAR ......................................................................................................................... 6
KISALTMALAR .................................................................................................................. 6
1. AMAÇ ......................................................................................................................... 7
2. GENEL SÜREÇ VE KULLANILACAK SERVĐSLER .................................................... 8
3. SERVĐS ORTAK YAPILARI ........................................................................................ 9
3.1. Servis Yapısı ....................................................................................................... 9
3.2. Erişim .................................................................................................................. 9
3.3. Kimlik Doğrulama ................................................................................................. 9
3.4. Geri Dönüş Tipleri ................................................................................................ 9
3.5. “Header” Kullanımı ..............................................................................................10
4. GBS Headar’ları .........................................................................................................12
5. DBBS Header’ları ......................................................................................................13
6. SÜREÇ ADIMLARI VE KULLANILACAK METODLAR ...............................................14
6.1. Kimlik Doğrulama ................................................................................................14
6.2. Defter Liste Đşlemleri ...........................................................................................15
6.2.1. Defter Liste Kaydı Oluşturulması .....................................................................15
6.2.2. Defter Liste Kayıtlarının Sorgulanması ............................................................16
6.2.3. Defter Liste Kaydının Silinmesi ........................................................................17
6.3. Defter Kaydı Đşlemleri..........................................................................................18
6.3.1. Mükellef ve Defter Bilgilerinin Kaydedilmesi ....................................................18
6.3.2. Mükellef Defterlerinin (Takım) Kayıt Edilmesi ..................................................20
6.3.3. Defter Listesine Ait Defter Kayıtlarının Sorgulanması ......................................21
6.3.4. Defter Listesine Ait Defter Takım Kayıtlarının Sorgulanması ...........................22
6.3.5. Defter Kaydının Güncellenmesi .......................................................................23
6.3.6. Defter Takımı Mükellef Güncellenmesi ............................................................24
6.3.7. Defter Kaydının Silinmesi ................................................................................25
6.3.8. Defter Takımının Silinmesi ..............................................................................26
6.4. Meşruhat.............................................................................................................27
6.4.1. Defter Listesi Meşruhat Bilgisi .........................................................................27
6.4.2. Defter Takımı Meşruhat Bilgisi ........................................................................28
6.4.3. Defter Meşruhat Bilgisi ....................................................................................29
7. KULLANICI ĐŞLEMLERĐ .............................................................................................30
7.1. SMMM Bilgi Sorgulama ......................................................................................30
7.2. SMMM Bilgi Düzenleme ......................................................................................31
8. SERVĐSLERDE KULLANILAN TĐPLER ......................................................................32
8.1. Class ..................................................................................................................32
8.1.1. DisKullaniciKimlik ............................................................................................32
8.1.2. DefterOlusturServisSonuc ...............................................................................32
8.1.3. DefterListeSorgulaServisSonuc .......................................................................33
8.1.4. DefterListeBilgi ................................................................................................33
8.1.5. MerkezBilgiSorguSonuc ..................................................................................34
8.1.6. Adres ..............................................................................................................35
8.1.7. Meslek.............................................................................................................35
1 Bu doküman, Bilgi Đşlem Müdürlüğü tarafından hazırlanan “Doküman Oluşturma Standartları” içerisinde yazılan kurallar doğrultusunda oluşturulmuştur.
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
3/47 HĐZMETE ÖZEL
8.1.8. DefterTakimBilgi ..............................................................................................36
8.1.9. Mukellef ...........................................................................................................36
8.1.10. DefterBilgi .......................................................................................................37
8.1.11. Zaman .............................................................................................................37
8.1.12. DefterListesiDefterSorgulaServisSonuc...........................................................38
8.1.13. DefterTakimListesiSorgulaServisSonuc...........................................................38
8.1.14. DefterGeciciBilgi ..............................................................................................39
8.1.15. DefterMesruatBilgiSorgulaServisSonuc ...........................................................39
8.1.16. DefterOnayYevmiyeBilgi .................................................................................40
8.1.17. MaliMusavirSorgulaServisSonuc .....................................................................41
8.1.18. MaliMusavir .....................................................................................................41
8.2. Tanımlı Tipler ......................................................................................................42
8.2.1. ProgramAdi .....................................................................................................42
8.2.2. KimlikNOTipi ...................................................................................................42
8.2.3. NPSIslemTipi ..................................................................................................43
8.2.4. GIBFaalKodlari ................................................................................................43
8.2.5. GIBSirketTurleri ...............................................................................................44
8.2.6. DefterNeviTipi .................................................................................................45
9. SERVĐS GERĐ DÖNÜŞ KODLARI ..............................................................................46
9.1. Defter Belge Bilgi Servisi (DBBS) .......................................................................46
9.2. GĐB Bilgi Servisi (GBS) .......................................................................................47
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
4/47 HĐZMETE ÖZEL
TABLO L ĐSTESĐ Tablo 1: “ServisSonuc” Sınıfı ................................................................................................. 9
Tablo 2: “ServisHataHeader” Sınıfı .......................................................................................10
Tablo 3: “ServisHata” Sınıfı ..................................................................................................10
Tablo 4: Hata Kodları ve Mesaj Açıklamaları ........................................................................11
Tablo 5: “BilgiServisHeader” Sınıfı........................................................................................12
Tablo 6: “DisBiletHeader” Sınıfı ............................................................................................13
Tablo 7: “DisBilet” Sınıfı ........................................................................................................13
Tablo 8: “DisKullaniciKimlikDogrula2” Metodu ......................................................................14
Tablo 9: “DefterListeOlustur” Metodu ....................................................................................15
Tablo 10: “DefterListeSorgula” Metodu .................................................................................16
Tablo 11: “DefterListeSil” Metodu ........................................................................................17
Tablo 12: “TuzelSahisMukellefMerkezBilgiSorgu” Metodu ....................................................18
Tablo 13: “GercekSahisMukellefMerkezBilgiSorgu” Metodu .................................................19
Tablo 14: “DefterTakimBildir” Metodu ...................................................................................20
Tablo 15: “DefterListesiDefterSorgula” Metodu .....................................................................21
Tablo 16: “DefterTakimListesiSorgula” Metodu .....................................................................22
Tablo 17: “DefterGuncelle” Metodu.......................................................................................23
Tablo 18: “DefterTakimMukellefGuncelle” Metodu ................................................................24
Tablo 19: “DefterSil” Metodu.................................................................................................25
Tablo 20: “DefterTakimSil” Metodu .......................................................................................26
Tablo 21: “DefterListeMesruatBilgiSorgula” Metodu .............................................................27
Tablo 22: “DefterTakimMesruatBilgiSorgula” Metodu ...........................................................28
Tablo 23: “DefterMesruatBilgiSorgula” Metodu .....................................................................29
Tablo 24: “MaliMusavirSorgula” Metodu ...............................................................................30
Tablo 25: “MaliMusavirSorgula” Metodu ...............................................................................31
Tablo 26: “DisKullaniciKimlik” Sınıfı ......................................................................................32
Tablo 27: “DefterOlusturServisSonuc” Sınıfı .........................................................................32
Tablo 28: “DefterListeSorgulaServisSonuc” Sınıfı .................................................................33
Tablo 29: “DefterListeBilgi” Sınıfı .........................................................................................33
Tablo 30: “MerkezBilgiSorguSonuc” Sınıfı ............................................................................34
Tablo 31: “Adres” Sınıfı ........................................................................................................35
Tablo 32: “Meslek” Sınıfı ......................................................................................................35
Tablo 33: “DefterTakimBilgi” Sınıfı ........................................................................................36
Tablo 34: “Mukellef” Sınıfı ....................................................................................................36
Tablo 35: “DefterBilgi” Sınıfı .................................................................................................37
Tablo 36: “Zaman” Sınıfı .......................................................................................................37
Tablo 37: “DefterListesiDefterSorgulaServisSonuc” Sınıfı ....................................................38
Tablo 38: “DefterTakimListesiSorgulaServisSonuc” Sınıfı ....................................................38
Tablo 39: “DefterGeciciBilgi” Sınıfı .......................................................................................39
Tablo 40: “DefterMesruatBilgiSorgulaServisSonuc” Sınıfı .....................................................39
Tablo 41: “DefterOnayYevmiyeBilgi” Sınıfı ...........................................................................41
Tablo 42: “MaliMusavirSorgulaServisSonuc” Sınıfı ...............................................................41
Tablo 43: “MaliMusavir” Sınıfı ...............................................................................................41
Tablo 44: “ProgramAdi” Tipi..................................................................................................42
Tablo 45: “KimlikNOTipi” Tipi ................................................................................................42
Tablo 46: “NPSIslemTipi” Tipi ...............................................................................................43
Tablo 47: “GIBFaalKodlari” Tipi ............................................................................................43
Tablo 48: “GIBSirketTurleri” Tipi ...........................................................................................44
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
5/47 HĐZMETE ÖZEL
Tablo 49: “DefterNeviTipi” Tipi ..............................................................................................45
Tablo 50: “DBBS” Mesajları ..................................................................................................46
Tablo 51: “GBS” Mesajları ....................................................................................................47
Not: Oluşturulan tablolarda nesneler; “Class” turuncu, “Servis” mavi, “Header” mor, “Method” ise gri renklerde gösterilmiştir.
Nesne Kullanılan renk
Servis
Header
Method
Class
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
6/47 HĐZMETE ÖZEL
TANIMLAR Kullanıcı: Defter/Belge işlemlerinin elektronik ortamda gerçekleştirilmesi kapsamında SMMM’leri ifade eder. Đstemci: Web servislerine istekte bulunacak uygulamadır. Mükellef: Kullanıcıların (SMMM’lerin) defter kayıtlarını tutmakta sorumlu oldukları vergi mükellefleridir. Defter: Mükellefe aittir. Her bir defter tasdiki noterlik işleminde bir yevmiye kaydına karşılık gelir. Takım: Bir mükellefe ait defterleri ifade eder. Defter Listesi: Kullanıcıların mükelleflerinin defter bilgilerini içine ekleyecekleri kayıttır. Bir veya birden fazla oluşturulabilir. Her defter listesi kaydının bir tekil numarası vardır. Mali müşavirler hazırlamış oldukları defter listeleri için işlem yaptırmak üzere Noterliklere gittiklerinde bu tekil numarayı belirtmeleri gerekmektedir. KISALTMALAR DBBS: Defter Belge Bilgi Servisi NPS: Noterlik Paylaşım Sistemi
KDS: Kimlik Doğrulama Servisi
TCKN: T.C Kimlik Numarası
VKN: Vergi Kimlik Numarası
GĐB: Gelirler Đdaresi Başkanlığı
SMMM: Serbest Muhasebeci Mali Müşavir
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
7/47 HĐZMETE ÖZEL
1. AMAÇ
Gelirler Đdaresi Başkanlığı’nın çıkarmış olduğu, 02.03.2011 tarih 27862 nolu resmi gazetede yayınlanan “406 SIRA NO’LU VERGĐ USUL KANUNU GENEL TEBLĐĞĐ” kapsamında yer alan “Noterler veya Noterlik Görevini Đfa ile Mükellef Olanlar Tarafından Tasdik Edilen Belgeler ve Defterlere Đlişkin Bildirimler” bölümünde belirtildiği gibi; noterliklerin tasdik ettikleri belgelerin ve defterlerin elektronik ortamda bilgilerinin hazırlanması ve bildirimlerinin gerçekleştirilmesi için gerekli görevleri servis tabanlı mimari yapısıda sağlamaktır.
Temel görevleri:
1. Tasdik edilecek defter ve belge bilgilerinin oluşturulması, dökümü alınması gereken meşruhat bilgilerinin döküme hazır şekilde sunulması.
2. Bilgileri oluşturulan defter ve belgelerinin noterliklerde gerçekleştirilecek olan tasdik aşamasında yine noterliklere sunulması.
3. Noterliklerde gerçekleştirilen tasdik işlemi sonucu oluşan yevmiye bilgilerinin Noterlik Paylaşım Sistemine bildirilmesi.
4. Noterlik Paylaşım Sistemine bildiren defter belge tasdik işlemlerine ait gerekli bilgilerin Gelir Đdaresi Başkanlığı’na bildirilmesi.
Bu temel görevler arasında 1. görev SMMM ve kullandıkları uygulamaları ilgilendirmekte olup, bu görev kapsamındaki servis metotları SMMM’lerin kullanmakta olduğu uygulamalar için hazırlanmıştır.
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
8/47 HĐZMETE ÖZEL
2. GENEL SÜREÇ VE KULLANILACAK SERV ĐSLER SMMM’ler sorumlu oldukları mükelleflere ait tasdik edilecek defter bilgilerini hazırlar ve bu bilgileri Noterliğe sunarak tasdik işlemlerini gerçekleştirirler. Tüm işlemlerin elektronik ortama taşınması ile amaçlanan; tasdik edilecek defterlere ait mükellef bilgilerinin bir merkez (GĐB Sicil Servisi) tarafından doğrulanarak oluşabilecek hata ve eksiklikleri en aza indirgemektir. Beyan edilen bu bilgilerin noterliklerde işlem yapılıp yevmiyeleri kesildikten sonra noterlik tarafından tekrar GĐB’e bildirimi gerçekleştirilecektir. Süreçte yer alan tüm işlemlerin elektronik ortamda gerçekleştirilmesi kapsamında 3 ayrı servis kullanılır.
1. Kimlik Do ğrulama Servisi (KDS): Defter kayıtlarını elektronik ortamda hazırlamak isteyen kullanıcıların (SMMM vb.) bu işlemleri gerçekleştirebilmeleri için öncelikle kimliklerin doğrulanıp gerekli onayın verileceği servistir. Onaylama sonucu istemciye bir bilet numarası (NPS Belge NO) döndürülür.
2. Defter Belge Bilgi Servisi (DBBS): Tüm defter ve belge işlemleri için kullanılan servistir. Bu servis üzerinden herhangi bir işlem gerçekleştirmek için Kimlik Doğrulama Servisi üzerinden kimlik doğrulamasının yapılıp gerekli bilgilerin alınması ve Defter Belge Bilgi Servisi’ne bu bilgilerin sunulması gerekmektedir.
3. GĐB Bilgi Servisi (GBS): Mükelleflere ait vergi sicil bilgilerinin sorgulanacağı servistir. Noterlik personeli dışındaki kullanıcıların bu servisi kullanabilmesi için Kimlik Doğrulama Servisi üzerinden kimlik doğrulamasının yapılıp gerekli bilgilerin alınması ve GĐB Bilgi Servisi’ne bu bilgilerin sunulması gerekmektedir.
SMMM’ler tarafından gerçekleştirilecek servis işlemleri:
1. Mükelleflerine ait defter bilgilerini elektronik ortama taşımak için bir veya birden fazla “Defter Listesi” oluşturacaklardır.
2. Oluşturdukları listelere mükelleflerin defter bilgilerini sicil bilgileriyle beraber ekleyeceklerdir. Mükellef sicil bilgilerini sorgulamak için GBS kullanılacaktır.
3. Listeler içindeki defterlere ait meşruhat dökümleri ve ilgili raporları alabileceklerdir.
4. Noterliklerde oluşturdukları liste içerisindeki defterlere işlem yaptırabilmek için defter liste numarasını belirteceklerdir.
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
9/47 HĐZMETE ÖZEL
3. SERVĐS ORTAK YAPILARI 3.1. Servis Yapısı Tüm servisler “Document/Literal Wrapped” stilinde hazırlanmıştır. 3.2. Erişim KDS: http://smmmservis.tnb.org.tr/NPSKimlikDogrulamaServisi/Service.asmx GBS: http://smmmservis.tnb.org.tr/GIBBilgiServisi/GBS.asmx DBBS: http://smmmservis.tnb.org.tr/DefterBelgeBilgiServisiMM/DBBSMM.asmx Servis wsdl dosyaların servis yollarının sonuna “?WSDL” eklenerek erişilebilir. Geliştirme ve test için http://smmmservis.tnb.org.tr yerine “212.174.166.29” ip si kullanılmalıdır. 3.3. Kimlik Do ğrulama Servis metodlarına istekte bulunabilmek için daha öncesinde KDS’den kimlik doğrulama işlemi gerçekleştirilmelidir. Kimlik doğrulama işleminin başarılı olması sonucunda istemciye bir bilet numarası döndürülür ve istemci diğer servislerin metodlarına istekte bulunabilmek için “Header” alanlarında bu bilet numarası bilgisini sunmalıdır. (Bkz. A. Kimlik Doğrulama) 3.4. Geri Dönü ş Tipleri Kimlik Doğrulama Servisi hariç diğer iki servisin metodlarının geri dönüş tiplerinde ortak iki alan mevcuttur. Bu iki alan ServisSonuc sınıfında bulunmaktadır ve tüm servis metodlarından geri dönen sınıflar bu sınıftan türemiştir.
Tip class ServisSonuc
Alanlar
Tipi Adı Açıklama
short SonucKod Servis metodundan dönen kod değeridir. Her servise ait Servis Sonuç Kodları
string SonucAciklama Servis metodundan dönen açıklamadır. Metodun istenilen işlemi başarı ile gerçekleştirilmesi sonucunda genellikle bir açıklama döndürülmeyebilir.
Tablo 1: “ ServisSonuc” Sınıfı
Geri dönüş nesneleri “Null” oldukları zaman “ServisHataHeader” alanından gerekli hata mesajı alınmalıdır.
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
10/47 HĐZMETE ÖZEL
3.5. “Header” Kullanımı Servis yapısı içinde metodlara özel olmayan genel durumlar hakkındaki bilgiler, kullanılan “Header”lar tarafından işlenilmektedir. Tüm servislerde ortak olarak kullanılan “ServisHataHeader” yapısı mevcuttur. Yönü servisten istemcilere doğrudur. Đstekte bulunulan metod aracılığı ile gerçekleştirilmek istenen işleme özel olmayan, servis tarafında oluşan genel durum/hata mesajlarını “Servis Hata” alanı içinde verir. Tip class ServisHataHeader
Alanlar
Tipi Adı Açıklama
ServisHata ServisHata Servis metodundan dönen kod değeridir.
Tablo 2: “ServisHataHeader” Sınıfı
Tip class ServisHata
Alanlar
Tipi Adı Açıklama
string Mesaj Hataya ait kod değeridir.
string Kod Hata açıklamasıdır.
Tablo 3: “ ServisHata” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
11/47 HĐZMETE ÖZEL
Referans geri dönüş tiplerinin “Null”, değer geri dönüş tiplerinin ise “0”dan küçük olması durumunda bu header bilgisi kontrol edilmelidir. Örnek olarak servise ait bir metodun resmi tatil günlerinde çağrılması durumunda metod geri dönüş nesnesi “Null” olarak gelecek ve “ServisHataHeader” alanından “Bu servis çalışma günleri dışında hizmete kapalıdır!” mesajı 11 kodu ile birlikte alınabilecektir. Kullanılan hata kodları ve mesajları:
Kod Mesaj
10 Servis belirtilen açıklamadan dolayı erişime kapatılmıştır.
11 Servis resmi tatil günlerinde çalışmaz.
12 Đstemci tarihi servis tarihi ile uyuşmuyor.
13 Đstekte bulunulan metod için gerekli “BiletHeader” veya “DisBiletHeader” bilgileri bulunamadı.
14 Metod için belirtilen “Bilet” bilgisi kayıtlarda bulunamadı.
15 Metod için belirtilen “Bilet” bilgisi kayıtlarda bulundu fakat diğer bilgileri doğrulanamadı.
16 Servis hizmet saat aralığı dışında çalışmaz.
17,18 Bilgi servisleri için gerekli “BilgiServisHeader” bilgisi bulunamadı.
19 Yapılmak istenen iş için şu an bilet verilemez.
20 Metod için belirtilen “DisBilet” bilgisi kayıtlarda bulundu fakat diğer bilgileri doğrulanamadı.
50,51,52 Exception
Tablo 4: Hata Kodları ve Mesaj Açıklamaları
GBS ve DBBS servislerine özel olan headerlar aşağıda detaylandırılmıştır.
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
12/47 HĐZMETE ÖZEL
4. GBS Headar’ları GBS’den bilgi amaçlı sorgulama gerçekleştirebilmek için daha önce KDS’den kimlik doğrulama gerçekleştirilmesi ve sonucunda edinilen bilet numarasını (NPS Belge NO) BilgiServisHeader yapısında sunmak gerekir. Bilet numarası geçerli olduğu sürece her sorgu için aynı değer kullanılabilir. BilgiServisHeader bilgisini sunmak zorunludur. Tip class BilgiServisHeader
Alanlar
Tipi Adı Açıklama
NPSIslemTipi IslemTipi Sorgulama işleminin hangi noterlik işlem tipi için yapılacağını belirtir. NPSIslemTipi.DefterOnayi seçilmelidir.
ProgramAdi Program Đstemci uygulamayı belirtir.
long NPSBelgeNO KDS’den kimlik doğrulama işlemi sonucu alınan NPS Belge NO’dur.
string Sifre Kullanılmayacaktır.
Tablo 5: “ BilgiServisHeader” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
13/47 HĐZMETE ÖZEL
5. DBBS Header’ları DBBS metodlarına istekte bulunabilmek için, GBS de olduğu gibi, daha önce KDS’den kimlik doğrulama gerçekleştirilmesi ve sonucunda edinilen bilet numarasını (NPS Belge NO) DisBiletHeader yapısında sunmak gerekir. Bilet numarası geçerli olduğu sürece her sorgu için aynı değer kullanılabilir. DisBiletHeader bilgisini sunmak zorunludur.
Tip class DisBiletHeader
Alanlar
Tipi Adı Açıklama
DisBilet DisBilet Đsteğin gerçekleştirilmesi için gerekli bilgileri içerir.
DateTime IstemciZamani Đstemci uygulamanın zaman bilgisini içerir.
Tablo 6: “ DisBiletHeader” Sınıfı
Tip class DisBilet
Alanlar
Tipi Adı Açıklama
long NPSBelgeNO KDS’den kimlik doğrulama işlemi sonucu alınan NPS Belge NO’dur.
DateTime VerilisTarihi Kullanılmayacaktır.
NPSIslemTipi Islemtipi Sorgulama işleminin hangi noterlik işlem tipi için yapılacağını belirtir. NPSIslemTipi.DefterOnayi seçilmelidir.
string KimlikNO Kullanıcının kimlik doğrulama işleminde kullandığı kimlik nosunu belirtir.
KimlikNOTipi KimlikNOTipi Kullanıcının kimlik doğrulama işleminde kullandığı kimlik no tipini belirtir.
Tablo 7: “ DisBilet” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
14/47 HĐZMETE ÖZEL
6. SÜREÇ ADIMLARI VE KULLANILACAK METODLAR Bu bölümde bir defter listesi hazırlama süreci ve bu süreci tamamlamak için çağrılması gereken metodlar sırasıyla anlatılacaktır. 6.1. Kimlik Do ğrulama Đstemcilerin (kullanıcıların) süreci başlatabilmeleri ve süreç içinde çağıracakları metodlara istekte bulunabilmeleri için “Kimlik Doğrulama” işlemini gerçekleştirmeleri gereklidir. Bu adımda kullanıcı TCKN\VKN bilgisi, şifre ve bazı ek bilgiler KDS ye sunularak onaylama işlemi gerçekleştirilir. Onaylama işlemi başarılı olduğunda kullanıcıya tekil bir değer olan NPS Belge NO değeri döndürülür. Edinilen bu NPS Belge NO değeri kullanılacak diğer servislerin metodlarında headerlar içinde belirtilmelidir.
Servis Kimlik Doğrulama Servisi (KDS)
Header lar
Tip Açıklama Yön
ServisHataHeader Geri dönüş değeri -1 olduğu zaman gerekli mesajların bakılacağı alandır.
Servisten Đstemciye
Method DisKullaniciKimlikDogrula2
Parametreler
Tip Parametre Adı Açıklama
DisKullaniciKimlik disKullaniciKimlik Kullanıcının kimlik doğrulama için sağlaması gereken bilgileri içerir.
NPSIslemTipi islemTipi Hangi işlem tipi için kimlik doğrulama gerçekleştirilmek istendiğini belirtir.
Zaman istemciZamani Đstemcinin zamanını belirtir.
Geri Dönü ş Tipi
long Kimlik doğrulama isteği onaylanırsa 0’dan büyük bir değer döner. Kimlik doğrulama onaylanmazsa -1 değeri döner.
Tablo 8: “ DisKullaniciKimlikDogrula2” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
15/47 HĐZMETE ÖZEL
6.2. Defter Liste Đşlemleri
6.2.1. Defter Liste Kaydı Olu şturulması Kullanıcılar mükelleflere ait defterleri saklayabilmek için bir defter listesi kaydı oluşturmalıdır. Birden fazla defter liste kaydı oluşturabilir. Bir defter listesinde en fazla 50 defter takımı saklanabilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterListeOlustur
Parametreler
Tip Parametre Adı Açıklama
DefterListeBilgi defterListeBilgi Kullanıcının defter liste kaydı oluşturmak için gerekli bilgileri içerir. Sınıf içerisindeki,
DefterListeNO, KayitAcilisZamani, NoterlikKullaniciAdi, NoterlikKodu
alanlarının doldurulmasına gerek yoktur.
Geri Dönü ş Tipi
DefterListeOlusturServisSonuc Oluşturulan defter listesinin numarasını içerir.
Tablo 9: “DefterListeOlustur” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
16/47 HĐZMETE ÖZEL
6.2.2. Defter Liste Kayıtlarının Sorgulanması Kullanıcılar oluşturdukları defter liste kayıtlarını sorgulayabilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterListeSorgula
Parametreler
Tip Parametre Adı Açıklama
string kimlikNO Kullanıcının defter liste kaydı açarken kullandığı kimlik nosunu belirtir.
KimlikNOTipi kimlikNOTipi Kullanıcının defter liste kaydı açarken kullandığı kimlik no tipini belirtir.
Geri Dönü ş Tipi
DefterListeSorgulaServisSonuc Kullanıcıya ait defter liste kayıt(lar)ını içerir.
Tablo 10 : “DefterListeSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
17/47 HĐZMETE ÖZEL
6.2.3. Defter Liste Kaydının Silinmesi Kullanıcılar oluşturdukları defter liste kayıtlarını silebilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterListeSil
Parametreler
Tip Parametre Adı Açıklama
long defterListeNO Silinecek defter listeye ait numara.
Geri Dönü ş Tipi
ServisSonuc Đşlemini başarılı olup olmadığını gerekli mesajlarla barındırır.
Tablo 11 : “DefterListeSil” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
18/47 HĐZMETE ÖZEL
6.3. Defter Kaydı Đşlemleri 6.3.1. Mükellef ve Defter Bilgilerinin Kaydedilmes i Mükellefe ait defterlerin (takım) bilgisinin kayıt edilmesi için öncelikle mükellef sicil bilgileri sorgulanmalıdır. Daha sonra mükellef sicil bilgileri ile beraber hazırlanan takım bilgileri toplu olarak tek seferde bildirilir. 6.3.1.1. Mükellef Bilgilerinin Sorgulanması Defter listesine bir defter bilgisinin eklenebilmesi için önce defterin sahibi olan mükellefin bilgileri mükellefe ait TCKN veya VKN bilgisi ile sorgulanmalıdır. Sadece bu adıma özel GBS servisine istekte bulunulur. 6.3.1.2. Mükellef Bilgilerinin VKN ile Sorgulanması Servis GĐB Bilgi Servisi (GBS)
Header lar
Tip Yön
BilgiServisHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method TuzelSahisMukellefMerkezBilgiSorgu
Parametreler
Tip Parametre Adı Açıklama
string vkn Sorgulanacak mükellefe ait VKN
Geri Dönü ş Tipi
MerkezBilgiSorguSonuc Sorgulanan mükellefe ait bilgileri içerir.
Tablo 12 : “TuzelSahisMukellefMerkezBilgiSorgu” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
19/47 HĐZMETE ÖZEL
6.3.1.3. Mükellef Bilgilerinin TCKN ile Sorgulanmas ı
Servis GĐB Bilgi Servisi (GBS)
Header lar
Tip Yön
BilgiServisHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method GercekSahisMukellefMerkezBilgiSorgu
Parametreler
Tip Parametre Adı Açıklama
long tckn Sorgulanacak mükellefe ait TCKN
Geri Dönü ş Tipi
MerkezBilgiSorguSonuc Sorgulanan mükellefe ait bilgileri içerir.
Tablo 13: “ GercekSahisMukellefMerkezBilgiSorgu” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
20/47 HĐZMETE ÖZEL
6.3.2. Mükellef Defterlerinin (Takım) Kayıt Edilme si Mükellef sicil bilgileri sorgulandıktan sonra bu bilgilerle beraber mükellefe ait olan tüm defterlerin (takım) bilgileri belirtilen defter liste numarası altında kayıt altına alınır. Takım içerisinde mükellefe ait birden fazla defter olabilir. Bu defter takımı kayıt altına alınırken servis tarafında takım için bir numara, Takım NO, oluşturulur. Ayrıca her defter kaydı için de tekil olan bir NPS Belge NO oluşturulur. Sonraki adımlarda bir defter kaydını belirtecek tekil değer bu NPS Belge NO bilgisidir. Kayıt edilen takıma daha sonra yine aynı yöntemle defter eklenebilir. Yalnız aynı takıma eklenmesi için Takım NO bilgisinin belirtilmesi gerekir. Not: Kayıt altına alınan defterler noterlik tarafın dan henüz i şlemleri tamamlanmadı ğı için “Geçici Defter” adı altında isimlendirilmi ştir. Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterTakimBildir
Parametreler
Tip Parametre Adı Açıklama
DefterTakimBilgi defterTakimBilgi Mükellef sicil bilgilerini ve tüm defterlerin bilgilerini içerir.
Geri Dönü ş Tipi
ServisSonuc Đşlemini başarılı olup olmadığını gerekli mesajlarla barındırır.
Tablo 14: “ DefterTakimBildir” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
21/47 HĐZMETE ÖZEL
6.3.3. Defter Listesine Ait Defter Kayıtlarının Sor gulanması Bir defter liste kaydına ait defter kayıtları sorgulanabilir. Bu sorgu ile beraber mükellefin defter takımı bildirilirken servis tarafında oluşturulan takımın Takım NO ve her defterin NPS Belge NO bilgileri edinilebilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterListesiDefterSorgula
Parametreler
Tip Parametre Adı Açıklama
long defterListeNO Sorgulanacak defter liste kaydına ait Defter Liste NO bilgisi
Geri Dönü ş Tipi
DefterListesiDefterSorgulaServisSonuc Defter listesi içindeki defter kayıtlarını barındırır.
Tablo 15: “ DefterListesiDefterSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
22/47 HĐZMETE ÖZEL
6.3.4. Defter Listesine Ait Defter Takım Kayıtların ın Sorgulanması Bir defter listesi kaydına ait defter takım kayıtları sorgulanabilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterTakimListesiSorgula
Parametreler
Tip Parametre Adı Açıklama
long defterListeNO Sorgulanacak defter liste kaydına ait Defter Liste NO bilgisi
Geri Dönü ş Tipi
DefterTakimListesiSorgulaServisSonuc Defter listesi içindeki defter takım kayıtlarını barındırır.
Tablo 16: “ DefterTakimListesiSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
23/47 HĐZMETE ÖZEL
6.3.5. Defter Kaydının Güncellenmesi Daha önce oluşturulan bir defterin kaydının bilgileri güncellenebilir. Bu işlem için sadece o defteri işaret eden NPS Belge NO kullanılır. Bu metod ile sadece defter bilgileri güncellenebilir. Defterin mükellefine ait bilgiler güncellenmez. Takım içindeki tüm defterleri için mükellef güncellenebilir. (6.3.6. Defter Takımı Mükellef Güncellemesi)
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterGuncelle
Parametreler
Tip Parametre Adı Açıklama
DefterBilgi defterBilgi Güncellenecek defterin yeni bilgilerini içerir.
Geri Dönü ş Tipi
ServisSonuc Đşlemini başarılı olup olmadığını gerekli mesajlarla barındırır.
Tablo 17: “ DefterGuncelle” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
24/47 HĐZMETE ÖZEL
6.3.6. Defter Takımı Mükellef Güncellenmesi Defter takımı içindeki tüm defterlerinin mükellefleri güncellenebilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterTakimMukellefGuncelle
Parametreler
Tip Parametre Adı Açıklama
Mukellef mukellef Güncellenecek mükellefin yeni bilgilerini içerir.
long defterListeNo Güncellenecek takımın içinde bulunduğu defter liste numarasını belirtir.
long takimNO Güncellenecek takımın numarasını belirtir.
Geri Dönü ş Tipi
ServisSonuc Đşlemini başarılı olup olmadığını gerekli mesajlarla barındırır.
Tablo 18: “ DefterTakimMukellefGuncelle” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
25/47 HĐZMETE ÖZEL
6.3.7. Defter Kaydının Silinmesi Mükellefin bir defteri silinebilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterSil
Parametreler
Tip Parametre Adı Açıklama
long npsBelgeNO Silinecek defterin NPS Belge NO bilgisi.
Geri Dönü ş Tipi
ServisSonuc Đşlemini başarılı olup olmadığını gerekli mesajlarla barındırır.
Tablo 19: “ DefterSil” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
26/47 HĐZMETE ÖZEL
6.3.8. Defter Takımının Silinmesi Mükellefe ait tüm defterler (takım silinebilir.)
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterTakimSil
Parametreler
Tip Parametre Adı Açıklama
string kimlikNO Kullanıcının defter liste kaydı açarken kullandığı kimlik numarasını belirtir.
KimlikNOTipi kimlikNOTipi Kullanıcının defter liste kaydı açarken kullandığı kimlik no tipini belirtir.
long defterListeNO Takımın içinde yer aldığı defter liste kaydının numarası.
long takimNO Silinecek takıma ait Takım NO Bilgisi
Geri Dönü ş Tipi
ServisSonuc Đşlemini başarılı olup olmadığını gerekli mesajlarla barındırır.
Tablo 20: “ DefterTakimSil” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
27/47 HĐZMETE ÖZEL
6.4. Meşruhat Defter kayıtları için meşruhat dökümleri alınabilir. Bu dökümler için XML kaynak verisi edinmek amacı ile kullanılabilecek oluşturacak üç farklı sorgulama yapılabilir. 6.4.1. Defter Listesi Me şruhat Bilgisi Bir defter listesi içindeki tüm defterler için meşruhat bilgisi sunar.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterListeMesruatBilgiSorgula
Parametreler
Tip Parametre Adı Açıklama
long defterListeNO Defter liste numarasını belirtir.
Geri Dönü ş Tipi
DefterMesruatBilgiSorgulaServisSonuc Defterlere ait meşruhat bilgilerini içerir.
Tablo 21: “ DefterListeMesruatBilgiSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
28/47 HĐZMETE ÖZEL
6.4.2. Defter Takımı Me şruhat Bilgisi Bir defter takımı içindeki defterlerin meşruhat bilgisini sunar. .
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterTakimMesruatBilgiSorgula
Parametreler
Tip Parametre Adı Açıklama
long defterListeNO Defter liste numarasını belirtir.
long takimNO Takım numarasını belirtir.
Geri Dönü ş Tipi
DefterMesruatBilgiSorgulaServisSonuc Defterlere ait meşruhat bilgilerini içerir.
Tablo 22: “ DefterTakimMesruatBilgiSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
29/47 HĐZMETE ÖZEL
6.4.3. Defter Meşruhat Bilgisi Bir deftere ait meşruhat bilgisini sunar.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method DefterMesruatBilgiSorgula
Parametreler
Tip Parametre Adı Açıklama
long npsBelgeNO Defterin NPS Belge NO sunu belirtir.
Geri Dönü ş Tipi
DefterMesruatBilgiSorgulaServisSonuc Defterlere ait meşruhat bilgilerini içerir.
Tablo 23: “ DefterMesruatBilgiSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
30/47 HĐZMETE ÖZEL
7. KULLANICI ĐŞLEMLER Đ Kullanıcı bilgileri servis tarafından sorgulanıp düzeltilebilir. 7.1. SMMM Bilgi Sorgulama
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip Yön
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method MaliMusavirSorgula
Parametreler
Tip Parametre Adı Açıklama
string musavirKimlikNO Müşavir kimlik no
KimlikNOTipi musavirKimlikNOTipi Müşavir kimlik no tipi
Geri Dönü ş Tipi
MaliMusavirSorgulaServisSonuc Müşavir bilgilerini barındırır.
Tablo 24: “ MaliMusavirSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
31/47 HĐZMETE ÖZEL
7.2. SMMM Bilgi Düzenleme Kullanıcıya ait bilgiler kullanıcı tarafında düzenlenebilir.
Servis Defter Belge Bilgi Servisi (DBBS)
Header lar
Tip ����
DisBiletHeader Đstemciden Servise
ServisHataHeader Servisten Đstemciye
Method MaliMusavirSorgula
Parametreler
Tip Parametre Adı Açıklama
MaliMusavir maliMusavir Müşavir bilgilerini barındırır.
Geri Dönü ş Tipi
ServisSonuc Đşlemini başarılı olup olmadığını gerekli mesajlarla barındırır.
Tablo 25: “ MaliMusavirSorgula” Metodu
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
32/47 HĐZMETE ÖZEL
8. SERVĐSLERDE KULLANILAN T ĐPLER 8.1. Class 8.1.1. DisKullaniciKimlik
Tip class DisKullaniciKimlik
Alanlar
Tipi Adı Açıklama
ProgramAdi ProgramAdi Đsteğin gerçekleştirilmesi için gerekli bilgileri içerir.
string KimlikNO Kullanıcının kimlik doğrulama için kullanacağı kimlik no
KimlikNOTipi KimlikNOTipi Kullanıcının kimlik doğrulama için kullanacağı kimlik no tipi
string NoterlikKodu Kullanılmayacaktır.
string NoterlikKullaniciAdi Kullanılmayacaktır.
DisKullaniciTipi DisKullaniciTipi Kullanıcı tipi belirtir. MaliMusavir değeri seçilecektir.
string Sifre Kullanıcının şifresidir.
Tablo 26: “ DisKullaniciKimlik” Sınıfı
8.1.2. DefterOlusturServisSonuc Tip class DefterListeOlusturServisSonuc
Alanlar
Tipi Adı Açıklama
long DefterListeNO Oluşturulan defter listesinin numarası.
Tablo 27: “ DefterOlusturServisSonuc” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
33/47 HĐZMETE ÖZEL
8.1.3. DefterListeSorgulaServisSonuc Tip class DefterListeSorgulaServisSonuc
Alanlar
Tipi Adı Açıklama
DefterListeBilgi[] DefterListeListesi Defter listelerini içeren dizi.
Tablo 28: “ DefterListeSorgulaServisSonuc” Sınıfı
8.1.4. DefterListeBilgi Tip class DefterListeBilgi
Alanlar
Tipi Adı Açıklama
long DefterListeNO Defter Liste NO
Zaman KayitAcilisZamani Defter liste kaydının açılış zamanı.
KimlikNOTipi KimlikNOTipi Defter liste kaydını açan kullanıcı kimlik no tipi
string KimlikNO Defter liste kaydını açan kullanıcı kimlik no
string Ad Defter liste kaydını açan kullanıcı adı
string Soyad Defter liste kaydını açan kullanıcı soyadı
string NoterlikKullaniciAdi Kullanılmayacaktır.
Tablo 29: “ DefterListeBilgi” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
34/47 HĐZMETE ÖZEL
8.1.5. MerkezBilgiSorguSonuc Tip class MerkezBilgiSorguSonuc
Alanlar
Tipi Adı Açıklama
string Adi Mükellefin adı. Tüzel şahıslar için boş gelir.
string Soyadi Mükellef soyadı. Tüzel şahıslar için boş gelir.
string BabaAdi Mükellefin baba adı. Tüzel şahıslar için boş gelir.
string VergiDairesiAdi Mükellef vergi dairesi adı.
string VergiDairesiKodu Mükellef vergi dairesi kodu
string VKN Mükellef vergi kimlik numarası
string Unvan Mükellef unvanı. Gerçek şahıslar için boş gelir.
Adres IsAdresi Mükellef iş adresi
Adres IkametgahAdresi Mükellef ikametgah adresi
Meslek[] MeslekListesi Mükellefin meslek listesi.
GIBFaalKodlari FaalTerkBilgisi Mükellefin faal veya terk bilgisi.
GIBSirketTurleri SirketTuru Mükellefin şirket türü
KimlikNOTipi SorguKimlikNOTipi Sorgulanan mükellefe ait kimlik no tipi
string SorguKimlikNO Sorgulanan mükellefe ait kimlik no
Tablo 30: “ MerkezBilgiSorguSonuc” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
35/47 HĐZMETE ÖZEL
8.1.6. Adres Tip class Adres
Alanlar
Tipi Adı Açıklama
string MahalleSemt
string CaddeSokak
string KapiNO
string DaireNO
string IlceAdi
string IlKodu
string IlAdi
Tablo 31: “ Adres” Sınıfı
8.1.7. Meslek Tip class Meslek
Alanlar
Tipi Adı Açıklama
string MeslekAdi
string MeslekKodu
Tablo 32: “ Meslek” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
36/47 HĐZMETE ÖZEL
8.1.8. DefterTakimBilgi Tip class DefterTakimBilgi
Alanlar
Tipi Adı Açıklama
long DefterListeNO Defter Liste NO
Mukellef Mukellef Mükellef bilgileri
DefterBilgi[] Takim Defter bilgilerini içeren dizi.
long TakimNO Defter takımına ait numara. Mükellefin takımın ilk bildirilmek istendiğinde 0 atanacak. Daha önce bildirilmiş bir takıma yeni defter eklenirse takımın numarası atanacak.
Tablo 33: “ DefterTakimBilgi” Sınıfı
8.1.9. Mukellef Tip class Mukellef
Alanlar
Tipi Adı Açıklama
string KimlikNO Mükellef kimlik no
KimlikNOTipi KimlikNOTipi Mükellef kimlik no tipi
string VergiDairesiKodu Mükellef vergi dairesi kodu
string VergiDairesiAdi Mükellef vergi dairesi adı
string Unvan Mükellef unvanı. Gerçek şahısları içi “{Ad} {Soyad}” şeklinde atanacak.
string EkBilgi Mükellefe ait ek bilgi. Örnek olarak şirketin şube adı girilebilir.
string Adres Mükellef adresi
string meslek Mükellef mesleği.
decimal TaahhhutSermaye Mükellefin taahhüt edilen sermayesi
decimal OdenenSermaye Mükellefin ödenen sermayesi
Tablo 34: “ Mukellef” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
37/47 HĐZMETE ÖZEL
8.1.10. DefterBilgi Tip class DefterBilgi
Alanlar
Tipi Adı Açıklama
long NPSBelgeNO Deftere ait sistem tarafından verilecek NPS Belge NO. Đstemci tarafından bildirilirken 0 atanacak.
int OnaySayfaSayisi Defter onay sayfa sayısı
DefterNeviTipi NeviTipi Defter nevi.
short Donem Defterin ait olduğu dönem.
short TekCift
int BaslangicSayfaNO Defter başlangıç sayfa numarası
int BitisSayfaNO Defter bitiş sayfa numarası.
Tablo 35: “ DefterBilgi” Sınıfı
8.1.11. Zaman Tip class Zaman
Alanlar
Tipi Adı Açıklama
int Yil
int Ay
int Gun
int Saat
int Dakika
int Saniye
Tablo 36: “ Zaman” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
38/47 HĐZMETE ÖZEL
8.1.12. DefterListesiDefterSorgulaServisSonuc Tip class DefterListesiDefterSorgulaServisSonuc
Alanlar
Tipi Adı Açıklama
DefterGeciciBilgi[] DefterGeciciListe Listenin defterlerini içeren dizi
int DefterGeciciAdet Liste içindeki defter adedi.
Tablo 37: “ DefterListesiDefterSorgulaServisSonuc” Sınıfı
8.1.13. DefterTakimListesiSorgulaServisSonuc Tip class DefterTakimListesiSorgulaServisSonuc
Alanlar
Tipi Adı Açıklama
DefterTakimBilgi [] DefterTakimBilgilistesi Listenin defter takım kayıtlarını içeren dizi
Tablo 38: “ DefterTakimListesiSorgulaServisSonuc” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
39/47 HĐZMETE ÖZEL
8.1.14. DefterGeciciBilgi Tip class DefterGeciciBilgi
Alanlar
Tipi Adı Açıklama
long NPSBelgeNO Deftere ait sistem tarafından verilecek NPS Belge NO. Đstemci tarafından bildirilirken 0 atanacak.
int OnaySayfaSayisi Defter onay sayfa sayısı
DefterNeviTipi NeviTipi Defter nevi.
short Donem Defterin ait olduğu dönem.
short TekCift
int BaslangicSayfaNO Defter başlangıç sayfa numarası
int BitisSayfaNO Defter bitiş sayfa numarası.
long DefterListeNO Defterin ait olduğu liste numarası.
long TakimNO Defterin ait olduğu takım numarası
bool YevmiyeBildirildiMi Defterin noterlik tarafından kesilen yevmiyesinin NPS’ye bildirilip bildirilmediği
Mukellef Mukellef Defterin mükellef bilgileri
Tablo 39: “ DefterGeciciBilgi” Sınıfı
8.1.15. DefterMesruatBilgiSorgulaServisSonuc Tip class DefterMesruatBilgiSorgulaServisSonuc
Alanlar
Tipi Adı Açıklama
DefterOnayYevmiyeBilgi[]
DefterOnayListe Defterlere ait meşruhat bilgilerini barındırır.
Tablo 40: “ DefterMesruatBilgiSorgulaServisSonuc” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
40/47 HĐZMETE ÖZEL
8.1.16. DefterOnayYevmiyeBilgi Tip class DefterOnayYevmiyeBilgi
Alanlar
Tipi Adı Açıklama
long NPSBelgeNO Deftere ait sistem tarafından verilecek NPS Belge NO
int OnaySayfaSayisi Defter onay sayfa sayısı
DefterNeviTipi NeviTipi Defter nevi.
short Donem Defterin ait olduğu dönem.
short TekCift
int BaslangicSayfaNO Defter başlangıç sayfa numarası
int BitisSayfaNO Defter bitiş sayfa numarası.
long DefterListeNO Defterin ait olduğu liste numarası.
long TakimNO Defterin ait olduğu takım numarası
bool YevmiyeBildirildiMi Defterin noterlik tarafından kesilen yevmiyesinin NPS’ye bildirilip bildirilmediği
Mukellef Mukellef Defterin mükellef bilgileri
string NPSBildirimReferansNO
Kullanılmayacaktır
String NoterlikKodu Kullanılmayacaktır
Zaman YevmiyeTarihi Kullanılmayacaktır
int YevmiyeNO Kullanılmayacaktır
long NoterTCKN Kullanılmayacaktır
short VezneAnaKod Kullanılmayacaktır
short VezneAltKod Kullanılmayacaktır
Zaman YevmiyeBildirimZamani Kullanılmayacaktır
string YevmiyeReferansNO Kullanılmayacaktır
bool Secili Kullanılmayacaktır
long TakimNO Defterin ait olduğu takım numarasını verir.
string MesruatMetin Meşruahatta çıkacak metni verir.
Zaman BildirimZamani Kullanılmayacaktır
string BildirimOid Kullanılmayacaktır
bool GIBBildirimAsamasind Kullanılmayacaktır
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
41/47 HĐZMETE ÖZEL
a
bool OpsiyonSuresiIcindeMi Kullanılmayacaktır
bool GIBBildirildi Kullanılmayacaktır
Tablo 41: “ DefterOnayYevmiyeBilgi” Sınıfı
8.1.17. MaliMusavirSorgulaServisSonuc Tip class MaliMusavirSorgulaServisSonuc
Alanlar
Tipi Adı Açıklama
MaliMusavir MaliMusavir Müşavir bilgilerini barındırır.
Tablo 42: “ MaliMusavirSorgulaServisSonuc” Sınıfı
8.1.18. MaliMusavir Tip class MaliMusavir
Alanlar
Tipi Adı Açıklama
string Unvan Unvan
string KimlikNO Kimlik NO
KimlikNOTipi KimlikNOTipi Kimlik NO Tipi
string EPosta E-Posta
string Telefon Telefon
string Sifre Şifre
string Adres Adres
Tablo 43: “ MaliMusavir” Sınıfı
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
42/47 HĐZMETE ÖZEL
8.2. Tanımlı Tipler 8.2.1. ProgramAdi Tip enum ProgramAdi
Değerler
Adı Açıklama
Belirtilmemis Kullanılmayacaktır.
Vezne Kullanılmayacaktır.
YazimNet Kullanılmayacaktır.
VezneNet Kullanılmayacaktır.
TNBOnline Kullanılmayacaktır.
Tablo 44: “ProgramAdi” Tipi
8.2.2. KimlikNOTipi Tip enum KimlikNOTipi
Değerler
Adı Açıklama
Belirtilmemis Kullanılmayacaktır.
TCKN Türkiye Cumhuriyeti Kimlik Numarası
VKN Vergi Kimlik Numarası
MTKN Merkezi Tüzel Kişilik Numarası. Kullanılmayacaktır.
TCSN Ticaret Sicil Numarası. Kullanılmayacaktır.
Tablo 45: “ KimlikNOTipi” Tipi
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
43/47 HĐZMETE ÖZEL
8.2.3. NPSIslemTipi Tip enum NPSIslemTipi
Değerler
Adı Açıklama
Belirtilmemis Kullanılmayacaktır.
AracSatisi Kullanılmayacaktır.
DefterOnayi Noterlikler tarafından gerçekleştirilen Defter Onay işlemlerini işaret eder.
SendikaUyelik Kullanılmayacaktır.
BelgeOnayi Kullanılmayacaktır.
Tablo 46: “ NPSIslemTipi” Tipi
8.2.4. GIBFaalKodlari Tip enum GIBFaalKodlari
Değerler
Adı Açıklama
Belirtilmemis Kullanılmayacaktır.
Faal
Tanimsiz
Tablo 47: “ GIBFaalKodlari” Tipi
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
44/47 HĐZMETE ÖZEL
8.2.5. GIBSirketTurleri Tip enum GIBSirketTurleri
Değerler
Adı Açıklama
Belirtilmemis Kullanılmayacaktır.
Gercek
Adi
Kollektif
AdiKomandit
ESHKomandit
LTD
Anonim
Koop
Diger
Tablo 48: “ GIBSirketTurleri” Tipi
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
45/47 HĐZMETE ÖZEL
8.2.6. DefterNeviTipi Tip enum DefterNeviTipi
Değerler
Adı Açıklama
Belirtilmemis Kullanılmayacaktır.
DigerDefter
YevmiyeDefteri
EnvanterDefteri
IsletmeDefteri
CiftciIsletmeDefteri
ImalatveIstihsalVergisiDefteri
NakliyatVergisiDefteri
YabanciNakliyatHasilatDefteri
SerbestMeslekKazancDefteri
DamgaVergisiDefteri
IsletmeTuruDigerDefter
BilancoTuruDigerDefter
DefteriKebir
KararDefteri
OrtaklarPayDefteri
Tablo 49: “ DefterNeviTipi” Tipi
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
46/47 HĐZMETE ÖZEL
9. SERVĐS GERĐ DÖNÜŞ KODLARI 9.1. Defter Belge Bilgi Servisi (DBBS) Kod Mesaj
501 Metod isteği başarılı ile sonuçlandı.
511 Metod parametre bilgileri uygun değil.
512 Đşlem yapılmak istenen kayıt bulunamadı.
516 Sorgulanan kayıt bulunamadı.
517 Defter listesine ait defter kayıdı bulunamadı.
521 Mükellefe ait bilgiler eksik veya uygun değil.
522 Mükellefe ait defter bilgisi bulunamadı.
523 Mükellefe ait defter bilgisi uygun değil.
532 Silinecek defter takım numarası veya ait olduğu defter liste numarası uygun değil.
533 Silinecek defter numarası uygun değil.
560 Mali müşavir bilgisi uygun değil.
562 Bir listeye en fazla 50 mükellef (takım) için kayıt yapabilirsiniz.
Tablo 50: “DBBS” Mesajları
TÜRKĐYE NOTERLER B ĐRLĐĞĐ
BĐLGĐ ĐŞLEM MÜDÜRLÜĞÜ
DEFTER BELGE SERV ĐSĐ
TEKNĐK DOKÜMANI
Şablon Değişiklik No:1.6 Tarih: 26.12.2012
47/47 HĐZMETE ÖZEL
9.2. GĐB Bilgi Servisi (GBS) Kod Mesaj
201 Metod isteği başarılı ile sonuçlandı.
211 Belirtilen TCKN bilgisi format olarak uygun değil.
212 Belirtilen VKN bilgisi format olarak uygun değil
213 Belirtilen TCKN bilgisine göre mükellef kayıdı bulunamadı.
214 Belirtilen VKN bilgisi bulunamadı.
215 Gerçek şahıs sorgulama işlemi gerçekleştirilemedi.
216 Tüzel şahıs sorgulama işlemi gerçekleştirilemedi.
250 Tanımlanmamış alan adı.
Tablo 51: “GBS” Mesajları