Inetis DDV

Dostop do iskalnika

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.

Na voljo je tudi SOAP spletna storitev z naslednjo WSDL definicijo. Programski primeri so spodaj.

API odgovor

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

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

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.

Programski primeri za REST in SOAP

REST API

REST vmesnik vrača JSON in je priporočena izbira za nove integracije.

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);
}

SOAP API

SOAP vmesnik je namenjen predvsem obstoječim integracijam in okoljem, kjer odjemalci uporabljajo WSDL definicijo.

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();
}

PHP SOAP

$search = array('iskalni_niz' => 'SI59827513');
$url = 'https://ddv.inetis.com/Iskalnik3.asmx?WSDL';
$client = new SoapClient($url);
$data = $client->Isci($search);
print_r($data);

Python SOAP

from zeep import Client

client = Client('https://ddv.inetis.com/Iskalnik3.asmx?wsdl')
result = client.service.Isci('inetis')
print(result)

VB.NET SOAP

Dim iskalnik As New DDV3.SoapIskalnik3SoapClient
Dim niz As String = "SI59827513"

Dim rezultati As List(Of DDV3.soapZavezanec3) = iskalnik.Isci(niz)
For Each r As DDV3.soapZavezanec3 In rezultati
    Console.Write(r.Naziv)
    Console.Write(" - " & r.IdentifikacijskaStevilkaZaDDV)
    If r.VlogaVDdvSkupini = "S" Then
        Console.Write(" (DDV skupina)")
    ElseIf r.VlogaVDdvSkupini = "Č" Then
        Console.Write(" (DDV skupina: SI" & r.DavcnaStevilkaDDVSkupine & ")")
    End If
    If 0 < r.TransakcijskiRacuni.Count Then
        Dim tr As DDV3.soapTransakcijskiRacun3
        tr = r.TransakcijskiRacuni(0)
        Console.Write(" - " & tr.TRR)
    End If
    Console.WriteLine()
Next