„Excel“ priedas leidžia greitai ir automatiškai patikrinti subjektus (rangovus) naudojant „Excel“ skaičiuoklę pagal jų dabartinę būseną VIES sistema.

Šiame skyriuje pateikiamos instrukcijos, kaip integruoti Microsoft Excel programą su nip24.pl sistema. Pateiktas priedas buvo sėkmingai išbandytas šiose MS Excel versijose: 2007, 2010, 2013, 2016, 2019 (Windows ir MacOS operacinėse sistemose) ir 2021 (Windows ir MacOS operacinėse sistemose) ir žiniatinklio versija Excel365.

Naujausią „Excel 2007“, 2010, 2013, 2016 ir 2019 m. priedo versiją visada galima atsisiųsti iš Atsisiuntimo puslapis. Priedas gali būti įdiegtas ir 32 bitų, ir 64 bitų Excel versijose. Dėmesio! Pasirinkite versiją (32 arba 64 bitų). atitinka Excel versiją, o ne operacinė sistema.

Norėdami atsisiųsti ir įdiegti priedą, skirtą „MacOS“ ir „Excel 2021“, skirtą „Windows“ ir „Excel365“, apsilankykite oficialioje „Microsoft“ parduotuvėje: https://appsource.microsoft.com.

Visas „Excel“ papildinio funkcionalumas gali būti patikrintas – nereikia susikurti paskyros – naudojant suteiktą Bandomasis API. Puslapyje taip pat aprašoma, kaip sukonfigūruoti „Excel“ priedą, kad jis būtų naudojamas testavimui skirtoje API.

Norint naudoti priedą gamybinėje API, reikia susikurti paskyrą viesapi.eu svetainėje, įsigyti minimalų Verslo planą ir sugeneruoti raktą bei jo identifikatorių. Paskyros registravimo ir nustatymo bei raktų generavimo procesas aprašytas Dokumentacija Interneto svetainė.

„MS Excel 2021“ ir „Excel 365“ diegimas ir konfigūravimas iš „Microsoft Store“ (AppSource)

Montavimas

Įėjus į oficialią „Microsoft Store“ svetainę https://appsource.microsoft.com, spustelėkite Get it now mygtuką.

vies excel masinis patvirtinimas

Bus rodomas prisijungimo langas, kuriame turėsite įvesti el. pašto adresą, kuriam susikūrėte „Microsoft“ paskyrą (privati arba įmonė). Jei neturite tokios paskyros, galite ją sukurti ir tęsti diegimo procesą arba sustabdyti diegimą ir pasinaudoti galimybe įdiegti priedą vienu iš aukščiau aprašytų būdų.

Norėdami atsisiųsti ir įdiegti priedą iš „Excel 2021“ arba „Excel 365“ (žiniatinklio), eikite į Insert [1] skirtuke raskite skiltį Papildiniai ir spustelėkite OfficeAdd-ins [2] mygtukas. Tada atsidariusiame lange įveskite žodį "viesapi ′ [3] paieškos laukelyje ir paspauskite didinamojo stiklo piktogramą. Priedas pavadinimu „VIES API - EU VAT Validation“, kuris turėtų būti įdiegtas spustelėjus Add mygtuką [4]. Visi aukščiau pateikti veiksmai iliustruoti toliau esančioje ekrano kopijoje:

Paspaudę Add mygtuką, turėtų pasirodyti ekranas, kuriame galėsite perskaityti licencijos sąlygas ir privatumo apsaugos taisykles.

Norėdami pradėti diegti priedą, paspauskite Continue mygtuką.

Konfigūracija

Teisingai įdiegę papildinį, turėtumėte pamatyti ekraną, panašų į toliau pateiktą. Viduje Home menu [1], raskite piktogramą, vaizduojančią VIES API Panel [2] ir spustelėkite jį, kad būtų rodomas šoninis skydelis. Iš karto po įdiegimo priedas sukonfigūruojamas veikti bandomojoje aplinkoje – išsami informacija apie Bandomasis API puslapis. Naudojant priedą bandomuoju režimu, nereikia sukurti paskyros viesapi.eu Interneto svetainė.

