Upravljanje VIES API računom putem klijentske ploče

Ovo poglavlje pruža detaljne informacije koje opisuju pojedinačne kartice i postavke dostupne u upravljačkoj ploči za korisnički račun.

Izradi račun

Za izradu računa morate navesti Email adresa, postavite lozinku („Password") i ponovite to ("Confirm Password“), a zatim prihvatite Terms and Conditions.

.

Prijava na račun

Prijava se vrši pomoću Email adresa navedena prilikom registracije i Password.

Na zaslonu za prijavu postoji opcija za oporavak zaboravljene lozinke („Forgot your password?“):

Nakon unosa adrese e-pošte i pritiska na Reset password gumb, sustav će poslati poruku na navedenu adresu e-pošte koja će korisniku omogućiti resetiranje lozinke.

Vrste računa

Usluga nudi dvije vrste računa:

• Prepaid – vrsta prepaid računa koja zahtijeva plaćanje prije korištenja Usluga.
• Postpaid – vrsta pretplatničkog računa koja zahtijeva plaćanje nakon korištenja Usluga.

Svakom novom Korisniku usluge prema zadanim postavkama dodjeljuje se vrsta prepaid računa prilikom kreiranja računa.

Korisnikov račun može se prebaciti na pretplatu ako je koristio Uslugu najmanje tri mjeseca i ima barem aktivni Poslovni plan.

Za prelazak na pretplatni način rada obratite se Službi za korisnike.

Profili – Popunjavanje podataka o tvrtki

Profile Kartica se koristi za upravljanje korisničkim i poslovnim podacima.

Company details: Ovaj odjeljak treba ispuniti informacijama koje se koriste za fakturiranje i komunikaciju s VIES sustavom. Korisnici mogu ručno unijeti PDV broj ili koristiti "Get from VIES” za izravno dohvaćanje podataka iz baze podataka. Ostala polja uključuju: country, company name, postal code, post city, city, street name, building number, i office number.

Osim toga, možete odrediti namjensku adresu e-pošte na koju će se slati računi (prema zadanim postavkama, ovo je adresa za prijavu) i uključiti dodatne podatke na računu, npr. broj narudžbe (broj narudžbenice).

Nakon što unesete ili promijenite podatke, ne zaboravite potvrditi promjenu pritiskom na Savegumb.

Login email change & Password change: Odjeljak profila sadrži zasebne obrasce koji vam omogućuju promjenu adrese e-pošte za prijavu i promjenu trenutne lozinke.

Nadzorna ploča

Nadzorna ploča je informacijski centar vašeg računa i pruža brz pregled ključnih metrika. Uključuje sljedeće ploče:

  • AccountStatus i vrsta računa (npr. Prepaid, Aktivan).
  • SubscriptionInformacije o trenutnom planu i njegovom plaćanju (npr. Početni, Plaćeno/Nije plaćeno).
  • Requests this monthLinijski grafikon koji prikazuje broj zahtjeva VIES sustava raščlanjenih prema VIES statusu i zahtjevima za VIES status s raščlanjenim podacima o adresi u tekućem mjesecu.
  • Brze poveznice: Gumbi koji vode do API documentation („Dokumentacija“), REST API Client („Swagger UI“ – omogućuje vam testiranje API funkcija iz preglednika) i preuzimanje OpenAPI definition kao viesapi.yaml datoteka.

.

Pretplata

Ova kartica vam omogućuje odabir i promjenu tarifnog plana.

• Bilješka: Plaćeni planovi mogu se koristiti tek nakon što navedete svoje EU VAT broj i podatke o tvrtki u Profile tab.
• Dostupni paketi uključuju Startup (10,00 EUR), Business (30,00 EUR) i Professional (50,00 EUR).

Nakon odabira plana i pritiska na Buy now gumb , korisnik se prebacuje na Payments tab.

.Detalji plana

Proširivanje detalja plana („Show details„) vam omogućuje da točno vidite što uključuje:

API ključevi

API ključevi su potrebni za autentifikaciju pristupa uslugama putem REST API-ja, klijentskih biblioteka i svih ostalih alata koje pruža usluga (aplikacije i dodaci).

• Korisnik može generirati neograničen broj ključeva.
• Ključni identifikator („Identifier„) je javan, dok je sam ključ („API key„) je skriven i može se kopirati.
• Ključeve na popisu možete uređivati i deaktivirati pomoću opcije "Action" Jelovnik

