Google Táblázatok™ VIES Validator bővítmény

Google Táblázatok™ VIES Validator bővítmény

vies API Google TáblázatokA Google Sheets™ bővítmény lehetővé teszi a Google Sheets™ táblázatkezelőt használó entitások (vállalkozók) gyors és automatikus ellenőrzését aktuális állapotuk szempontjából a rendszerben. VIES rendszer.

Ez a dokumentáció tartalmazza a Google Táblázatok™ alkalmazás VIES API rendszerrel való integrálásának utasításait.

 

 

Telepítés és konfiguráció

Telepítés

Miután belépett a Google Workspace Marketplace webhelyére https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, kattints a Install gomb.

vies api google táblák bővítmény telepítése

Válassza ki azt a Google-fiókot, amelyhez telepíteni és elérhetővé kell tenni a VIES Validator Google Táblázatok bővítményt:

vies api google táblák bővítmény telepítés fiók

A következő képernyőn elolvashatja a Adatvédelmi irányelvek és az alkalmazandó Szolgáltatási feltételek, valamint az általunk feldolgozandó adatok körét. A telepítés következő lépéséhez nyomja meg a Continue gomb.

vies api google táblák bővítmény telepítési engedélyek

Győződjön meg arról, hogy megadta a szükséges engedélyeket a bővítmény megfelelő működéséhez, majd nyomja meg a gombot. Allow gomb:

vies api google táblák bővítmény telepítési engedélyek engedélyezése

A VIES Validation bővítményt sikeresen telepítettük a fiókodra, és a Google Táblázatok Bővítmények lapon történő elindítása után elérhető lesz. A folytatáshoz kattintson ide Next:

vies api google táblák bővítmény telepítési bővítmény

A telepítő utolsó képernyője felszólít a bővítmény konfigurálására. A „Complete additional setup now” hivatkozásra kattintva egy új böngészőablakban megnyílik az aktuális dokumentációs oldal. Kattintson a Done gombra, és kezdje el a bővítmény konfigurálását a Konfiguráció részben leírtak szerint.

vies api google táblák bővítmény telepítve

Konfiguráció

A telepítés után a bővítmény alapértelmezés szerint tesztkörnyezetre van állítva (további részletek: Teszt API oldal). Ahhoz, hogy függvényeket lehessen hívni éles környezetben, egyszer be kell állítani a viesapi.eu weboldal elérését. Ehhez nyissa meg bármelyik Google Sheets™ táblázatot, és hajtsa végre a függvényt:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

ahol a függvény paraméterei:

  • identifier – a paraméternek tartalmaznia kell a viesapi.eu weboldalon lévő fiókon generált azonosítót (ID),
  • key – a paraméternek tartalmaznia kell a viesapi.eu weboldalon lévő fiókon generált Kulcsot.

Az azonosító és a kulcs létrehozásának részletei a következő oldalon találhatók: Dokumentáció weboldal.

Egy adott API-val (teszt vagy termelés) való kapcsolat helyességének ellenőrzéséhez a következő funkciót kell végrehajtani:

=VIESAPI_CONNECT_STATUS()

Ami értékeket adhat vissza:

  • SUCCESS: Production – ha a bővítmény megfelelően van konfigurálva az éles környezettel való együttműködésre,
  • SUCCESS: Test – ha a bővítmény megfelelően van beállítva, hogy működjön együtt a tesztkörnyezet,
  • ERROR: Connection requires configuration – hibás konfiguráció esetén.

Ha oldalsáv-konfigurációt szeretne, kattintson a Extensions fülre, majd válassza a VIES API - EU VAT Validation és végül kattints Show sidebar az oldalsáv engedélyezéséhez:

vies api google táblák bővítmény konfiguráció oldalsáv

Akkor menj a ID and Key tabulátorral a belépéshez ID és Key a megfelelő szövegmezőkben, amelyek a VIES API-fiókjába való bejelentkezés után érhetők el: https://viesapi.eu/sign-in/

