XML de Dikkat Edilecek Hususlar

Transkript

1 XML de Dikkat Edilecek Hususlar XML dokümanı örnek alınarak Banka kök etiketinde yer alan EFTKodu alanına kuruluşun EFT kodu, Adi alanına kuruluşun adı ve GuncellemeTarihi alanına güncellenme tarihi yazılır GuncellemeTarihi alanına yyyy-aa-ggtss:dd:ss formatında söz konusu XML dokümanında yapılan son güncellemenin güncelleme tarihi yazılır IslemGrubu etiketinde yer alan IslemGrubuAdi alanına Para Aktarma, Bireysel Krediler, Kredi Kartları ve Banka Kartları, Mevduat Hesapları, ATM Kullanım, Kiralık Kasa Ücretleri, Menkul Kıymet İşlemleri, Çekler ve Senetler işlem grupları yazılır Yukarıda bahsi geçen sekiz işlem grubu kapsamında yer almayan tüm işlemlere Diğer işlem grubu altında yer verilmelidir Her IslemGrubu nun altında bu işlem grubu ile ilgili Islem ler yer alır Islem etiketinde yer alan IslemAdi alanına bağlı oldukları işlem grubunun işlemleri yazılır Örneğin; Para Aktarma işlem grubu için Islem etiketinde IslemuAdi alanına Havale, EFT, Swift yazılabilir Para Aktarma işlem grubu için işlemler sadece Havale, EFT ve Swift olarak tanımlanmalı bunların haricinde işlem eklenmemelidir Bireysel Krediler işlem grubu için işlemler sadece Konut Kredileri, Taşıt Kredileri ve İhtiyaç Kredileri olarak tanımlanmalı bunların haricinde işlem eklenmemelidir Para Aktarma ve Bireysel Krediler haricindeki işlem gruplarının altına, kuruluşlar faaliyetleriyle ilgi işlemler ekleyebilirler Her Islem in altında o işlem ile ilgili Kalem ler yer alır Kalem etiketinde yer alan KalemAdi alanına bağlı oldukları işlemin kalemleri yazılır Örneğin; Para Aktarma işlem grubundaki Havale işleminin Kalem etiketinde KalemAdi alanına İsme Havale, Hesaba Havale yazılabilir

2 Her Kalem in altında o kalem ile ilgili Masraf lar yer alır Masraf etiketinde yer alan MasrafAdi alanına bağlı olduğu kaleme ait masrafların, ücretlerinin, oranların tanımı, BirimOran alanına Asgari Azami oranın birimi (Örneğin %), BirimTutar alanına Azgari Azami tutarın birimi (Örneğin TL, USD gibi), <AsgariTutar> </AsgariTutar> etiketleri arasına masrafın asgari değeri, <AsgariOran> </AsgariOran> etiketleri arasına masrafın asgari oranı, <AzamiTutar> </AzamiTutar> etiketleri arasına masrafın azami değeri, <AzamiOran> </AzamiOran> etiketleri arasına masrafın azami oranı, <Aciklama> </Aciklama> etiketleri arasına varsa söz konusu masraf ile ilgili açıklama, <GuncellemeTarihi> </GuncellemeTarihi> etiketleri arasına söz konusu masrafın güncelleme tarihi yyyy-aa-ggtss:dd:ss formatında yazılır Örneğin; Para Aktarma işlem grubuna bağlı, Havale işlemindeki İsme Havale kaleminin Masrafları 10 bin TL üzeri havale masrafı, 50 bin TL üzeri havale masrafı olabilir 10 bin TL üzeri havale masrafı kaleminin asgari değeri <AsgariTutar>12025</AsgariTutar>, asgari oranı <AsgariOran>10</AsgariOran>, azami değeri <AzamiTutar>250</AzamiTutar> ve azami oranı <AzamiOran>25</AzamiOran olarak yazılabilir AzamiTutar veya AzamiOran alanları mutlaka doldurulmalıdır AsgariTutar ve AsgariOran alanlarını doldurmak isteğe bağlıdır AzamiTutar, AzamiOran, AsgariTutar ve AsgariOran alanlarına sadece rakam yazılmalı, bu değerle ilgili birim (TL, %, Dolar, Avro vs) Masraf etiketindeki BirimOran ve BirimTutar alanlarına yazılmalıdır Değer yazılırken ondalık ayracı olarak nokta ( ) kullanılmalı, binlik ayracı kullanılmamalıdır Hazırlanan XML dokümanı, XML şema dokümanı yardımıyla şekilsel doğrulanarak Kurumumuzun erişebileceği bir bağlantıda yayımlanmalıdır Bu XML dokümanını, kuruluşlar web sitelerinde bilgileri güncellediği anda güncellemelidirler XML dokümanın adı TuketiciVerilerixml olmalı, kuruluşun internet sitesinde internet bağlantısından yayımlanmalıdır XML dokümanının dışarıdan herhangi bir değişikliğe iznin verilmeyecek şekilde güvenliği söz konusu kuruluşun sorumluluğundadır