Norėdami perjungti priedą į gamybos aplinką, spustelėkite ID and key [3] skirtuką ir įveskite Key ir raktas ID, kurią rasite prisijungę prie savo paskyros viesapi.eu svetainėje esančiame „API Keys“ skirtuką. Įvedę abi reikšmes, paspauskite Save mygtuką.

Jei dar neturite paskyros mūsų svetainėje, spustelėkite nuorodą adresu viesapi.eu [4] ir atlikite registracijos procesą, kuris išsamiai aprašytas Dokumentacija puslapį.

„Excel“ diegimas ir konfigūravimas: 2007, 2010, 2013, 2016 ir 2019 m.

Montavimas

Gaukite naujausią „Excel 2007“, 2010, 2013, 2016 ir 2019 m. papildinio versiją iš Atsisiuntimo puslapis. Paleiskite MS Excel ir eikite į File> Options, tada pasirinkite Add-ins [1] iš meniu.

Nustatymų apačioje pasirinkite Excel Add-ins [2] ir spustelėkite Go [3] mygtukas.

Patyrę vartotojai gali pridėti priedą iš Developer skirtuką [1], tada spustelėkite Excel Add-ins [2] ir spustelėkite Browse [3] mygtukas:

vies excel

Viduje Add-ins langą, spustelėkite Browse mygtuką, eikite į katalogą, kuriame viesapi-ms-excel-addin-version-number.zip failas buvo išpakuotas ir pasirinkite:

  • viesapiExcel.xll – 32 bitų „Excel“ versijai,
  • viesapiExcel64.xll – 64 bitų „Excel“ versijai.

vies excel insatllation

Teisingas priedo įkėlimas parodytas paveikslėlyje žemiau [1].

vies excel konfigūracija

Pakanka spustelėti OK mygtuką [2], kad papildyme įdiegtos funkcijos būtų pasiekiamos programoje „Excel“.

Konfigūracija

Įdiegus papildinį pagal numatytuosius nustatymus nustatoma bandomoji aplinka (daugiau informacijos apie Bandomasis API puslapis). Kad būtų galima iškviesti funkcijas gamybinėje aplinkoje, reikia vieną kartą sukonfigūruoti prieigą prie viesapi.eu svetainės. Norėdami tai padaryti, eikite į bet kurią „Excel“ skaičiuoklę ir atlikite šią funkciją:

=VIESAPI.CONNECT.PRODUCTION("identifier";"key")

kur funkcijos parametrai:

  • identifier – parametre turi būti nurodytas identifikatorius (ID), sugeneruotas paskyroje viesapi.eu svetainėje,
  • key – parametre turi būti raktas, sugeneruotas paskyroje viesapi.eu svetainėje.

Išsami informacija apie identifikatoriaus ir rakto generavimą aprašyta Dokumentacija Interneto svetainė.

Norint patikrinti ryšio su tam tikra API teisingumą (bandymas arba gamyba), reikia atlikti šią funkciją:

=VIESAPI.CONNECT.STATUS()

Kuris gali grąžinti reikšmes:

  • SUCCESS: Production – jei priedas tinkamai sukonfigūruotas dirbti su gamybos aplinka,
  • SUCCESS: Test – jei priedas tinkamai sukonfigūruotas dirbti su bandymo aplinka,
  • ERROR: Connection requires configuration – esant neteisingai konfigūracijai.

Pagal numatytuosius nustatymus kiekvienas „Excel“ dokumentas yra nustatytas automatiškai apskaičiuoti skaičiuoklę. Šios parinkties nustatymas reiškia, kad visos formulės iškviečiamos, kai atliekami pakeitimai, turintys įtakos formulei. To pavyzdys yra eilutės ištrynimas darbalapyje.

