i.EKA kasos aparato modulis — virtuali fiskalizacija

1. Sistemos apžvalga

JARS Apskaita — tai debesijos apskaitos sistema, skirta Lietuvos smulkiam ir vidutiniam verslui. Sistema veikia naršyklėje (arba kaip darbalaukio programa) ir apima visą apskaitos ciklą: sąskaitų planą, pirkimo ir pardavimo sąskaitas faktūras, žurnalo įrašus, banko išrašų importą, darbo užmokestį, ilgalaikį turtą ir ataskaitų rengimą.

Sistemą kuria UAB Sistemium, ji prieinama adresu app.jars.lt. Naudojama daugianuomotojo architektūra — kiekvienos įmonės duomenys saugomi izoliuotoje duomenų bazėje.

2. Kasos aparato modulis

Kasos aparato modulis užtikrina pilną kasos operacijų valdymą, integruotą su apskaitos sistema:

• Kasos aparatų valdymas — kūrimas, konfigūravimas ir registracija VMI i.EKA sistemoje
• Kasos orderiai — pajamų (pinigų priėmimas) ir išlaidų (pinigų išmokėjimas) orderiai su automatiniu buhalterinių įrašų registravimu
• Pardavimo kvitai — eilutiniai kvitai su PVM skaičiavimu ir fiskalizacija per VMI
• Z ataskaitos — fiskalinės dienos uždarymo ataskaitos, siunčiamos VMI
• Kvitų spausdinimas — 80 mm terminis spausdintuvas (ESC-POS) ir A4 formatas
• Pirkėjo ekranas — VFD 2×20 simbolių ekranas, rodantis esamą prekę, sumą ir grąžą
• Pinigų stalčius — automatinis atidarymas registruojant kvitą ir atliekant pinigų įnešimo/išėmimo operacijas

3. Kasos terminalo sąsaja

Sistema apima atskirą kasos terminalo sąsają, skirtą mažmeninei prekybai, nepriklausomą nuo apskaitos modulio. Terminalas optimizuotas kasos darbui: dideli mygtukai, greitas kvito kūrimas ir realaus laiko periferinių įrenginių integracija.

Terminalo sąsaja prieinama tik darbalaukio programoje ir nepasiekiama per žiniatinklį — taip atitinkamas Lietuvos teisės aktų reikalavimas dėl popierinio kvito spausdinimo.

• Kasos aparato ir fiskalinės dienos pasirinkimas
• Eilutinis kvito pildymas (prekės paieška, kiekis, kaina)
• Mokėjimo priėmimas (grynieji / kortelė / pavedimas) su grąžos skaičiavimu
• Pinigų įnešimo / išėmimo operacijos (nefiskaliniai dokumentai)
• Z ataskaitos pateikimas (fiskalinės dienos uždarymas)

4. Terminio kvito spausdinimas

Kvitai spausdinami standartiniu 80 mm terminiu spausdintuvu (ESC-POS protokolas), jungiamu per USB.

• Popieriaus plotis: 80 mm
• Daugiakalbystė: lietuvių, rusų, anglų kalbos
• Kvito struktūra: įmonės antraštė, pavadinimas, data, prekių eilutės, PVM suvestinė, suma, mokėjimas, fiskalinis blokas
• Automatinis dalinis pjovimas po spausdinimo
• USB įrenginio konfigūracija, bandomasis spausdinimas, ryšio būsenos stebėjimas

Kvito tikrinimo QR kodas

Kiekvienas fiskalizuotas kvitas turi QR kodą, nukreipiantį į VMI tikrinimo portalą (kvitas.vmi.lt). QR kode užkoduoti kasos aparato numeris, kvito parašas ir maišos reikšmė — pirkėjas gali patikrinti kvito autentiškumą internete.

5. Pirkėjo ekranas (VFD)

Sistema palaiko VFD (vakuuminio fluorescencinio ekrano) tipo pirkėjo ekranus, jungiamus per USB. Ekranas realiu laiku rodo sandorio informaciją.