vies api google táblák kiegészítő konfigurációs azonosítója és kulcsa

Használat

A kiegészítő használata előtt meg kell ismerkednie a működésének sajátosságaival:

  • Minden függvényhívás aszinkron módban fut, ami nem okozza a Google Táblázatok™ alkalmazás lefagyási (nincs válasz) hatását.
  • Egy sor vagy oszlop hozzáadása (beszúrása) nem frissíti az összes meghatározott függvényhívást.
  • A függvényeket tartalmazó cellák másolása vagy áthelyezése nem frissíti a meghatározott függvényhívásokat.
  • Egy sor vagy oszlop törlése frissíti az összes definiált függvényhívást, és lekérdezéseket küld a viesApi.eu oldalra (csak alapértelmezett Google Sheets™ beállítások esetén). Az alapértelmezett beállítások módosításának leírása a Konfiguráció fejezetben található.
  • Figyelem! Nem ajánlott 500-nál több párhuzamos lekérdezést futtatni, mert a Google Táblázatok™ gondot okoznak a nagyszámú aszinkron hívás kezelésével.

Vállalati adatok lekérése a VIES-től

VIESAPI_VIES_DATA() – A funkció az összes elérhető cégadatot közvetlenül a VIES rendszerből kéri le. A paramétereknek a következőknek kell lenniük:

  • európai adóazonosító szám (áfa EU),
  • (választható) FORMAT a visszaadott adatok közül (lásd: Címkék, amelyek a FORMAT paraméter).

=VIESAPI_VIES_DATA("PL7171642051")

Ha csak vállalati státuszra van szüksége a VIES-ben, használja a következő lekérdezést:

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

Ha a visszaküldött státusz Igen, az azt jelenti, hogy a cég érvényes EU adószámmal rendelkezik.

Címkék elérhetők a VIESAPI_VIES_DATA funkcióként használható FORMAT paraméter:

  • $(UID) – a viesApi.eu szolgáltatás által generált egyedi azonosító
  • $(CountryCode) – országkód
  • $(VATNumber) – európai adószám
  • $(Valid) – a VIES szolgáltatás válasza, amely tájékoztatja az ellenőrzött vállalat aktuális uniós áfa-státuszáról (Yes/No)
  • $(TraderName) – cégbejegyzési név
  • $(TraderCompanyType) – vállalkozás típusa
  • $(TraderAddress) – a kereskedő címe, ahol a cég be van jegyezve
  • $(ID) – a VIES rendszer által generált egyedi azonosító (konzultációs szám)
  • $(Date) – a válasz generálásának dátuma
  • $(Source) – az adatok forrása

Alapértelmezett formátum: "$(TraderName), $(TraderAddress)"

Ha a húr "JSON" mint a FORMAT paraméter, a függvény a teljes eredményt JSON karakterlánc formájában adja vissza, amely szabadon elemezhető és tovább feldolgozható:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Elemzett cégadatok beszerzése a VIES-ből

VIESAPI_VIES_DATA_PARSED() – A függvény közvetlenül a VIES rendszerből kéri le az összes elérhető cégadatot. Ezenkívül a cég neve és címe különálló attribútumokra bontott, elemzett adatként kerül visszaadásra. A paramétereknek a következőknek kell lenniük:

  • európai adóazonosító szám (áfa EU),
  • (választható) FORMAT a visszaadott adatok közül (lásd: Címkék, amelyek a FORMAT paraméter).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Ha csak vállalati státuszra van szüksége a VIES-ben, használja a következő lekérdezést:

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

Ha a visszaküldött státusz Igen, az azt jelenti, hogy a cég érvényes EU adószámmal rendelkezik.

