MK noteikumu Nr. 662 14. pielikuma datu iesniegšana Valsts kancelejas datu noliktavā

[#1]

No 615. versijas Horizon ir pieejama tiešsaistes integrācija ar Valsts kanceleju. Risinājums izmanto VK API servisu un nodrošina iespēju tiešā veidā no Horizon sagatavot datus uz Valsts kanceleju, kā arī, veiksmīgas pārbaudes gadījumā, datus aizsūtīt uz Valsts kanceleju uzreiz no Horizon sistēmas.

⚠️Konfigurācijai un arī tālākai risinājuma lietošanai ir nepieciešams pieprasīt Valsts kancelejai API adresi, API atslēgu, lietotājvārdu un paroli.

Lai iegūtu pieslēguma informāciju, jāvēršas pie Valsts kancelejas Valsts pārvaldes politikas departamenta Cilvēkresursu politikas nodaļas konsultanta Jāņa Beltiņa: janis.beltins@mk.gov.lv, +371 67082986

Konfigurācija

Izvēlne: Sistēma → Datu apmaiņa → Valsts kancelejas API→ Pieslēgumi

Jāpievieno jauns pieslēgums ar šādu informāciju:

Kods - norāda vēlamo, piemēram, “VKAPI”

Nosaukums - norāda vēlamo, piemēram, “VKAPI pieslēgums”

API adrese - noklusēti aizpildīta ar saskarnes adresi https://dn.mk.gov.lv/api/v1

API atslēga -  jāpieprasa Valsts kancelejai 

Lietotāja vārds – Valsts kancelejas lietotāja vārds

Iestāde – Horizon vairāku nodokļu maksātāju režīmā konfigurācija veicama katrai no iestādēm, kuras ģenerēs un iesniegs datus par saviem darbiniekiem.  

Nospiežot pogu “Pārbaudīt”, atveras logs, kurā jāievada Valsts kancelejas lietotāja parole. 

Paziņojums “Pārbaude veiksmīga” apstiprina, ka pieslēguma konfigurācija ir izdevusies.

Datu sagatavošana un datu nosūtīšana

Izvēlne: Atskaites → Personāla uzskaite → Personāla datu eksports

Datu sagatavošana  Horizon tiek sagatavota līdzšinējā kārtībā.  VK API integrācija nodrošina tikai jaunu veidu, kā sagatavotās datnes ievietot Valsts kancelejas datu noliktavā.

Tāpat ir iespējams veikt failu eksportu uz Excel un iesniegt datnes manuāli Valsts kancelejas datu noliktavā.  

Excel eksports

Lai veiktu datņu eksportu uz Excel jāizvēlas vajadzīgā datne un jānospiež poga “Excel eksports”. Eksportēts .xlsx fails ir saglabāts mapē, kura ir norādīta eksporta parametros.

Informācija par sagatavoto failu/ failiem ir pieejama datu eksporta loga labajā pusē.

Progresa josla loga augšā ļauj sekot eksporta gaitai. Ja josla iekrāsota zaļā krāsā - dati ir veiksmīgi eksportēti uz uzvēlēto mapi, ja oranžā krāsā – dati ir eksportēti, bet ar brīdinājumiem vai kļūdām. 

Datu sagatavošana nosūtīšanai tiešsaistē

Pirms veidot un sūtīt datnes uz Valsts kanceleju ir jāveic datu sagatavošana, lai pārliecinātos, ka nepieciešamas datnes tiek uzģenerētas bez kļūdām. Lai sagatavotu datus nosūtīšanai, ir jānospiež poga  ”Datu sagatavošana”.

📌Gadījumā, ja poga “Datu sagatavošana” ir neaktīva, ir jāpārbauda vai ir izveidots pieslēgums un eksporta parametros ir izvēlēta tā iestāde, kurai ir izveidots pieslēgums.

Gadījumā, ja ir izveidoti vairāki pieslēgumi, tad, nospiežot uz “Datu sagatavošana”, ir jāizvēlas savienojums, kuru ir nepieciešams izmantot.

Pēc datu sagatavošanas, .json fails ir pieejams mapē, kura tika izvēlēta, aizpildot eksporta konfigurāciju.

❗Sagatavotos .json failus nevar manuāli samainīt. Mēģinot aizsūtīt datus,  kuri tikuši mainīti manuāli, parādīsies kļūdas paziņojums, un dati netiks nosūtīti.

Informācija par sagatavotajiem failiem ir pieejama loga labajā pusē.

❗ Ja sagatavotajā failā ir kļūdas, informācija par tām tiek izcelta sarkanā krāsā. Dati, kuros ir kļūdas netiks nosūtīti uz Valsts kanceleju.

Datu nosūtīšana

Pēc tam, kad datnes ir sagatavotas nosūtīšanai, paliek aktīva poga “Datu nosūtīšana”.

 Nospiežot pogu “Datu nosūtīšana”, ir jāievada Valsts kancelejas lietotāja parole:

Informācija par nosūtīšanas procesa statusu tiek attēlota personāla datu eksporta loga labajā pusē.

Kļūdas ir iekrāsotas ar sarkanu krāsu. Dati, kuri satur kļūdas, netiek nosūtīti uz Valsts kanceleju.

Ierakstu fails eksportam – ierakstu skaits, kurš bija paredzēts nosūtīšanai uz Valsts kanceleju

Ieraksti, kas eksportēti failā – ierakstu skaits, kurš tika nosūtīts uz Valsts kanceleju

Nosūtītie dati un saņemtās atbildes

Izvēlne: Sistēma → Datu apmaiņa → Valsts kancelejas API  → Datu apmaiņas žurnāls 

Informācija par aizsūtītajiem datiem un saņemtās atbildes ir pieejamas datu apmaiņas žurnālā. 

Lai apskatītu aizsūtītā .json aila saturu, jāizvēlas Darbības  →  Nosūtītie dati.

Lai apskatītu saņemtās atbildes, jāizvēlas  Darbības → Izpildes notikumi.

Papildus lietotājiem ir iespēja apskatīties no API iesniegtos datus arī Valsts kancelejas datu noliktavā. Pēc datu iesniegšanas un pieslēgšanās datu noliktavai, lietotājam jāatver kāda no datnēm, jāizvēlas datu iesniegšanas periods un iestāde, tad jāspiež poga “Ielādēt datus”, kas atrodas pie datnes nosaukuma galvenajā logā. Pēc datu ielādes tiks ielasīti dati, kas tika pievienoti ar API saskarnes palīdzību.

Instrukcija MK 662. noteikumu 14. pielikuma datu sagatavošanai pieejama šeit.