Uvod

Storitev Viesapi.eu zagotavlja podatke izbranih podjetnikov z uporabo spletnih storitev, programskih knjižnic in namenskih aplikacij. Z uporabo razpoložljive programske opreme (knjižnice, aplikacije in Excelov dodatek) bodo vaše stranke lahko:

preverjanje statusa EU DDV številke izvajalcev v sistemu VIES,
prenesite podatke o podjetju iz sistema VIES,
avtomatsko izpolnjevanje obrazcev za račune,

na najhitrejši možni način.

Ta dokument podrobno opisuje, katere korake je treba izvesti za pravilno integracijo s storitvijo viesapi.eu.

Pozor! Celotno funkcionalnost lahko preverite s priloženim Test VIES API. Z uporabo API TEST je mogoče preveriti vse funkcije, ki so na voljo v plačljivih paketih brez potrebe po ustvarjanju računa.

Za dostop do produkcijskega vmesnika API sledite spodnjim korakom.

Prvi korak je registracija v sistemu in ustvarjanje računa. Zahvaljujoč temu bo mogoče prenesti programsko opremo in jo dodatno konfigurirati za pravilno komunikacijo s spletnimi storitvami, ki jih ponuja storitev viesapi.eu.

Registracija

Obvezna je registracija subjekta, ki želi uporabljati funkcionalnosti storitve viesapi.eu. Če želite to narediti, pojdite na Registracija strani in izpolnite ustrezen obrazec. Pogoj za uporabo storitve viesapi.eu je sprejetje predpisov. Pravilno izpolnitev obrazca in klik na Prijavite se gumb ustvari račun v storitvi viesapi.eu in njegovo samodejno aktivacijo.

Vpiši se

Prijava v aktiviran račun je možna po vnosu Zavihek za prijavo ter vnos e-poštnega naslova in gesla, ki ste ga določili ob registraciji. Po pravilni avtentikaciji je možno upravljanje računa. Uporabnik lahko na svojem računu ustvari identifikatorje in dostopne ključe, ki se uporabljajo za njegovo avtentikacijo v sistemu.

Generiranje identifikatorja (identifier) in ključa za dostop (key)

Ob prvi prijavi se an identifier se ustvari samodejno skupaj z ustreznim key. The identifier je javen in ne potrebuje varstva, medtem ko je key je zasebno in ne bi smelo biti na voljo tretjim osebam. Poleg tega lahko uporabnik za večjo varnost vnese IP address od koder lahko prihajajo poizvedbe. To je lahko na primer naslov IP spletne trgovine. Število generiranih parov ključev in identifikatorjev ni omejeno. V primeru, da uporabnik ne želi uporabljati nobenega para identifikator-ključ, ga lahko izklopi tako, da spremeni njegov status.

API ključi

Trenutno razpoložljive metode dostopa do VIES API

Spodaj predstavljamo možne načine dostopa do VIES API. Kliknite na naslov ali povezavo do dokumentacije za podrobnosti.

1. Programske knjižnice: PHP, .NET (C#, Visual Basic, SQL Server, Access, Dynamics, FoxPro), Python, Java, C/C++, JavaScript

Tehnična dokumentacija in podroben opis uporabe knjižnic sta na voljo v Dokumentacija zavihek.

Datoteke knjižnic lahko prenesete s povezanega spletnega mesta Prenesi.

2. Microsoft Excel VIES API dodatek

Za ljudi, ki vsakodnevno uporabljajo aplikacijo Excel, smo pripravili dodatek, enostaven za uporabo. Omogoča vam učinkovito (brez znanja programiranja) preverjanje statusa subjekta na beli listi, registru za DDV in sistemu VIES ter iskanje in prenos podatkov subjektov ter preverjanje njihovega trenutnega statusa poslovanja.

Podrobnosti o namestitvi, konfiguraciji in uporabi MS Excel VIES API dodatek strani.

3. Preverjevalnik prijav za DDV v EU (GUI)

Aplikacija VIES Checker omogoča nalaganje poljubne CSV datoteke za preverjanje subjektov (pogodbenikov), katerih EU DDV številke so shranjene v CSV datoteki glede na njihov status v sistemu VIES.

Podrobnosti o namestitvi, konfiguraciji in uporabi so opisane neposredno na Aplikacija VIES Checker strani.

Aplikacija ne potrebuje namestitve in skrbniških pravic za delovanje. Lahko ga prenesete iz Prenesi strani.

4. EU DDV CLI/CMD Checker

VIES CLI/CMD Checker je odjemalska aplikacija, ki omogoča hitro in samodejno preverjanje subjektov (pogodbenikov) iz nivoja ukazne vrstice (CLI/CMD) glede na njihov trenutni status v sistemu VIES.

Podrobnosti o namestitvi, konfiguraciji in uporabi so opisane neposredno na VIES Checker CLI/CMD strani.