Preverjevalnik VIES za dodatek Google Preglednice™

Preverjevalnik VIES za dodatek Google Preglednice™

API za Google preglednice viesDodatek za Google Preglednice™ vam omogoča hitro in samodejno preverjanje entitet (izvajalcev) z uporabo preglednice Google Preglednice™ glede na njihov trenutni status v sistem VIES.

Ta dokumentacija vsebuje navodila za integracijo aplikacije Google Preglednice™ s sistemom VIES API.

 

 

Namestitev in konfiguracija

Namestitev

Po vstopu na spletno mesto Google Workspace Marketplace https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, kliknite na Install gumb.

Namestitev dodatka za Google Preglednice vies API

Izbira Google Računa, za katerega naj bo nameščen in na voljo dodatek VIES Validator za Google Preglednice:

Namestitev dodatka za Google Preglednice v API-ju za Vies

Na naslednjem zaslonu lahko preberete Politika zasebnosti in veljavno Pogoji storitve, kot tudi obseg vaših podatkov, ki jih bomo obdelovali. Če želite nadaljevati na naslednji korak namestitve, pritisnite Continue gumb.

dovoljenja za namestitev dodatka v API-ju za Google Preglednice

Potrdite, da ste podelili potrebna dovoljenja za pravilno delovanje dodatka, in pritisnite Allow gumb:

dovoljenja za namestitev dodatka v API za Google Preglednice

Dodatek VIES Validation je bil uspešno nameščen v vaš račun in bo na voljo po zagonu Google Preglednic na zavihku Razširitve. Za nadaljevanje kliknite Next:

Namestitev razširitve dodatka za Google Preglednice v API-ju

Na zadnjem zaslonu namestitvenega programa boste pozvani, da konfigurirate dodatek. S klikom na »Complete additional setup now” bo odprlo novo okno brskalnika s trenutno stranjo dokumentacije. Kliknite Done gumb in začnite konfigurirati dodatek, kot je opisano v razdelku Konfiguracija.

Nameščen je dodatek za Google Preglednice Vies API

Konfiguracija

Po namestitvi je vtičnik privzeto nastavljen na testno okolje (več podrobnosti na Test API stran). Za klic funkcij v produkcijskem okolju je treba enkrat konfigurirati dostop do spletnega mesta viesapi.eu. To storite tako, da odprete katero koli preglednico Google Sheets™ in izvedete funkcijo:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

kjer so parametri funkcije:

  • identifier – parameter naj vsebuje identifikator (ID), generiran na računu na spletni strani viesapi.eu,
  • key – parameter naj vsebuje Ključ, ustvarjen na računu na spletni strani viesapi.eu.

Podrobnosti o generiranju identifikatorja in ključa so opisane na Dokumentacija Spletna stran.

Za preverjanje pravilnosti povezave z danim API (testnim ali produkcijskim) je treba izvesti naslednjo funkcijo:

=VIESAPI_CONNECT_STATUS()

Ki lahko vrne vrednosti:

  • SUCCESS: Production – če je dodatek pravilno konfiguriran za delo s produkcijskim okoljem,
  • SUCCESS: Test – če je dodatek pravilno konfiguriran za delo z testno okolje,
  • ERROR: Connection requires configuration – v primeru napačne konfiguracije.

Če imate raje konfiguracijo stranske vrstice, kliknite Extensions zavihek in nato izberite VIES API - EU VAT Validation in končno kliknite Show sidebar Če želite omogočiti stransko vrstico:

Stranska vrstica za konfiguracijo dodatka za Google Preglednice vies API

Potem pojdite na ID and Key zavihek za vstop v ID in Key v ustrezna besedilna polja, ki so na voljo po prijavi v vaš račun VIES API: https://viesapi.eu/sign-in/

ID in ključ konfiguracije dodatka za Google Preglednice vies API

Uporaba

Pred uporabo dodatka se morate seznaniti s posebnostmi njegovega delovanja:

  • Vsi klici funkcij se izvajajo v asinhronem načinu, kar ne povzroča zamrznitve (brez odziva) aplikacije Google Sheets™.
  • Dodajanje (vstavljanje) vrstice ali stolpca ne osveži vseh definiranih klicev funkcij.
  • Kopiranje ali premikanje celic, ki vsebujejo funkcije, ne osveži definiranih klicev funkcij.
  • Brisanje vrstice ali stolpca osveži vse definirane klice funkcij in pošlje poizvedbe na viesApi.eu (samo v primeru privzetih nastavitev Google Preglednic™). Opis spreminjanja privzetih nastavitev je vključen v poglavju Konfiguracija.
  • Pozor! Ni priporočljivo izvajati več kot 500 vzporednih poizvedb, ker ima Google Sheets™ težave z obdelavo velikega števila asinhronih klicev.

Pridobite podatke o podjetju iz VIES