Címkék elérhetők a VIESAPI_VIES_DATA_PARSED funkcióként használható FORMAT paraméter:

  • $(UID) – a viesApi.eu szolgáltatás által generált egyedi azonosító
  • $(CountryCode) – országkód
  • $(VATNumber) – európai adószám
  • $(Valid) – a VIES szolgáltatás válasza, amely tájékoztatja az ellenőrzött vállalat aktuális uniós áfa-státuszáról (Yes/No)
  • $(TraderName) – cégbejegyzési név
  • $(TraderNameComponents.Name) – cégnév a kereskedőNevéből (jogi forma nélkül)
  • $(TraderNameComponents.LegalForm) – a jogi forma neve a kereskedőNevéből (cégnév nélkül)
  • $(TraderNameComponents.LegalFormCanonicalId) – a jogi forma szótári azonosítója
  • $(TraderNameComponents.LegalFormCanonicalName) – a jogi forma szótári neve
  • $(TraderCompanyType) – vállalkozás típusa
  • $(TraderAddress) – a kereskedő címe, ahol a cég be van jegyezve
  • $(TraderAddressComponents.Country) – a kereskedő ország neve nemzeti nyelvén
  • $(TraderAddressComponents.PostalCode) – a kereskedő címének irányítószáma
  • $(TraderAddressComponents.City) – a kereskedő címének városa
  • $(TraderAddressComponents.Street) – a kereskedő címének utcaneve
  • $(TraderAddressComponents.StreetNumber) – a kereskedő címének utcaneve, házszám
  • $(TraderAddressComponents.HouseNumber) – a kereskedő címének megfelelő lakás-/irodai szám
  • $(TraderAddressComponents.Other) – egyéb címadatok (körzet neve, épület neve, emeletszám stb.)
  • $(ID) – a VIES rendszer által generált egyedi azonosító (konzultációs szám)
  • $(Date) – a válasz generálásának dátuma
  • $(Source) – az adatok forrása

Alapértelmezett formátum: "$(TraderName), $(TraderAddress)"

Ha a húr "JSON" mint a FORMAT paraméter, a függvény a teljes eredményt JSON karakterlánc formájában adja vissza, amely szabadon elemezhető és tovább feldolgozható:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Felhasználói fiók állapotának ellenőrzése (ingyenes)

VIESAPI_ACCOUNT_STATUS() – A függvény alapvető információkat ad vissza a felhasználó által jelenleg használt tervről. A paramétereknek a következőknek kell lenniük:

  • (választható) FORMAT a visszaadott adatok közül (lásd: Címkék, amelyek a FORMAT paraméter)

=VIESAPI_ACCOUNT_STATUS()

Figyelem! A függvény meghívása nem növeli a lekérdezések számát.

Az elérhető címkék a VIESAPI_ACCOUNT_STATUS funkció használható a FORMAT paraméter:

  • $(UID) – a viesApi.eu szolgáltatás által generált egyedi azonosító
  • $(BillingPlanName) – a jelenlegi terv neve
  • $(SubscriptionPrice) – havi előfizetési díj
  • $(ItemPrice) – egyetlen, a csomagon kívüli lekérdezés költsége
  • $(ItemPriceStatus) – lekérdezésenkénti költség – ÁFA/VIES/vállalati tevékenységi státusz
  • $(ItemPriceParsed) – lekérdezésenkénti költség – ÁFA/VIES/Cégtevékenységi állapot elemzett adatokkal
  • $(Limit) – a tervben szereplő lekérdezések maximális száma
  • $(RequestDelay) – minimális időköz a lekérdezések között
  • $(DomainLimit) – maximális domainszám (API-kulcs)
  • $(OverPlanAllowed) – a tervben szereplő lekérdezések maximális számának túllépésének képessége
  • $(ExcelAddIn) – hozzáférés a Google Táblázatok™ és a Microsoft Excel™ bővítményhez
  • $(Stats) – hozzáférés a lekérdezési statisztikákhoz
  • $(NIPMonitor) – hozzáférés a vállalatok státuszának nyomon követéséhez: ÁFA/VIES/Tevékenységi státusz
  • $(FuncGetVIESData) – hozzáférés a VIES rendszerben a cég státuszát ellenőrző funkciókhoz
  • $(FuncGetVIESDataParsed) – hozzáférés olyan funkciókhoz, amelyek ellenőrzik a cég státuszát a VIES rendszerben, és elemzik a kereskedő nevét és címét
  • $(VIESDataCount) – az ebben a hónapban végrehajtott VIES-lekérdezések száma
  • $(VIESDataParsedCount) – az ebben a hónapban elemzett adatokkal végrehajtott VIES-lekérdezések száma
  • $(TotalCount) – az ebben a hónapban végrehajtott lekérdezések teljes száma

