„Google Sheets™“ priedas VIES validatoriui

„Google Sheets™“ priedas VIES validatoriui

„Vies API“ „Google“ skaičiuoklės„Google Sheets™“ papildinys leidžia greitai ir automatiškai patikrinti subjektų (rangovų) dabartinę būseną naudojant „Google Sheets™“ skaičiuoklę. VIES sistema.

Šioje dokumentacijoje pateikiamos instrukcijos, kaip integruoti „Google Sheets™“ programą su VIES API sistema.

 

 

Diegimas ir konfigūravimas

Montavimas

Įėjus į „Google Workspace Marketplace“ svetainę https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, spustelėkite Install mygtuką.

„Vies API“ „Google“ skaičiuoklių papildinio diegimas

„Google“ paskyros, kurioje turėtų būti įdiegtas ir pasiekiamas „VIES Validator“ „Google“ skaičiuoklių papildinys, pasirinkimas:

„Vies API“ „Google“ skaičiuoklių priedo diegimo paskyra

Kitame ekrane galite perskaityti Privatumo politika ir taikytinas Paslaugų teikimo sąlygos, taip pat jūsų duomenų, kuriuos apdorosime, apimtį. Norėdami pereiti prie kito diegimo veiksmo, paspauskite Continue mygtuką.

„Vies API“ „Google“ skaičiuoklių priedo diegimo leidimai

Patvirtinkite, kad suteikėte reikiamus leidimus, kad priedas tinkamai veiktų, ir paspauskite Allow mygtukas:

„Vies“ API „Google“ skaičiuoklės priedo diegimo leidimai leisti

VIES patvirtinimo priedas sėkmingai įdiegtas jūsų paskyroje ir bus pasiekiamas paleidus „Google“ skaičiuokles skirtuke „Plėtiniai“. Norėdami tęsti, spustelėkite Next:

„Vies API“ „Google“ skaičiuoklių papildinio diegimo plėtinys

Paskutiniame diegimo programos ekrane būsite paraginti sukonfigūruoti priedą. Paspaudę „Complete additional setup now„“ nuoroda atidarys naują naršyklės langą su dabartiniu dokumentacijos puslapiu. Spustelėkite Done mygtuką ir pradėkite konfigūruoti priedą, kaip aprašyta skyriuje „Konfigūracija“.

įdiegtas „Vies API“ „Google“ skaičiuoklių priedas

Konfigūracija

