Sodros EDAS

EDAS (Elektroninė draudėjų aptarnavimo sistema) — Valstybinio socialinio draudimo fondo valdybos portalas, per kurį darbdaviai pateikia įmokų deklaracijas (SAM) ir pranešimus apie apdraustųjų statusą (1-SD, 2-SD ir kt.). JARS Apskaita integruota su EDAS per oficialią SOAP DataService sąsają — sugeneruotos deklaracijos įkeliamos tiesiai į vartotojo EDAS ruošinių aplanką, kur jį tereikia pasirašyti.

Architektūra

JARS UI → JARS API serveris → Sodros EDAS DataService (SOAP) → vartotojo EDAS paskyra
                                                                       ↓
                                                              vartotojas pasirašo
                                                              portale (Smart-ID / m. parašas)

JARS pati pranešimo nepasirašo ir nepateikia — tai vartotojo veiksmas. JARS vaidmuo:

1. Sugeneruoti FFData XML dokumentą (SAM / 1-SD / 2-SD) pagal Sodros schemą.
2. Įkelti jį į EDAS kaip ruošinį (DRF būsena) per SOAP.
3. Atidaryti EDAS pasirašymo URL naujame naršyklės lange.
4. Periodiškai atnaujinti būseną iš Sodros (getDocumentStatus), atspindint pasirašymo / pateikimo / priėmimo eigą.

Toks padalijimas atitinka Sodros saugumo reikalavimą: deklaraciją pasirašyti gali tik įgaliotas fizinis asmuo savo elektroniniu parašu.

Naudojamos SOAP paslaugos

JARS API kviečia šias EDAS DataService operacijas:

Visos užklausos pasirašytos WS-Security UsernameToken — antraštėje siunčiamas EDAS vartotojo vardas ir slaptažodis. Slaptažodis JARS pusėje saugomas šifruotas AES-256-GCM raktu (SODRA_EDAS_KEY aplinkos kintamasis), todėl net DB užvaldžius atakuotojas slaptažodžio neperskaitytų.

Autentifikacija EDAS portale

EDAS naudoja atskirą slaptažodį tinklinei sąsajai, nesutampantį su pagrindiniu portalo slaptažodžiu. Jį susikuria pats vartotojas EDAS portale:

1. Prisijunkite į EDAS savo įprastomis priemonėmis (Smart-ID, m. parašas).
2. Mano duomenys → Nustatymai → „Pateikti pasirašymui per tinklinę sąsają paslaugą".
3. Sugeneruokite slaptažodį (10–14 simbolių, be simbolio & — Sodros apribojimas).
4. Šio slaptažodžio EDAS daugiau neparodys, todėl iškart įveskite jį JARS Nustatymai → Įmonės nustatymai → Sodra → „EDAS slaptažodis".

EDAS vartotojo vardas paprastai sutampa su naudojamu portale prisijungimui (gali būti 7 skaitmenų draudėjo kodas).

Palaikomi pranešimai

Visi pranešimai formuojami pagal ABBYY FFData XML formatą, kurį priima Sodros tinklinė sąsaja:

Pranešimų generavimo darbo eiga aprašyta skyriuje Darbo užmokestis → Sodros deklaracijos.

Dokumento gyvavimo ciklas

Po sėkmingo uploadEdasDraft Sodros pusėje dokumentui priskiriama būsena, kuri keičiasi vartotojui atliekant veiksmus portale:

Būsena atnaujinama rankiniu mygtuku „Atnaujinti būseną" deklaracijų sąraše — JARS atlieka vieną getDocumentStatus užklausą Sodroms ir įrašo gautą būseną kartu su laiko žyme edasLastCheckedAt. Automatinio periodinio atnaujinimo dar nėra — po pasirašymo EDAS portale grįžkite į JARS ir spustelėkite mygtuką, kad pamatytumėte „Priimta" būseną.

Atsarginis kelias: failo eksportas

Jei vartotojas neturi EDAS tinklinės sąsajos slaptažodžio arba pageidauja įkelti deklaraciją per įprastą EDAS portalo formą:

1. „Atsisiųsti" mygtukas grąžina FFData XML failą.
2. Vartotojas pats įkelia jį per EDAS portalo „Pateikti naują dokumentą" skiltį.
3. Po pateikimo per portalą JARS automatiškai būsenos atnaujinti negali — JARS aplankas pasiliks „Sugeneruota" būsenoje, bet realioji deklaracijos būsena pasimato pačiame EDAS portale.

Aplinkos

Sodros EDAS turi tik vieną aplinką — gamybinę (https://draudejai.sodra.lt/...). Skirtingai nuo VMI i.EKA, atskira testavimo aplinka deklaracijų pateikimui neegzistuoja. Bandymams Sodros patys rekomenduoja sukurti deklaracijas su testiniais duomenimis ir prieš pasirašant juos panaikinti iš EDAS ruošinių aplanko.

Klaidų tvarkymas

Jei EDAS grąžina SOAP klaidą (pvz., neteisingi prisijungimo duomenys, neatitinkanti schema, nesančio draudėjo kodas), JARS API parsina <errorDescription> lauką iš atsakymo ir parodo vartotojui aiškų pranešimą. Žali SOAP kūnai saugomi serverio logose diagnostikai.