Storitve G2G - Sezam storitev

Odjemalec lahko pridobi seznam storitev, ki so na voljo. Storitve so združene v skupine storitev (odjemalcu so na voljo dve metodi, ena za pridobitev seznama skupin storitev, druga za pridobitev storitev znotraj skupine).
Za vsako skupino storitev / storitev sistem G2G vrne šifro, oznako, naziv, kratek opis ter spletno povezavo (url) do podrobnejšega opisa. Pri storitvah pa vrne še informacijo, ali je storitev aktivna ali neaktivna.

1. Dostop do skupine storitev
1.1. Klic spletne metode za pridobitev metapodatkov o storitvi
1.1.1. Avtorizacija z uporabniškim certifikatom
Odjemalec pokliče metodo GetGroupOfServicesForG2G. Parametri:

handle - rezultat prijave na eDavke
language - jezik uporabniškega vmesnika odjemalca. Podrobneje.
typeOfRequest - vrsta podatkov, do katerih želimo dostopati. Podrobneje.

Primer: zahteva za vrsto podatkov »Pogodbeni«

string handle = Prijava();
string language = "SI";
string typeOfRequest = "Pogodbeni";
string response = soapService.GetGroupOfServicesForG2G(handle, language, typeOfRequest);

1.1.2. Avtorizacija s strežniškim certifikatom
Odjemalec pokliče na spletnem servisu metodo GetServiceG2P. V parametru document poda XML dokument po shemi http://edavki.durs.si/Documents/Schemas/G2G_SEZ_STOR_V1.xsd.
Primer: zahteva za vrsto podatkov »Pogodbeni«

string document = @"<ZahtevaSeznamStr>
                      <Glava>
                        <Jezik>SI</Jezik>
                        <VrstaPodatkov>Pogodbeni</VrstaPodatkov>
                      </Glava>
                      <Postavke/>
                    </ZahtevaSeznamStr>";
string response = soapService.GetServiceG2P(document);

1.2. Odgovor spletnega servisa

Odgovor je dokument po shemi http://edavki.durs.si/Documents/Schemas/G2G_SEZ_STOR_ODG_V1.xsd
Pomen polj:

SifraSkupineStoritev – šifra skupine storitev. Vsaka skupina ima svojo šifro, vrednost se uporabi v zahtevi za pridobitev seznama storitev v skupini.
OznakaSkupineStoritev – oznaka skupine storitev.
NazivSkupineStoritev – naziv skupine storitev.
Pomoc – kratek opis storitev, ki se nahajajo v skupini.
UrlPomoc – url do dokumenta s podrobnejšim opisom skupine.
StatusOdgovora – ali je pri obdelavi prišlo do napake. V primeru napak so podrobnosti zapisane v elementih "SifraNapake", "NazivNapake", "OpisNapake"

Primer:

<OdgovorSeznamStr xmlns="http://edavki.durs.si/Documents/Schemas/G2G_SEZ_STOR_ODG_V1.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Glava>
    <Jezik>SI</Jezik>
    <StatusOdgovora>0</StatusOdgovora>
    <VrstaPodatkov>Pogodbeni</VrstaPodatkov>
  </Glava>
  <Postavke>
    <SeznamSkupinStoritev>
      <SkupinaStoritev>
        <OznakaSkupineStoritev>G2G</OznakaSkupineStoritev>
        <SifraSkupineStoritev>1</SifraSkupineStoritev>
        <NazivSkupineStoritev>Storitve G2G</NazivSkupineStoritev>
        <Pomoc>Splošne storitve G2G</Pomoc>
        <UrlPomoc>http://test.edavki.si/g2g_help/StorG2G.pdf</UrlPomoc>
      </SkupinaStoritev>
      <SkupinaStoritev>
        <OznakaSkupineStoritev>G2G_NORM</OznakaSkupineStoritev>
        <SifraSkupineStoritev>2</SifraSkupineStoritev>
        <NazivSkupineStoritev>Normiranost</NazivSkupineStoritev>
        <Pomoc>Storitve za preveritev statusa normiranosti</Pomoc>
        <UrlPomoc>http://test.edavki.si/g2g_help/StorNorm.pdf</UrlPomoc>
      </SkupinaStoritev>
    </SeznamSkupinStoritev>
  </Postavke>
</OdgovorSeznamStr>

