Google Sheetsi™ lisandmoodul VIES Validator

Google Sheetsi™ lisandmoodul VIES Validator

vies API Google SheetsGoogle Sheets™ lisandmoodul võimaldab teil Google Sheets™ arvutustabelit kasutavate üksuste (töövõtjate) praegust olekut kiiresti ja automaatselt kontrollida. VIES süsteem.

See dokumentatsioon sisaldab juhiseid Google Sheets™ rakenduse integreerimiseks VIES API süsteemiga.

 

 

Paigaldamine ja seadistamine

Paigaldamine

Pärast Google Workspace Marketplace'i veebisaidile sisenemist https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, klõpsake nuppu Install nuppu.

vies api google'i arvutustabelite lisandmooduli installimine

Google'i konto valimine, millele peaks VIES Validator Google Sheetsi lisandmoodul olema installitud ja saadaval:

vies api google arvutustabelite lisandmooduli installikonto

Järgmisel ekraanil saate lugeda Privaatsuspoliitika ja kohaldatav Kasutustingimused, samuti teie andmete ulatust, mida me töötleme. Järgmise installietapiga jätkamiseks vajutage nuppu Continue nuppu.

vies api google arvutustabelid lisandmooduli installimisõigused

Veenduge, et olete lisandmooduli nõuetekohaseks toimimiseks andnud vajalikud õigused ja vajutage nuppu Allow nupp:

vies api google arvutustabelid lisandmooduli installimisõigused luba

VIES-i valideerimise lisandmoodul on teie kontole edukalt installitud ja see on saadaval pärast Google Sheetsi käivitamist vahekaardil Laiendused. Jätkamiseks klõpsake palun Next:

vies api google sheetsi lisandmooduli installilaiend

Installeri viimasel ekraanil palutakse teil lisandmoodul seadistada. Klõpsates nupul „Complete additional setup now” avab uue brauseriakna praeguse dokumentatsioonilehega. Klõpsake nuppu Done nuppu ja alustage lisandmooduli seadistamist, nagu on kirjeldatud jaotises „Konfiguratsioon”.

vies API Google Sheetsi lisandmoodul on installitud

Seadistamine

Pärast installimist seatakse pistikprogramm vaikimisi testkeskkonnale (täpsemalt Test API leht). Funktsioonide väljakutsumiseks tootmiskeskkonnas on vaja üks kord seadistada juurdepääs viesapi.eu veebisaidile. Selleks minge suvalisse Google Sheets™ arvutustabelisse ja käivitage funktsioon:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

kus funktsiooni parameetrid on:

  • identifier – parameeter peaks sisaldama identifikaatorit (ID), mis on loodud kontol veebisaidil viesapi.eu,
  • key – parameeter peaks sisaldama Viesapi.eu veebisaidi kontol loodud võtit.

Identifikaatori ja võtme genereerimise üksikasju kirjeldatakse lehel Dokumentatsioon veebisait.

Ühenduse õigsuse kontrollimiseks antud API-ga (test või tootmine) tuleks läbi viia järgmine funktsioon:

=VIESAPI_CONNECT_STATUS()

Mis võib tagastada väärtused:

  • SUCCESS: Production – kui lisandmoodul on tootmiskeskkonnaga töötamiseks õigesti konfigureeritud,
  • SUCCESS: Test – kui lisandmoodul on õigesti konfigureeritud töötama koos testkeskkond,
  • ERROR: Connection requires configuration – vale konfiguratsiooni korral.

Kui eelistate külgriba konfiguratsiooni, klõpsake nuppu Extensions vahekaart ja seejärel valige VIES API - EU VAT Validation ja lõpuks klõpsa Show sidebar külgriba lubamiseks:

vies api google'i arvutustabelite lisandmooduli konfiguratsiooni külgriba

Seejärel minge ID and Key sisestamiseks tabulaatorit ID ja Key vastavatesse tekstiväljadesse, mis on saadaval pärast VIES API kontole sisselogimist: https://viesapi.eu/sign-in/

