Google Sheets™ papildinājums VIES validatoram

Google Sheets™ papildinājums VIES validatoram

vies API Google izklājlapasGoogle Sheets™ papildinājums ļauj ātri un automātiski pārbaudīt vienību (darbuzņēmēju) pašreizējo statusu, izmantojot Google Sheets™ izklājlapu. VIES sistēma.

Šajā dokumentācijā ir sniegti norādījumi par Google Sheets™ lietojumprogrammas integrēšanu ar VIES API sistēmu.

 

 

Instalēšana un konfigurēšana

Uzstādīšana

Pēc ieiešanas Google Workspace Marketplace vietnē https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, noklikšķiniet uz Install pogu.

vies API Google Sheets pievienojumprogrammas instalēšana

Google konta atlasīšana, kuram jāinstalē un jābūt pieejamam VIES Validator Google Sheets pievienojumprogrammai:

vies api google izklājlapu pievienojumprogrammas instalēšanas konts

Nākamajā ekrānā varat izlasīt Privātuma politika un piemērojamo Pakalpojuma noteikumi, kā arī jūsu datu apjomu, ko mēs apstrādāsim. Lai pārietu uz nākamo instalēšanas soli, nospiediet pogu Continue pogu.

vies api google izklājlapu pievienojumprogrammas instalēšanas atļaujas

Pārliecinieties, ka esat piešķīris nepieciešamās atļaujas, lai pievienojumprogramma darbotos pareizi, un nospiediet pogu Allow poga:

vies api google izklājlapu pievienojumprogrammas instalēšanas atļaujas atļaut

VIES validācijas pievienojumprogramma ir veiksmīgi instalēta jūsu kontā un būs pieejama pēc Google izklājlapu palaišanas cilnē Paplašinājumi. Lai turpinātu, lūdzu, noklikšķiniet Next:

vies API google izklājlapu pievienojumprogrammas instalēšanas paplašinājums

Instalētāja pēdējā ekrānā tiks lūgts konfigurēt pievienojumprogrammu. Noklikšķinot uz “Complete additional setup now"saite atvērs jaunu pārlūkprogrammas logu ar pašreizējo dokumentācijas lapu. Noklikšķiniet uz Done pogu un sāciet pievienojumprogrammas konfigurēšanu, kā aprakstīts sadaļā Konfigurācija.

Vies API Google Sheets pievienojumprogramma ir instalēta

Konfigurācija

Pēc instalēšanas spraudnis pēc noklusējuma tiek iestatīts uz testa vidi (sīkāka informācija par Testa API lapa). Lai varētu izsaukt funkcijas ražošanas vidē, ir nepieciešams vienreiz konfigurēt piekļuvi viesapi.eu vietnei. Lai to izdarītu, atveriet jebkuru Google Sheets™ izklājlapu un izpildiet funkciju:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

kur funkcijas parametri ir:

  • identifier – parametrā jāietver identifikators (ID), kas ģenerēts kontā vietnē viesapi.eu,
  • key – parametrā ir jāietver atslēga, kas ģenerēta kontā vietnē viesapi.eu.

Sīkāka informācija par identifikatora un atslēgas ģenerēšanu ir aprakstīta vietnē Dokumentācija tīmekļa vietne.

Lai pārbaudītu savienojuma pareizību ar doto API (tests vai ražošana), jāveic šāda funkcija:

=VIESAPI_CONNECT_STATUS()

Kas var atgriezt vērtības:

  • SUCCESS: Production – ja pievienojumprogramma ir pareizi konfigurēta darbam ar ražošanas vidi,
  • SUCCESS: Test – ja pievienojumprogramma ir pareizi konfigurēta darbam ar testa vide,
  • ERROR: Connection requires configuration – nepareizas konfigurācijas gadījumā.

Ja vēlaties sānu joslas konfigurāciju, noklikšķiniet uz Extensions cilni, pēc tam atlasiet VIES API - EU VAT Validation un visbeidzot noklikšķiniet Show sidebar lai iespējotu sānu joslu:

vies API google izklājlapu papildinājuma konfigurācijas sānjosla

Tad dodieties uz ID and Key cilne, lai ievadītu ID un Key atbilstošajos teksta laukos, kas ir pieejami pēc pieteikšanās savā VIES API kontā: https://viesapi.eu/sign-in/

