Inetis DDV

REST API

Zunanje aplikacije lahko izvedejo iskanje z zahtevo na naslov:

https://ddv.inetis.com/iskalnik3.aspx?isci=[iskani niz]

Iskalni niz je lahko:

davčna številka,
matična številka,
besede iz naziva zavezanca ali
številka transakcijskega računa.

REST vmesnik vrača JSON in je priporočena izbira za nove integracije. Za obstoječe WSDL odjemalce je na voljo tudi SOAP API.

Če parameter isci manjka, vsebuje manj kot tri znake ali je daljši od 120 znakov, vmesnik vrne HTTP status 400. Če je za istega odjemalca hkrati odprtih preveč iskanj, vrne 429. Če zadetkov ni, vrne HTTP status 200 in prazen seznam [].

Primer uporabe

const query = new URLSearchParams({ isci: "SI59827513" });
const response = await fetch("https://ddv.inetis.com/iskalnik3.aspx?" + query);
const rezultati = await response.json();

for (const zavezanec of rezultati) {
    console.log(zavezanec.Naziv, zavezanec.IdentifikacijskaStevilkaZaDDV);
}

Primer odgovora

[
  {
    "DavcnaStevilka": "SI59827513",
    "DavcnaStevilkaSubjekta": "59827513",
    "IdentifikacijskaStevilkaZaDDV": "SI59827513",
    "VlogaVDdvSkupini": "",
    "Naziv": "INETIS D.O.O.",
    "ZavezanecZaDDV": true,
    "TransakcijskiRacuni": []
  }
]

SOAP API

SOAP vmesnik je namenjen predvsem obstoječim integracijam in okoljem, kjer odjemalci uporabljajo WSDL definicijo. Na voljo sta SOAP spletna storitev in WSDL definicija.

C# SOAP

var iskalnik = new ddv3.SoapIskalnik3SoapClient();
var niz = "SI59827513";

var rezultati = iskalnik.Isci(niz);
foreach (ddv3.soapZavezanec3 r in rezultati)
{
    Console.Write(r.Naziv);
    Console.Write(" - " + r.IdentifikacijskaStevilkaZaDDV);
    if (r.VlogaVDdvSkupini == "S")
    {
        Console.Write(" (DDV skupina)");
    }
    else if (r.VlogaVDdvSkupini == "Č")
    {
        Console.Write(" (DDV skupina: SI" + r.DavcnaStevilkaDDVSkupine + ")");
    }
    if (0 < r.TransakcijskiRacuni.Count)
    {
        var tr = (ddv3.soapTransakcijskiRacun3)
            r.TransakcijskiRacuni[0];
        Console.Write(" - " + tr.TRR);
    }
    Console.WriteLine();
}

Polja v odgovoru

REST klic iskalnik3.aspx vrne seznam objektov zavezancev v JSON obliki. SOAP metoda Isci vrača vsebinsko enaka polja v tipu soapZavezanec3.

Polja zavezanca

DavcnaStevilka: Prikazna številka zavezanca. Če je zavezanec za DDV, vsebuje DDV identifikacijsko številko s predpono SI; pri članu DDV skupine je to DDV številka skupine. Če subjekt ni zavezanec za DDV, vsebuje navadno davčno številko brez predpone.
DavcnaStevilkaSubjekta: Lastna 8-mestna davčna številka konkretnega subjekta, brez predpone SI. Pri članu DDV skupine se razlikuje od DDV identifikacijske številke, ker član za namene DDV uporablja številko skupine.
IdentifikacijskaStevilkaZaDDV: DDV identifikacijska številka v obliki SI + številka. Pri članu DDV skupine vsebuje DDV številko skupine. Pri subjektu, ki ni zavezanec za DDV, je prazna.
DavcnaStevilkaDDVSkupine: 8-mestna davčna številka DDV skupine, brez predpone SI. Prazna, kadar subjekt ni v DDV skupini. Pri sami DDV skupini je enaka številki DavcnaStevilkaSubjekta.
VlogaVDdvSkupini: Vloga subjekta v DDV skupini: prazno pomeni, da subjekt ni v DDV skupini, S pomeni DDV skupino, Č pomeni člana DDV skupine.
MaticnaStevilka: Matična številka subjekta, kadar je objavljena.
VrstaSubjekta: Vrsta subjekta: P za pravno osebo, F za fizično osebo. To polje ne opisuje članstva v DDV skupini.
PodatkiSubjektaObjavljeni: true, kadar so osnovni podatki subjekta objavljeni; false, kadar FURS osebnih podatkov ne objavlja.
Naziv: Naziv subjekta, kadar je objavljen.
NazivKratek: Kratek naziv subjekta, kadar je objavljen.
Naslov: Naslov subjekta, kadar je objavljen.
ZavezanecZaDDV: true, kadar je subjekt zavezanec za DDV.
PlacnikDDV: true, kadar je subjekt plačnik DDV po 76. a členu ZDDV-1.
DatumRegistracije: Datum registracije za DDV. V REST odzivu je zapisan v ISO obliki, v SOAP odzivu kot datum.
Dejavnost: Šifra dejavnosti subjekta.
DejavnostOpis: Opis dejavnosti iz šifranta dejavnosti. Polje je prazno, kadar opis ni znan.
Skis: SKIS klasifikacija poslovnega subjekta po AJPES PRS podatkih, na primer S.14100. Polje je prazno, kadar klasifikacije ni mogoče povezati z zavezancem.
SkisOpis: Opis SKIS klasifikacije iz šifranta sifrant_skis. Polje je prazno, kadar Skis ni znan ali šifra ni v šifrantu.
Urad: Opis pristojnega finančnega urada.
TransakcijskiRacuni: Seznam transakcijskih računov subjekta.

Polja transakcijskega računa

Polje TransakcijskiRacuni vsebuje seznam računov z naslednjimi polji.

TRR: Številka transakcijskega računa v prikazni obliki.
VrstaRacuna: Oznaka vrste računa iz registra transakcijskih računov.
VrstaRacunaOpis: Opis vrste računa iz šifranta sifrant_trr. Polje je prazno, kadar oznaka vrste računa ni v šifrantu.
ImeBanke: Ime banke oziroma ponudnika plačilnih storitev.
BIC: BIC banke. Polje je na voljo v API verzije 3.
DatumOdprtja: Datum odprtja računa.
DatumZadnjeSpremembe: Datum zadnje spremembe podatkov o računu.
Zaprt: true, kadar je račun zaprt.
DatumZaprtja: Datum zaprtja računa, kadar je račun zaprt.