vies API Google Sheetsi lisandmooduli konfiguratsiooni ID ja võti

Kasutamine

Enne lisandmooduli kasutamist peaksite tutvuma selle toimimise eripäradega:

  • Kõik funktsioonikõned täidetakse asünkroonses režiimis, mis ei põhjusta Google Sheets™ rakenduse hangumist (vastuse puudumist).
  • Rea või veeru lisamine (sisestamine) ei värskenda kõiki määratletud funktsioonikutseid.
  • Funktsioone sisaldavate lahtrite kopeerimine või teisaldamine ei värskenda määratletud funktsioonikutseid.
  • Rea või veeru kustutamine värskendab kõiki määratletud funktsioonikõnesid ja saadab päringud viesApi.eu-sse (ainult Google Sheets™ vaikesätete korral). Vaikesätete muutmise kirjeldus on lisatud konfiguratsiooni peatükile.
  • Tähelepanu! Ei ole soovitatav käivitada rohkem kui 500 paralleelset päringut, kuna Google Sheets™-il on probleeme suure hulga asünkroonsete päringute käsitlemisega.

Hankige ettevõtte andmed VIES-ist

VIESAPI_VIES_DATA() – Funktsioon hangib kõik saadaolevad ettevõtte andmed otse VIES-süsteemist. Parameetrid peaksid olema:

  • Euroopa maksukohustuslasena registreerimise number (VAT EU),
  • (valikuline) FORMAT tagastatud andmetest (vt silte, mida saab kasutada FORMAT parameeter).

=VIESAPI_VIES_DATA("PL7171642051")

Kui vajate VIES-is ainult ettevõtte staatust, kasutage järgmist päringut:

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

Kui tagastatud staatus on Jah, tähendab see, et ettevõttel on kehtiv EL KMKR number.

Sildid saadaval aadressil VIESAPI_VIES_DATA funktsiooni, mida saab kasutada kui FORMAT parameeter:

  • $(UID) – viesApi.eu teenuse loodud unikaalne identifikaator
  • $(CountryCode) – riigikood
  • $(VATNumber) – Euroopa käibemaksukohustuslase number
  • $(Valid) – VIES-teenuse vastus, milles teavitatakse kontrollitava ettevõtte praegusest ELi käibemaksustaatuse kohta (Yes/No)
  • $(TraderName) – ettevõtte registreerimisnimi
  • $(TraderCompanyType) – ettevõtte tüüp
  • $(TraderAddress) – kaupleja aadress, kus ettevõte on registreeritud
  • $(ID) – VIES-süsteemi loodud unikaalne identifikaator (konsultatsiooninumber)
  • $(Date) – vastuse genereerimise kuupäev
  • $(Source) – andmete allikas

Vaikevorming: "$(TraderName), $(TraderAddress)"

Kui string "JSON" on antud kui FORMAT parameeter, tagastab funktsioon täieliku tulemuse JSON-stringina, mida saab vabalt sõeluda ja edasi töödelda:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Hankige VIES-ist parsitud ettevõtte andmeid

VIESAPI_VIES_DATA_PARSED() – Funktsioon hangib kõik saadaolevad ettevõtte andmed otse VIES-süsteemist. Lisaks tagastatakse ettevõtte nimi ja aadress parsitud andmetena, mis on jaotatud eraldi atribuutideks. Parameetrid peaksid olema:

  • Euroopa maksukohustuslasena registreerimise number (VAT EU),
  • (valikuline) FORMAT tagastatud andmetest (vt silte, mida saab kasutada FORMAT parameeter).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Kui vajate VIES-is ainult ettevõtte staatust, kasutage järgmist päringut:

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

Kui tagastatud staatus on Jah, tähendab see, et ettevõttel on kehtiv EL KMKR number.

