„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ą.
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 Office
Add-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:
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.
Teisingas priedo įkėlimas parodytas paveikslėlyje žemiau [1].
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:
- Nuo
File
Meniu, pasirinkiteOptions
- Pažymėkite
Formulas
skirtuką - Skiltyje Skaičiavimo parinktys pasirinkite nustatymą:
Manual
ir panaikinkite žymėjimą papildoma parinktis:Recalculate the workbook before saving
. - 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
Atnaujinkite papildinį į naujausią versiją
Dėmesio!Toliau nurodyta „Excel“ priedo atnaujinimo procedūra tinkamai veikia „MS Excel 2019“, 2021 ir „Excel 365“ versijose, kur priedą galima įdiegti iš „Microsoft Store“.
Dėmesio! Įdiegę naujausią versiją, turite iš naujo sukonfigūruoti priedą, ty įvesti ir išsaugoti ID bei raktą.
Norėdami įdiegti naujausią „Excel“ papildinio versiją, atlikite šiuos veiksmus:
1. Iškviesdami formulę patikrinkite įdiegto priedo versiją =VIESAPI.VERSION()
. Naujausia priedo versija yra 1.2.8
2. Išvalykite MS Excel talpyklą pagal procedūrą, aprašytą oficialiame dokumentacijos puslapyje: https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache
3. Atlikę visus veiksmus nuo 2 punkto, iš naujo paleiskite MS Excel programą.
4. Paleidus iš naujo, MS Excel programa atsisiųs naujausią priedo versiją iš Microsoft Store.
5. Sukonfigūruokite priedą įvesdami ID ir raktą, atsisiųstą prisijungę prie paskyros mūsų Interneto svetainė – skirtukas „API raktai“.
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 kaipFORMAT
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 kaipFORMAT
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