EDS API servisa apraksts

Elektroniskās deklarēšanas sistēmas API serviss

Kas ir API?

API (Application Programming Interface) jeb lietojumprogrammu saskarne ir noteikumu vai protokolu kopums, kas ļauj programmatūras lietojumprogrammām sazināties savā starpā, lai apmainītos ar datiem, līdzekļiem un funkcionalitāti.

Valsts ieņēmumu dienesta (VID) Elektroniskās deklarēšanas sistēmas (EDS) servisu saskarne (API) izveidota datu apmaiņai starp nodokļu maksātāja informācijas sistēmu un VID informācijas sistēmām.

Pašreiz EDS lietotājiem pieejami četri API servisi:

• Pamatfunkcionalitāte – izmanto EDS dokumentu (deklarācijas, pārskati, ziņojumi) datu iesniegšanai VID un VID uzkrāto pārskatu datu saņemšanai tiešsaistē. Serviss realizēts OpenApi 3.0 standartā, saglabājot esošo EDS dokumentu un pārskatu datu struktūru un saturu. Darbības API saskarnē tiek veiktas EDS lietotāja vārdā. Lai varētu izmantot šo saskarni, lietotājam ir jādod piekrišana kā arī jāuzģenerē API atslēga, kura jāizmanto autentifikācijas pieprasījumos kopā ar lietotāja vārdu un paroli. Ir iespējams ierobežot piekļuvi Servisu saskarnei tikai no noteiktām IP adresēm.
• Taksometri – izmanto informācijas par veiktajiem pasažieru pārvadājumiem nosūtīšanai Valsts ieņēmumu dienestam tiešsaistē. Serviss ir pieejams izmantojot HTTPS/SSL. EDS API sistēmas lietotāju autentifikācijai un autorizācijai izmanto shēmu, kas atbilst OAuth 2.0 protokola “Client Credentials Grant” scenārijam. Darbības šajā API sadaļā tiek veiktas nodokļu maksātāja vārdā. Taksometru API saskarnes lietošanai, lietotājam jāuzģenerē API lietotāja identifikators (client_id) un jāpiereģistrē parole (client_secret), kurus izmantos autentifikācijas pieprasījumos. Pasažieru komercpārvadājumu reģistrācija JSON formāta apraksts publicēts VID tīmekļvietnē EDS elektronisko dokumentu formātu apraksti.
• CESOP[1] API – izmanto Maksājumu pakalpojumu sniedzēja ziņojumu par pārrobežu maksājumiem un to saņēmējiem (CESOP) iesniegšanai. Paredzēts datņu līdz 1GB augšupielādei ES CESOP XML apstiprinātajā formātā. Datus ir iespējams iesniegt JSON formātā.
• E-Rēķini (E-Invoice API V2) – izmanto e-rēķinu iesniegšanai. Pieļaujamais viena e-rēķina izmērs: 20.00MB:

API servisa izmantošanai lietotājam EDS sadaļā IESTATĪJUMI  /  API atslēgas jāizveido API sertifikāts vai API atslēga:

• laukā Tips izvēlas: API sertifikāts vai API atslēga;
• laukā Tiesību apgabals atzīmē vajadzīgo:
  • Dokumentu API (izmanto arī e-rēķiniem);
  • Taksometru API;
  • CESOP API.
• API atslēgai izvēlas derīguma termiņu. Maksimālais 90 dienas;
• IP adresi var nenoradīt;
• nospiež pogu Izveidot.

Izveidoto API sertifikāta datni lejupielādē savā datorā vai viedierīcē.

Izveidoto API atslēgu iezīmē un iekopē savā datorā vai viedierīcē. API atslēgas lejupielāde nav paredzēta:

Kas nepieciešams EDS API servisu lietošanai?

