Download Report

_________________________________________
Agencija Republike Slovenije
za javnopravne evidence in storitve
Tržaška cesta 16, 1000 Ljubljana
Služba za informacijsko tehnologijo
Navodilo za uporabo spletnega servisa wsRzppInfo
Datum: marec 2015
SIT_Uporabniška navodila
NAMEN IN ZGODOVINA DOKUMENTA
NEMEN DOKUMENTA
Dokument predstavlja in opisuje metodo spletne storitve wsRzppInfo.
Nadzor dokumenta:
Številka dokumenta:
Naziv dokumenta:
Kratek naziv:
Oznaka dokumenta:
Verzija dokumenta:
Datum dokumenta:
Datum verzije:
Dokument izdelal:
Prejemniki dokumenta:
Skrbnik dokumenta:
382-22/2015
Navodilo za uporabo spletnega servisa wsRzppInfo
Uporabniška navodila
SIT_NAV_RZPP_Navodilo_za_uporabo_servisa_wsRzppInfo
1.0
3. 3. 2015
3. 3. 2015
Stane Bavdek
Uporabniki storitve wsRzppInfo (lizinške hiše)
Stane Bavdek
Zgodovina sprememb:
Ver.
Datum
spremembe
Spremenil
Vsebina spremembe
(spremenjeno/dopolnjeno/izbrisano)
2 od 7
SIT_Uporabniška navodila
VSEBINA
NAMEN IN ZGODOVINA DOKUMENTA .................................................................... 2
NEMEN DOKUMENTA ........................................................................................... 2
VSEBINA .................................................................................................................... 3
Opis spletnega servisa wsRzppInfo ............................................................................ 4
Podatki o wsRzppInfo ................................................................................................. 4
Url storitve: .............................................................................................................. 4
Xml sheme: ............................................................................................................. 4
Metoda servisa............................................................................................................ 5
RzppInfoVrni............................................................................................................ 5
Atributi v xml datoteki .................................................................................................. 6
Status premičnine.................................................................................................... 7
Tip zadeve ............................................................................................................... 7
Seznam napak ............................................................................................................ 7
3 od 7
SIT_Uporabniška navodila
OPIS SPLETNEGA SERVISA WSRZPPINFO
Spletni servis je namenjen neposrednemu povezovanju programskih rešitev uporabnikov z Registrom
neposestnih zastavnih pravic in zarubljenih premičnin (RZPP). Servis omogoča pridobivanje podatkov o
zastavljenih motornih in tirnih vozilih, motornih kolesih ter prikolicah in polprikolicah, v omejenem obsegu
podatkov.
Programske rešitve uporabnika pridobivajo podatke na podlagi posredovane identifikacijske (VIN) številke
vozila.
Uporabnik se ob klicu servisa predstavi z uporabniškim imenom in geslom portala Ajpes, s katerim je bil
izveden nakup paketa poizvedb te storitve na portalu Ajpes.
PODATKI O WSRZPPINFO
URL STORITVE:
Test:
https://wwwt.ajpes.si/wsRzppInfo/RzppInfo.asmx
V testnem okolju se servisu predstavimo z uporabnikom wsRzppInfoTest. Geslo za testnega uporabnika,
uporabnik prejme prek elektronske pošte oziroma prek telefona. Servis vrača podatke iz testnega okolja,
zato ti podatki niso uporabni v produkcijske namene.
Produkcija:
https://www.ajpes.si/wsRzppInfo/RzppInfo.asmx
XML SHEME:
Shema je dosegljiva na naslovu: http://www.ajpes.si/xml_sheme/rzpp/
Ime sheme
Ime datoteke
Namespace
RzppPod
rzpp_info_v1_0.xsd
http://www.ajpes.si/xml_sheme/rzpp/rzpp_info-20150131
4 od 7
SIT_Uporabniška navodila
METODA SERVISA
RZPPINFOVRNI
Metoda vrne podatke o premičnini iz RZPP, ki ustreza posredovanemu identifikatorju.
Klic metode:
RzppInfoVrni(ByVal Identifikator As String, ident() As String) As RzppPod
Vhodni parametri:
Identifikator
ident (0)
ident (1)
ident (2)
– VIN številka vozila
– uporabniško ime na portalu AJPES
– geslo
– šifra storitve (RZPP_MON_P)
Metoda vrne odgovor po shemi RzppPod.
Primer SOAP zahtevka:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RzppInfoVrni xmlns="http://www.ajpes.si/rzpp_info/">
<Identifikator>WVWZZZ9NZVY123456</Identifikator>
<Ident>
<string>wsRzppInfoTest</string>
<string>geslo</string>
<string>RZPP_MON_P</string>
</Ident>
</RzppInfoVrni>
</soap:Body>
</soap:Envelope>
Primer SOAP odgovora:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RzppInfoVrniResponse xmlns="http://www.ajpes.si/rzpp_info/">
<RzppInfoVrniResult xmlns="http://www.ajpes.si/xml_sheme/rzpp/rzpp_info-20150131">
<Ident datum="2015-02-23T11:05:45"/>
<Premicnina identifikacijskaStevilka="WVWZZZ9NZVY123456">
<Status>Zarubljena</Status>
<Znamka>Volkswagen</Znamka>
<Vrsta>osebni avtomobil</Vrsta>
<KomercialnaOznaka>POLO/60</KomercialnaOznaka>
<DatumPrveRegistracije>1999-07-21</DatumPrveRegistracije>
<Zadeve tip="Rubež" stevilka="35897.1"/>
</Premicnina>
</RzppInfoVrniResult>
</RzppInfoVrniResponse>
</soap:Body>
</soap:Envelope>
5 od 7
SIT_Uporabniška navodila
Primer SOAP odgovora ob napaki:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RzppInfoVrniResponse xmlns="http://www.ajpes.si/rzpp_info/">
<RzppInfoVrniResult xmlns="http://www.ajpes.si/xml_sheme/rzpp/rzpp_info-20150131">
<Ident datum="2015-02-18T16:03:37.3860738+01:00" idNapake="-1038">
<OpisNapake>Za to storitev (RZPP_MON_P) ni dovolj sredstev na
računu.</OpisNapake>
</Ident>
</RzppInfoVrniResult>
</RzppInfoVrniResponse>
</soap:Body>
</soap:Envelope>
Primer SOAP odgovora kadar ni podatkov, ki bi ustrezali kriterijem iskanja:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RzppInfoVrniResponse xmlns="http://www.ajpes.si/rzpp_info/">
<RzppInfoVrniResult xmlns="http://www.ajpes.si/xml_sheme/rzpp/rzpp_info-20150131">
<Ident datum="2015-02-23T11:22:03" idNapake="1">
<OpisNapake>Premičnine z vpisanim identifikatorjem
WVWZZZ3NZVY876543 med iskano vrsto premičnin ni v registru.</OpisNapake>
</Ident>
<Premicnina identifikacijskaStevilka=" WVWZZZ3NZVY876543"/>
</RzppInfoVrniResult>
</RzppInfoVrniResponse>
</soap:Body>
</soap:Envelope>
ATRIBUTI V XML DATOTEKI
Pri klicu metode servisa s šifro storitve RZPP_MON_P, servis vrača naslednje atribute:
POLJE_XML
Ident
datum
idNapake
OpisNapake
Premicnina
identifikacijskaStevilka
Status
Znamka
Vrsta
KomercialnaOznaka
DatumPrveRegistracije
Zadeve
tip
stevilka
OPIS
Trenutni datum in čas
Številka napake v primeru neuspešnega klica
Opis napake v primeru neuspešnega klica
VIN številka vozila
Status premičnine
Znamka
Vrsta
Komercialna oznaka
Datum prve registracije
Tip zadeve
Številka zadeve
6 od 7
SIT_Uporabniška navodila
STATUS PREMIČNINE
Ni zastavljena
Plombirana
Zarubljena
Plombirana, Zarubljena
Zastavljena
Plombirana, Zastavljena
Zarubljena, Zastavljena
Plombirana, Zarubljena, Zastavljena
Prepovedana
Plombirana, Prepovedana
Zarubljena, Prepovedana
Plombirana, Zarubljena, Prepovedana
Zastavljena, Prepovedana
Plombirana, Zastavljena, Prepovedana
Zarubljena, Zastavljena, Prepovedana
Plombirana, Zarubljena, Zastavljena, Prepovedana
TIP ZADEVE
Zastava
Rubež
Prepoved
SEZNAM NAPAK
-1020 Napaka. Ni identifikatorja. Vpišite identifikator premičnine.
Identifikator (VIN) ni bil posredovan.
-1035 Napaka. Identifikator vsebuje posebne znake.
Identifikator ne sme vsebovati posebnih znakov.
-1028 Ni podatkov za identifikacijo (Ident)!
Parameter aray Ident ni posredovan.
-1030 Napačna šifra storitve: #SifraStoritve#
Šifra storitve mora biti RZPP_MON_P
-1031 Napačno število parametrov za identifikacijo uporabnika.
Parameter aray Ident mora vsebovati natančno tri elemente.
-1032 Napačno uporabniško ime ali geslo.
Preverja se uporabniško ime in geslo na portalu Ajpes.
-1038 Za to storitev (" #SifraStoritve# ") ni dovolj sredstev na računu.
Obvestilo pomeni, da je presežena količina poizvedb v kupljenem paketu ali da je potekel čas veljavnosti
paketa.
-1010 Sistemska napaka. Poskusite kasneje.
7 od 7