3 XML dokümanında veya diğer aşamalarda olabilecek hataların bildirimini sağlamak amacıyla kuruluşların, bir teknik bir de yetkili personelin iletişim bilgilerini tarihine kadar e-posta adresi aracılığıyla Kurumumuza iletmeleri gerekmektedir Tanımlanan bu personellerin bilgilerinde bir değişiklik olduğu durumda, aynı gün içerisinde Kurumumuz bilgilendirilmelidir

4 Örnek XML Dokümanı <?xml version="10" encoding="windows-1254"?> <Banka EFTKodu = "802" Adi="Banka Adı" GuncellemeTarihi=" T12:45:00"> <IslemGrubu IslemGrubuAdi="Para Aktarma"> <Islem IslemAdi="Havale"> <Masraf MasrafAdi="Masraf Adı" BirimTutar="" BirimOran="%"> <AsgariTutar></AsgariTutar> <AsgariOran>12</AsgariOran> <AzamiTutar></AzamiTutar> <AzamiOran>18</AzamiOran> <GuncellemeTarihi> T12:45:00</GuncellemeTarihi> <Masraf MasrafAdi="Masraf Adı" BirimTutar="TL" BirimOran=""> <AsgariTutar>80</AsgariTutar> <AsgariOran></AsgariOran> <AzamiTutar>150</AzamiTutar> <AzamiOran></AzamiOran> <GuncellemeTarihi> T12:20:00</GuncellemeTarihi> <Masraf MasrafAdi="Masraf Adı" BirimTutar="" BirimOran="%"> <AsgariTutar></AsgariTutar> <AsgariOran>2567</AsgariOran> <AzamiTutar></AzamiTutar> <AzamiOran>4555</AzamiOran> <GuncellemeTarihi> T11:30:00</GuncellemeTarihi> <Masraf MasrafAdi="Masraf Adı" BirimTutar="TL" BirimOran="%"> <AsgariTutar>100</AsgariTutar> <AsgariOran>1265</AsgariOran> <AzamiTutar>250</AzamiTutar> <AzamiOran>1845</AzamiOran> <GuncellemeTarihi> T11:20:00</GuncellemeTarihi> <Islem IslemAdi="EFT"> <Masraf MasrafAdi="Masraf Adı" BirimTutar="USD" BirimOran=""> <AsgariTutar>25</AsgariTutar> <AsgariOran></AsgariOran> <AzamiTutar>50</AzamiTutar> <AzamiOran></AzamiOran> <GuncellemeTarihi> T12:23:00</GuncellemeTarihi> <Masraf MasrafAdi="Masraf Adı" BirimTutar="" BirimOran="%"> <AsgariTutar></AsgariTutar> <AsgariOran>1550</AsgariOran> <AzamiTutar></AzamiTutar> <AzamiOran>2550</AzamiOran> <GuncellemeTarihi> T10:30:00</GuncellemeTarihi> <Islem IslemAdi="Swift"> <Masraf MasrafAdi="Masraf Adı" BirimTutar="TL" BirimOran="">

