VIES Validator dodatka za Google tablice™

VIES Validator dodatka za Google tablice™

VIE API Google tabliceDodatak za Google Sheets™ omogućuje vam brzu i automatsku provjeru entiteta (izvođača radova) pomoću proračunske tablice Google Sheets™ u smislu njihovog trenutnog statusa u VIES sustav.

Ova dokumentacija sadrži upute o integraciji aplikacije Google Sheets™ s VIES API sustavom.

 

 

Instalacija i konfiguracija

Montaža

Nakon ulaska na web-stranicu Google Workspace Marketplace https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, kliknite na Install dugme.

instalacija dodatka za Google tablice putem Vies API-ja

Odabir Google računa za koji treba instalirati i biti dostupan dodatak VIES Validator za Google tablice:

instalacija dodatka za Google tablice putem API-ja za Vies API račun

Na sljedećem ekranu možete pročitati Politika privatnosti i primjenjivi Uvjeti pružanja usluge, kao i opseg vaših podataka koje ćemo obrađivati. Za prelazak na sljedeći korak instalacije pritisnite Continue dugme.

dozvole za instalaciju dodatka VIE API za Google tablice

Potvrdite da ste dali potrebna dopuštenja za ispravan rad dodatka i pritisnite Allow gumb:

dozvole za instalaciju dodatka za vies api google sheets

Dodatak VIES Validation uspješno je instaliran na vaš račun i bit će dostupan nakon pokretanja Google tablica na kartici Proširenja. Za nastavak kliknite Next:

Vies API Google tablice dodatak za instalaciju proširenja

Na posljednjem zaslonu instalacijskog programa zatražit će se od vas da konfigurirate dodatak. Klikom na "Complete additional setup now” otvorit će novi prozor preglednika s trenutnom stranicom dokumentacije. Kliknite na Done gumb i započnite konfiguriranje dodatka kako je opisano u odjeljku Konfiguracija.

Instaliran je dodatak Vies API za Google tablice

Konfiguracija

Nakon instalacije, dodatak je prema zadanim postavkama postavljen na testno okruženje (više detalja na Test API stranica). Da biste mogli pozivati funkcije u produkcijskom okruženju, potrebno je jednom konfigurirati pristup web stranici viesapi.eu. Da biste to učinili, idite na bilo koju proračunsku tablicu Google Sheets™ i izvršite funkciju:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

gdje su parametri funkcije:

  • identifier – parametar treba sadržavati identifikator (ID) generiran na računu na web stranici viesapi.eu,
  • key – parametar treba sadržavati Ključ generiran na računu na web stranici viesapi.eu.

Pojedinosti o generiranju identifikatora i ključa opisane su na Dokumentacija web stranica.

Kako bi se provjerila ispravnost veze s određenim API-jem (testnim ili proizvodnim), treba izvršiti sljedeću funkciju:

=VIESAPI_CONNECT_STATUS()

Koji može vratiti vrijednosti:

  • SUCCESS: Production – ako je dodatak ispravno konfiguriran za rad s proizvodnim okruženjem,
  • SUCCESS: Test – ako je dodatak ispravno konfiguriran za rad s testno okruženje,
  • ERROR: Connection requires configuration – u slučaju pogrešne konfiguracije.

Ako želite konfiguraciju bočne trake, kliknite na Extensions kartica, a zatim odaberite VIES API - EU VAT Validation i na kraju kliknite Show sidebar za omogućavanje bočne trake:

Bočna traka za konfiguraciju dodatka Vies API za Google tablice

Zatim idite na ID and Key tabulator za ulazak u ID i Key u odgovarajuća tekstualna polja koja su dostupna nakon prijave na vaš VIES API račun: https://viesapi.eu/sign-in/

ID i ključ konfiguracije dodatka za Vies API za Google tablice

Korištenje

Prije korištenja dodatka, trebali biste se upoznati sa specifičnostima njegovog rada:

  • Svi pozivi funkcija izvršavaju se u asinkronom načinu rada, što ne uzrokuje efekt zamrzavanja (nema odgovora) aplikacije Google Sheets™.
  • Dodavanje (umetanje) retka ili stupca ne osvježava sve definirane pozive funkcija.
  • Kopiranje ili premještanje ćelija koje sadrže funkcije ne osvježavaju definirane pozive funkcija.
  • Brisanjem retka ili stupca osvježit će se svi definirani pozivi funkcija i poslati upiti na viesApi.eu (samo u slučaju zadanih postavki Google Sheets™). Opis promjene zadanih postavki nalazi se u poglavlju Konfiguracija.
  • Pažnja! Ne preporučuje se pokretanje više od 500 paralelnih upita jer Google Sheets™ ima problema s rukovanjem velikim brojem asinkronih poziva.

Dobijte podatke o tvrtki iz VIES-a

VIESAPI_VIES_DATA() – Funkcija dohvaća sve dostupne podatke tvrtke izravno iz VIES sustava. Parametri bi trebali biti:

  • Europski porezni identifikacijski broj (PDV EU),
  • (neobavezno) FORMAT vraćenih podataka (pogledajte: Oznake koje se mogu koristiti kao FORMAT parametar).