VIESAPI_VIES_DATA() – Funkcija pridobi vse razpoložljive podatke podjetja neposredno iz sistema VIES. Parametri bi morali biti:

  • evropska davčna številka (VAT EU),
  • (neobvezno) FORMAT vrnjenih podatkov (glejte: Oznake, ki jih je mogoče uporabiti kot FORMAT parameter).

=VIESAPI_VIES_DATA("PL7171642051")

Če potrebujete le status podjetja v VIES, uporabite naslednjo poizvedbo:

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

Če je vrnjeni status Da, to pomeni, da ima podjetje veljavno EU številko za DDV.

Oznake, ki so na voljo v VIESAPI_VIES_DATA funkcijo, ki se lahko uporablja kot FORMAT parameter:

  • $(UID) – enolični identifikator, ki ga ustvari storitev viesApi.eu
  • $(CountryCode) – koda države
  • $(VATNumber) – evropska številka za DDV
  • $(Valid) – odgovor storitve VIES, ki obvešča o trenutnem statusu DDV v EU preverjenega podjetja (Yes/No)
  • $(TraderName) – ime podjetja v registraciji
  • $(TraderCompanyType) – vrsta poslovanja
  • $(TraderAddress) – naslov trgovca, kjer je podjetje registrirano
  • $(ID) – edinstveni identifikator, ki ga ustvari sistem VIES (posvetovalna številka)
  • $(Date) – datum, ko je bil odgovor ustvarjen
  • $(Source) – vir podatkov

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

Če niz "JSON" je podan kot FORMAT bo funkcija vrnila celoten rezultat v obliki niza JSON, ki ga je mogoče prosto razčleniti in nadalje obdelati:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Pridobite razčlenjene podatke podjetja iz VIES

VIESAPI_VIES_DATA_PARSED() – Funkcija pridobi vse razpoložljive podatke o podjetju neposredno iz sistema VIES. Poleg tega se ime in naslov podjetja vrneta kot razčlenjeni podatki, razdeljeni v ločene atribute. Parametri naj bodo:

  • evropska davčna številka (VAT EU),
  • (neobvezno) FORMAT vrnjenih podatkov (glejte: Oznake, ki jih je mogoče uporabiti kot FORMAT parameter).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Če potrebujete le status podjetja v VIES, uporabite naslednjo poizvedbo:

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

Če je vrnjeni status Da, to pomeni, da ima podjetje veljavno EU številko za DDV.

Oznake, ki so na voljo v VIESAPI_VIES_DATA_PARSED funkcijo, ki se lahko uporablja kot FORMAT parameter:

  • $(UID) – enolični identifikator, ki ga ustvari storitev viesApi.eu
  • $(CountryCode) – koda države
  • $(VATNumber) – evropska številka za DDV
  • $(Valid) – odgovor storitve VIES, ki obvešča o trenutnem statusu DDV v EU preverjenega podjetja (Yes/No)
  • $(TraderName) – ime podjetja v registraciji
  • $(TraderNameComponents.Name) – ime podjetja iz traderName (brez pravne oblike)
  • $(TraderNameComponents.LegalForm) – ime pravne oblike, pridobljeno iz traderName (brez imena podjetja)
  • $(TraderNameComponents.LegalFormCanonicalId) – slovarski identifikator pravne oblike
  • $(TraderNameComponents.LegalFormCanonicalName) – slovarsko ime pravne oblike
  • $(TraderCompanyType) – vrsta poslovanja
  • $(TraderAddress) – naslov trgovca, kjer je podjetje registrirano
  • $(TraderAddressComponents.Country) – ime države trgovca v njenem nacionalnem jeziku
  • $(TraderAddressComponents.PostalCode) – poštna številka naslova trgovca
  • $(TraderAddressComponents.City) – mesto, kjer je trgovec naveden
  • $(TraderAddressComponents.Street) – ulica, kjer je trgovec na naslovu
  • $(TraderAddressComponents.StreetNumber) – hišna številka ulice, na kateri je trgovec naveden
  • $(TraderAddressComponents.HouseNumber) – številka stanovanja/pisarne na naslovu trgovca
  • $(TraderAddressComponents.Other) – drugi podatki o naslovu (ime območja, ime stavbe, številka nadstropja itd.)
  • $(ID) – edinstveni identifikator, ki ga ustvari sistem VIES (posvetovalna številka)
  • $(Date) – datum, ko je bil odgovor ustvarjen
  • $(Source) – vir podatkov

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

Če niz "JSON" je podan kot FORMAT bo funkcija vrnila celoten rezultat v obliki niza JSON, ki ga je mogoče prosto razčleniti in nadalje obdelati:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Preverjanje stanja uporabniškega računa (brezplačno)

VIESAPI_ACCOUNT_STATUS() – Funkcija vrne osnovne informacije o načrtu, ki ga trenutno uporablja uporabnik. Parametri bi morali biti:

  • (neobvezno) FORMAT vrnjenih podatkov (glejte: Oznake, ki jih je mogoče uporabiti kot FORMAT parameter)

=VIESAPI_ACCOUNT_STATUS()

Pozor! Klic funkcije ne poveča števila izvedenih poizvedb.