• Ekrano formatas: 2 eilutės × 20 simbolių
• Pilnas lietuviškų simbolių palaikymas, įskaitant visus diakritikus (ą, č, ę, ė, į, š, ų, ū, ž)
• Ekrano būsenos: sveikatos ekranas, einamoji prekė ir kaina, bendra suma, sumokėta suma ir grąža, padėkos žinutė
• USB įrenginio konfigūracija, saugoma kiekvienam aparatui

6. Pinigų stalčius

Sistema palaiko automatinį pinigų stalčiaus atidarymą per USB prijungtą terminį spausdintuvą. Stalčius atsidaro automatiškai registruojant kvitą su grynaisiais pinigais arba atliekant pinigų įnešimo/išėmimo operacijas. Pinigų stalčiaus judesiai (įneštos ir išimtos sumos bei skaičiai) įtraukiami į Z ataskaitas, kaip reikalauja VMI.

7. Virtuali fiskalizacija (VF)

Sistema naudoja virtualios fiskalizacijos (VF) metodą kvitų fiskalizavimui. Skirtingai nuo aparatinių saugos modulių (SM), VF nereikalauja fizinio kriptografinio įrenginio. Vietoj to kiekvienas kvitas pasirašomas VMI i.EKA sistemos serverio pusėje per SOAP žiniatinklio paslaugas.

Kasos aparato tipas: „Kasos aparatas su virtualia fiskalizacija (VF)“ — virtualios fiskalizacijos kasos aparatas, kaip apibrėžta VMI. Kiekvienas kvitas, nefiskalinis dokumentas ir Z ataskaita perduodami VMI realiu laiku, kur gauna skaitmeninį parašą ir maišos reikšmę, sudarydami nepažeidžiamą dokumentų grandinę.

8. VMI i.EKA integracija

Sistema integruojasi su VMI i.EKA žiniatinklio paslaugomis naudodama SOAP protokolą per mTLS (abipusį TLS). Naudojamos šios žiniatinklio paslaugos:

Žiniatinklio paslaugos

9. Sertifikatų hierarchija (PKI)

i.EKA integracija naudoja trijų lygių PKI (viešojo rakto infrastruktūrą), kurią išduoda VMI:

1. Aptarnavimo įmonės identifikavimo sertifikatas — Identifikuoja UAB Sistemium kaip sertifikuotą aptarnavimo įmonę i.EKA API (AI001/AI002). Išduodamas VMI per CSR įkėlimą i.EKA portale.
2. Tarpinis transporto CA sertifikatas — Tarpinė sertifikatų institucija (CA) individualių kasos aparatų transporto sertifikatams pasirašyti. Vienas tarpinis CA gali pasirašyti neribotą skaičių kasos aparatų sertifikatų.
3. Kasos aparato transporto sertifikatas — Individualus kiekvieno kasos aparato sertifikatas, naudojamas mTLS autentifikacijai pateikiant dokumentus VF API (EKA004) ir valdant aparato būseną (EKA003). Generuojamas lokaliai, pasirašomas tarpinio CA ir registruojamas VMI per AI002.

10. Kasos aparato registracijos procesas

Naujo kasos aparato registracija VMI apima šiuos žingsnius:

1. Sugeneruoti kasos aparato transporto sertifikatą (RSA 2048 bitų raktų pora, pasirašyta tarpinio CA)
2. Registruoti kasos aparatą VMI per AI002 RegisterCashRegister (įmonės kodas, modelis, adresas, serijinis numeris)
3. Registruoti transporto sertifikatą per AI002 RegisterTransportModuleCertificate
4. Aktyvuoti kasos aparatą per EKA003 ActivateCashRegisterWithVF
5. Pateikti pirmąją Z ataskaitą per EKA004 registracijai užbaigti

Sistema pateikia žingsnis po žingsnio registracijos vedlį, kuris automatizuoja šį procesą. Vartotojas įveda įmonės duomenis ir pasirenka verslo adresą — sistema automatiškai sugeneruoja sertifikatą, registruoja VMI ir aktyvuoja aparatą.

11. Palaikomos fiskalinės operacijos

Visos fiskalinės operacijos perduodamos VMI realiu laiku per EKA004 VF API:

Pardavimo kvitas

