Suplimentul Excel vă permite să verificați rapid și automat entitățile (antreprenorii) folosind foaia de calcul Excel în ceea ce privește starea lor actuală în Sistemul VIES.

Acest capitol conține instrucțiuni despre cum să integrați aplicația Microsoft Excel cu sistemul nip24.pl. Suplimentul furnizat a fost testat cu succes în următoarele versiuni de MS Excel: 2007, 2010, 2013, 2016, 2019 (pe sistemele de operare Windows și MacOS) și 2021 (pe sistemele de operare Windows și MacOS) și versiunea web din Excel365.

Cea mai recentă versiune a suplimentului pentru Excel 2007, 2010, 2013, 2016 și 2019 este întotdeauna disponibilă pentru descărcare din Pagina de descărcare. Suplimentul poate fi instalat în ambele versiuni de Excel pe 32 de biți și 64 de biți. Atenţie! Selectați versiunea (32 sau 64 de biți) care se potrivește cu versiunea de Excel, nu sistemul de operare.

Pentru a descărca și instala suplimentul pentru MacOS și Excel 2021 pentru Windows și Excel365, vă rugăm să vizitați magazinul oficial Microsoft: https://appsource.microsoft.com.

Funcționalitatea completă a suplimentului Excel poate fi verificată - fără a fi nevoie să creați un cont – folosind cele furnizate Testați API-ul. Pagina descrie, de asemenea, cum să configurați un program de completare Excel pentru utilizare în API-ul furnizat pentru testare.

Utilizarea add-in-ului în API-ul de producție necesită crearea unui cont pe site-ul viesapi.eu, achiziționarea unui minim din Planul de afaceri și generarea unei chei și a identificatorului acesteia. Procesul de înregistrare și creare a unui cont, precum și de generare a cheilor a fost descris pe Documentație site-ul web.

Instalare și configurare pentru MS Excel 2021 și Excel 365 din Microsoft Store (AppSource)

Instalare

După intrarea pe site-ul Magazinului oficial Microsoft https://appsource.microsoft.com, apasă pe Get it now buton.

Va fi afișată o fereastră de autentificare în care trebuie să introduceți adresa de e-mail pentru care v-ați creat un cont la Microsoft (privat sau corporativ). Dacă nu aveți un astfel de cont, puteți să creați unul și să continuați procesul de instalare sau să opriți instalarea și să utilizați opțiunea de a instala suplimentul într-unul din modalitățile descrise mai sus.

Pentru a descărca și instala programul de completare din Excel 2021 sau Excel 365 (web), accesați Insert [1], găsiți secțiunea Suplimente și faceți clic pe OfficeAdd-ins butonul [2]. Apoi, în fereastra deschisă, introduceți cuvântul „viesapi ′ [3] în câmpul de căutare și apăsați pictograma lupă. Un supliment numit „VIES API - EU VAT Validation” ar trebui găsit, care ar trebui să fie instalat făcând clic pe Add butonul [4]. Toți pașii de mai sus sunt ilustrați în captura de ecran de mai jos:

După ce faceți clic pe Add butonul, ar trebui să apară un ecran în care puteți citi termenii licenței și regulile de protecție a confidențialității.

Pentru a începe instalarea suplimentului, apăsați Continue buton.

Configurare

După instalarea corectă a pluginului, ar trebui să vedeți un ecran similar cu cel prezentat mai jos. În Home menu [1], găsiți pictograma care reprezintă VIES API Panel [2] și faceți clic pe el pentru a afișa panoul lateral. Imediat după instalare, programul de completare este configurat să funcționeze într-un mediu de testare - detalii pe Pagina Test API. Utilizarea suplimentului în modul de testare nu necesită crearea unui cont pe viesapi.eu site-ul web.

Pentru a comuta suplimentul în mediul de producție, faceți clic pe ID and key [3] și introduceți Key și cheie ID, pe care îl puteți găsi după ce vă conectați la contul dvs. pe site-ul viesapi.eu în secțiunea „API Keys” fila. După introducerea ambelor valori, apăsați tasta Save buton.

Dacă nu aveți încă un cont pe site-ul nostru, faceți clic pe linkul la viesapi.eu [4] și parcurgeți procesul de înregistrare, care este descris în detaliu pe Documentație pagină.

Instalare și configurare pentru Excel: 2007, 2010, 2013, 2016 și 2019

Instalare

Obțineți cea mai recentă versiune a programului de completare pentru Excel 2007, 2010, 2013, 2016 și 2019 din Pagina de descărcare. Lansați MS Excel și accesați File> Options, apoi selectați Add-ins [1] din meniu.

În partea de jos a setărilor, selectați Excel Add-ins [2] și faceți clic pe Go butonul [3].

Utilizatorii avansați pot adăuga un supliment din Developer fila [1], apoi faceți clic Excel Add-ins [2] și faceți clic pe Browse butonul [3]:

În Add-ins fereastra, faceți clic pe Browse butonul, accesați directorul în care viesapi-ms-excel-addin-version-number.zip fișierul a fost dezambalat și selectați:

