VMI i.EKA
Kvitų ir Z-ataskaitų perdavimas į VMI.
i.EKA (interaktyvi elektroninių kasos aparatų sistema) — Valstybinės mokesčių inspekcijos paslauga, į kurią realiu laiku turi būti pateikiami visi pardavimai per fiskalizuotus kasos aparatus. JARS Apskaita integruota su i.EKA per oficialiąją SOAP API.
Architektūra
POS terminalas → JARS API serveris → VMI i.EKA SOAP paslauga
Visos SOAP užklausos atliekamos iš JARS serverio pusės — terminalas niekada nesijungia tiesiai į VMI. Priežastys:
- VMI sertifikatas (privatusis raktas) saugomas tik serveryje — terminale jo nėra.
- Centralizuotas pasirašymas ir audito fiksavimas.
Naudojamos SOAP paslaugos
JARS Apskaita kviečia šias VMI paslaugas:
| Paslauga | Paskirtis |
|---|---|
registerCashRegister | Naujo kasos aparato registracija (žr. Kasos aparato konfigūravimas → Registracija VMI). |
registerTransportModuleCertificate | Programinės kasos transport modulio sertifikato registracija. |
getBusinessAddresses | Įmonės verslo adresų sąrašo gavimas (registracijos vedlyje). |
getServiceOrganizationData | Aptarnaujančios organizacijos modelių ir sertifikuotų darbuotojų sąrašas. |
getCashRegisterWithVFState | Užregistruoto aparato būsenos užklausa. |
submitReceipt | Pardavimo kvito pateikimas. |
submitZReport | Z-ataskaitos pateikimas. |
submitNonFiscalReturn | Grąžinimo dokumento pateikimas. |
submitNonFiscalCancelation | Visiško kvito anuliavimo pateikimas. |
submitNonFiscalCollection | Nefiskalinio pajamų dokumento pateikimas. |
submitNonFiscalTaxChange | Nefiskalinio mokesčių pakeitimo dokumento pateikimas. |
getDocumentInfo | Konkretaus dokumento informacijos užklausa. |
testConnection | Ryšio su VMI patikrinimas. |
Visos užklausos pasirašytos įmonės programinės kasos aparato sertifikatu (PEM X.509). Schema atitinka i.EKA_VF_1.2.xsd.
Aplinkos
Du atskiri SOAP endpoint'ai:
- Demo aplinka —
https://demo.vmi.lt/.../iEKA.wsdl(bandymams, mokymams). - Production aplinka —
https://www.vmi.lt/.../iEKA.wsdl(realiems pardavimams).
Aplinka pasirenkama kiekvienam kasos aparatui atskirai.
Klaidų tvarkymas
Jei VMI grąžina klaidą, JARS API klasifikuoja ją pagal i.EKA atsakymo kodą ir pateikia kasininkui ar administratoriui lokalizuotą pranešimą. Klaidos detalės fiksuojamos serverio logose.