Excel pievienojumprogramma ļauj ātri un automātiski pārbaudīt entītijas (līgumslēdzējus), izmantojot Excel izklājlapu, ņemot vērā to pašreizējo statusu VIES sistēma.
Šajā nodaļā ir sniegti norādījumi par to, kā integrēt lietojumprogrammu Microsoft Excel ar sistēmu nip24.pl. Nodrošinātā pievienojumprogramma ir veiksmīgi pārbaudīta šādās MS Excel versijās: 2007, 2010, 2013, 2016, 2019 (operētājsistēmās Windows un MacOS) un 2021 (operētājsistēmās Windows un MacOS) un tīmekļa versijā. no Excel365.
Programmai Excel 2007, 2010, 2013, 2016 un 2019 paredzētā papildinājuma jaunākā versija vienmēr ir pieejama lejupielādei no Lejupielādes lapa. Papildinājumu var instalēt gan Excel 32 bitu, gan 64 bitu versijās. Uzmanību! Izvēlieties versiju (32 vai 64 bitu). atbilst Excel versijai, nevis operētājsistēma.
Lai lejupielādētu un instalētu papildinājumu operētājsistēmai MacOS un Excel 2021 operētājsistēmai Windows un Excel365, lūdzu, apmeklējiet oficiālo Microsoft veikalu: https://appsource.microsoft.com.
Pilnu Excel pievienojumprogrammas funkcionalitāti var pārbaudīt – bez nepieciešamības izveidot kontu – izmantojot paredzēto Testa API. Lapā ir arī aprakstīts, kā konfigurēt Excel pievienojumprogrammu lietošanai API, kas paredzēta testēšanai.
Lai izmantotu pievienojumprogrammu ražošanas API, ir nepieciešams izveidot kontu vietnē viesapi.eu, iegādāties vismaz Biznesa plānu un ģenerēt atslēgu un tās identifikatoru. Reģistrācijas un konta izveides process, kā arī atslēgu ģenerēšana ir aprakstīta vietnē Dokumentācija tīmekļa vietne.
Instalēšana un konfigurēšana programmām MS Excel 2021 un Excel 365 no Microsoft Store (AppSource)
Uzstādīšana
Pēc ieiešanas Microsoft oficiālā veikala vietnē https://appsource.microsoft.com, noklikšķiniet uz Get it now pogu.
Tiks parādīts pieteikšanās logs, kurā jāievada e-pasta adrese, kurai esat izveidojis Microsoft kontu (privāto vai korporatīvo). Ja jums nav šāda konta, varat to izveidot un turpināt instalēšanas procesu vai apturēt instalēšanu un izmantot iespēju instalēt papildinājumu kādā no iepriekš aprakstītajiem veidiem.
Lai lejupielādētu un instalētu pievienojumprogrammu no Excel 2021 vai Excel 365 (tīmeklī), dodieties uz Insert [1] cilnē atrodiet sadaļu Papildinājumi un noklikšķiniet uz OfficeAdd-ins [2] poga. Pēc tam atvērtajā logā ievadiet vārdu "viesapi ′ [3] meklēšanas laukā un nospiediet palielināmā stikla ikonu. Papildinājums ar nosaukumu “VIES API - EU VAT Validation”, kas jāinstalē, noklikšķinot uz Add poga [4]. Visas iepriekš minētās darbības ir parādītas zemāk esošajā ekrānuzņēmumā:
Pēc noklikšķināšanas uz Add pogu, jāparādās ekrānam, kurā varat izlasīt licences noteikumus un privātuma aizsardzības noteikumus.
Lai sāktu pievienojumprogrammas instalēšanu, nospiediet Continue pogu.
Konfigurācija
Pēc spraudņa pareizas instalēšanas jums vajadzētu redzēt ekrānu, kas ir līdzīgs zemāk redzamajam. Iekš Home menu [1], atrodiet ikonu, kas apzīmē VIES API Panel [2] un noklikšķiniet uz tā, lai parādītu sānu paneli. Tūlīt pēc instalēšanas pievienojumprogramma tiek konfigurēta darbam testa vidē — sīkāka informācija par Testa API lapa. Lai izmantotu papildinājumu testa režīmā, nav jāizveido konts vietnē viesapi.eu tīmekļa vietne.
Lai pārslēgtu papildinājumu uz ražošanas vidi, noklikšķiniet uz ID and key cilni [3] un ievadiet Key un atslēga ID, kuru varat atrast pēc pieteikšanās savā kontā vietnē viesapi.eu sadaļā “API Keyscilne. Pēc abu vērtību ievadīšanas nospiediet Save pogu.
Ja jums vēl nav konta mūsu vietnē, noklikšķiniet uz saites vietnē viesapi.eu [4] un veiciet reģistrācijas procesu, kas ir detalizēti aprakstīts vietnē Dokumentācija lappuse.
Instalēšana un konfigurēšana programmai Excel: 2007, 2010, 2013, 2016 un 2019
Uzstādīšana
Iegūstiet jaunāko pievienojumprogrammas versiju programmai Excel 2007, 2010, 2013, 2016 un 2019 no Lejupielādes lapa. Palaidiet MS Excel un dodieties uz File> Options, pēc tam atlasiet Add-ins [1] no izvēlnes.
Iestatījumu apakšā atlasiet Excel Add-ins [2] un noklikšķiniet uz Go [3] poga.
Pieredzējuši lietotāji var pievienot papildinājumu no Developer cilni [1], pēc tam noklikšķiniet Excel Add-ins [2] un noklikšķiniet uz Browse [3] poga:
Iekš Add-ins logā noklikšķiniet uz Browse pogu, dodieties uz direktoriju, kurā viesapi-ms-excel-addin-version-number.zip fails tika izpakots un atlasiet:
viesapiExcel.xll– Excel 32 bitu versijai,viesapiExcel64.xll– Excel 64 bitu versijai.
Pareiza pievienojumprogrammas ielāde ir parādīta attēlā zemāk [1].
Pietiek noklikšķināt uz OK pogu [2], lai programmā Excel būtu pieejamas pievienojumprogrammā ieviestās funkcijas.
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 lappuse). Lai varētu izsaukt funkcijas ražošanas vidē, ir nepieciešams vienreiz konfigurēt piekļuvi vietnei viesapi.eu. Lai to izdarītu, dodieties uz jebkuru Excel izklājlapu un veiciet 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ā.
Pēc noklusējuma katrs Excel dokuments ir iestatīts tā, lai automātiski aprēķinātu izklājlapu. Šīs opcijas iestatīšana nozīmē, ka visas formulas tiek izsauktas, kad tiek veiktas izmaiņas, kas ietekmē formulu. Piemērs tam ir rindas dzēšana darblapā.
Lai izvairītos no visu dotajā lapā definēto funkciju automātiskas izsaukšanas, kas ir saistīta ar vaicājumu automātisku nosūtīšanu uz veisapi.eu vietnes API, mainiet darbgrāmatas aprēķinu opciju uz Manual:
- No
Fileizvēlne, izvēlietiesOptions - Iezīmējiet
Formulascilne - Sadaļā Aprēķinu opcijas atlasiet iestatījumu:
Manualun noņemiet atzīmi papildu opcija:Recalculate the workbook before saving. - Ir nepieciešams saglabāt lapā veiktās izmaiņas.
Ja Excel izklājlapa ir konfigurēta šādi, lai piespiestu atsvaidzināt visas definētās formulas, nospiediet taustiņu kombināciju:
CTRL + ALT + SHIFT + F9
Lietošana
Noskatieties, kā automātiski un masveidā pārbaudīt uzņēmumu ES PVN statusu VIES sistēmā, izmantojot mūsu Excel pievienojumprogrammu:
Pirms pievienojumprogrammas izmantošanas jums jāiepazīstas ar tā darbības specifiku:
- Visi funkciju izsaukumi tiek izpildīti asinhronā režīmā, kas neizraisa Excel lietojumprogrammas iesaldēšanas (bez 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 nosūtīti vaicājumi vietnei viesApi.eu (tikai Excel noklusējuma iestatījumu gadījumā). Noklusēto 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 programmai Excel ir problēmas ar lielu skaitu asinhrono zvanu.
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)
FORMATno atgrieztajiem datiem (skatiet: Tagi, kurus var izmantot kāFORMATparametrs).
=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ē pakalpojums viesApi.eu$(CountryCode)- Valsts kods$(VATNumber)– Eiropas PVN maksātāja numurs$(Valid)– Derīgs statusa ES PVN numurs (Yes/No)
$(TraderName)– Līgumslēdzēja/piegādātāja nosaukums$(TraderCompanyType)- Uzņēmējdarbības veids$(TraderAddress)– Darījuma partnera adrese$(ID)– Unikāls identifikators, ko ģenerē VIES sistēma$(Date)– datums, kad tika ģenerēta atbilde$(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")
Lietotāja konta statusa pārbaude (bez maksas)
VIESAPI.STATUS.ACCOUNT() – Funkcija atgriež pamatinformāciju par lietotāja pašlaik izmantoto plānu. Parametriem jābūt:
- (neobligāti)
FORMATno atgrieztajiem datiem (skatiet: Tagi, kurus var izmantot kāFORMATparametrs)
=VIESAPI.STATUS.ACCOUNT()
Uzmanību! Funkcijas izsaukšana nepalielina veikto vaicājumu skaitu.
Tagi, kas pieejami vietnē VIESAPI.STATUS.ACCOUNT funkciju var izmantot kā FORMAT parametrs:
$(BillingPlanName)– Pašreizējā tarifu plāna nosaukums$(SubscriptionPrice)– Mēneša abonementa neto cena$(ItemPrice)– Viena pieprasījuma neto izmaksas ārpus plāna standarta plānā$(ItemPriceStatus)– Neto izmaksas par vienu pieprasījumu – VIES / Uzņēmuma uzņēmējdarbības statuss individuālajā plānā$(Limit)– Maksimālais vaicājumu skaits plānā$(RequestDelay)– Minimālais laika intervāls starp pieprasījumiem$(DomainLimit)- Maksimālais domēnu skaits (API atslēgas)$(OverPlanAllowed)– Iespēja pārsniegt maksimālo vaicājumu skaitu plānā$(ExcelAddIn)– Piekļuve, izmantojot MS Excel pievienojumprogrammu$(Stats)- Piekļuve veikto vaicājumu statistikai$(NIPMonitor)– Piekļuve VIES statusa uzraudzībai$(SearchByNIP)– Meklēt pēc ES PVN maksātāja identifikācijas numura$(FuncGetVIESData)– Piekļuve funkcijām, kas pārbauda entītijas statusu VIES sistēmā$(VIESStatusCount)– veikto pieprasījumu skaits par entītijas statusu VIES sistēmā$(TotalCount)– Kopējais izpildīto vaicājumu skaits pašreizējā mēnesī
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.
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