Back

UDHËZIM TEKNIK për ueb shërbimin e Bankës Popullore për listën e kursit dhe kurset e këmbimit për organet shtetërore

Në faqen e internetit të Bankës Popullore të Republikës së Maqedonisë së Veriut është i disponueshëm aplikacioni „ueb-shërbimi“ (ang. web service) dedikuar për shkarkimin automatik të të dhënave të listës së kursit të këmbimit në format „xml“ (xml) ose „xhejson“ (JSON), në adresën vijuese:

https://www.nbrm.mk/KLServiceNOV/imenametoda?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml ose json)

ose

https://www.nbrm.mk/KLServiceNOV/imenametoda?StartDate=dd-MМM-yyyy&EndDate=dd-MМM-yyyy&format=(xml ose json)

Ueb shërbimi disponon me katër metoda. Dy të parat i referohen listës së kursit të këmbimit, ndërsa dy të tjerat kurseve të këmbimit të BPRMV-së gjatë kryerjes së qarkullimit pagesor me vendet e huaja për nevojat e organeve shtetërore.

Lista e kursit të këmbimit:

1. GetExchangeRate
   https://www.nbrm.mk/KLServiceNOV/GetExchangeRate?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml ose json)
2. GetExchangeRateD
   https://www.nbrm.mk/KLServiceNOV/GetExchangeRateD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml ose json)

Kurset e këmbimit të BPRMV-së gjatë kryerjes së qarkullimit pagesor me vendet e huaja për nevojat e organeve shtetërore:

1. GetExchangeRates
   https://www.nbrm.mk/KLServiceNOV/GetExchangeRates?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml ose json)
2. GetExchangeRatesD
   https://www.nbrm.mk/KLServiceNOV/GetExchangeRatesD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml ose json)

Me përdorimin e ueb metodave: GetExchangeRate и GetExchangeRateD fitohet rezultat i ngjashëm: lista e kursit të këmbimit të Bankës Popullore të Republikës së Maqedonisë së Veriut. Dallimi i vetëm ndërmjet tyre është lloji i parametrave të cilat u përcillen:

1. GetExchangeRatepranon dy parametra: StartDate dhe EndDate. Që të dy parametrat duhet të jenë në format sekuence {String} dhe të prezantojnë datë të vlefshme në formë: dd.MM.yyyy (Shembull:StartDate=01.02.2010;EndDate=15.02.2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRate?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml%20ose%20json)

2. GetExchangeRateD pranon dy parametra: StartDate dhe EndDate. Që të dy parametrat duhet të jenë të vlefshme në format Date (Date) dhe të prezantojnë datë të vlefshme. (Shembull: StartDate=12-feb-2010; EndDate=15-feb-2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRateD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml%20ose%20json)

Si rezultat i përdorimit të ueb metodave GetExchangeRate dhe GetExchangeRateD fitohet lista e kursit të këmbimit, e cila përbëhetnga fushat në vijim:

1. Fusha: RBr lloji i të dhënave: double - Numri rendor i listës së kursit
2. Fusha: Datum lloji i të dhënave: DateTime - Data dhe vlefshmëria e listë së kursit
3. Fusha: Valuta lloji i të dhënave: double - Shifra e valutës
4. Fusha: Nomin lloji i të dhënave: double - Njësi valutore
5. Fusha: Oznaka lloji i të dhënave: string - Shenja e valutës
6. Fusha: Drzava lloji i të dhënave: string - Emri i shtetit - maqedonisht
7. Fusha: DrzavaAng lloji i të dhënave: string - Emri i shtetit - anglisht
8. Fusha: DrzavaAl lloji i të dhënave: string - Emri i shtetit - shqip
9. Fusha: NazivMak lloji i të dhënave: string - Emri i valutës - maqedonisht
10. Fusha: NazivAng lloji i të dhënave: string - Emri i valutës - anglisht
11. Fusha: NazivAl lloji i të dhënave: string - Emri i valutës - shqip
12. Fusha: Sreden lloji i të dhënave: double - Kursi mesatarë në denarë
13. Fusha: Datum_f lloji i të dhënave: double - Data e formimit të listës së kursit

Gjatë përdorimit të ueb metodave:GetExchangeRates dhe GetExchangeRatesD fitohet rezultat i ngjashëm: kurset e këmbimit të Bankës Popullore gjatë kryerjes së qarkullimit pagesor me vendet e huaja për nevojat e organeve shtetërore. Dallimi i vetëm ndërmjet tyre është lloji i parametrave të cilëve u përcillen:

3. GetExchangeRates i cili pranon dy parametra: StartDate dhe EndDate. Që të dy parametrat duhet të jenë në format sekuence (String) dhe të prezantojnë datë të vlefshme në formën: dd.MM.yyyy (Shembull: StartDate=01.02.2010; EndDate=15.02.2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRates?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml%20ose%20json)

4. GetExchangeRatesD i cili pranon dy parametra: StartDate dhe EndDate.Që të parametrat duhet të jenë në format Datë (Date) dhe të prezantojnë datë të vlefshme. (Shembull: StartDate=12-feb-2010; EndDate=15-feb-2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRatesD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml%20ose%20json)

Gjatë përdorimit të ueb metodave GetExchangeRates dhe GetExchangeRatesD, si rezultat fitohet lista e kursit të këmbimit e formuar nga fushat vijuese:

1. Fusha: RBr lloji i të dhënave: double - Numri rendor i listës së kursit
2. Fusha: Datum lloji i të dhënave: DateTime - Data dhe vlefshmëria e listë së kursit
3. Fusha: Valuta lloji i të dhënave: double - Shifra e valutës
4. Fusha: Nomin lloji i të dhënave: double - Njësi valutore
5. Fusha: Oznaka lloji i të dhënave: string - Shenja e valutës
6. Fusha: Drzava lloji i të dhënave: string - Emri i shtetit - maqedonisht
7. Fusha: DrzavaAng lloji i të dhënave: string - Emri i shtetit - anglisht
8. Fusha: DrzavaAl lloji i të dhënave: string - Emri i shtetit - shqip
9. Fusha: NazivMak lloji i të dhënave: string - Emri i valutës - maqedonisht
10. Fusha: NazivAng lloji i të dhënave: string - Emri i valutës - anglisht
11. Fusha: NazivAl lloji i të dhënave: string - Emri i valutës - shqip
12. Fusha: Sreden lloji i të dhënave: double - Kursi mesatarë në denarë
13. Fusha: Kupoven lloji i të dhënave: double - Kursi blerës në denarë
14. Fusha: Prodazen lloji i të dhënave: double - Kursi shitës në denarë
15. Fusha: Datum_f lloji i të dhënave: double - Data e formimit të listës së kursit