Ölçüm Noktası Kayıt Web Servisi

Transkript

1 Ölçüm Noktası Kayıt Web Servisi Dağıtım şirketleri Serbest Tüketici niteliğindeki (Serbest tüketici hakkını kullanan ve kullanmayan) bütün ölçüm noktalarını kaydetme ve güncelleme için setstolcumnoktasikaydet web servis metodunu kullanabilecektir. Dağıtım şirketinin öncelikle yapması gereken mevcut Serbest Tüketicilerin Tekil No'larını PMUM sisteminde güncellemektir. Tekil No'lar güncellendikten sonra PMUM da kayıtlı olmayan, Serbest Tüketici olabilecek bütün ölçüm noktalarının kaydetmesi gerekmektedir. setstolcumnoktasikaydet metodu çağırılırken yapılan istek içerisinde 'N14' parametreli Ölçüm Noktası EIC(Etso Kodu) Kodu var ise mevcut ölçüm noktasına güncelleme yapılacak demektir. EIC(Etso Kodu) Kod parametresi yok ise PMUM'da kayıtlı olmayan yeni bir Ölçüm Noktası kaydı yapılıyor demektir. Eğer yeni bir kayıt yapılıyorsa kaydedilen ölçüm noktasına PMUM tarafından bir EIC(Etso Kodu) Kod verilir ve sisteme kaydedilir. Herhangi bir hata almadan sisteme kaydedilen mesajlara cevap olarak ; Message fully accepted. dönülür. Aynı mesaj güncelleme için de geçerlidir. Tek istek de en fazla 1000 ölçüm noktası kaydedilebir yada güncellenebilir. Kaydedilen ölçüm noktalarının bilgisine getolcumnoktasiliste web servisiyle ulaşılabilir. PMUMetaDataReport altındaki parametreler genel itibariyle sabit değerler alacak ve aşağıdaki örnekte olduğu gibi kullanılacaktır. SenderIdentification parametresine isteği yapan organizasyonun EIC(Etso Kodu) Kodu gelecektir. Oluşturulacak istek dosyasındaki parametreler ve değerleri: N14 -> Ölçüm Noktası EIC(Etso Kodu) Kod (Güncellemede girilecek) N18 -> Ölçüm Noktası Ad N19 -> Ölçüm Noktası Adres N76 -> Tekil No N21 -> Ölçüm Noktası İlçe (id) N78 -> Ölçüm Noktası Durum (0:pasif, 1:aktif) N58 -> Tenzil Uevçb EIC(Etso Kodu) Kodu N23 -> Trafo Giriş Gerilim N51 -> Trafo Çıkış Gerilim N15 -> Ölçüm Noktası Abone No N24 -> Trafo Merkez N25 -> Trafoya Göre Konum N26 -> Trafoya Göre Konum Diğer N93 -> Bağlantı Noktası Gerilim(id) N29 -> Ölçüm Noktası Kullanım Tip (id) N30 -> Profil Tip (id) N31 -> Profil Abone Grup(id) N32 -> Ölçüm Noktası Okuma Tip (id) N42 -> Ölçüm Noktası Kayıp Tip (id) N41 -> Trafo Gücü N33 -> Bara Gerilim N46 -> Boştaki Kayıp

2 N50 -> İletken Özdirenç N48-> Hat Uzunluk N47 -> Hat Kesit N45 -> Yükteki Kayıp N49 -> Hat Devre Sayısı N35 -> İskk Konf Durum N62 -> Yıllık Ort.Tüketim N52 -> Veriş Pozisyon N53 -> Çekiş Pozisyon Örnek istek dosyası ; <?xml version="1.0" encoding="utf-8"?> <ws:setstolcumnoktasikaydet xmlns:ws=" <PMUMetaDataReport DtdRelease='1' DtdVersion='1'> <DocumentIdentification v='40x ***** ' /> <DocumentVersion v='1' /> <DocumentType v='n08' /> <DocumentStatus v='a02' /> <ProcessType v='n08' /> <ClassificationType v='a01' /> <SenderIdentification codingscheme='a01' v='40x *****' /> <SenderRole v='a27' /> <ReceiverIdentification codingscheme='a01' v='10x1001a1001a56w' /> <ReceiverRole v='a11' /> <DocumentDateTime xsi:nil='true' <DataPeriod v='' /> <Domain codingscheme='a01' v='10ytr-1001a0006o' /> <DataSeries> <SendersDataSeriesIdentification v=' ' /> <BusinessType v='n08' /> <Area codingscheme='a01' v='10ytr-1001a0006o' /> <Party xsi:nil='true' <AgreementIdentification xsi:nil='true' <Type v='n18' /> <Value v='tesis Ad' /> <Type v='n19' /> <Value v='adres' /> <Type v='n76' /> <Value v='tekil No' /> <Type v='n21' /> <Value v='1195' /> <Type v='n78' />

