Šiame straipsnyje aprašomos ypatingos savybės, į kurias būtina atsižvelgti Lietuvos fiskalizacijos kontekste arba kurios kyla iš teisės aktų ir techninių reikalavimų. Šiame straipsnyje vartojamų terminų ir jų reikšmių apžvalgą galima rasti straipsnyje Lietuvos fiskalizacijos terminai.

Turinio apžvalga:

• Priešreikalavimai – ko reikia, kad kasos aparatas veiktų pagal reikalavimus?
• Saugumo modulis – kas tai yra ir kokios specialios funkcijos su juo susijusios?
• Ryšys su iEKA – ką reikia atsižvelgti?
• Specialūs procesai – kokios yra šių procesų ypatybės:
  • Grąžinimai/keitimai
  • Techninis žurnalas
  • Ataskaitų sumos
  • Įmokos ir išmokos
  • Sandorių atšaukimas
  • Specialių prekių pardavimas
• Ataskaitos – kokios ataskaitos turi būti rengiamos ir kokius duomenis jos turi apimti?
• EKJ – kas tai yra ir kaip jį gauti?

Būtinos sąlygos

Kad kasos aparatas galėtų būti pradėtas naudoti Lietuvoje, būtina:

Service company

Tik sertifikuotos service company atstovai gali paleisti kasos aparatus ir prijungti juos prie „iEKA“ paslaugos bei saugumo modulio.

Aptarnavimo įmonę galite nustatyti konfigūracijoje Lietuva. Norint pasirinkti aptarnavimo įmonę (pasiekiama kaip išskleidžiamojo meniu elementas konfigūracijoje), būtina distributoriaus ir aptarnavimo įmonės sutartis. Kai sutartis įrašoma / aktyvuojama „RetailForce“ portale, konfigūracijoje atsiranda įrašas apie aptarnavimo įmonę.

Saugumo modulis

Čia aprašytam saugumo modulio fiskalizacijos modeliui kasos aparatas turi būti įrengtas saugumo moduliu, atitinkančiu galiojančius Lietuvos reikalavimus. Lietuvos taisyklės taip pat leidžia naudoti virtualios fiskalizacijos kasos aparatus, kuriems nereikalingas saugumo modulis (VMI oficialios gairės). Saugumo modulis su service company susijęs tik netiesiogiai. Tačiau perkant saugumo modulį, įsitikinkite, kad jį taip pat palaiko RetailForce system.

Saugumo modulio užduotys apima sandorių duomenų pasirašymą, bendros sumos skaitiklio valdymą bei privačių ir viešųjų raktų bei skaitmeninių sertifikatų saugų saugojimą.

Service company parameter

Kai konfigūracijoje pasirenkama service company ir ji priskiriama subjektui (organizacijai, įmonei, parduotuvei, terminalui), service company darbuotojas gali įvesti service company parametrus (žr. Lietuvos fiskalizacijos sąlygas) kiekvienam terminalui.

Jei kasos aparatas turi saugumo modulį ir įvesti service company parametrai, kasos aparatą (clientą) galima pradėti eksploatuoti.

Saugumo modulis

Duomenys iš fiskalinių operacijų automatiškai pasirašomi „RetailForce“ fiskalizacijos paslaugos pagalba per saugumo modulį.

Saugumo modulis aktyvuojamas automatiškai inicializavimo metu. Šio proceso metu į saugumo modulį taip pat įkeliami reikalingi skaitmeniniai sertifikatai.

Skaitmeniniai sertifikatai

Sertifikatai, naudojami duomenims pasirašyti ir kitiems tikslams, turi būti atnaujinti prieš pasibaigiant jų galiojimo laikui.

Sertifikatams keisti fiskalizacijos paslauga teikia šią funkciją:

• POST /api/v1/management/lithuania/{clientId}/certificate-update

Kai kreipiamasi į šį tašką, fiskalizacijos paslauga (middleware) patikrina, ar sertifikatus reikia pakeisti. Jei sertifikato galiojimo laikas artėja prie pabaigos, jis pakeičiamas naujesniu.

Atnaujinimas būtinas

Sertifikatą galima pakeisti tik po dienos uždarymo / ataskaitos (Z) (EndOfDay dokumentas). Kiekvienam EndOfDay dokumentui „fiscalResponse“ grąžinama savybė „certificatesUpdateRequired“.

Jei „certificatesUpdateRequired“ vertė = true, aukštesnio lygio sistema privalo inicijuoti sertifikato keitimą naudodama galinį tašką POST /api/v1/management/lithuania/{clientId}/certificate-update.

