Validator VIES pentru extensia Google Sheets™

Validator VIES pentru extensia Google Sheets™

vies api google sheetsAdd-on-ul Google Sheets™ vă permite să verificați rapid și automat entitățile (contractorii) folosind foaia de calcul Google Sheets™ în funcție de starea lor actuală în Sistemul VIES.

Această documentație conține instrucțiuni despre cum se integrează aplicația Google Sheets™ cu sistemul API VIES.

 

 

Instalare și configurare

Instalare

După ce accesați site-ul web Google Workspace Marketplace https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, apasă pe Install buton.

instalare supliment vies api google sheets

Selectarea Contului Google pentru care ar trebui instalat și disponibil extensia VIES Validator pentru Foi de calcul Google:

cont de instalare a suplimentului Vies API Google Sheets

Pe ecranul următor puteți citi Politica de Confidențialitate și aplicabile Termenii serviciului, precum și domeniul de aplicare al datelor dvs. pe care le vom prelucra. Pentru a trece la pasul următor al instalării, apăsați butonul Continue buton.

permisiuni de instalare pentru suplimentele Vies API Google Sheets

Confirmați că ați acordat permisiunile necesare pentru ca extensia să funcționeze corect și apăsați butonul Allow buton:

permisiunile de instalare ale suplimentului Google Sheets pentru Vies API permit

Add-on-ul VIES Validation a fost instalat cu succes în contul dvs. și va fi disponibil după lansarea Google Sheets în fila Extensii. Pentru a continua, vă rugăm să faceți clic pe Next:

extensie de instalare pentru Vies API Google Sheets

Ecranul final al programului de instalare vă va solicita să configurați extensia. Dacă faceți clic pe „Complete additional setup now„” va deschide o nouă fereastră de browser cu pagina curentă de documentație. Faceți clic pe Done și începeți configurarea extensiei așa cum este descris în secțiunea Configurare.

Add-on-ul Vies API Google Sheets instalat

Configurare