Kad išvengtumėte automatinio visų duotame lape apibrėžtų funkcijų iškvietimo, kuris yra susijęs su automatiniu užklausų siuntimu į veisapi.eu svetainės API, darbaknygės skaičiavimo parinktį pakeiskite į Rankinis:

  1. Nuo File Meniu, pasirinkite Options
  2. Pažymėkite Formulas skirtuką
  3. Skiltyje Skaičiavimo parinktys pasirinkite nustatymą: Manual ir panaikinkite žymėjimą papildoma parinktis: Recalculate the workbook before saving.
  4. Būtina išsaugoti lape atliktus pakeitimus.

Jei „Excel“ skaičiuoklė sukonfigūruota taip, kad priverstumėte atnaujinti visas apibrėžtas formules, paspauskite klavišų kombinaciją:

CTRL + ALT + SHIFT + F9

Naudojimas

Pažiūrėkite, kaip automatiškai ir masiškai patikrinti įmonių ES PVM statusą VIES sistemoje naudojant mūsų Excel priedą:

Prieš naudodami priedą, turėtumėte susipažinti su jo veikimo specifika:

  • Visi funkcijų iškvietimai vykdomi asinchroniniu režimu, o tai nesukelia „Excel“ programos stingimo (neatsako) efekto.
  • Pridėjus (įterpiant) eilutę arba stulpelį neatnaujinami visi apibrėžti funkcijų iškvietimai.
  • Kopijuojant arba perkeliant langelius, kuriuose yra funkcijų, apibrėžti funkcijų iškvietimai neatnaujinami.
  • Panaikinus eilutę ar stulpelį, bus atnaujinti visi apibrėžti funkcijų iškvietimai ir viesApi.eu bus išsiųstos užklausos (tik numatytųjų Excel nustatymų atveju). Numatytųjų nustatymų keitimo aprašymas pateikiamas skyriuje Konfigūracija.
  • Dėmesio! Nerekomenduojama vykdyti daugiau nei 500 lygiagrečių užklausų, nes Excel susiduria su daugybe asinchroninių skambučių problemų.

Gaukite įmonės duomenis iš VIES

VIESAPI.VIES.DATA() – Funkcija nuskaito visus turimus įmonės duomenis tiesiai iš VIES sistemos. Parametrai turėtų būti:

  • Europos mokesčių mokėtojo kodas (PVM EU),
  • (neprivaloma) FORMAT grąžintų duomenų (žr.: Žymos, kurios gali būti naudojamos kaip FORMAT parametras).

=VIESAPI.VIES.DATA("PL7171642051")

Jei jums reikia tik įmonės statuso VIES, naudokite šią užklausą:

=VIESAPI.VIES.DATA("PL7171642051";"$(Valid)")

Jei grąžinamas statusas yra Taip, tai reiškia, kad įmonė turi galiojantį ES PVM mokėtojo kodą.

Žymos pasiekiamos VIESAPI.VIES.DATA funkcija, kurią galima naudoti kaip FORMAT parametras:

  • $(UID) – Unikalus identifikatorius, sugeneruotas viesApi.eu paslaugos
  • $(CountryCode) - Šalies kodas
  • $(VATNumber) – Europos PVM mokėtojo kodas
  • $(Valid) – Galiojantis statusas ES PVM mokėtojo kodas (Yes/No)
  • $(TraderName) – Rangovo/tiekėjo pavadinimas
  • $(TraderCompanyType) – Verslo tipas
  • $(TraderAddress) – Sandorio šalies adresas
  • $(ID) – Unikalus identifikatorius, sugeneruotas VIES sistemos
  • $(Date) – Data, kada buvo sugeneruotas atsakymas
  • $(Source) – Duomenų šaltinis

Numatytasis formatas: "$(TraderName), $(TraderAddress)"

Jei styga "JSON" pateikiamas kaip FORMAT parametrą, funkcija grąžins visą rezultatą JSON eilutės forma, kurią galima laisvai analizuoti ir toliau apdoroti:

=VIESAPI.VIES.DATA("PL7171642051";"JSON")

Vartotojo paskyros būsenos patikrinimas (nemokamas)

