VIES API konto haldamine kliendipaneeli kaudu
See peatükk annab üksikasjalikku teavet kliendikonto halduspaneelil saadaolevate üksikute vahekaartide ja sätete kohta.
Loo konto
Konto loomiseks peate esitama Email aadress, määrake parool („Password“) ja korrake seda („Confirm Password“) ja seejärel nõustuge Terms and Conditions.

Logi sisse kontole
Sisselogimine toimub, kasutades Email registreerimisel esitatud aadress ja Password.

Sisselogimisekraanil on võimalus unustatud parool taastada („Forgot your password?“):

Pärast e-posti aadressi sisestamist ja nupule vajutamist Reset password nupule vajutades saadab süsteem määratud e-posti aadressile teate, mis võimaldab kasutajal parooli lähtestada.
Kontotüübid
Teenus pakub kahte tüüpi kontosid:
Igale uuele teenuse kasutajale määratakse konto loomisel vaikimisi ettemakstud konto tüüp.
Kasutaja konto saab järelmaksuga kontole üle minna, kui ta on teenust kasutanud vähemalt kolm kuud ja tal on vähemalt aktiivne äripakett.
Järelmaksuga režiimile ülemineku taotlemiseks võtke ühendust klienditeenindusega.
Profiilid – ettevõtte andmete täiendamine
Profile Vahekaarti kasutatakse kasutaja ja ettevõtte andmete haldamiseks.
Company details: See osa tuleb täita arveldamiseks ja VIES-süsteemiga suhtlemiseks kasutatava teabega. Kasutajad saavad käibemaksukohustuslase numbri käsitsi sisestada või kasutada nuppu „Get from VIES” nuppu, et andmeid otse andmebaasist hankida. Muud väljad hõlmavad järgmist: country, company name, postal code, post city, city, street name, building numberja office number.
Lisaks saate määrata spetsiaalse e-posti aadressi, kuhu arved saadetakse (vaikimisi on see sisselogimisaadress) ja lisada arvele lisateavet, nt tellimuse numbri (PO number).
Pärast andmete sisestamist või muutmist ärge unustage muudatust kinnitada, vajutades nuppu Savenupp.
Login email change & Password change: Profiiliosa sisaldab eraldi vorme, mis võimaldavad teil muuta oma sisselogimise e-posti aadressi ja praegust parooli.

Armatuurlaud
Armatuurlaud on teie konto teabekeskus ja annab kiire ülevaate peamistest näitajatest. See sisaldab järgmisi paneele:
AccountKonto olek ja tüüp (nt ettemakstud, aktiivne).SubscriptionTeave praeguse paketi ja selle tasumise kohta (nt Käivituspakett, Tasutud/Mittetasutud).Requests this monthJoondiagramm, mis näitab VIES-süsteemi päringute arvu VIES-i staatuse ja parsitud aadressiandmetega VIES-i staatuse päringute kaupa käesoleval kuul.- Kiirlingid: Nupud, mis viivad
API documentation(„Dokumentatsioon“)REST API Client(„Swagger UI” – võimaldab teil testida API funktsioone brauserist) ja alla laadidaOpenAPI definitionkuiviesapi.yamlfaili.

Tellimus
Sellel vahekaardil saate valida ja muuta oma tariifiplaani.
EU VAT number ja ettevõtte andmed Profile sakk.
Pärast plaani valimist ja nupu vajutamist Buy now nupp , suunatakse kasutaja edasi Payments sakk.
Plaani üksikasjad
Plaani üksikasjade laiendamine („Show details“) võimaldab teil täpselt näha, mida see sisaldab:

API võtmed
API-võtmed on vajalikud teenustele juurdepääsu autentimiseks REST API, klienditeekide ja kõigi muude teenuse pakutavate tööriistade (rakenduste ja lisandmoodulite) kaudu.
Identifier“) on avalik, samas kui võti ise („API key“) on peidetud ja seda saab kopeerida.Actionmenüü

Lisa API-võti
Uue võtme genereerimiseks klõpsake nuppu „+ Add API key„. Vormil saate määrata oma võtmemärgise („Key label„) selle tuvastamise hõlbustamiseks ja valikuliselt juurdepääsu piiramiseks konkreetse sisestamise teel IP address kust saadetakse päringud viesapi.eu teenusele.