După instalare, pluginul este setat în mod implicit la mediul de testare (mai multe detalii despre Testați API-ul (pagină). Pentru a putea apela funcții în mediul de producție, este necesar să configurați o singură dată accesul la site-ul viesapi.eu. Pentru a face acest lucru, accesați orice foaie de calcul Google Sheets™ și executați funcția:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

unde parametrii funcției sunt:

  • identifier – parametrul trebuie să conțină identificatorul (ID) generat în contul de pe site-ul viesapi.eu,
  • key – parametrul trebuie să conțină Cheia generată pe contul de pe site-ul viesapi.eu.

Detaliile despre generarea identificatorului și a cheii sunt descrise în Documentație site-ul web.

Pentru a verifica corectitudinea conexiunii cu un anumit API (test sau producție), trebuie efectuată următoarea funcție:

=VIESAPI_CONNECT_STATUS()

Care poate returna valori:

  • SUCCESS: Production – dacă programul de completare este configurat corect pentru a funcționa cu mediul de producție,
  • SUCCESS: Test – dacă programul de completare este configurat corect pentru a funcționa cu mediu de testare,
  • ERROR: Connection requires configuration – în cazul unei configurații greșite.

Dacă preferați o configurație cu bara laterală, faceți clic pe Extensions filă, apoi selectați VIES API - EU VAT Validation și în final faceți clic Show sidebar pentru a activa bara laterală:

bara laterală de configurare a suplimentului Vies API Google Sheets

Apoi mergeți la ID and Key tab pentru a introduce ID și Key în câmpurile de text corespunzătoare, disponibile după conectarea la contul dvs. VIES API: https://viesapi.eu/sign-in/

ID-ul și cheia de configurare a suplimentului Vies API Google Sheets

Utilizare

Înainte de a utiliza suplimentul, ar trebui să vă familiarizați cu specificul funcționării acestuia:

  • Toate apelurile de funcții sunt executate în mod asincron, ceea ce nu provoacă efectul de blocare (lipsa de răspuns) al aplicației Google Sheets™.
  • Adăugarea (inserarea) unui rând sau coloană nu reîmprospătează toate apelurile de funcții definite.
  • Copierea sau mutarea celulelor care conțin funcții nu reîmprospătează apelurile de funcții definite.
  • Ștergerea unui rând sau a unei coloane va reîmprospăta toate apelurile de funcții definite și va trimite interogări către viesApi.eu (numai în cazul setărilor implicite Google Sheets™). Descrierea modificării setărilor implicite este inclusă în capitolul Configurare.
  • Atenție! Nu se recomandă rularea a mai mult de 500 de interogări paralele, deoarece Google Sheets™ are probleme la gestionarea unui număr mare de apeluri asincrone.

Obțineți date despre companie de la VIES

VIESAPI_VIES_DATA() – Funcția preia toate datele disponibile ale companiei direct din sistemul VIES. Parametrii ar trebui să fie:

  • Număr european de identificare fiscală (TVA UE),
  • (optional) FORMAT a datelor returnate (vezi: Etichete care pot fi folosite ca FORMAT parametru).

=VIESAPI_VIES_DATA("PL7171642051")

Dacă aveți nevoie doar de statutul companiei în VIES, vă rugăm să utilizați următoarea interogare:

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

Dacă statutul returnat este Da, înseamnă că compania are un număr valid de TVA în UE.

Etichete disponibile în VIESAPI_VIES_DATA funcţie care poate fi folosită ca FORMAT parametru:

  • $(UID) – identificator unic generat de serviciul viesApi.eu
  • $(CountryCode) – codul țării
  • $(VATNumber) – număr european de TVA
  • $(Valid) – răspuns din partea serviciului VIES, care informează despre statutul actual în materie de TVA în UE al companiei verificate (Yes/No)
  • $(TraderName) – numele de înregistrare al companiei
  • $(TraderCompanyType) – tipul de afacere
  • $(TraderAddress) – adresa comerciantului unde este înregistrată societatea
  • $(ID) – identificator unic generat de sistemul VIES (număr de consultare)
  • $(Date) – data la care a fost generat răspunsul
  • $(Source) – sursa datelor

Format implicit: "$(TraderName), $(TraderAddress)"

Dacă sfoara "JSON" este dat ca FORMAT parametrul, funcția va returna rezultatul complet sub forma unui șir JSON, care poate fi analizat liber și procesat în continuare:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Obțineți date analizate ale companiei de la VIES

VIESAPI_VIES_DATA_PARSED() – Funcția preia toate datele disponibile ale companiei direct din sistemul VIES. În plus, numele și adresa companiei sunt returnate ca date analizate, împărțite în atribute separate. Parametrii ar trebui să fie:

  • Număr european de identificare fiscală (TVA UE),
  • (optional) FORMAT a datelor returnate (vezi: Etichete care pot fi folosite ca FORMAT parametru).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Dacă aveți nevoie doar de statutul companiei în VIES, vă rugăm să utilizați următoarea interogare:

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

Dacă statutul returnat este Da, înseamnă că compania are un număr valid de TVA în UE.

Etichete disponibile în VIESAPI_VIES_DATA_PARSED funcţie care poate fi folosită ca FORMAT parametru:

  • $(UID) – identificator unic generat de serviciul viesApi.eu
  • $(CountryCode) – codul țării
  • $(VATNumber) – număr european de TVA
  • $(Valid) – răspuns din partea serviciului VIES, care informează despre statutul actual în materie de TVA în UE al companiei verificate (Yes/No)
  • $(TraderName) – numele de înregistrare al companiei
  • $(TraderNameComponents.Name) – numele companiei din traderName (fără formă juridică)
  • $(TraderNameComponents.LegalForm) – denumirea formei juridice extrasă din traderName (fără denumirea companiei)
  • $(TraderNameComponents.LegalFormCanonicalId) – identificator de dicționar al formei juridice
  • $(TraderNameComponents.LegalFormCanonicalName) – denumirea din dicționar a formei juridice
  • $(TraderCompanyType) – tipul de afacere
  • $(TraderAddress) – adresa comerciantului unde este înregistrată societatea
  • $(TraderAddressComponents.Country) – numele țării comerciant în limba sa națională
  • $(TraderAddressComponents.PostalCode) – codul poștal al adresei comerciantului
  • $(TraderAddressComponents.City) – orașul adresei comerciantului
  • $(TraderAddressComponents.Street) – strada adresei comerciantului
  • $(TraderAddressComponents.StreetNumber) – numărul străzii de la adresa comerciantului
  • $(TraderAddressComponents.HouseNumber) – numărul apartamentului/biroului de la adresa comerciantului
  • $(TraderAddressComponents.Other) – alte detalii despre adresă (denumirea zonei, numele clădirii, numărul etajului etc.)
  • $(ID) – identificator unic generat de sistemul VIES (număr de consultare)
  • $(Date) – data la care a fost generat răspunsul
  • $(Source) – sursa datelor

Format implicit: "$(TraderName), $(TraderAddress)"

Dacă sfoara "JSON" este dat ca FORMAT parametrul, funcția va returna rezultatul complet sub forma unui șir JSON, care poate fi analizat liber și procesat în continuare:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Verificarea stării contului de utilizator (gratuit)

VIESAPI_ACCOUNT_STATUS() – Funcția returnează informații de bază despre planul utilizat în prezent de utilizator. Parametrii ar trebui să fie:

  • (optional) FORMAT a datelor returnate (vezi: Etichete care pot fi folosite ca FORMAT parametru)

=VIESAPI_ACCOUNT_STATUS()

Atenţie! Apelarea funcției nu crește numărul de interogări efectuate.

Etichetele disponibile în VIESAPI_ACCOUNT_STATUS funcția poate fi folosită ca FORMAT parametru:

  • $(UID) – identificator unic generat de serviciul viesApi.eu
  • $(BillingPlanName) – numele planului actual
  • $(SubscriptionPrice) – taxă lunară de abonament
  • $(ItemPrice) – costul unei singure interogări în afara planului
  • $(ItemPriceStatus) – cost per interogare – TVA/VIES/statutul activității companiei
  • $(ItemPriceParsed) – cost per interogare – TVA/VIES/statusul activității companiei cu date analizate
  • $(Limit) – numărul maxim de interogări din plan
  • $(RequestDelay) – intervalul minim de timp dintre interogări
  • $(DomainLimit) – numărul maxim de domenii (chei API)
  • $(OverPlanAllowed) – capacitatea de a depăși numărul maxim de interogări din plan
  • $(ExcelAddIn) – acces la extensiile Google Sheets™ și Microsoft Excel™
  • $(Stats) – acces la statisticile interogărilor
  • $(NIPMonitor) – acces la monitorizarea statutului companiilor: TVA/VIES/Statut activitate
  • $(FuncGetVIESData) – acces la funcții care verifică statutul companiei în sistemul VIES
  • $(FuncGetVIESDataParsed) – acces la funcții care verifică statutul companiei în sistemul VIES și analizează numele și adresa comerciantului
  • $(VIESDataCount) – numărul de interogări VIES efectuate în această lună
  • $(VIESDataParsedCount) – numărul de interogări VIES cu date analizate efectuate în această lună
  • $(TotalCount) – numărul total de interogări efectuate în această lună

FORMAT implicit: "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)"

Dacă sfoara "JSON" este dat ca FORMAT parametrul, funcția va returna rezultatul complet sub forma unui șir JSON, care poate fi analizat liber și procesat în continuare.

Verificarea stării sistemului VIES (gratuit)

VIESAPI_VIES_STATUS() – Această funcție vă permite să verificați starea actuală a sistemului VIES. Returnează o stare generală care indică disponibilitatea, precum și o listă a țărilor membre individuale, împreună cu starea actuală de disponibilitate a sistemelor lor naționale. Parametrii ar trebui să fie:

  • (optional) FORMAT a datelor returnate (vezi: Etichete care pot fi folosite ca FORMAT parametru)

=VIESAPI_VIES_STATUS()

Atenţie! Apelarea funcției nu crește numărul de interogări efectuate.

Etichetele disponibile în VIESAPI_VIES_STATUS funcția poate fi folosită ca FORMAT parametru:

  • $(UID) – identificator unic generat de serviciul viesApi.eu
  • $(Available) – disponibilitatea actuală a sistemului VIES (Disponibil, Parțial disponibil, Indisponibil)
  • $(Countries) – lista statelor fiecărui membru (Disponibil, Indisponibil)
  • $(AT), $(FR), $(PL), etc. – starea disponibilității unei anumite țări membre (folosiți codul țării format din 2 litere majuscule ca valoare a etichetei)

FORMAT implicit: "$(Available)"

Dacă sfoara "JSON" este dat ca FORMAT parametrul, funcția va returna rezultatul complet sub forma unui șir JSON, care poate fi analizat liber și procesat în continuare.

Alte funcții utile (gratuit)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funcția returnează informații despre numărul total de solicitări efectuate în luna curentă de facturare pentru un anumit cont (toate cheile API). Returnează exact același număr ca și $(TotalCount) eticheta în VIESAPI_STATUS_ACCOUNT() funcţie.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funcția returnează informații despre numărul maxim de interogări disponibile în planul selectat de utilizator. Returnează exact același număr ca și $(Limit) etichetați VIES.STATUS.ACCOUNT() funcţie

VIESAPI_EUVAT_NORM() – Această funcție corectează și formatează numărul de TVA al UE (elimină spațiile și cratimele etc.) offline și nu preia nicio dată din VIES:

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

VIESAPI_EUVAT_VALID() – Funcția verifică doar corectitudinea (sintaxă, suma de control) offline a numărului de TVA UE și nu preia nicio dată din sistemul VIES. Se intoarce TRUE dacă numărul este valid sau FALSE daca nu este valabil:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funcția returnează starea curentă a configurației suplimentului.

Dacă funcția returnează următoarea valoare, înseamnă, printre altele, că ID și API key nu au fost salvati:

ERROR: Connection requires configuration

După salvarea API ID și key, funcția ar trebui să returneze următorul mesaj:

SUCCESS: Production

Google Sheets™ este o marcă înregistrată a Google LLC.