Fiskalinis kvitas su prekių/paslaugų eilutėmis, PVM skaičiavimu pagal tarifą, mokėjimo būdu (grynieji, kortelė, pavedimas) ir bendromis sumomis. Kiekvienas kvitas gauna unikalų dokumento numerį, maišos reikšmę ir VMI skaitmeninį parašą. Palaikomi PVM tarifai: 21 %, 9 %, 5 %, 0 %.

Prekių grąžinimas

Nefiskalinis grąžinimo dokumentas, nurodantis originalų kvitą (pagal kasos aparato registracijos numerį ir dokumento numerį). Registruoja grąžinimo sumą ir mokėjimo būdą.

Kvito anuliavimas

Nefiskalinis anuliavimo dokumentas, kuris panaikina anksčiau išduotą kvitą. Registruoja anuliuotą sumą.

Nefiskalinės kasos operacijos

Pinigų įnešimo ir išėmimo operacijos (pvz., pradinis likutis, pinigų inkasavimas). Registruoja operacijos kryptį (įnešimas/išėmimas), sumą ir kasos likutį prieš ir po operacijos.

Z ataskaita (fiskalinės dienos uždarymas)

Fiskalinės dienos uždarymo ataskaita, apibendrinanti visas dienos operacijas: bendras pardavimas, PVM pagal tarifus, kvitų skaičius, pinigų judėjimas, anuliavimas, grąžinimai ir kaupiamieji Grand Total (GT) skaitikliai. Fiskalinės dienos uždarymas yra privalomas prieš atidarant naują.

12. Grynųjų pinigų mokėjimų apvalinimas

Vadovaujantis Lietuvos teisės aktų reikalavimais, grynųjų pinigų mokėjimų sumos apvalinamos iki artimiausių 5 centų. Apvalinimo skirtumas nurodomas kvite atskiroje eilutėje ir įtraukiamas į VMI siunčiamą fiskalinį dokumentą. Mokėjimai kortele ir pavedimu neapvalinami.

13. Dokumentų grandinės vientisumas

Kiekvienas VMI pateiktas dokumentas gauna SHA-256 maišos reikšmę ir skaitmeninį parašą. Kiekvienas vėlesnis dokumentas nurodo ankstesnio dokumento maišos reikšmę, sudarydamas kriptografinę grandinę, užtikrinančią duomenų vientisumą ir apsaugą nuo klastojimo.

Palaikomos trys nepriklausomos maišos grandinės: fiskaliniai kvitai, nefiskaliniai dokumentai ir Z ataskaitos. Pirmasis kiekvienos grandinės dokumentas naudoja savireferencinę maišos reikšmę. Grand Total (GT) skaitikliai yra kaupiamieji per visas fiskalines dienas.

14. Integracija su testine aplinka

Sistema yra pilnai integruota su VMI i.EKA demonstracine (testine) aplinka. Visos žiniatinklio paslaugos buvo ištestuotos ir patikrintos demonstracinėje aplinkoje, įskaitant pilną gyvavimo ciklą: sertifikatų valdymą, kasos aparatų registraciją, kvitų fiskalizaciją, grąžinimus, anuliavimus, nefiskalines operacijas ir Z ataskaitas.

Demonstracinės aplinkos adresai:

15. Techninės specifikacijos

• i.EKA integracijos protokolas: SOAP 1.1 per HTTPS su abipusiu TLS (mTLS)
• Fiskalinių dokumentų schema: i.EKA VF 1.2 (XSD, išduota VMI)
• i.EKA autentifikacija: X.509 kliento sertifikatai, 3 lygių PKI hierarchija, išduota VMI
• Sertifikatai: šifruota saugykla serverio pusėje, izoliuota kiekvienam kasos aparatui
• Platforma: debesijos SaaS paslauga, prieinama adresu app.jars.lt
• Klientai: žiniatinklio naršyklė + darbalaukio programa (Windows, macOS)
• Kvitų spausdintuvas: 80 mm terminis, ESC-POS protokolas, USB
• Pirkėjo ekranas: VFD tipas, 2×20 simbolių, USB

16. Kūrėjo informacija

Kasos aparato modulį ir VMI i.EKA integraciją kuria ir prižiūri:

• Kūrėjas: UAB Sistemium
• Programinė įranga: JARS Apskaita v1.0
• Kontaktai: info@jars.lt