Alapértelmezett FORMÁTUM: "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)"

Ha a húr "JSON" mint a FORMAT paraméter, a függvény a teljes eredményt JSON karakterlánc formájában adja vissza, amely szabadon elemezhető és tovább feldolgozható.

VIES rendszer állapotának ellenőrzése (ingyenes)

VIESAPI_VIES_STATUS() – Ez a függvény lehetővé teszi a VIES rendszer aktuális állapotának ellenőrzését. Visszaadja az elérhetőséget jelző általános állapotot, valamint az egyes tagországok listáját a nemzeti rendszereik aktuális elérhetőségi állapotával együtt. A paramétereknek a következőknek kell lenniük:

  • (választható) FORMAT a visszaadott adatok közül (lásd: Címkék, amelyek a FORMAT paraméter)

=VIESAPI_VIES_STATUS()

Figyelem! A függvény meghívása nem növeli a lekérdezések számát.

Az elérhető címkék a VIESAPI_VIES_STATUS funkció használható a FORMAT paraméter:

  • $(UID) – a viesApi.eu szolgáltatás által generált egyedi azonosító
  • $(Available) – a VIES rendszer jelenlegi elérhetősége (Elérhető, Részben elérhető, Nem elérhető)
  • $(Countries) – az egyes tagországok államainak listája (Elérhető, Nem elérhető)
  • $(AT), $(FR), $(PL), etc. – egy adott tagország elérhetőségi állapota (címkeértékként kétbetűs nagybetűs országkódot kell használni)

Alapértelmezett FORMÁTUM: "$(Available)"

Ha a húr "JSON" mint a FORMAT paraméter, a függvény a teljes eredményt JSON karakterlánc formájában adja vissza, amely szabadon elemezhető és tovább feldolgozható.

Egyéb hasznos funkciók (ingyenes)

VIESAPI_ACCOUNT_STATUS_TOTAL() – A függvény információt ad vissza az aktuális számlázási hónapban egy adott fiókra vonatkozó lekérdezések teljes számáról (összes API-kulcs). Pontosan ugyanazt a számot adja vissza, mint a $(TotalCount) címke a VIESAPI_STATUS_ACCOUNT() funkció.

VIESAPI_ACCOUNT_STATUS_LIMIT() – A függvény információt ad vissza a felhasználó által kiválasztott tervben elérhető lekérdezések maximális számáról. Pontosan ugyanazt a számot adja vissza, mint a $(Limit) tag be VIES.STATUS.ACCOUNT() funkció

VIESAPI_EUVAT_NORM() – Ez a funkció offline módban javítja és formázza az EU adószámot (eltávolítja a szóközöket, kötőjeleket stb.), és nem kér le adatokat a VIES-ből:

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

VIESAPI_EUVAT_VALID() – A funkció csak offline ellenőrzi az EU ÁFA szám helyességét (szintaxis, ellenőrző összeg), és nem kér le adatokat a VIES rendszerből. Visszatér TRUE ha a szám érvényes ill FALSE ha nem érvényes:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – A függvény visszaadja a bővítmény konfigurációjának aktuális állapotát.

Ha a függvény a következő értéket adja vissza, az többek között azt jelenti, hogy a ID és API key nem lettek elmentve:

ERROR: Connection requires configuration

Mentés után a API ID és key, a függvénynek a következő üzenetet kell visszaadnia:

SUCCESS: Production

A Google Táblázatok™ a Google LLC védjegye.