.

Dodaj API ključ

Za generiranje novog ključa kliknite "+ Add API key„. U obrascu možete definirati vlastitu oznaku tipke („Key label„) kako bi se olakšala njegova identifikacija i opcionalno ograničio pristup unosom određenog IP address s kojeg će se slati zahtjevi prema viesapi.eu usluzi.

Naplata

Billing: Detaljan popis API zahtjeva. Korisnici mogu filtrirati popis prema datumu i odabranim API ključevima. Tablica prikazuje request date, key ID, key label, request type (“Request for EU VAT number status in the VIES system"), i requested value (specifični PDV broj EU-a).

.Plaćanja

Prikaz za prepaid račun

Za Prepaid računi , ovaj odjeljak vam omogućuje odabir plana s padajućeg popisa, određivanje razdoblja važenja (s mogućnošću popusta za dulja razdoblja, npr. 20% na 12 mjeseci) i pregled Neto, PDV i Bruto iznosa.

Korisnik može generirati predračun („Download pro forma invoice„) za plaćanje bankovnim prijenosom ili plaćanje online putem integratora plaćanja Stripe.com ili Tpay.com.

.

Prikaz za pretplaćeni račun

Naknadno plaćanje prikaz računa, ovaj odjeljak prikazuje popis računa koje treba platiti i omogućuje vam njihovo preuzimanje kao PDF datoteke.

Narudžbe

Orders: Zapis korisničkih narudžbi. Filtrirajte po datumu i statusu narudžbe. Vidljive stavke uključuju brojeve narudžbi, datume, statuse (npr. potvrda plaćanja na čekanju, Canceled) i ukupne cijene.

Narudžbe koje nisu plaćene na vrijeme automatski se otkazuju.

Statistika

Kartica Dostupno za profesionalne i individualne planove. Prikazuje agregiranu upotrebu API-ja po danu, specifične API ključeve i vrste upita, zajedno s brojem upućenih poziva („Count„). Također ima mogućnost izvoza prikaza u CSV datoteku.

.

Monitor

Ova kartica je dostupna samo u profesionalnim i individualnim planovima.

Omogućuje vam konfiguriranje i automatizaciju provjere statusa grupa PDV brojeva u određenom trenutku.

Groups: Korisnici mogu dodavati, uređivati i brisati grupe. Grupe sadrže PDV brojeve EU koji će se provjeravati u određenim ciklusima. Maksimalna veličina grupe je 10.000 PDV brojeva EU.

Checks: Popis dovršenih PDV provjera. Tablica prikazuje datum provjere, PDV broj EU-a, status, kod odgovora i je li došlo do promjene statusa. Podaci se mogu izvesti u CSV.

Detaljan opis načina rada usluge praćenja PDV broja EU nalazi se u poglavlju: https://viesapi.eu/monitoring-eu-vat-numbers-in-vies-service/

Dodaj grupu

Dodavanje definicije grupe uključuje unos njenog naziva i postavljanje rasporeda za njeno izvršavanje:

Uredi grupu

Izmjena grupe funkcionira na isti način kao i dodavanje nove. Samo ne zaboravite potvrditi promjene klikom na Save gumb .

Izbriši grupu

Brisanje grupe iz sustava znači nepovratan gubitak povijesti za te podatke (preporučuje se izvoz prije brisanja).

Dodaj brojeve odabranoj grupi

Zbrajanje brojeva: PDV brojevi mogu se uvesti iz CSV datoteke u odabrane grupe ili jednostavno zalijepiti u tekstualni okvir (jedan broj po retku). Ne zaboravite uključiti prefiks države za svaki PDV broj EU-a, npr.: PL7171642051.

Zapisnici

Ova kartica je namijenjena korisnicima poslovnih, profesionalnih i individualnih planova. Omogućuje skupno preuzimanje cjelovitih zapisnika VIES provjere. Korisnici odabiru željeni mjesec s padajućeg popisa (npr. 2026.-09.) i kliknu "Downloadgumb "".

.

Fakture

Ova kartica pruža sažetak izdanih računa s mogućnošću filtriranja po datumu. Popis uključuje status (npr. „Unpaid“), datum izdavanja, broj računa, iznos, datum dospijeća i gumb za preuzimanje dokumenta kao PDF datoteke.