Saugumo modulio reikšmės

Saugumo modulyje saugomas vertes (pardavimų skaitiklis, kasos aparato ID, pasirašytų dokumentų skaičius ir kt.) galima nuskaityti naudojant galinį tašką

• GET /api/v1/management/lithuania/{clientId}/param-stick

Testinio saugumo modulio atstatymas

Skirtingai nuo saugumo modulių, skirtų veikti gamybinėje aplinkoje, bandomuosius saugumo modulius galima atkurti į gamyklinius nustatymus. Tai ypač svarbu diegimo etape, jei įvyko klaidų (pvz., iEKA ryšyje – žr. toliau).

Atstatymas atliekamas naudojant šį galinį tašką

• DELETE /api/v1/management/lithuania/{clientId}/reset-stick

Ryšys su iEKA

Be sandorių duomenų pasirašymo per saugumo modulį, duomenų perdavimas į mokesčių institucijų internetinę sistemą (iEKA) yra vienas iš pagrindinių Lietuvos fiskalizacijos reikalavimų.

The RetailForce system ensures automatic communication with iEKA. iEKA restricts the number of data records that can be transferred within a certain period of time, as well as the frequency of transfers/requests within a period of time. Due to this, the fiscalisation service does not transmit data to iEKA in real time, but rather asynchronously.

Klaidų šalinimas

Duomenys, naudojami kaip duomenų perdavimo pagrindas, fiskalizacijos paslaugos saugomi aplanke (pvz., „Windows“ sistemose) C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}\lithuaniaFiscalFiles.

Procesas

Pirmiau aprašytame aplanke paprastai yra trys pakatalogiai:

• „send“ – duomenys, kuriuos reikia perduoti į iEKA (duomenys, kurie dar nebuvo perduoti).
• accepted – duomenys, kurie buvo išsiųsti į iEKA ir kuriuos sistema priėmė.
• 20xy – iEKA atsakymas po kiekvieno atskiro duomenų įrašo patikrinimo (nurodo metus, kuriais buvo užregistruota operacija).

Duomenų perdavimas į iEKA vyksta taip:

1. „RetailForce Client“ gauna duomenis iš aukštesnio lygio sistemos („kasos aparato“) ir
2. konvertuoja juos į iEKA formatą (tačiau kaip JSON failą).
3. Šis JSON failas saugomas aplanke „\\lithuaniaFiscalFiles\send“.
4. Failai, esantys aplanke „\\send“, periodiškai (asinchroniškai) perduodami į iEKA sistemą. Prieš perdavimą JSON failai konvertuojami į iEKA XML formatą.
5. Kai duomenys pasiekia „iEKA“ sistemą, „iEKA“ patvirtina jų gavimą.
6. Tuomet sandorių duomenys kartu su iš iEKA gautu patvirtinimu perkeliami iš aplanko „\\send“ į aplanką „\\accepted“.
   1. Jei duomenų nepavyko perduoti į iEKA, jie lieka aplanke \\send, o fiskalizacijos paslauga vėliau bando juos perduoti.
7. Dabar iEKA sistema tikrina perduotų duomenų teisingumą. Duomenų perdavimo modulis (fiskalizacijos paslauga) turi aktyviai užklausti tikrinimo būseną
8. Šis užklausimas taip pat atliekamas periodiškai dėl iEKA pusėje taikomų ryšio apribojimų (žr. aukščiau).
9. Patikrinimo būsenos užklausos rezultatas išsaugomas aplanke „20xy“ (duomenys perkeliami iš „\\accepted“ į „\\20xy“).

Sandorio būsena

Priešakinės sistemos („kasos aparatai“) gali patikrinti atskirų sandorių būseną naudodamos šias funkcijas:

• GET /api/v1/management/lithuania/{clientId}/check-document-status-by-iEKA-document-number/{iEKADocumentNumber} ir
• GET /api/v1/management/lithuania/{clientId}/check-document-status-by-document-number/{DocumentNumber}

Ypatingos procedūros

Prekių grąžinimas / keitimas

Grąžinimai (pvz., prekių keitimas) Lietuvoje laikomi nefiskaliniais dokumentais, t. y. nefiskaliniais sandoriais. Jie perduodami į „iEKA“ sistemą, tačiau nėra pasirašomi per saugumo modulį. Tai taip pat reiškia, kad grąžinimo dokumentai neturi įtakos saugumo modulio pardavimų (bendros sumos) skaitikliams.

Kad „RetailForce“ systema teisingai atpažintų grąžinimus kaip tokius, turi būti nustatyti šie parametrai:

