TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ -...

47
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

Transcript of TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ -...

Page 1: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜ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

Page 2: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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.

Page 3: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 4: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 5: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 6: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 7: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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.

Page 8: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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.

Page 9: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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.

Page 10: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 11: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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.

Page 12: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 13: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 14: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 15: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 16: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 17: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 18: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 19: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 20: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 21: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 22: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 23: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 24: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 25: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 26: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 27: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 28: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 29: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 30: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 31: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 32: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 33: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 34: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 35: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 36: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 37: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 38: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 39: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 40: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 41: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 42: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 43: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 44: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 45: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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

Page 46: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı

Page 47: TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ - smmm.tnb.org.trsmmm.tnb.org.tr/Download/GENEL/DefterBelgeBilgiServisi.v6... · TÜRK ĐYE NOTERLER B ĐRL ĐĞĐ BĐLG Đ ĐŞ LEM MÜDÜRLÜ ĞÜ

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ı