vies API Google Sheets papildinājuma konfigurācijas ID un atslēga

Lietošana

Pirms pievienojumprogrammas izmantošanas jums jāiepazīstas ar tā darbības specifiku:

  • Visi funkciju izsaukumi tiek izpildīti asinhronā režīmā, kas neizraisa Google Sheets™ lietojumprogrammas iesaldēšanas (nav atbildes) efektu.
  • Pievienojot (ievietojot) rindu vai kolonnu, netiek atsvaidzināti visi definētie funkciju izsaukumi.
  • Kopējot vai pārvietojot šūnas, kurās ir funkcijas, definētie funkciju izsaukumi netiek atsvaidzināti.
  • Dzēšot rindu vai kolonnu, tiks atsvaidzināti visi definētie funkciju izsaukumi un vaicājumi tiks nosūtīti uz viesApi.eu (tikai Google Sheets™ noklusējuma iestatījumu gadījumā). Noklusējuma iestatījumu maiņas apraksts ir iekļauts sadaļā “Konfigurācija”.
  • Uzmanību! Nav ieteicams palaist vairāk nekā 500 paralēlus vaicājumus, jo pakalpojumam Google Sheets™ ir problēmas apstrādāt lielu skaitu asinhronu izsaukumu.

Iegūstiet uzņēmuma datus no VIES

VIESAPI_VIES_DATA() – Funkcija izgūst visus pieejamos uzņēmuma datus tieši no VIES sistēmas. Parametriem jābūt:

  • Eiropas nodokļu identifikācijas numurs (PVN ES),
  • (neobligāti) FORMAT no atgrieztajiem datiem (skatiet: Tagi, kurus var izmantot kā FORMAT parametrs).

=VIESAPI_VIES_DATA("PL7171642051")

Ja jums ir nepieciešams tikai uzņēmuma statuss VIES, lūdzu, izmantojiet šo vaicājumu:

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

Ja atgrieztais statuss ir Jā, tas nozīmē, ka uzņēmumam ir derīgs ES PVN maksātāja numurs.

Tagi ir pieejami vietnē VIESAPI_VIES_DATA funkcija, ko var izmantot kā FORMAT parametrs:

  • $(UID) – unikāls identifikators, ko ģenerē viesApi.eu pakalpojums
  • $(CountryCode) – valsts kods
  • $(VATNumber) – Eiropas PVN numurs
  • $(Valid) – VIES pakalpojuma atbilde, kurā tiek informēts par pārbaudāmā uzņēmuma pašreizējo ES PVN statusu (Yes/No)
  • $(TraderName) – uzņēmuma reģistrācijas nosaukums
  • $(TraderCompanyType) – uzņēmējdarbības veids
  • $(TraderAddress) – tirgotāja adrese, kurā uzņēmums ir reģistrēts
  • $(ID) – VIES sistēmas ģenerēts unikāls identifikators (konsultācijas numurs)
  • $(Date) – datums, kurā atbilde tika ģenerēta
  • $(Source) – datu avots

Noklusējuma formāts: "$(TraderName), $(TraderAddress)"

Ja virkne "JSON" tiek dota kā FORMAT parametru, funkcija atgriezīs pilnu rezultātu JSON virknes veidā, ko var brīvi parsēt un tālāk apstrādāt:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Iegūstiet parsētus uzņēmuma datus no VIES

VIESAPI_VIES_DATA_PARSED() – Funkcija izgūst visus pieejamos uzņēmuma datus tieši no VIES sistēmas. Turklāt uzņēmuma nosaukums un adrese tiek atgriezti kā parsēti dati, kas sadalīti atsevišķos atribūtos. Parametriem jābūt šādiem:

  • Eiropas nodokļu identifikācijas numurs (PVN ES),
  • (neobligāti) FORMAT no atgrieztajiem datiem (skatiet: Tagi, kurus var izmantot kā FORMAT parametrs).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Ja jums ir nepieciešams tikai uzņēmuma statuss VIES, lūdzu, izmantojiet šo vaicājumu:

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

Ja atgrieztais statuss ir Jā, tas nozīmē, ka uzņēmumam ir derīgs ES PVN maksātāja numurs.