• „documentType“: 0 / „[0] = Kvitas“
• „cancellationDocument“: true
• „documentReference“ – turi būti nustatyta nuoroda į kitą dokumentą (pirminį pardavimo dokumentą)
• Neigiamos sandorio vertės („GrossValue“, „NetValue“, „TaxValue“, „Amount“)

Techninis žurnalas

Lietuvoje privaloma registruoti techninius procesus. Kaip ir kitose šalyse, tai daroma naudojant techninių įvykių žurnalą / techninį žurnalą arba „AuditLog“.

Ypač turi būti registruojami šie įvykiai:

• Kasinės stalčiaus atidarymas (DrawerOpen) – turi būti perduodamas iš aukštesnio lygio sistemos.
• Dokumento anuliavimas (DocumentCancelDocument) – registruojamas automatiškai.

Daugiau informacijos rasite straipsnyje Techniniai įvykiai Lietuvoje.

Ataskaitų sumos

Ataskaitose (ataskaita (Z) – dienos fiskalinė ataskaita, ataskaita (X) – dienos tarpinė ataskaita) tam tikros (bendros) sumos turi būti pateikiamos atskirai. Siekiant tai užtikrinti, perduodant duomenis iš šaltinio sistemos („kasos aparatų“) į fiskalizacijos paslaugą, būtina laikytis tam tikrų taisyklių.

Išsamią informaciją rasite straipsnyje Ataskaitų sumavimas Lietuvoje.

PayIn ir PayOut

Pagal Lietuvos fiskalizacijos reikalavimus kasos aparato (stalčiaus) grynųjų pinigų likutis turi būti perduodamas į iEKA. Siekiant tai užtikrinti, įmokų ir išmokų operacijos (pvz., grąžos įnešimai) taip pat turi būti perduodamos iš šaltinio sistemos į „RetailForce“ fiskalizacijos paslaugą (middleware) kaip „PayIn“ ir „PayOut“ dokumentai („documentType“: 11 / „[11] = PayIn“ ir „documentType“: 10 / „[10] = PayOut“ su „BusinessTransactionType“: „[90] = MoneyTransfer“).

Dėl „PayIn“ ir „PayOut“ reikia atkreipti dėmesį į šiuos dalykus:

JSON payload pavyzdžiai

PayIn:

(Release: 1.11.4; DOM versija 1.6.2)

{
	"ModelVersion": "1.6.2",
	"UniqueClientId": "bef09871-a19b-4eba-9f88-f14e0b482ab3",
	"UniqueCashRegisterId": "0001-0007",
	"FiscalModuleVersion": "1.11.4.593",
	"FiscalCountryModuleVersion": "0.9.7",
	"SoftwareName": "RetailForce NeverPOS",
	"DocumentGuid": "da8e52c6-fb33-4b07-8f9b-7962bc0a0002",
	"DocumentId": "PI001",
	"DocumentNumber": "PI202500001",
	"CreateDate": "2025-12-16T14:43:08.6110527+02:00",
	"BookDate": "2025-12-16T14:43:08.6110527+02:00",
	"DocumentType": 11,
	"User": {
		"Id": "7b1e3d67-25d0-4ad1-a230-5264b3aa1fca"
	},
	"PositionCount": 1,
	"DocumentIssueType": 0,
	"FiscalDocumentNumber": "0",
	"FiscalDocumentStartTime": 0,
	"Positions": [
		{
			"Type": "[3] = Booking",
			"Caption": "Pridėti grynuosius pinigus",
			"BusinessTransactionType": "[11] = PayIn",
			"VatIdentification": 10,
			"VatPercent": 0.0,
			"NetValue": 20.0,
			"GrossValue": 20.0,
			"TaxValue": 0.0,
			"PositionNumber": 0,
			"DeletedPosition": false,
			"AdditionalFields": {},
			"ExternalIdentifier": []
		}
	],
	"Payments": [
		{
			"Amount": 20.0,
			"CurrencyIsoCode": "EUR",
			"UniqueReadablePaymentIdentifier": "CashMovement",
			"AdditionalFields": {},
			"PaymentType": 0,
			"ExternalIdentifier": []
		}
	],
	"AdditionalHeader": [],
	"AdditionalFooter": [],
	"FiscalAdditionalFields": {}
}

Išmoka:

(Release: 1.11.4; DOM versija 1.6.2)