Sildid saadaval aadressil VIESAPI_VIES_DATA_PARSED funktsiooni, mida saab kasutada kui FORMAT parameeter:

  • $(UID) – viesApi.eu teenuse loodud unikaalne identifikaator
  • $(CountryCode) – riigikood
  • $(VATNumber) – Euroopa käibemaksukohustuslase number
  • $(Valid) – VIES-teenuse vastus, milles teavitatakse kontrollitava ettevõtte praegusest ELi käibemaksustaatuse kohta (Yes/No)
  • $(TraderName) – ettevõtte registreerimisnimi
  • $(TraderNameComponents.Name) – ettevõtte nimi ettevõtte TraderName'ilt (ilma juriidilise vormita)
  • $(TraderNameComponents.LegalForm) – õigusliku vormi nimi, mis on saadud ettevõtja nimest (ilma ettevõtte nimeta)
  • $(TraderNameComponents.LegalFormCanonicalId) – õigusliku vormi sõnastiku identifikaator
  • $(TraderNameComponents.LegalFormCanonicalName) – õigusliku vormi sõnastikunimetus
  • $(TraderCompanyType) – ettevõtte tüüp
  • $(TraderAddress) – kaupleja aadress, kus ettevõte on registreeritud
  • $(TraderAddressComponents.Country) – kaupleja riigi nimi selle riigikeeles
  • $(TraderAddressComponents.PostalCode) – kaupleja aadressi postiindeks
  • $(TraderAddressComponents.City) – kaupleja aadressi linn
  • $(TraderAddressComponents.Street) – kaupleja aadressi tänav
  • $(TraderAddressComponents.StreetNumber) – kaupleja aadressi tänava maja number
  • $(TraderAddressComponents.HouseNumber) – kaupleja aadressi korteri/kontori number
  • $(TraderAddressComponents.Other) – muud aadressiandmed (piirkonna nimi, hoone nimi, korruse number jne)
  • $(ID) – VIES-süsteemi loodud unikaalne identifikaator (konsultatsiooninumber)
  • $(Date) – vastuse genereerimise kuupäev
  • $(Source) – andmete allikas

Vaikevorming: "$(TraderName), $(TraderAddress)"

Kui string "JSON" on antud kui FORMAT parameeter, tagastab funktsioon täieliku tulemuse JSON-stringina, mida saab vabalt sõeluda ja edasi töödelda:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Kasutajakonto oleku kontroll (tasuta)

VIESAPI_ACCOUNT_STATUS() – Funktsioon tagastab põhiteabe kasutaja hetkel kasutatava plaani kohta. Parameetrid peaksid olema:

  • (valikuline) FORMAT tagastatud andmetest (vt silte, mida saab kasutada FORMAT parameeter)

=VIESAPI_ACCOUNT_STATUS()

Tähelepanu! Funktsiooni kutsumine ei suurenda tehtud päringute arvu.

Sildid, mis on saadaval saidil VIESAPI_ACCOUNT_STATUS funktsiooni saab kasutada kui FORMAT parameeter:

  • $(UID) – viesApi.eu teenuse loodud unikaalne identifikaator
  • $(BillingPlanName) – praeguse plaani nimi
  • $(SubscriptionPrice) – igakuine tellimustasu
  • $(ItemPrice) – ühe päringu maksumus väljaspool paketti
  • $(ItemPriceStatus) – päringu hind – käibemaks/VIES/ettevõtte tegevuse staatus
  • $(ItemPriceParsed) – päringu hind – käibemaks/VIES/ettevõtte tegevuse staatus parsitud andmetega
  • $(Limit) – maksimaalne päringute arv plaanis
  • $(RequestDelay) – päringute vaheline minimaalne ajavahemik
  • $(DomainLimit) – domeenide (API-võtmete) maksimaalne arv
  • $(OverPlanAllowed) – võimalus ületada plaanis olevate päringute maksimaalset arvu
  • $(ExcelAddIn) – juurdepääs Google Sheetsi™ ja Microsoft Exceli™ lisandmoodulile
  • $(Stats) – juurdepääs päringustatistikale
  • $(NIPMonitor) – juurdepääs ettevõtete staatuse jälgimisele: KMKR/VIES/tegevuse staatus
  • $(FuncGetVIESData) – juurdepääs funktsioonidele, mis kontrollivad ettevõtte staatust VIES-süsteemis
  • $(FuncGetVIESDataParsed) – juurdepääs funktsioonidele, mis kontrollivad ettevõtte staatust VIES-süsteemis ning analüüsivad ettevõtja nime ja aadressi
  • $(VIESDataCount) – sel kuul tehtud VIES-päringute arv
  • $(VIESDataParsedCount) – sel kuul parsitud andmetega VIES-päringute arv
  • $(TotalCount) – sel kuul tehtud päringute koguarv