3 <Value v='1' /> <Type v='n58' /> <Value v='***********' /> <Type v='n23' /> <Value v='34.5' /> <Type v='n51' /> <Value v='0.4' /> <Type v='n15' /> <Value v='abone No' /> <Type v='n24' /> <Value v='460' /> <Type v='n25' /> <Value v='5' /> <Type v='n26' /> <Value v='' /> <Type v='n93' /> <Value v='9' /> <Type v='n29' /> <Value v='1' /> <Type v='n30' /> <Value v='1' /> <Type v='n31' /> <Value v='2' /> <Type v='n32' /> <Value v='2' /> <Type v='n42' /> <Value v='2' /> <Type v='n41' /> <Value v='0.4' /> <Type v='n33' /> <Value v='9' />

4 <Type v='n46' /> <Value v='' /> <Type v='n50' /> <Value v='' /> <Type v='n48' /> <Value v='' /> <Type v='n47' /> <Value v='' /> <Type v='n45' /> <Value v='' /> <Type v='n49' /> <Value v='' /> <Type v='n35' /> <Value v='0' /> <Type v='n62' /> <Value v='**.**' /> <Type v='n52' /> <Value v='' /> <Type v='n53' /> <Value v='' /> </DataSeries> </PMUMetaDataReport> </ws:setstolcumnoktasikaydet> * id değeri girilecek parametreler ve açıklamaları dökümanın en sonunda açıklanmıştır. * Ölçüm noktası okuma tip serbest tüketiciler için 2 olmalıdır. Kayıtlı Ölçüm Noktası Alma Web Servisi PMUM'da kayıtlı ölçüm noktalarının verisini web servisle alabilmek için getolcumnoktasiliste web servisi kullanılacaktır. Bu metod <olcumnoktasikodu> ve <liste> parametrelerini alacaktır. <olcumnoktasikodu> : Bu alana EIC(Etso Kodu) Kodu yada Tekil No gelebilir. Sorgulama neye göre yapılmak istenirse buraya o değer girilmeli. Bu alana Tekil No girilirse sadece girilen tekil no'ya ait ölçüm noktası bilgisi gelir. Ölçüm noktaları sıralı bir şekilde verilecektir. İlk sıradaki EIC(Etso Kodu) kod bilinmiyorsa bu parametreye 0 değeri verilirse ilk kayıt verilir.

5 <liste> : Bu alana girilen değer yanlızca true yada false olabilir. false girilirse sadece girilen ölçüm noktası koduna ait ölçüm noktası verileri getirilir. true girilirse girilen EIC(Etso Kodu) Kodundan itibaren sıralı bir şekilde tane ölçüm noktası verisi gelir. Gelen verinin en sonundaki EIC(Etso Kodu) kod bu servise tekrar gönderilirse ondan sonraki ölçüm noktası gelir. Böylece dağıtım şirketi er er bütün ölçüm noktası verisine ulaşabilir. Örnek istek dosyası ; <?xml version="1.0" encoding="utf-8"?> <impl:getolcumnoktasiliste xmlns:impl=" <olcumnoktasikodu>*****</olcumnoktasikodu> <liste>true</liste> </impl:getolcumnoktasiliste> Ölçüm Noktası Talep Etme Web Servisi Ölçüm noktası talep edebilmek için setolcumnoktasitalep web servis metodu kullanılacaktır. Yapılan talebin güncellenmesi de yine bu metod üzerinden yapılacaktır. Bu metodu kullanarak ölçüm noktası talep etmek için gönderilen PMUMetaDataReport isteğindeki parametreler genel itibariyle sabit değerler alacak ve aşağıdaki örnekte oladuğu gibi kullanılacaktır. Sadece SenderIdentification parametresine isteği yapan organizasyonun EIC(Etso Kodu) Kodu gelecektir. Bir istekte en fazla 1000 ölçüm noktası talep edilebilecektir. İstekte yer alan DataSeries altında 4 DataEntry olmalı. Z27 -> Talep edilecek ölçüm noktasının EIC(Etso Kodu) kodu Z29 -> Talep Tip (id) Z34 -> İkili anlaşma bildirim formu(0 yada 1) Z35 -> ikili anlaşma iptal bildirim formu (0 yada 1). setolcumnoktasitalep web servisi kullanılarak mevcut talep de güncelleme yapabilmek için gönderilen PMUMetaDataReport isteği içerisindeki parametreler aşağıdaki gibi olmalı. Z27 -> Talep edilecek ölçüm noktasının EIC(Etso Kodu) kodu Z28 -> Talep Dönem Z30 -> Talep Durum(0 yada 1) Z36 -> Talep Güncelleme Neden Z34 -> İkili anlaşma bildirim formu(0 yada 1) Z35 -> ikili anlaşma iptal bildirim formu (0 yada 1). Aktif bir talebi pasife çekmek için talep duruma 0 girilmelidir.