Tagi ir pieejami vietnē VIESAPI_VIES_DATA_PARSED funkcija, ko var izmantot kā FORMAT parametrs:

  • $(UID) – unikāls identifikators, ko ģenerē viesApi.eu pakalpojums
  • $(CountryCode) – valsts kods
  • $(VATNumber) – Eiropas PVN numurs
  • $(Valid) – VIES pakalpojuma atbilde, kurā tiek informēts par pārbaudāmā uzņēmuma pašreizējo ES PVN statusu (Yes/No)
  • $(TraderName) – uzņēmuma reģistrācijas nosaukums
  • $(TraderNameComponents.Name) – uzņēmuma nosaukums no traderName (bez juridiskās formas)
  • $(TraderNameComponents.LegalForm) – juridiskās formas nosaukums, kas iegūts no traderName (bez uzņēmuma nosaukuma)
  • $(TraderNameComponents.LegalFormCanonicalId) – juridiskās formas vārdnīcas identifikators
  • $(TraderNameComponents.LegalFormCanonicalName) – juridiskās formas nosaukums vārdnīcā
  • $(TraderCompanyType) – uzņēmējdarbības veids
  • $(TraderAddress) – tirgotāja adrese, kurā uzņēmums ir reģistrēts
  • $(TraderAddressComponents.Country) – tirgotāja valsts nosaukums tās valsts valodā
  • $(TraderAddressComponents.PostalCode) – tirgotāja adreses pasta indekss
  • $(TraderAddressComponents.City) – tirgotāja adreses pilsēta
  • $(TraderAddressComponents.Street) – tirgotāja adreses iela
  • $(TraderAddressComponents.StreetNumber) – tirgotāja adreses ielas numurs
  • $(TraderAddressComponents.HouseNumber) – tirgotāja adreses dzīvokļa/biroja numurs
  • $(TraderAddressComponents.Other) – cita adreses informācija (rajona nosaukums, ēkas nosaukums, stāva numurs utt.)
  • $(ID) – VIES sistēmas ģenerēts unikāls identifikators (konsultācijas numurs)
  • $(Date) – datums, kurā atbilde tika ģenerēta
  • $(Source) – datu avots

Noklusējuma formāts: "$(TraderName), $(TraderAddress)"

Ja virkne "JSON" tiek dota kā FORMAT parametru, funkcija atgriezīs pilnu rezultātu JSON virknes veidā, ko var brīvi parsēt un tālāk apstrādāt:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Lietotāja konta statusa pārbaude (bez maksas)

VIESAPI_ACCOUNT_STATUS() – Funkcija atgriež pamatinformāciju par lietotāja pašlaik izmantoto plānu. Parametriem jābūt:

  • (neobligāti) FORMAT no atgrieztajiem datiem (skatiet: Tagi, kurus var izmantot kā FORMAT parametrs)

=VIESAPI_ACCOUNT_STATUS()

Uzmanību! Funkcijas izsaukšana nepalielina veikto vaicājumu skaitu.

Tagi, kas pieejami vietnē VIESAPI_ACCOUNT_STATUS funkciju var izmantot kā FORMAT parametrs:

  • $(UID) – unikāls identifikators, ko ģenerē viesApi.eu pakalpojums
  • $(BillingPlanName) – pašreizējā plāna nosaukums
  • $(SubscriptionPrice) – ikmēneša abonēšanas maksa
  • $(ItemPrice) – viena pieprasījuma izmaksas ārpus plāna
  • $(ItemPriceStatus) – izmaksas par vaicājumu – PVN/VIES/uzņēmuma darbības statuss
  • $(ItemPriceParsed) – izmaksas par vaicājumu – PVN/VIES/uzņēmuma darbības statuss ar parsētiem datiem
  • $(Limit) – maksimālais vaicājumu skaits plānā
  • $(RequestDelay) – minimālais laika intervāls starp vaicājumiem
  • $(DomainLimit) – maksimālais domēnu (API atslēgu) skaits
  • $(OverPlanAllowed) – spēja pārsniegt maksimālo vaicājumu skaitu plānā
  • $(ExcelAddIn) – piekļuve Google Sheets™ un Microsoft Excel™ pievienojumprogrammai
  • $(Stats) – piekļuve vaicājumu statistikai
  • $(NIPMonitor) – piekļuve uzņēmumu statusa uzraudzībai: PVN/VIES/darbības statuss
  • $(FuncGetVIESData) – piekļuve funkcijām, kas pārbauda uzņēmuma statusu VIES sistēmā
  • $(FuncGetVIESDataParsed) – piekļuve funkcijām, kas pārbauda uzņēmuma statusu VIES sistēmā un analizē tirgotāja vārdu, uzvārdu un adresi
  • $(VIESDataCount) – šajā mēnesī veikto VIES vaicājumu skaits
  • $(VIESDataParsedCount) – šajā mēnesī veikto VIES vaicājumu skaits ar parsētiem datiem
  • $(TotalCount) – kopējais šajā mēnesī veikto vaicājumu skaits