• viesapiExcel.xll – pentru versiunea pe 32 de biți de Excel,
• viesapiExcel64.xll – pentru versiunea pe 64 de biți de Excel.

Încărcarea corectă a suplimentului este prezentată în figura de mai jos [1].

Este suficient să faceți clic pe OK butonul [2] pentru a face disponibile în Excel funcțiile implementate în add-in.

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 accesul la site-ul viesapi.eu o dată. Pentru a face acest lucru, accesați orice foaie de calcul Excel și efectuaț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.

În mod implicit, fiecare document Excel este setat să calculeze automat foaia de calcul. Setarea acestei opțiuni implică apelarea tuturor formulelor atunci când se fac modificări care afectează formula. Un exemplu în acest sens este ștergerea unui rând dintr-o foaie de lucru.

Pentru a evita invocarea automată a tuturor funcțiilor definite într-o foaie dată, care este legată de trimiterea automată a interogărilor către API-ul site-ului veisapi.eu, schimbați opțiunea de calcul a registrului de lucru la Manual:

1. De la File meniul, Selectați Options
2. Evidențiați Formulas fila
3. În secțiunea Opțiuni de calcul, selectați setarea: Manual și debifați varianta suplimentara: Recalculate the workbook before saving.
4. Este necesar să salvați modificările făcute în foaie.

Cu foaia de calcul Excel configurată astfel, pentru a forța reîmprospătarea tuturor formulelor definite, apăsați combinația de taste:

CTRL + ALT + SHIFT + F9

Actualizați pluginul la cea mai recentă versiune

Atenţie! Următoarea procedură pentru actualizarea programului de completare Excel funcționează corect pentru versiunile MS Excel 2019, 2021 și Excel 365, unde programul de completare poate fi instalat din Microsoft Store.

Atenţie! După instalarea celei mai recente versiuni, trebuie să reconfigurați add-on-ul, adică să introduceți și să salvați ID-ul și cheia.

Pentru a instala cea mai recentă versiune a programului de completare Excel, urmați acești pași:

1. Verificați versiunea programului de completare instalat apelând formula =VIESAPI.VERSION(). Cea mai recentă versiune a suplimentului este 1.2.8

2. Ștergerea cache-ului MS Excel, conform procedurii descrise pe pagina oficială de documentație: https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache

3. După finalizarea tuturor pașilor de la punctul 2, reporniți aplicația MS Excel.

4. În timpul repornirii, aplicația MS Excel va descărca cea mai recentă versiune a programului de completare din Microsoft Store.

5. Configurați add-on-ul introducând ID-ul și cheia descărcate după conectarea la contul dvs. pe nostru site-ul web – fila „Chei API”.

Utilizare

Urmăriți cum să verificați automat și masiv statutul de TVA în UE al companiilor în sistemul VIES utilizând suplimentul nostru Excel:

Î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 modul asincron, ceea ce nu provoacă efectul de înghețare (fără răspuns) al aplicației Excel.
• 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 (doar în cazul setărilor implicite Excel). Descrierea modificării setărilor implicite este inclusă în capitolul Configurare.
• Atenţie! Nu este recomandat să rulați mai mult de 500 de interogări paralele, deoarece Excel are probleme cu 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 tarii
• $(VATNumber) – Număr de TVA european
• $(Valid) – Număr de TVA UE de stare valabilă (Yes/No)
  
• $(TraderName) – Numele contractantului/furnizorului
• $(TraderCompanyType) - Tip afacere
• $(TraderAddress) – Adresa contrapartidei
• $(ID) – Identificator unic generat de sistemul VIES
• $(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")

Verificarea stării contului de utilizator (gratuit)

VIESAPI.STATUS.ACCOUNT() – 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.STATUS.ACCOUNT()

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

Etichetele disponibile în VIESAPI.STATUS.ACCOUNT funcția poate fi folosită ca FORMAT parametru:

• $(BillingPlanName) – Denumirea planului tarifar actual
• $(SubscriptionPrice) – Prețul net al abonamentului lunar
• $(ItemPrice) – Costul net de interogare unică în afara planului în planul standard
• $(ItemPriceStatus) – Costul net al unei singure anchete – VIES / Statutul de afaceri al entității într-un plan individual
• $(Limit) – Numărul maxim de interogări din plan
• $(RequestDelay) – Intervalul minim de timp dintre cereri
• $(DomainLimit) – Număr maxim de domenii (chei API)
• $(OverPlanAllowed) – Capacitatea de a depăși numărul maxim de interogări din plan
• $(ExcelAddIn) – Accesați folosind programul de completare MS Excel
• $(Stats) – Acces la statisticile interogărilor efectuate
• $(NIPMonitor) – Acces la monitorizarea stării VIES
• $(SearchByNIP) – Căutare după numărul de identificare fiscală UE
• $(FuncGetVIESData) – Acces la funcții care verifică starea entității în sistemul VIES
• $(VIESStatusCount) – Numărul de întrebări efectuate cu privire la statutul entității în sistemul VIES
• $(TotalCount) – Numărul total de interogări executate în luna curentă

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.

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