6 Örnek istek dosyası ; <?xml version="1.0" encoding="utf-8"?> <ws:setolcumnoktasitalep xmlns:ws=" <PMUMetaDataReport DtdRelease='1' DtdVersion='1'> <DocumentIdentification v='40x ***** ' /> <DocumentVersion v='1' /> <DocumentType v='n08' /> <DocumentStatus v='a02' /> <ProcessType v='n08' /> <ClassificationType v='a01' /> <SenderIdentification codingscheme='a01' v='40x *****' /> <SenderRole v='a27' /> <ReceiverIdentification codingscheme='a01' v='10x1001a1001a56w' /> <ReceiverRole v='a11' /> <DocumentDateTime xsi:nil='true' <DataPeriod v='' /> <Domain codingscheme='a01' v='10ytr-1001a0006o' /> <DataSeries> <SendersDataSeriesIdentification v=' ' /> <BusinessType v='n08' /> <Area codingscheme='a01' v='10ytr-1001a0006o' /> <Party xsi:nil='true' <AgreementIdentification xsi:nil='true' <Type v='z27'/> <Value v='40z10000*****'/> <Type v='z29'/> <Value v='1'/> <Type v='z34'/> <Value v='1'/> <Type v='z35'/> <Value v='0'/> </DataSeries> </PMUMetaDataReport> </ws:setolcumnoktasitalep> * Talep Tip id değeri dökümanın en sonunda açıklanmıştır. * Portföyden çıkış taleplerinde Z35 parametresi 1, Z34 parametresi 0 olmalıdır. Portföy'e alma taleplerinde ise Z35 parametresi 0, Z34 parametresi 1 olmalıdır.

7 Ölçüm Noktası Talep Listeleme Web Servisi getolcumnoktasitalepliste web servis metoduyla sizin talep ettiğiniz ölçüm noktaları ve sizden talep edilen ölçüm noktaları alınabilecek. Dönem ve tür parametreleri alacak bu web serviste bu iki parametre kesinlikle girilmelidir. Tür parametresi 0 yada 1 olabilir. Bu parametre 0 ise benim taleplerim 1 ise benden talep edilenler listesini getirir. Örnek istek dosyası ; <?xml version="1.0" encoding="utf-8"?> <ws:getolcumnoktasitalepliste xmlns:ws=" <date> t00:00z</date> <tur>0</tur> </ws:getolcumnoktasitalepliste> Dönen cevap dosyasında ; Z27 -> Etso Kod N15 -> Abone No N18 -> Ölçüm Noktası Adı N19 -> Ölçüm Noktası Adres N20 -> Ölçüm Noktası il id N21 -> Ölçüm Noktası ilçe adı Z28 -> Talep Dönem Z29 -> Talep Tip Z30 -> Talep Durum Z31 -> Talep Ekleme Tarih Z32 -> Talep Iptal Organizasyon Z33 -> Talep IABF Durum Z37 -> Talep Organizasyon Z38 -> Talep Iptal Tarih Tekil No ya da Abone ile EIC(Etso Kodu) Kod Sorgulama getolcumnoktasietsokod web servis metodunda yapılan son değişiklik ile piyasa katılımcıları yaptıkları PMUMetaDataReport isteğinde gönderikleri Etso Kod(EIC), Tekil No ya da Abone No'ya ait belirli ölçüm noktası bilgilerini alabilecekler. Etso Kod(N14), Tekil numara(n76) ya da Abone Numara(N15) değerlerinden en az bir tanesinin ve DataSeries içersindeki Party parametresinin kesinlikle girilmesi gerekmektedir. Party kısmına o ölçüm noktasının sayaç okuyan kurum Etso Kodu(EIC) gelmelidir. PMUMetaDataReport isteğindeki SenderIdentification kısmına ise isteği yapan organizasyonun Etso Kodu(EIC) kodu gelmelidir. Sadece abone numarasına göre yapılan sorgularda birden fazla kayıt gelebileceği için dönen cevapta birden fazla dataseries olabilir. <?xml version="1.0" encoding="utf-8"?> <ws:getolcumnoktasietsokod xmlns:ws=" <PMUMetaDataReport DtdRelease='1' DtdVersion='1'> <DocumentIdentification v='40x ***** ' /> <DocumentVersion v='1' /> <DocumentType v='n08' /> <DocumentStatus v='a02' /> <ProcessType v='n08' /> <ClassificationType v='a01' /> <SenderIdentification codingscheme='a01' v='40x *****' />