2. Dostop do seznama storitev v izbrani skupini
2.1. Klic spletne metode za pridobitev metapodatkov o storitvi
2.1.1. Avtorizacija z uporabniškim certifikatom
Odjemalec pokliče metodo GetListOfServicesForG2G. Parametri:

handle - rezultat prijave na eDavke
language - jezik uporabniškega vmesnika odjemalca. Podrobneje.
typeOfRequest - vrsta podatkov, do katerih želimo dostopati. Podrobneje.
groupId - za katero skupino želi uporabnik pridobiti seznam storitev.

Primer: zahteva za vrsto podatkov »Pogodbeni«, skupina storitev 1

string handle = Prijava();
string language = "sl";
string typeOfRequest = "Pogodbeni";
string groupId = "1";
string response = soapService.GetListOfServicesForG2G(handle, language, typeOfRequest);

2.1.2. Avtorizacija s strežniškim certifikatom
Odjemalec pokliče na spletnem servisu metodo GetServiceG2P. V parametru document poda XML dokument po shemi http://edavki.durs.si/Documents/Schemas/G2G_SEZ_STOR_V1.xsd.
Primer: zahteva za vrsto podatkov »Pogodbeni«, skupina storitev 1

string document = "<ZahtevaSeznamStr>
                     <Glava>
                       <Jezik>SI</Jezik>
                       <VrstaPodatkov>Pogodbeni</VrstaPodatkov>
                     </Glava>
                     <Postavke>
                       <SifraSkupineStoritev>1</SifraSkupineStoritev>
                     </Postavke>
                   </ZahtevaSeznamStr>";
string response = soapService.GetServiceG2P(document);

2.2. Odgovor spletnega servisa
Odgovor je dokument po shemi http://edavki.durs.si/Documents/Schemas/G2G_SEZ_STOR_V1_ODG.xsd
Pomen polj:

SifraStoritve – šifra storitve.
OznakaStoritve – oznaka storitve.
NazivStoritve – naziv storitve.
StatusStoritve – status storitve (Aktivna / Neaktivna). V primeru, da je status storitve »Neaktivna«, potem njena uporaba ni mogoča.
Pomoc – kratek opis storitve.
UrlPomoc - url do dokumenta s podrobnejšim opisom skupine.
RazlogNeaktivna – Kratek opis, zakaj storitev ni aktivna (polje je vključeno le pri neaktivnih storitvah).

Primer:

<OdgovorSeznamStr>
  <Glava>
    <Jezik>SI</Jezik>
    <VrstaPodatkov>Pogodbeni</VrstaPodatkov>
    <StatusOdgovora>0</StatusOdgovora>
  </Glava>
  <Postavke>
    <SeznamStoritev>
      <Storitev>
        <OznakaStoritve>DOH_ŠD</OznakaStoritve>
        <SifraStoritve>43</SifraStoritve>
        <NazivStoritve>Posredovanje podatkov o dohodkih študentskim domovom/pisarnam</NazivStoritve>
        <StatusStoritve>Aktivna</StatusStoritve>
        <Pomoc>Storitev vrne seznam dohodkov, ki se upoštevajo pri izračunu višine subvencije študentskega doma.</Pomoc>
        <UrlPomoc>http://test.edavki.si/g2g_help/Stor43.pdf</UrlPomoc>        
      </Storitev>
      <Storitev>
        <OznakaStoritve>NORM_STAT</OznakaStoritve>
        <SifraStoritve>44</SifraStoritve>
        <NazivStoritve>Preverjanje podatka o obstoju potrdila o ugotavljanju davčne osnove z upoštevanjem normiranih odhodkov</NazivStoritve>
        <StatusStoritve>Neaktivna</StatusStoritve>
        <Pomoc>Storitev vrne informacijo, ali za fizično osebo obstaja davčne osnova z upoštevanjem normiranih odhodkov</Pomoc>
        <UrlPomoc>http://test.edavki.si/g2g_help/Stor44.pdf</UrlPomoc>
        <RazlogNeaktivna>Zaradi nadgradnje bo storitev nedostopna do 1.12.2010.</RazlogNeaktivna>
      </Storitev>
    </SeznamStoritev>
  </Postavke>
</OdgovorSeznamStr>

Povezave

Opis osnovnih elementov shem dokumentov