Noklusējuma FORMĀTS: "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)"

Ja virkne "JSON" tiek dota kā FORMAT parametru, funkcija atgriezīs pilnu rezultātu JSON virknes veidā, ko var brīvi parsēt un tālāk apstrādāt.

VIES sistēmas statusa pārbaude (bez maksas)

VIESAPI_VIES_STATUS() – Šī funkcija ļauj pārbaudīt VIES sistēmas pašreizējo statusu. Tā atgriež kopējo statusu, kas norāda pieejamību, kā arī atsevišķu dalībvalstu sarakstu kopā ar to nacionālo sistēmu pašreizējo pieejamības statusu. Parametriem jābūt šādiem:

  • (neobligāti) FORMAT no atgrieztajiem datiem (skatiet: Tagi, kurus var izmantot kā FORMAT parametrs)

=VIESAPI_VIES_STATUS()

Uzmanību! Funkcijas izsaukšana nepalielina veikto vaicājumu skaitu.

Tagi, kas pieejami vietnē VIESAPI_VIES_STATUS funkciju var izmantot kā FORMAT parametrs:

  • $(UID) – unikāls identifikators, ko ģenerē viesApi.eu pakalpojums
  • $(Available) – VIES sistēmas pašreizējā pieejamība (pieejama, daļēji pieejama, nav pieejama)
  • $(Countries) – atsevišķu dalībvalstu štatu saraksts (Pieejams, Nav pieejams)
  • $(AT), $(FR), $(PL), etc. – konkrētas dalībvalsts pieejamības statuss (kā taga vērtību izmantojiet divburtu lielo valsts kodu)

Noklusējuma FORMĀTS: "$(Available)"

Ja virkne "JSON" tiek dota kā FORMAT parametru, funkcija atgriezīs pilnu rezultātu JSON virknes veidā, ko var brīvi parsēt un tālāk apstrādāt.

Citas noderīgas funkcijas (bez maksas)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funkcija atgriež informāciju par kopējo pieprasījumu skaitu, kas veikti pašreizējā norēķinu mēnesī konkrētajam kontam (visas API atslēgas). Atgriež tieši tādu pašu skaitli kā $(TotalCount) tagā VIESAPI_STATUS_ACCOUNT() funkciju.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funkcija atgriež informāciju par maksimālo lietotāja izvēlētajā plānā pieejamo vaicājumu skaitu. Atgriež tieši tādu pašu skaitli kā $(Limit) atzīmējiet VIES.STATUS.ACCOUNT() funkciju

VIESAPI_EUVAT_NORM() – Šī funkcija labo un formatē ES PVN numuru (noņem atstarpes un defises utt.) bezsaistē un neizgūst datus no VIES:

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

VIESAPI_EUVAT_VALID() – Funkcija bezsaistē pārbauda tikai ES PVN numura pareizību (sintakse, kontrolsummu) un neizgūst datus no VIES sistēmas. Atgriežas TRUE ja numurs ir derīgs vai FALSE ja tas nav derīgs:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funkcija atgriež pievienojumprogrammas konfigurācijas pašreizējo statusu.

Ja funkcija atgriež šādu vērtību, tas cita starpā nozīmē, ka ID un API key netika saglabāti:

ERROR: Connection requires configuration

Pēc saglabāšanas API ID un key, funkcijai ir jāatgriež šāds ziņojums:

SUCCESS: Production

Google Sheets™ ir Google LLC preču zīme.