VIESAPI.STATUS.ACCOUNT() – Funkcija grąžina pagrindinę informaciją apie šiuo metu vartotojo naudojamą planą. Parametrai turėtų būti:

  • (neprivaloma) FORMAT grąžintų duomenų (žr.: Žymos, kurios gali būti naudojamos kaip FORMAT parametras)

=VIESAPI.STATUS.ACCOUNT()

Dėmesio! Funkcijos iškvietimas nepadidina pateiktų užklausų skaičiaus.

Galimos žymos VIESAPI.STATUS.ACCOUNT funkcija gali būti naudojama kaip FORMAT parametras:

  • $(BillingPlanName) – Esamo tarifų plano pavadinimas
  • $(SubscriptionPrice) – Grynoji mėnesio abonemento kaina
  • $(ItemPrice) – Vienos užklausos grynoji kaina, nepatenka į standartinį planą
  • $(ItemPriceStatus) – Grynoji vienos užklausos kaina – VIES / Subjekto verslo statusas individualiame plane
  • $(Limit) – Maksimalus užklausų skaičius plane
  • $(RequestDelay) – Minimalus laiko intervalas tarp užklausų
  • $(DomainLimit) – Maksimalus domenų skaičius (API raktai)
  • $(OverPlanAllowed) – Galimybė viršyti maksimalų užklausų skaičių plane
  • $(ExcelAddIn) – Prieiga naudojant MS Excel priedą
  • $(Stats) – Prieiga prie atliktų užklausų statistikos
  • $(NIPMonitor) – Prieiga prie VIES būsenos stebėjimo
  • $(SearchByNIP) – Paieška pagal ES PVM mokėtojo kodą
  • $(FuncGetVIESData) – Prieiga prie funkcijų, kurios tikrina objekto būseną VIES sistemoje
  • $(VIESStatusCount) – Užklausų dėl subjekto statuso VIES sistemoje skaičius
  • $(TotalCount) – Bendras einamąjį mėnesį įvykdytų užklausų skaičius

Numatytasis FORMATAS: "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)"

Jei styga "JSON" pateikiamas kaip FORMAT parametrą, funkcija grąžins visą rezultatą JSON eilutės forma, kurią galima laisvai analizuoti ir toliau apdoroti.

Kitos naudingos funkcijos (nemokamai)

VIESAPI.ACCOUNT.STATUS.TOTAL() – Funkcija pateikia informaciją apie bendrą užklausų, pateiktų einamąjį atsiskaitymo mėnesį tam tikrai paskyrai, skaičių (visi API raktai). Grąžina lygiai tą patį skaičių kaip $(TotalCount) žyma VIESAPI.STATUS.ACCOUNT() funkcija.

VIESAPI.ACCOUNT.STATUS.LIMIT() – Funkcija grąžina informaciją apie maksimalų užklausų skaičių, galimą vartotojo pasirinktame plane. Grąžina lygiai tą patį skaičių kaip $(Limit) pažymėti VIES.STATUS.ACCOUNT() funkcija

VIESAPI.EUVAT.NORM() – Ši funkcija taiso ir formatuoja ES PVM mokėtojo numerį (pašalina tarpus ir brūkšnelius ir pan.) neprisijungus ir negauna jokių duomenų iš VIES:

=VIESAPI.EUVAT.NORM("PL 717-164-20-51")

VIESAPI.EUVAT.VALID() – Funkcija neprisijungus tikrina tik ES PVM mokėtojo numerio teisingumą (sintaksę, kontrolinę sumą) ir negauna jokių duomenų iš VIES sistemos. Grąžina TRUE jei numeris galioja arba FALSE jei jis negalioja:

=VIESAPI.EUVAT.VALID("PL7171642051")

VIESAPI.CONNECTION.STATE() – Funkcija grąžina esamą priedo konfigūracijos būseną.

Jei funkcija grąžina šią reikšmę, tai, be kita ko, reiškia, kad ID ir API key nebuvo išsaugoti:

ERROR: Connection requires configuration

Išsaugojus API ID ir key, funkcija turėtų grąžinti šį pranešimą:

SUCCESS: Production