Vaikevorming: "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)"

Kui string "JSON" on antud kui FORMAT parameeter, tagastab funktsioon täieliku tulemuse JSON-stringina, mida saab vabalt sõeluda ja edasi töödelda.

VIES-süsteemi oleku kontroll (tasuta)

VIESAPI_VIES_STATUS() – See funktsioon võimaldab teil kontrollida VIES-süsteemi praegust olekut. See tagastab üldise oleku, mis näitab kättesaadavust, ning üksikute liikmesriikide loendi koos nende riiklike süsteemide praeguse kättesaadavuse olekuga. Parameetrid peaksid olema järgmised:

  • (valikuline) FORMAT tagastatud andmetest (vt silte, mida saab kasutada FORMAT parameeter)

=VIESAPI_VIES_STATUS()

Tähelepanu! Funktsiooni kutsumine ei suurenda tehtud päringute arvu.

Sildid, mis on saadaval saidil VIESAPI_VIES_STATUS funktsiooni saab kasutada kui FORMAT parameeter:

  • $(UID) – viesApi.eu teenuse loodud unikaalne identifikaator
  • $(Available) – VIES-süsteemi praegune kättesaadavus (saadaval, osaliselt saadaval, pole saadaval)
  • $(Countries) – üksikute liikmesriikide olekute loetelu (saadaval, mittesaadaval)
  • $(AT), $(FR), $(PL), etc. – konkreetse liikmesriigi kättesaadavuse staatus (kasutage sildi väärtusena kahetähelist suurtähtedega riigikoodi)

Vaikevorming: "$(Available)"

Kui string "JSON" on antud kui FORMAT parameeter, tagastab funktsioon täieliku tulemuse JSON-stringina, mida saab vabalt sõeluda ja edasi töödelda.

Muud kasulikud funktsioonid (tasuta)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funktsioon tagastab teabe antud konto kohta jooksval arvelduskuul tehtud päringute koguarvu kohta (kõik API võtmed). Tagastab täpselt sama numbri kui $(TotalCount) märgendis VIESAPI_STATUS_ACCOUNT() funktsiooni.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funktsioon tagastab teabe kasutaja valitud plaanis saadaolevate päringute maksimaalse arvu kohta. Tagastab täpselt sama numbri kui $(Limit) märgi sisse VIES.STATUS.ACCOUNT() funktsiooni

VIESAPI_EUVAT_NORM() – See funktsioon parandab ja vormindab EL-i käibemaksunumbri (eemaldab tühikud ja sidekriipsud jne) võrguühenduseta ega too VIES-ist andmeid:

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

VIESAPI_EUVAT_VALID() – Funktsioon kontrollib ainult võrguühenduseta EL-i käibemaksukohustuslase numbri õigsust (süntaksit, kontrollsummat) ega too VIES-süsteemist andmeid. Tagastab TRUE kui number on kehtiv või FALSE kui see ei kehti:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funktsioon tagastab lisandmooduli konfiguratsiooni praeguse oleku.

Kui funktsioon tagastab järgmise väärtuse, tähendab see muu hulgas, et ID ja API key ei salvestatud:

ERROR: Connection requires configuration

Pärast salvestamist API ID ja key, peaks funktsioon tagastama järgmise teate:

SUCCESS: Production

Google Sheets™ on Google LLC kaubamärk.