Pereiti prie pagrindinio turinio

fiscalResponseLithuania – Lietuva

Harald Krondorfer
  • Atnaujintas

Kai dokumentas perduodamas „RetailForce“ fiskalizacijos tarnybai (createDocument ir storeDocument), tarnyba atsako vadinamuoju „FiscalResponse“. Šis objektas aprašytas straipsnyje „FiscalResponse“ objektas.

Priklausomai nuo to, kokia fiskalinė šalis priskirta atitinkamam klientui (priklausomai nuo atitinkamos kliento konfigūracijos), masyve „AdditionalFields“ pateikiama skirtinga informacija. Šiame straipsnyje pateikiama informacija, kuri grąžinama kaip atsakymas (response) fiskalizacijos procese Lietuvoje (pagal Nutarimą VA-40).

Pastaba: priklausomai nuo perduodamo dokumento tipo („documentType“), „fiskalResponse“ objektas turi skirtingas savybes!

FiscalResponseLithuania - [0] = Receipt

„additionalFields“ „fiscalResponse“ Lietuvoje perduodant kvitą („documentType“: „[0] = Receipt“).

{
  "fiscalCountry": "[15] = Lithuania",
  "fiscalisationDocumentNumber": 9,
  "fiscalDocumentNumber": "9",
  "fiscalDocumentStartTime": 1763729408,
  "processStartTime": 0,
  "errorDescription": "",
  "cashRegisterId": "CR-000016903",
  "signature": "IiyTWZRCNlUjZmT9TqEKanbqrpkXtiUxjfew+5YZwabxoPXLiZcmFPpRAIjCEisqE3xDm0fSJxmpfaj2nYp1r+OaxHsNpX3xajVArIyCgPMgRSSMdiyC16iMMeimm2RfmTX5H7PNGCLAMR3RVdF0si7hp+3PXImK3ePGRi0QIahaMswGQhbYvXqoRR8Dl/dwSjuIofju5io8sEio8zVK/lcwXXEDMDoWoWwkbhHBqo7LJDjhPf3gE2JeRavqhS/MPgRaRP71sLomHjsWan/+J9JbUdbySBE+HWFVVjpCNBNsQmijLXf53G3UXV6zDKu61+KOKP8xeTVVTlH6u9DkVg==",
  "userMessage": "",
  "printMessage": "***Test***",
  "requestTime": "2025-11-21T14:50:20.2176992+02:00",
  "requestCompletionTime": "2025-11-21T14:50:24.8096631+02:00",
  "qrCode": "https://kvitas.vmi.lt?NR=9&SM=SM-000014959&RS=222C-9359-9442-3655&RC=DF5A-CBEB-A253-A06A&DT=2025-11-21T14:50:08",
  "printingFields": {
    "EKA_Nr": "CR-000016903",
	"Saugos_modulio_ID": "SM-000014959",
	"Kvito_parašas": "222C-9359-9442-3655",
	"Kvito_kodas": "DF5A-CBEB-A253-A06A"
  },
  "AdditionalFields": {
    "SecurityModuleNr": "SM-000014959",
    "DocumentCode": "DF5ACBEBA253A06A",
    "ReceiptCode": "DF5A-CBEB-A253-A06A",
    "ClosingReportNumber": 5,
    "SlipSignature": "222C935994423655",
    "DocumentHash": "L8hz011jK01qv7Y8djvhRTwqpWRDeb5h04UnMbbZ/zI="
  }

Lietuvoje fiskalizacijos procese naudojami (perduodami) šie papildomi laukai.

Elementas Tipas Aprašymas
cashRegisterId   iEKA priskirtas kasos ID
signature   Pilnas dokumento parašas. Jis turi būti nurodytas pilna forma EKJ (elektroniniame žurnale).
printingFields   Grąžinama informacija, kuri turi būti atspausdinta atitinkamame dokumente. Daugiau informacijos straipsnyje „printingFields – Lietuva“.
additionalFields   Šaliai būdinga informacija
  SecurityModuleNr   Naudojamo saugumo modulio ID
  DocumentCode   Dokumento kodas – saugumo modulio grąžinamoji reikšmė (ReceiptCode)
  ReceiptCode   Dokumento kodas – saugumo modulio grąžinamoji reikšmė (ReceiptCode) formatu, nurodytu QR kode (XXXX-XXXX-XXXX-XXXX)
  ClosingReportNumber   Dabartinės dienos ataskaitos numeris (Ataskaita (Z))
  SlipSignature   Dokumento parašas, konvertuotas į skaitomą formą (be atskyrimo ženklo „-“)
  DocumentHash   Dokumento HASH vertė

 

FiscalResponseLithuania - [11] = PayIn / [10] = PayOut

papildomi laukai fiscalResponse Lietuvoje perduodant PayIn ir PayOut dokumentus („documentType“: „[11] = PayIn“ ir „[10] = PayOut“).

{
  "fiscalCountry": "[15] = Lithuania",
  "fiscalisationDocumentNumber": 9,
  "fiscalDocumentNumber": "9",
  "fiscalDocumentStartTime": 1763729408,
  "processStartTime": 0,
  "errorDescription": "",
  "cashRegisterId": "CR-000016903",
  "signature": "IiyTWZRCNlUjZmT9TqEKanbqrpkXtiUxjfew+5YZwabxoPXLiZcmFPpRAIjCEisqE3xDm0fSJxmpfaj2nYp1r+OaxHsNpX3xajVArIyCgPMgRSSMdiyC16iMMeimm2RfmTX5H7PNGCLAMR3RVdF0si7hp+3PXImK3ePGRi0QIahaMswGQhbYvXqoRR8Dl/dwSjuIofju5io8sEio8zVK/lcwXXEDMDoWoWwkbhHBqo7LJDjhPf3gE2JeRavqhS/MPgRaRP71sLomHjsWan/+J9JbUdbySBE+HWFVVjpCNBNsQmijLXf53G3UXV6zDKu61+KOKP8xeTVVTlH6u9DkVg==",
  "userMessage": "",
  "printMessage": "***Test***",
  "requestTime": "2025-11-21T14:50:20.2176992+02:00",
  "requestCompletionTime": "2025-11-21T14:50:24.8096631+02:00",
  "qrCode": "https://kvitas.vmi.lt?NR=9&SM=SM-000014959&RS=222C-9359-9442-3655&RC=DF5A-CBEB-A253-A06A&DT=2025-11-21T14:50:08",
  "printingFields": {
    "Np_PayIn": "INFO KVITO PATIKRINIMUI",
    "EKA_Nr": "CR-000016903",
	"Saugos_modulio_ID": "SM-000014959"
  },
  "AdditionalFields": {
    "SecurityModuleNr": "SM-000014959",
    "ClosingReportNumber": 18,
    "DocumentHash": "L8hz011jK01qv7Y8djvhRTwqpWRDeb5h04UnMbbZ/zI=",
    "DayFiscalDocNr": 0,
	"DayNonFiscalDocNr": 1
  }

Lietuvoje fiskalizacijos procese naudojami (perduodami) šie papildomi laukai.

Elementas Tipas Aprašymas
cashRegisterId   iEKA priskirtas kasos ID
signature   Pilnas dokumento parašas. Jis turi būti nurodytas pilna forma EKJ (elektroniniame žurnale).
printingFields   Grąžinama informacija, kuri turi būti atspausdinta atitinkamame dokumente. Daugiau informacijos straipsnyje „printingFields – Lietuva“.
additionalFields   Šaliai būdinga informacija
  SecurityModuleNr   Naudojamo saugumo modulio ID
  ClosingReportNumber   Dabartinės dienos uždarymo ataskaitos numeris (Ataskaita (Z))
  DocumentHash   Dokumento HASH vertė
  DayFiscalDocNr   Dabartinės dienos fiskalinių dokumentų skaičius (nuo paskutinės dienos ataskaitos)
  DayNonFiscalDocNr   Nefiskalinių dokumentų skaičius einamąją dieną (nuo paskutinio dienos uždarymo)

 

FiscalResponseLithuania - [98] = CashCheck / [99] = EndOfDay

additionalFields lauke fiscalResponse Lietuvoje, perduodant tarpinę ataskaitą „Report (X)“ arba dienos uždarymo ataskaitą „Report (Z)“ („documentType“: „[98] = CashCheck“ ir „[99] = EndOfDay“).

{
	"FiscalCountry": "[15] = Lithuania",
	"FiscalisationDocumentNumber": 41,
	"FiscalDocumentNumber": "41",
	"FiscalDocumentStartTime": 0,
	"ProcessStartTime": 0,
	"ErrorDescription": "",
	"CashRegisterId": "CR-000018338",
	"Signature": "MbnnxmiIeFz4rtFX+Se9YZVl/VF2TQVXoOSaJ7sI4NPNtqDbzsSrDeGbVtL/f9kpGRIA0YRWqkTXkkoXPsQtnWOyabQn3Iutt30/AN1QcsyE/+uZiVM96H2tI8hbCbsse1dExpMI5ii3G5VykFcL6Nru3qc/E4NnUwDpy6ovQYcjoRXwhq+Y1FdOAz+ItQZObkyUZqZkeDv4e9k/jRF4aug62scMbDc7m0TA9o0Iso83E+z1XSO1K4ysS2hbv/Xys8/GFPjR4Js5sY6KavN8jwIYn6QrjrL2n8NjmogJXRK5yuQjMqsJnK6tekWx3+A5tWk8eeitsDJa9VZg77qIeA==",
	"UserMessage": "",
	"PrintMessage": "***Test***",
	"RequestTime": "2026-03-05T17:34:31.2864171+02:00",
	"RequestCompletionTime": "2026-03-05T17:34:31.9759694+02:00",
	"QrCode": "",
	"PrintingFields": {
		"Np_EndOfDay": "DIENOS FISKALINĖ ATASKAITA",
		"Kvitas_Nr.": "41",
		"EKA_Nr.": "CR-000018338",
		"Saugos_modulio_ID": "SM-000016203"
	},
	"AdditionalFields": {
		"SecurityModuleNr": "SM-000016203",
		"DocumentCode": null,
		"ReceiptCode": null,
		"ClosingReportNumber": 7,
		"SlipSignature": null,
		"DocumentHash": "8rU9x/dSXr8T0MmC/rX/VVlVAifXVNOOcPpBCZJUwdU=",
		"DayFiscalDocNr": 3,
		"DayNonFiscalDocNr": 0,
		"DayCashDrawerOpenings": 0,
		"CertificatesUpdateRequired": false,
		"TaxChangeNumber": "1",
		"LastTaxChangeDateTime": "2000-01-01T00:00:00+02:00",
		"DayTotalSalesAmount": 4.56,
		"DayTotalSalesTaxAmount": 0.78,
		"DayCanceledReceiptsDocumentsQuantity": 0,
		"DayCanceledReceiptsDocumentsAmount": 0.0,
		"GrandTotalOfSales": 34.76,
		"GrandTotalOfSalesTax": 5.8
	}
}

Lietuvoje fiskalizacijos procese naudojami (perduodami) šie papildomi laukai.

Elementas Tipas Aprašymas
cashRegisterId   iEKA priskirtas kasos ID
signature   Pilnas dokumento parašas. Jis turi būti nurodytas pilna forma EKJ (elektroniniame žurnale).
printingFields   Grąžinama informacija, kuri turi būti atspausdinta atitinkamame dokumente. Daugiau informacijos straipsnyje „printingFields – Lietuva“.
additionalFields   Šaliai būdinga informacija
  SecurityModuleNr   Naudojamo saugumo modulio ID
  ClosingReportNumber   Dabartinės dienos uždarymo ataskaitos numeris (Ataskaita (Z))
  DocumentHash   Dokumento HASH vertė
  DayFiscalDocNr   Dabartinės dienos fiskalinių dokumentų skaičius (nuo paskutinės dienos ataskaitos)
  DayNonFiscalDocNr   Nefiskalinių dokumentų skaičius einamąją dieną (nuo paskutinio dienos uždarymo)
  DayCashDrawerOpenings  

Kaso stalčiaus atidarymų skaičius einamąją dieną (nuo paskutinio dienos uždarymo)

Dėmesio: šios savybės vertė yra nelygi nuliui tik tuomet, jei kasos stalčiaus atidarymai yra įrašomi kaip įvykio įrašas (DrawerOpen, kodas: 200)!
 
TaxChangeNumber
   PVM tarifų pakeitimų skaičius.
 
LastTaxChangeDateTime
  

Paskutinio PVM tarifų pakeitimo data ir laikas.

Pastaba: ant kvitų (Ataskaita X ir Ataskaita Z) turi būti spausdinama tik data, o ne laikas.
  DayTotalSalesAmount   Dienos pardavimo suma (dabartinės dienos pardavimo suma)
  DayTotalSalesTaxAmount   Dienos PVM suma (dabartinės dienos PVM suma)
  DayCanceledReceiptsDocumentsQuantity  

Dabartinės dienos kvitų atšaukimų skaičius

Dėmesio: Lietuvoje dokumentų atšaukimai turi būti registruojami naudojant funkciją POST /api/v1/transactions/cancelDocument. Ši savybė nurodo, kiek kartų buvo iškviesta ši funkcija.
  DayCanceledReceiptsDocumentsAmount  

Atsisakytų kvitų atskirų pozicijų suma.

Dėmesio: Lietuvoje dokumentų atšaukimai turi būti registruojami naudojant funkciją POST /api/v1/transactions/cancelDocument. Ši savybė nurodo atskirų pozicijų, kurios buvo įtrauktos į atitinkamus užklausimus, sumą.
  GrandTotalOfSales   Pardavimų skaitiklis iš saugumo modulio (bendros sumos skaitiklis)
  GrandTotalOfSalesTax   Mokesčių skaitiklis iš saugumo modulio (bendros sumos mokesčių skaitiklis)

 

Susiję straipsniai

Komentarai

0 komentarų

Tam, kad paliktumėte komentarus prisijunkite

Powered by Zendesk