8 <SenderRole v='a27' /> <ReceiverIdentification codingscheme='a01' v='10x1001a1001a56w' /> <ReceiverRole v='a11' /> <DocumentDateTime xsi:nil='true' <DataPeriod v='' /> <Domain codingscheme='a01' v='10ytr-1001a0006o' /> <DataSeries> <Party xsi:nil='true' xmlns:xsi=' v ='40X *****'/> <Type v='n14'/> <Value v='***'/> <Type v='n15'/> <Value v='*******'/> <Type v='n76'/> <Value v='***'/> </DataSeries> </PMUMetaDataReport> </ws:getolcumnoktasietsokod> Dönen cevap dosyasında ; N76 -> Tekil No N15 -> Abone No N14 -> EIC(Etso Kodu) Kod N29 -> Ölçüm Noktası Kullanım Tip (id) N18 -> Ölçüm Noktası Adı N19 -> Ölçüm Noktası Adres N20 -> Ölçüm Noktası İl Id N21 -> Ölçüm Noktası İlçe Id Trafoya Göre Konum 1 Yükseltici Transformator Çikisi 2 Indirici Transformator Girisi 3 Karsi Uc Fider 4 Yükseltici Transformator Girisi 5 Indirici Transformator Cikisi 6 Diger

9 Bağlantı Noktası Gerilim 1 380, , ,0 4 66,0 5 36,0 6 15,8 7 11,5 8 6,3 9 0, ,0 Ölçüm Noktası Kullanım Tip 1 Serbest Tüketici Hakkına Sahip (ST) 2 Serbest Tüketici Adayı (ST Aday) 3 Ölçüm Noktası Boşta (O.N.Boşta) Ölçüm Noktası Talep Tip 1 Yeni Kayıt 2 Tedarikçi Değişimi 3 Portföyden Çıkış 4 Tahliye Portföyden Çıkış 5 Yeni Kayıt Ön Bildirim 6 Tedarikçi Değişimi Ön Bildirim 7 Portföyden Çıkış Ön Bildirim 9 Yeni Kayıt Nihai Bildirim 10 Tedarikçi Değişimi Nihai Bildirim 11 Portföyden Çıkış Nihai Bildirim 12 Tahliye Portföyden Çıkış Nihai Bildirim 13 Yeni Kayıt Çoklu Talep 14 Tedarikçi Değişimi Çoklu Talep 15 Ölçüm Noktası Pasif Durumda 16 Ölçüm Noktası Tekil No Mevcut Değil(Dağıtıma Başvurunuz)

10 Ölçüm Noktası Profil Tip 1 Normal 2 Alternatif Ölçüm Noktası Kayıp Tip 0 Iletim Kaybi 1 Orta Gerilim Kaybi 2 Alçak Gerilim Kaybi 3 Kayıp Yok Soru, Görüş ve Önerileriniz için; Semih AKIN Bilgisayar Mühendisi Piyasa Mali Uzlaştırma Merkezi(PMUM) semihakin@pmum.gov.tr