Įdiegus papildinį pagal numatytuosius nustatymus nustatoma bandomoji aplinka (daugiau informacijos apie Bandomasis API (puslapis). Norint iškviesti funkcijas gamybinėje aplinkoje, būtina vieną kartą sukonfigūruoti prieigą prie viesapi.eu svetainės. Norėdami tai padaryti, eikite į bet kurią „Google Sheets™“ skaičiuoklę ir atlikite šią funkciją:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

kur funkcijos parametrai:

  • identifier – parametre turi būti nurodytas identifikatorius (ID), sugeneruotas paskyroje viesapi.eu svetainėje,
  • key – parametre turi būti raktas, sugeneruotas paskyroje viesapi.eu svetainėje.

Išsami informacija apie identifikatoriaus ir rakto generavimą aprašyta Dokumentacija Interneto svetainė.

Norint patikrinti ryšio su tam tikra API teisingumą (bandymas arba gamyba), reikia atlikti šią funkciją:

=VIESAPI_CONNECT_STATUS()

Kuris gali grąžinti reikšmes:

  • SUCCESS: Production – jei priedas tinkamai sukonfigūruotas dirbti su gamybos aplinka,
  • SUCCESS: Test – jei priedas tinkamai sukonfigūruotas dirbti su bandymo aplinka,
  • ERROR: Connection requires configuration – esant neteisingai konfigūracijai.

Jei pageidaujate šoninės juostos konfigūracijos, spustelėkite Extensions skirtuką, tada pasirinkite VIES API - EU VAT Validation ir galiausiai spustelėkite Show sidebar norėdami įjungti šoninę juostą:

„Vies“ API „Google“ skaičiuoklių papildinio konfigūracijos šoninė juosta

Tada eikite į ID and Key skirtuką, kad įvestumėte ID ir Key atitinkamuose teksto laukuose, kurie pasiekiami prisijungus prie VIES API paskyros: https://viesapi.eu/sign-in/

„Vies API“ „Google“ skaičiuoklių priedo konfigūracijos ID ir raktas

Naudojimas

Prieš naudodami priedą, turėtumėte susipažinti su jo veikimo specifika:

  • Visi funkcijų iškvietimai vykdomi asinchroniniu režimu, kuris nesukelia „Google Sheets™“ programos užstrigimo (nėra atsakymo) efekto.
  • Pridėjus (įterpiant) eilutę arba stulpelį neatnaujinami visi apibrėžti funkcijų iškvietimai.
  • Kopijuojant arba perkeliant langelius, kuriuose yra funkcijų, apibrėžti funkcijų iškvietimai neatnaujinami.
  • Ištrynus eilutę arba stulpelį, bus atnaujinti visi apibrėžti funkcijų iškvietimai ir išsiųstos užklausos į viesApi.eu (tik esant numatytiesiems „Google Sheets™“ nustatymams). Numatytųjų nustatymų keitimo aprašymas pateiktas skyriuje „Konfigūracija“.
  • Dėmesio! Nerekomenduojama vykdyti daugiau nei 500 lygiagrečių užklausų, nes „Google Sheets™“ kyla problemų apdorojant didelį skaičių asinchroninių iškvietimų.

Gaukite įmonės duomenis iš VIES

VIESAPI_VIES_DATA() – Funkcija nuskaito visus turimus įmonės duomenis tiesiai iš VIES sistemos. Parametrai turėtų būti:

  • Europos mokesčių mokėtojo kodas (PVM EU),
  • (neprivaloma) FORMAT grąžintų duomenų (žr.: Žymos, kurios gali būti naudojamos kaip FORMAT parametras).

=VIESAPI_VIES_DATA("PL7171642051")

Jei jums reikia tik įmonės statuso VIES, naudokite šią užklausą:

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

Jei grąžinamas statusas yra Taip, tai reiškia, kad įmonė turi galiojantį ES PVM mokėtojo kodą.

Žymos pasiekiamos VIESAPI_VIES_DATA funkcija, kurią galima naudoti kaip FORMAT parametras:

  • $(UID) – unikalus identifikatorius, sugeneruotas paslaugos „viesApi.eu“
  • $(CountryCode) – šalies kodas
  • $(VATNumber) – Europos PVM mokėtojo kodas
  • $(Valid) – VIES tarnybos atsakymas, informuojantis apie dabartinį tikrinamos įmonės ES PVM mokėtojo statusą (Yes/No)
  • $(TraderName) – įmonės registracijos pavadinimas
  • $(TraderCompanyType) – verslo tipas
  • $(TraderAddress) – prekybininko adresas, kuriuo įmonė yra registruota
  • $(ID) – unikalus VIES sistemos sugeneruotas identifikatorius (konsultacijos numeris)
  • $(Date) – atsakymo sugeneravimo data
  • $(Source) – duomenų šaltinis

Numatytasis formatas: "$(TraderName), $(TraderAddress)"

Jei styga "JSON" pateikiamas kaip FORMAT parametrą, funkcija grąžins visą rezultatą JSON eilutės forma, kurią galima laisvai analizuoti ir toliau apdoroti:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Gaukite išanalizuotus įmonės duomenis iš VIES

VIESAPI_VIES_DATA_PARSED() – Funkcija nuskaito visus turimus įmonės duomenis tiesiai iš VIES sistemos. Be to, įmonės pavadinimas ir adresas grąžinami kaip išanalizuoti duomenys, suskirstyti į atskirus atributus. Parametrai turėtų būti:

  • Europos mokesčių mokėtojo kodas (PVM EU),
  • (neprivaloma) FORMAT grąžintų duomenų (žr.: Žymos, kurios gali būti naudojamos kaip FORMAT parametras).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Jei jums reikia tik įmonės statuso VIES, naudokite šią užklausą:

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

Jei grąžinamas statusas yra Taip, tai reiškia, kad įmonė turi galiojantį ES PVM mokėtojo kodą.

Žymos pasiekiamos VIESAPI_VIES_DATA_PARSED funkcija, kurią galima naudoti kaip FORMAT parametras:

  • $(UID) – unikalus identifikatorius, sugeneruotas paslaugos „viesApi.eu“
  • $(CountryCode) – šalies kodas
  • $(VATNumber) – Europos PVM mokėtojo kodas
  • $(Valid) – VIES tarnybos atsakymas, informuojantis apie dabartinį tikrinamos įmonės ES PVM mokėtojo statusą (Yes/No)
  • $(TraderName) – įmonės registracijos pavadinimas
  • $(TraderNameComponents.Name) – įmonės pavadinimas iš „traderName“ (be teisinės formos)
  • $(TraderNameComponents.LegalForm) – teisinės formos pavadinimas, gautas iš „traderName“ (be įmonės pavadinimo)
  • $(TraderNameComponents.LegalFormCanonicalId) – teisinės formos žodyninis identifikatorius
  • $(TraderNameComponents.LegalFormCanonicalName) – teisinės formos žodyninis pavadinimas
  • $(TraderCompanyType) – verslo tipas
  • $(TraderAddress) – prekybininko adresas, kuriuo įmonė yra registruota
  • $(TraderAddressComponents.Country) – prekiaujančios šalies pavadinimas jos nacionaline kalba
  • $(TraderAddressComponents.PostalCode) – prekiautojo adreso pašto kodas
  • $(TraderAddressComponents.City) – prekiautojo adreso miestas
  • $(TraderAddressComponents.Street) – prekiautojo adreso gatvė
  • $(TraderAddressComponents.StreetNumber) – prekiautojo adreso gatvės namo numeris
  • $(TraderAddressComponents.HouseNumber) – prekiautojo adreso buto / biuro numeris
  • $(TraderAddressComponents.Other) – kiti adreso duomenys (srities pavadinimas, pastato pavadinimas, aukšto numeris ir kt.)
  • $(ID) – unikalus VIES sistemos sugeneruotas identifikatorius (konsultacijos numeris)
  • $(Date) – atsakymo sugeneravimo data
  • $(Source) – duomenų šaltinis

Numatytasis formatas: "$(TraderName), $(TraderAddress)"

Jei styga "JSON" pateikiamas kaip FORMAT parametrą, funkcija grąžins visą rezultatą JSON eilutės forma, kurią galima laisvai analizuoti ir toliau apdoroti:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Vartotojo paskyros būsenos patikrinimas (nemokamas)

VIESAPI_ACCOUNT_STATUS() – Funkcija grąžina pagrindinę informaciją apie šiuo metu vartotojo naudojamą planą. Parametrai turėtų būti:

  • (neprivaloma) FORMAT grąžintų duomenų (žr.: Žymos, kurios gali būti naudojamos kaip FORMAT parametras)

=VIESAPI_ACCOUNT_STATUS()

Dėmesio! Funkcijos iškvietimas nepadidina pateiktų užklausų skaičiaus.

Galimos žymos VIESAPI_ACCOUNT_STATUS funkcija gali būti naudojama kaip FORMAT parametras:

  • $(UID) – unikalus identifikatorius, sugeneruotas paslaugos „viesApi.eu“
  • $(BillingPlanName) – dabartinio plano pavadinimas
  • $(SubscriptionPrice) – mėnesinis prenumeratos mokestis
  • $(ItemPrice) – vienos užklausos, neįtrauktos į planą, kaina
  • $(ItemPriceStatus) – kaina už užklausą – PVM / VIES / įmonės veiklos statusas
  • $(ItemPriceParsed) – kaina už užklausą – PVM / VIES / įmonės veiklos būsena su išanalizuotais duomenimis
  • $(Limit) – maksimalus užklausų skaičius plane
  • $(RequestDelay) – minimalus laiko intervalas tarp užklausų
  • $(DomainLimit) – maksimalus domenų (API raktų) skaičius
  • $(OverPlanAllowed) – galimybė viršyti maksimalų užklausų skaičių plane
  • $(ExcelAddIn) – prieiga prie „Google Sheets™“ ir „Microsoft Excel™“ papildinių
  • $(Stats) – prieiga prie užklausų statistikos
  • $(NIPMonitor) – prieiga prie įmonių statuso stebėjimo: PVM / VIES / Veiklos statusas
  • $(FuncGetVIESData) – prieiga prie funkcijų, kurios tikrina įmonės statusą VIES sistemoje
  • $(FuncGetVIESDataParsed) – prieiga prie funkcijų, kurios tikrina įmonės statusą VIES sistemoje ir analizuoja prekiautojo vardą, pavardę ir adresą
  • $(VIESDataCount) – šį mėnesį atliktų VIES užklausų skaičius
  • $(VIESDataParsedCount) – šį mėnesį atliktų VIES užklausų su išanalizuotais duomenimis skaičius
  • $(TotalCount) – bendras šį mėnesį atliktų užklausų skaičius

Numatytasis FORMATAS: "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)"

Jei styga "JSON" pateikiamas kaip FORMAT parametrą, funkcija grąžins visą rezultatą JSON eilutės forma, kurią galima laisvai analizuoti ir toliau apdoroti.

VIES sistemos būsenos patikrinimas (nemokamai)

VIESAPI_VIES_STATUS() – Ši funkcija leidžia patikrinti dabartinę VIES sistemos būseną. Ji pateikia bendrą būseną, nurodančią prieinamumą, taip pat atskirų šalių narių sąrašą kartu su dabartine jų nacionalinių sistemų prieinamumo būsena. Parametrai turėtų būti tokie:

  • (neprivaloma) FORMAT grąžintų duomenų (žr.: Žymos, kurios gali būti naudojamos kaip FORMAT parametras)

=VIESAPI_VIES_STATUS()

Dėmesio! Funkcijos iškvietimas nepadidina pateiktų užklausų skaičiaus.

Galimos žymos VIESAPI_VIES_STATUS funkcija gali būti naudojama kaip FORMAT parametras:

  • $(UID) – unikalus identifikatorius, sugeneruotas paslaugos „viesApi.eu“
  • $(Available) – dabartinis VIES sistemos prieinamumas (prieinama, iš dalies prieinama, nepasiekiama)
  • $(Countries) – atskirų šalių narių sąrašas (yra, nėra)
  • $(AT), $(FR), $(PL), etc. – konkrečios šalies narės prieinamumo būsena (kaip žymės reikšmę naudokite dviraidį didžiąsias šalies kodą)

Numatytasis FORMATAS: "$(Available)"

Jei styga "JSON" pateikiamas kaip FORMAT parametrą, funkcija grąžins visą rezultatą JSON eilutės forma, kurią galima laisvai analizuoti ir toliau apdoroti.

Kitos naudingos funkcijos (nemokamai)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funkcija pateikia informaciją apie bendrą užklausų, pateiktų einamąjį atsiskaitymo mėnesį tam tikrai paskyrai, skaičių (visi API raktai). Grąžina lygiai tą patį skaičių kaip $(TotalCount) žyma VIESAPI_STATUS_ACCOUNT() funkcija.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funkcija grąžina informaciją apie maksimalų užklausų skaičių, galimą vartotojo pasirinktame plane. Grąžina lygiai tą patį skaičių kaip $(Limit) pažymėti VIES.STATUS.ACCOUNT() funkcija

VIESAPI_EUVAT_NORM() – Ši funkcija taiso ir formatuoja ES PVM mokėtojo numerį (pašalina tarpus ir brūkšnelius ir pan.) neprisijungus ir negauna jokių duomenų iš VIES:

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

VIESAPI_EUVAT_VALID() – Funkcija neprisijungus tikrina tik ES PVM mokėtojo numerio teisingumą (sintaksę, kontrolinę sumą) ir negauna jokių duomenų iš VIES sistemos. Grąžina TRUE jei numeris galioja arba FALSE jei jis negalioja:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funkcija grąžina esamą priedo konfigūracijos būseną.

Jei funkcija grąžina šią reikšmę, tai, be kita ko, reiškia, kad ID ir API key nebuvo išsaugoti:

ERROR: Connection requires configuration

Išsaugojus API ID ir key, funkcija turėtų grąžinti šį pranešimą:

SUCCESS: Production

„Google Sheets™“ yra „Google LLC“ prekės ženklas.