=VIESAPI_VIES_DATA("PL7171642051")

Ako trebate samo status tvrtke u VIES-u, koristite sljedeći upit:

=VIESAPI_VIES_DATA("PL7171642051";"$(Valid)")

Ako je vraćeni status Da, to znači da tvrtka ima važeći EU PDV broj.

Oznake dostupne u VIESAPI_VIES_DATA funkcija koja se može koristiti kao FORMAT parametar:

  • $(UID) – jedinstveni identifikator koji generira usluga viesApi.eu
  • $(CountryCode) – pozivni broj države
  • $(VATNumber) – europski PDV broj
  • $(Valid) – odgovor VIES servisa s obavijesti o trenutnom statusu PDV-a provjerene tvrtke u EU (Yes/No)
  • $(TraderName) – naziv tvrtke za registraciju
  • $(TraderCompanyType) – vrsta poslovanja
  • $(TraderAddress) – adresu trgovca na kojoj je tvrtka registrirana
  • $(ID) – jedinstveni identifikator koji generira VIES sustav (konzultacijski broj)
  • $(Date) – datum kada je odgovor generiran
  • $(Source) – izvor podataka

Zadani format: "$(TraderName), $(TraderAddress)"

Ako niz "JSON" daje se kao FORMAT parametar, funkcija će vratiti potpuni rezultat u obliku JSON niza, koji se može slobodno analizirati i dalje obrađivati:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Dobijte parsirane podatke tvrtke iz VIES-a

VIESAPI_VIES_DATA_PARSED() – Funkcija dohvaća sve dostupne podatke o tvrtki izravno iz VIES sustava. Osim toga, naziv i adresa tvrtke vraćaju se kao raščlanjeni podaci podijeljeni u zasebne atribute. Parametri bi trebali biti:

  • Europski porezni identifikacijski broj (PDV EU),
  • (neobavezno) FORMAT vraćenih podataka (pogledajte: Oznake koje se mogu koristiti kao FORMAT parametar).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Ako trebate samo status tvrtke u VIES-u, koristite sljedeći upit:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"$(Valid)")

Ako je vraćeni status Da, to znači da tvrtka ima važeći EU PDV broj.

Oznake dostupne u VIESAPI_VIES_DATA_PARSED funkcija koja se može koristiti kao FORMAT parametar:

  • $(UID) – jedinstveni identifikator koji generira usluga viesApi.eu
  • $(CountryCode) – pozivni broj države
  • $(VATNumber) – europski PDV broj
  • $(Valid) – odgovor VIES servisa s obavijesti o trenutnom statusu PDV-a provjerene tvrtke u EU (Yes/No)
  • $(TraderName) – naziv tvrtke za registraciju
  • $(TraderNameComponents.Name) – naziv tvrtke iz traderName (bez pravnog oblika)
  • $(TraderNameComponents.LegalForm) – naziv pravnog oblika preuzet iz naziva trgovca (bez naziva tvrtke)
  • $(TraderNameComponents.LegalFormCanonicalId) – rječnički identifikator pravnog oblika
  • $(TraderNameComponents.LegalFormCanonicalName) – rječnički naziv pravnog oblika
  • $(TraderCompanyType) – vrsta poslovanja
  • $(TraderAddress) – adresu trgovca na kojoj je tvrtka registrirana
  • $(TraderAddressComponents.Country) – naziv zemlje trgovca na njenom nacionalnom jeziku
  • $(TraderAddressComponents.PostalCode) – poštanski broj adrese trgovca
  • $(TraderAddressComponents.City) – grad u kojem se nalazi adresa trgovca
  • $(TraderAddressComponents.Street) – ulica na kojoj se nalazi adresa trgovca
  • $(TraderAddressComponents.StreetNumber) – broj zgrade na kojoj se nalazi adresa trgovca
  • $(TraderAddressComponents.HouseNumber) – broj stana/ureda na adresi trgovca
  • $(TraderAddressComponents.Other) – ostali podaci o adresi (naziv područja, naziv zgrade, broj kata itd.)
  • $(ID) – jedinstveni identifikator koji generira VIES sustav (konzultacijski broj)
  • $(Date) – datum kada je odgovor generiran
  • $(Source) – izvor podataka

Zadani format: "$(TraderName), $(TraderAddress)"

Ako niz "JSON" daje se kao FORMAT parametar, funkcija će vratiti potpuni rezultat u obliku JSON niza, koji se može slobodno analizirati i dalje obrađivati:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Provjera statusa korisničkog računa (besplatno)

VIESAPI_ACCOUNT_STATUS() – Funkcija vraća osnovne informacije o planu koji korisnik trenutno koristi. Parametri bi trebali biti:

  • (neobavezno) FORMAT vraćenih podataka (pogledajte: Oznake koje se mogu koristiti kao FORMAT parametar)

=VIESAPI_ACCOUNT_STATUS()

Pažnja! Pozivanje funkcije ne povećava broj postavljenih upita.