Arveldamine
Billing: API-päringute üksikasjalik loend. Kasutajad saavad loendit kuupäeva ja valitud API-võtmete järgi filtreerida. Tabelis kuvatakse request date, key ID, key label, request type (“Request for EU VAT number status in the VIES system“) ja requested value (spetsiifiline ELi käibemaksukohustuslase number).

Maksed
Vaade ettemaksuga kontole
Sest Ettemakstud kontod , selles jaotises saate valida rippmenüüst paketi, määrata kehtivusaja (pikemate perioodide korral on võimalik saada allahindlust, nt 20% 12 kuuks) ning vaadata neto-, käibemaksu- ja brutosummasid.
Kasutaja saab genereerida pro forma arve („Download pro forma invoice“) pangaülekandega maksmiseks või veebimakse tegemiseks makseintegraatorite kaudu Stripe.com või Tpay.com.

Vaade järelmaksuga kontole
Järelmaks Kontovaates kuvatakse selles jaotises tasumisele kuuluvate arvete loend ja saate need PDF-failidena alla laadida.

Tellimused
Orders: Kasutajate tellimuste register. Filtreeri kuupäeva ja tellimuse staatuse järgi. Nähtavate üksuste hulka kuuluvad tellimuse numbrid, kuupäevad, staatused (nt makse kinnituse ootel, Canceled) ja koguhinnad.
Õigeaegselt tasumata tellimused tühistatakse automaatselt.

Statistika
Vahekaart Saadaval professionaalsete ja individuaalsete pakettide jaoks. See kuvab API koondkasutuse päevade kaupa, konkreetsed API-võtmed ja päringutüübid koos tehtud kõnede arvuga („Count“). Samuti on võimalik vaade CSV-faili eksportida.

Monitor
See vahekaart on saadaval ainult professionaalses ja individuaalses paketi puhul.
See võimaldab teil konfigureerida ja automatiseerida käibemaksukohustuslase numbrite rühmade staatuse kontrollimist antud ajahetkel.
Groups: Kasutajad saavad gruppe lisada, muuta ja kustutada. Grupid sisaldavad EL-i käibemaksukohustuslase numbreid, mida kontrollitakse kindlate tsüklite järel. Grupi maksimaalne suurus on 10 000 EL-i käibemaksukohustuslase numbrit.
Checks: Lõpetatud käibemaksukontrollide loend. Tabelis kuvatakse kontrolli kuupäev, EL-i käibemaksukohustuslase number, olek, vastusekood ja kas staatus muutus. Andmeid saab eksportida CSV-vormingusse.

Üksikasjalik kirjeldus EL-i käibemaksukohustuslase numbri jälgimise teenuse toimimise kohta on esitatud järgmises peatükis: https://viesapi.eu/monitoring-eu-vat-numbers-in-vies-service/
Lisa grupp
Grupi definitsiooni lisamine hõlmab selle nime sisestamist ja selle täitmise ajakava määramist:

Muuda gruppi
Grupi muutmine toimib samamoodi nagu lisamine. Pea meeles, et muudatused tuleb kinnitada, klõpsates nupul Save nupp .

Kustuta grupp
Rühma süsteemist kustutamine tähendab selle andmete ajaloo pöördumatut kadumist (enne kustutamist on soovitatav eksportida).

Lisa numbrid valitud rühma
Numbrite liitmine: KMKR-numbreid saab importida CSV-failist valitud gruppidesse või lihtsalt kleepida tekstikasti (üks number rea kohta). Ärge unustage iga EL-i KMKR-numbri puhul lisada riigi eesliidet, nt: PL7171642051.

Logid
See vahekaart on mõeldud äri-, professionaalsete ja individuaalsete pakettide kasutajatele. See võimaldab VIES-i täielike kinnituslogide hulgi allalaadimist. Kasutajad valivad rippmenüüst soovitud kuu (nt 2026-09) ja klõpsavad nuppu „Download” nuppu.

Arved
See vahekaart annab ülevaate väljastatud arvetest, kus on võimalus filtreerida kuupäeva järgi. Loend sisaldab staatust (nt „Unpaid“), väljastamise kuupäev, arve number, summa, maksetähtpäev ja nupp dokumendi PDF-failina allalaadimiseks.