EDS API servisa lietošanai konfigurācijas jāveic gan EDS (jāpiešķir tiesības, jāizveido API atslēga vai sertifikāts), gan klientu sistēmā. Tādējādi nodokļu maksātāja grāmatvedības vai uzņēmuma vadības sistēmas uzturētājam jāuzstāda saskarni savā sistēmā ar OpenApi 3.0 un Swagger komponentēm. 

Prasības API servisa Pamatfunkcionalitāte lietošanai

• Nodokļu maksātāja lietotājam, kas izmantos API servisu Pamatfunkcionalitāte, EDS sadaļā Servisu saskarne API jāatzīmē atļauja izmantot EDS lietotāja kontu, pārstāvot attiecīgo nodokļu maksātāju, un jāizveido API atslēga:
  

• EDS dokumentu swagger.json apraksti ir pieejami EDS sadaļā IESTATĪJUMI / API ATSLĒGU PĀRVALDĪBA:

SVARĪGI! Lietojot EDS API pamatfunkcionalitāti, saglabājas visi tie paši nosacījumi un prasības attiecībā uz nodokļu maksātāju pārstāvniecību. Lai iesniegtu EDS dokumentu, lietotājam jābūt uzņēmuma amatpersonai vai jābūt VID reģistrētai pilnvarai ar derīgu termiņu.

Prasības API servisa Taksometri lietošanai

• Takšu nozarei, izmantojot API servisu Taksometri, jāizveido EDS API klientu identifikatori autotransporta līdzekļu vadītājiem, kuri pēc katra brauciena sūtīs taksometra skaitītāja datus VID tiešsaistē. Kā izveidot EDS API klienta identifikatoru, skatīt zemāk
  

SVARĪGI! Lai lietotājam būtu piekļuve pie API servisa Taksometri, jāatzīmē tiesības sadaļā Lietotāji un to tiesības / lietotāja vārds un uzvārds / Elektroniskās deklarēšanas sistēmā /  Lietotāja tiesības sistēmā jāatzīmē tiesības veikt API servisa “Taksometri” konfigurāciju:

Prasības CESOP API servisa lietošanai

• CESOP dokumentu iesniegšanai nodokļu maksātāja pilnvarotai personai EDS jābūt tiesībām šo dokumentu iesniegt. Lai piešķirtu tiesības iesniegt CESOP dokumentu, nodokļu maksātāja EDS tiesību pārvaldniekam EDS sadaļā IESTATĪJUMI >> Lietotāji un to tiesības >> lietotāja, kas nodokļu maksātāja vārdā sagatavos un iesniegs CESOP dokumentu, vārds un uzvārds >> Elektroniskās deklarēšanas sistēma >> nospiež uz izvēlnes Rediģēt tiesības veikt darbības ar dokumentiem >> atzīmē zemāk attēlotās tiesības CESOP dokumentiem:
  

SVARĪGI! Nodokļu maksātāju pārstāvošiem EDS lietotājiem, jābūt VID reģistrētai pilnvarai iesniegt EDS dokumentus.

Pilnvaras paraugs pieejams VID tīmekļvietnē Iesniegumi un pilnvaras.

EDS API izmantošanas priekšrocības

EDS API servisa izmantošana paātrina un vienkāršo atskaišu iesniegšanu VID EDS – nav jāveic atskaišu saglabāšana datorā, pēc tam šīs atskaites imports VID EDS – ar vienu klikšķi atskaite tiek importēta uz VID EDS. Attīstot pakalpojumu, paredzēts, ka atskaites iesniegšanu varēs veikt bez pieslēgšanās VID EDS, bet no grāmatvedības programmas.

Lai uzzinātu vairāk par nodokļu maksātāja iespējam izmantot EDS API, VID aicina vērsieties pie savas grāmatvedības sistēmas vai uzņēmuma vadības sistēmas programmatūras izstrādātāja.

EDS dokumentu sarakstu, kuriem ir izveidots API serviss, var aplūkot, atverot EDS sadaļu IESTATĪJUMI / Pamatfunkcionalitāte / Servisu saskarne API /Atvērt servisu saskarni