5 <AsgariTutar>120</AsgariTutar> <AsgariOran></AsgariOran> <AzamiTutar>350</AzamiTutar> <AzamiOran></AzamiOran> <GuncellemeTarihi> T17:15:00</GuncellemeTarihi> <IslemGrubu IslemGrubuAdi="Bireysel Krediler"> <Islem IslemAdi ="Konut Kredileri"> <Kalem KalemAdi =" TL ye Kadar Konut Kredileri"> <Masraf MasrafAdi="Dosya Masrafı" BirimTutar="TL" BirimOran="%"> <AsgariTutar>100</AsgariTutar> <AsgariOran>10</AsgariOran> <AzamiTutar>400</AzamiTutar> <AzamiOran>20</AzamiOran> <GuncellemeTarihi> T12:45:00</GuncellemeTarihi> <Islem IslemAdi="Taşıt Kredileri"> <Islem IslemAdi="İhtiyaç Kredileri"> <IslemGrubu IslemGrubuAdi="Kredi Kartları ve Banka Kartları"> <IslemGrubu IslemGrubuAdi="Mevduat Hesapları"> <IslemGrubu IslemGrubuAdi="ATM Kullanım"> <IslemGrubu IslemGrubuAdi="Kiralık Kasa Ücretleri"> <IslemGrubu IslemGrubuAdi="Menkul Kıymet İşlemleri"> <IslemGrubu IslemGrubuAdi="Çekler ve Senetler"> <IslemGrubu IslemGrubuAdi="Diğer"> </Banka>

6 XSD Dokümanı <?xml version="10" encoding="windows-1254"?> <xsd:schema xmlns:xsd=" <xsd:element name="banka"> <xsd:element name="islemgrubu" maxoccurs="unbounded"> <xsd:element name="islem" maxoccurs="unbounded"> <xsd:element name="kalem" maxoccurs="unbounded"> <xsd:element name="masraf" maxoccurs="unbounded"> <xsd:element name="asgaritutar" type="xsd:decimal" nillable="true"/> <xsd:element name="asgarioran" type="xsd:decimal" nillable="true"/> <xsd:element name="azamitutar" type="xsd:decimal" nillable="true"/> <xsd:element name="azamioran" type="xsd:decimal" nillable="true"/> <xsd:element name="aciklama" type="metin"/> <xsd:element name="guncellemetarihi" type="xsd:datetime"/> <xsd:attribute name="masrafadi" type="metin255dolu" use="required"/> <xsd:attribute name="birimtutar" type="metin50" use="required"/> <xsd:attribute name="birimoran" type="metin50" use="required"/> <xsd:attribute name="kalemadi" type="metin255dolu" use="required"/> <xsd:attribute name="islemadi" type="metin255dolu" use="required"/> <xsd:unique name="uniquekalem"> <xsd:selector xpath="kalem"/> <xsd:field </xsd:unique> <xsd:attribute name="islemgrubuadi" type="metin255dolu" use="required"/> <xsd:unique name="uniqueislem"> <xsd:selector xpath="islem"/> <xsd:field </xsd:unique> <xsd:attribute name="eftkodu" type="xsd:int" use="required"/> <xsd:attribute name="adi" type="metin255dolu" use="required"/> <xsd:attribute name="guncellemetarihi" type="xsd:datetime" use="required"/> <xsd:unique name="uniqueislemgrubu"> <xsd:selector xpath="islemgrubu"/> <xsd:field </xsd:unique> <xsd:simpletype name="metin"> <xsd:restriction base="xsd:string"> <xsd:maxlength value="4000"/> </xsd:restriction> </xsd:simpletype> <xsd:simpletype name="metin50"> <xsd:restriction base="xsd:string"> <xsd:maxlength value="50"/> </xsd:restriction> </xsd:simpletype> <xsd:simpletype name="metin255dolu"> <xsd:restriction base="xsd:string"> <xsd:maxlength value="255"/> <xsd:minlength value="1"/> </xsd:restriction> </xsd:simpletype> </xsd:schema>