Oznake, ki so na voljo v VIESAPI_ACCOUNT_STATUS funkcijo lahko uporabite kot FORMAT parameter:

  • $(UID) – enolični identifikator, ki ga ustvari storitev viesApi.eu
  • $(BillingPlanName) – ime trenutnega načrta
  • $(SubscriptionPrice) – mesečna naročnina
  • $(ItemPrice) – stroški posameznega povpraševanja zunaj paketa
  • $(ItemPriceStatus) – cena na poizvedbo – DDV/VIES/status dejavnosti podjetja
  • $(ItemPriceParsed) – cena na poizvedbo – DDV/VIES/status dejavnosti podjetja z razčlenjenimi podatki
  • $(Limit) – največje število poizvedb v načrtu
  • $(RequestDelay) – minimalni časovni interval med poizvedbami
  • $(DomainLimit) – največje število domen (API ključev)
  • $(OverPlanAllowed) – možnost prekoračitve največjega števila poizvedb v načrtu
  • $(ExcelAddIn) – dostop do dodatka Google Preglednice™ in Microsoft Excel™
  • $(Stats) – dostop do statistike poizvedb
  • $(NIPMonitor) – dostop do spremljanja statusa podjetij: DDV/VIES/status dejavnosti
  • $(FuncGetVIESData) – dostop do funkcij, ki preverjajo status podjetja v sistemu VIES
  • $(FuncGetVIESDataParsed) – dostop do funkcij, ki preverjajo status podjetja v sistemu VIES in analizirajo ime in naslov trgovca
  • $(VIESDataCount) – število poizvedb VIES, opravljenih ta mesec
  • $(VIESDataParsedCount) – število poizvedb VIES z razčlenjenimi podatki, opravljenih ta mesec
  • $(TotalCount) – skupno število poizvedb, opravljenih ta mesec

Privzeti 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)"

Če niz "JSON" je podan kot FORMAT bo funkcija vrnila celoten rezultat v obliki niza JSON, ki ga je mogoče prosto razčleniti in nadalje obdelati.

Preverjanje stanja sistema VIES (brezplačno)

VIESAPI_VIES_STATUS() – Ta funkcija vam omogoča preverjanje trenutnega stanja sistema VIES. Vrne splošno stanje, ki označuje razpoložljivost, ter seznam posameznih držav članic skupaj s trenutnim stanjem razpoložljivosti njihovih nacionalnih sistemov. Parametri morajo biti:

  • (neobvezno) FORMAT vrnjenih podatkov (glejte: Oznake, ki jih je mogoče uporabiti kot FORMAT parameter)

=VIESAPI_VIES_STATUS()

Pozor! Klic funkcije ne poveča števila izvedenih poizvedb.

Oznake, ki so na voljo v VIESAPI_VIES_STATUS funkcijo lahko uporabite kot FORMAT parameter:

  • $(UID) – enolični identifikator, ki ga ustvari storitev viesApi.eu
  • $(Available) – trenutna razpoložljivost sistema VIES (Na voljo, Delno na voljo, Ni na voljo)
  • $(Countries) – seznam posameznih držav članic (Na voljo, Ni na voljo)
  • $(AT), $(FR), $(PL), etc. – status razpoložljivosti določene države članice (kot vrednost oznake uporabite dvočrkovno kodo države z velikimi črkami)

Privzeti FORMAT: "$(Available)"

Če niz "JSON" je podan kot FORMAT bo funkcija vrnila celoten rezultat v obliki niza JSON, ki ga je mogoče prosto razčleniti in nadalje obdelati.

Druge uporabne funkcije (brezplačno)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funkcija vrne podatke o skupnem številu poizvedb v tekočem obračunskem mesecu za dani račun (vsi API ključi). Vrne popolnoma enako število kot $(TotalCount) oznako v VIESAPI_STATUS_ACCOUNT() funkcijo.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funkcija vrne informacije o največjem številu poizvedb, ki so na voljo v načrtu, ki ga izbere uporabnik. Vrne popolnoma enako število kot $(Limit) označite VIES.STATUS.ACCOUNT() funkcijo

VIESAPI_EUVAT_NORM() – Ta funkcija popravi in oblikuje EU številko DDV (odstrani presledke in vezaje itd.) brez povezave in ne pridobi nobenih podatkov iz VIES:

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

VIESAPI_EUVAT_VALID() – Funkcija samo preveri pravilnost (sintakso, kontrolno vsoto) številke EU za DDV brez povezave in ne pridobi nobenih podatkov iz sistema VIES. Vračila TRUE če je številka veljavna oz FALSE če ne velja:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funkcija vrne trenutno stanje konfiguracije dodatka.

Če funkcija vrne naslednjo vrednost, to med drugim pomeni, da je ID in API key niso bili shranjeni:

ERROR: Connection requires configuration

Po shranjevanju API ID in key, mora funkcija vrniti naslednje sporočilo:

SUCCESS: Production

Google Preglednice™ je blagovna znamka podjetja Google LLC.