{
	"ModelVersion": "1.6.2",
	"UniqueClientId": "277a1220-5af4-4fc4-900f-694dcc0a6227",
	"UniqueCashRegisterId": "0001-0007",
	"FiscalModuleVersion": "1.11.4.593",
	"FiscalCountryModuleVersion": "0.9.7",
	"SoftwareName": "RetailForce NeverPOS",
	"DocumentGuid": "da8e52c6-fb33-4b07-8f9b-7962bc0a0002",
	"DocumentId": "PO0002",
	"DocumentNumber": "PO202500001",
	"CreateDate": "2025-12-16T12:08:08.6110527+02:00",
	"BookDate": "2025-12-16T12:08:08.6110527+02:00",
	"DocumentType": 10,
	"User": {
		"Id": "7b1e3d67-25d0-4ad1-a230-5264b3aa1fca"
	},
	"PositionCount": 1,
	"DocumentIssueType": 0,
	"FiscalDocumentNumber": "0",
	"FiscalDocumentStartTime": 0,
	"Positions": [
		{
			"Type": "[3] = Booking",
			"Caption": "Grynųjų pinigų išėmimas",
			"BusinessTransactionType": "[10] = PayOut",
			"PayOutType": null,
			"VatIdentification": 10,
			"VatPercent": 0.0,
			"NetValue": -12.0,
			"GrossValue": -12.0,
			"TaxValue": 0.0,
			"PositionNumber": 0,
			"DeletedPosition": false,
			"AdditionalFields": {},
			"ExternalIdentifier": []
		}
	],
	"Payments": [
		{
			"Amount": -12.0,
			"CurrencyIsoCode": "EUR",
			"UniqueReadablePaymentIdentifier": "CashMovement",
			"AdditionalFields": {},
			"PaymentType": 0,
			"ExternalIdentifier": []
		}
	],
	"AdditionalHeader": [],
	"AdditionalFooter": [],
	"FiscalAdditionalFields": {}
}

Sandorių nutraukimas / atsisakymas

Bet koks sandorio nutraukimas prieš jo užbaigimą turi būti užregistruotas Lietuvoje. Galinis taškas

• POST /api/v1/transactions/cancelDocument

.

Persiunčiamame JSON payload turi būti

• visas pozicijas, užregistruotas iki atšaukimo momento, tačiau
• tuščią „Payments“ objektą.

Pavyzdys:

(Release: 1.11.4; DOM versija 1.6.2)

{
	"ModelVersion": "1.6.2",
	"UniqueClientId": "bef09871-a19b-4eba-9f88-f14e0b482ab3",
	"UniqueCashRegisterId": "T001-1502",
	"FiscalModuleVersion": "1.11.4.593",
	"FiscalCountryModuleVersion": "0.9.7",
	"SoftwareName": "x x 1.0",
	"AutomaticVatCalculation": 0,
	"DocumentGuid": "da8e52c6-fb33-4b07-8f9b-7962bc0c0002",
	"DocumentId": "0002",
	"DocumentNumber": "202500001",
	"CreateDate": "2025-12-16T15:19:08.6110527+02:00",
	"BookDate": "2025-12-16T15:19:08.6110527+02:00",
	"DocumentType": 0,
	"User": {
		"Id": "7b1e3d67-25d0-4ad1-a230-5264b3aa1fca"
	},
	"PositionCount": 2,
	"DocumentIssueType": 0,
	"FiscalDocumentNumber": "0",
	"FiscalDocumentStartTime": 0,
	"Positions": [
		{
			"ItemCaption": "Testavimo prekė 222",
			"Discounts": [],
			"Type": "[0] = Item",
			"Quantity": 1.0,
			"QuantityUnit": {
				"Id": null
			},
			"ItemId": "8639d547-3db3-4a44-e0c3-08de3c72db58",
			"ItemType": 0,
			"BaseNetValue": 1.77686,
			"BaseGrossValue": 2.15,
			"BaseTaxValue": 0.37314,
			"BaseTaxValue2": null,
			"BusinessTransactionType": "[0] = Revenue",
			"VatIdentification": 1,
			"VatPercent": 21.0,
			"NetValue": 1.78,
			"GrossValue": 2.15,
			"TaxValue": 0.37,
			"ItemTaxType": 0,
			"PositionNumber": 0,
			"DeletedPosition": false,
			"AdditionalFields": {},
			"ExternalIdentifier": []
		},
		{
			"Type": "[10] = Total",
			"Rounding": 0.0,
			"BaseValue": 2.15,
			"Value": 2.15,
			"Discounts": [],
			"PositionNumber": 1,
			"DeletedPosition": false,
			"AdditionalFields": {},
			"ExternalIdentifier": []
		}
	],
	"Payments": [],
	"AdditionalHeader": [],
	"AdditionalFooter": [],
	"FiscalAdditionalFields": {}
}