Oznake dostupne u VIESAPI_ACCOUNT_STATUS funkcija se može koristiti kao FORMAT parametar:

  • $(UID) – jedinstveni identifikator koji generira usluga viesApi.eu
  • $(BillingPlanName) – naziv trenutnog plana
  • $(SubscriptionPrice) – mjesečna pretplata
  • $(ItemPrice) – cijena jednog upita izvan plana
  • $(ItemPriceStatus) – cijena po upitu – PDV/VIES/Status aktivnosti tvrtke
  • $(ItemPriceParsed) – cijena po upitu – PDV/VIES/Status aktivnosti tvrtke s parsiranim podacima
  • $(Limit) – maksimalan broj upita u planu
  • $(RequestDelay) – minimalni vremenski interval između upita
  • $(DomainLimit) – maksimalan broj domena (API ključeva)
  • $(OverPlanAllowed) – mogućnost prekoračenja maksimalnog broja upita u planu
  • $(ExcelAddIn) – pristup dodatku za Google tablice™ i Microsoft Excel™
  • $(Stats) – pristup statistikama upita
  • $(NIPMonitor) – pristup praćenju statusa tvrtki: PDV/VIES/Status aktivnosti
  • $(FuncGetVIESData) – pristup funkcijama koje provjeravaju status tvrtke u VIES sustavu
  • $(FuncGetVIESDataParsed) – pristup funkcijama koje provjeravaju status tvrtke u VIES sustavu i analiziraju ime i adresu trgovca
  • $(VIESDataCount) – broj VIES upita izvršenih ovog mjeseca
  • $(VIESDataParsedCount) – broj VIES upita s parsiranim podacima izvršenih ovog mjeseca
  • $(TotalCount) – ukupan broj upita izvršenih ovog mjeseca

Zadani FORMAT: "Name of the current tariff plan: $(BillingPlanName), Monthly subscription net price: $(SubscriptionPrice), Maximum number of inquiries in the plan: $(Limit), Total number of queries made in the current month: $(TotalCount)"

Ako niz "JSON" daje se kao FORMAT parametar, funkcija će vratiti potpuni rezultat u obliku JSON niza, koji se može slobodno analizirati i dalje obrađivati.

Provjera statusa VIES sustava (besplatno)

VIESAPI_VIES_STATUS() – Ova funkcija vam omogućuje provjeru trenutnog statusa VIES sustava. Vraća opći status koji pokazuje dostupnost, kao i popis pojedinačnih zemalja članica zajedno s trenutnim statusom dostupnosti njihovih nacionalnih sustava. Parametri bi trebali biti:

  • (neobavezno) FORMAT vraćenih podataka (pogledajte: Oznake koje se mogu koristiti kao FORMAT parametar)

=VIESAPI_VIES_STATUS()

Pažnja! Pozivanje funkcije ne povećava broj postavljenih upita.

Oznake dostupne u VIESAPI_VIES_STATUS funkcija se može koristiti kao FORMAT parametar:

  • $(UID) – jedinstveni identifikator koji generira usluga viesApi.eu
  • $(Available) – trenutna dostupnost VIES sustava (Dostupno, Djelomično dostupno, Nedostupno)
  • $(Countries) – popis država pojedinih zemalja članica (Dostupno, Nedostupno)
  • $(AT), $(FR), $(PL), etc. – status dostupnosti određene zemlje članice (kao vrijednost oznake koristite dvoslovni veliki kod zemlje)

Zadani FORMAT: "$(Available)"

Ako niz "JSON" daje se kao FORMAT parametar, funkcija će vratiti potpuni rezultat u obliku JSON niza, koji se može slobodno analizirati i dalje obrađivati.

Ostale korisne funkcije (besplatno)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funkcija vraća podatke o ukupnom broju upita napravljenih u tekućem obračunskom mjesecu za određeni račun (svi API ključevi). Vraća potpuno isti broj kao $(TotalCount) oznaka u VIESAPI_STATUS_ACCOUNT() funkcija.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funkcija vraća informacije o maksimalnom broju dostupnih upita u planu koji je odabrao korisnik. Vraća potpuno isti broj kao $(Limit) označiti VIES.STATUS.ACCOUNT() funkcija

VIESAPI_EUVAT_NORM() – Ova značajka ispravlja i formatira EU PDV broj (uklanja razmake i crtice itd.) izvan mreže i ne dohvaća nikakve podatke iz VIES-a:

=VIESAPI_EUVAT_NORM("PL 717-164-20-51")

VIESAPI_EUVAT_VALID() – Funkcija samo provjerava ispravnost (sintaksu, kontrolni zbroj) EU PDV broja offline i ne dohvaća nikakve podatke iz VIES sustava. Povratak TRUE ako broj vrijedi ili FALSE ako ne vrijedi:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funkcija vraća trenutni status konfiguracije dodatka.

Ako funkcija vrati sljedeću vrijednost, to između ostalog znači da je ID i API key nisu spremljeni:

ERROR: Connection requires configuration

Nakon spremanja API ID i key, funkcija bi trebala vratiti sljedeću poruku:

SUCCESS: Production

Google Sheets™ je zaštitni znak tvrtke Google LLC.