Duomenys apie sandorio nutraukimą turi būti siunčiami į iEKA ir taip pat rodomi ataskaitose (žr. kitą skyrių).

Audito žurnalo įrašas apie sandorio nutraukimą / atsisakymą

Jei duomenų paketas siunčiamas į POST /api/v1/transactions/cancelDocument, „RetailForce“ fiskalizacijos paslauga automatiškai sukuria įrašą techniniame įvykių žurnale / techniniame žurnale („audito žurnale“) tokio tipo:

• DocumentCancelDocument

Įraše nurodoma perduotame payloade esančių atskirų prekių bendra vertė (GrossValue), nes ši informacija

• turi būti perduota iEKA ir
• taip pat turi būti nurodyta ataskaitoje (Z) ir
• ataskaitoje (X).

Duomenys perduodami į „iEKA“ per „EndOfDay“ dokumentą. Įrašius dienos uždarymą, „fiscalResponse Lithuania“ grąžinamos šios reikšmės:

• „DayCanceledReceiptsDocumentsQuantity“ – per dieną nutrauktų / atšauktų operacijų skaičius
• „DayCanceledReceiptsDocumentsAmount“ – visų nutrauktų / atšauktų sandorių (bruto) suma

Specialių prekių pardavimas

Lietuvoje tam tikrų prekių pardavimas turi būti specialiai pažymėtas. Šie pardavimai iEKA sistemai pateikiami kaip atskiri suminiai duomenys ir taip pat įtraukiami į ataskaitas (Ataskaita (X), Ataskaita (Z)).

Šią vadinamąją „specialių prekių prekybą“ sudaro šios prekių grupės:

• Alkoholis ir
• Kuras

„RetailForce DOM“ sistemoje atitinkami prekės vienetai gali būti atitinkamai pažymėti naudojant savybę „ItemTypeClassification“. Lietuvoje kaip „specialiosios prekės“ klasifikuojamas prekių grupes galima rasti per „fiscalCountryProperties“ (savybė: „supportedItemTypeClassification“).

Ataskaitos

Kasinės sistemos turi gebėti generuoti šias ataskaitas:

• Ataskaita (X) – dienos tarpinė ataskaita (taip pat žinoma kaip Ataskaita (X))
• Ataskaita (Z) – dienos fiskalinė ataskaita (taip pat žinoma kaip ataskaita (Z))
• Išsami fiskalinė ataskaita
• Apibendrinanti fiskalinė ataskaita

Daugiau informacijos apie tai, kokie duomenys turi būti įtraukti į atitinkamas ataskaitas, rasite straipsnyje Dokumentų reikalavimai Lietuvoje.

EKJ

EKJ (elektroninė kontrolinė juosta, žr. Lietuvos fiskalizacijos sąlygos) yra automatiškai saugoma fiskalinio kliento. „RetailForce Cloud“ ir API galiniuose taškuose ji vadinama ECJ.

Kaip rašoma EKJ

• Po kiekvieno saugumo modulio pasirašyto dokumento (pvz., kvito, įplaukų/išmokų, ataskaitos (X), ataskaitos (Z)) fiskalinis klientas sukuria teksto versiją ir prideda ją prie tos dienos EKJ failo (vienas teksto failas per dieną).
• Jei klientas yra prijungtas prie RetailForce Cloud, kiekvienas įrašas taip pat perkeliama į debesų archyvą.

EKJ išgavimas

• Fiscal Client: GET /api/v1/management/lithuania/{clientId}/ecj-zip?fromDate={date}&tillDate={date} grąžina ZIP failą, kuriame yra po vieną tekstinį failą už kiekvieną pasirinktos laikotarpio dieną. Jei už tą laikotarpį nėra EKJ duomenų, grąžinama klaida „Duomenų nerasta“.
• RetailForce Cloud Portal: Lietuvos terminale veiksmas „Rodyti EKJ“ atidaro dialogo langą. Pasirinkite „Datą“ ir spustelėkite „Rodyti“, kad iš debesų archyvo būtų parodytas tos dienos EKJ.
• RetailForce Cloud API: GET /api/v1.0/implementation/lt/{terminalId}/ecj?date={date} grąžina vienos dienos EKJ (failo pavadinimą ir turinį). GET /api/v1.0/implementation/lt/{terminalId}/ecj-zip?fromDate={date}&tillDate={date} pradeda pasirinktos laikotarpio eksportą į ZIP failą; kai eksportas baigtas, jį galima atsisiųsti per pranešimus „RetailForce Cloud“ portale.

Šis straipsnis buvo išverstas automatiškai.