After a document has been submitted to the RetailForce Fiscalisation service (createDocument and storeDocument), the service responds with a so-called FiscalResponse. This object is described in general in the article FiscalResponse object.
Depending on which fiscal country is assigned to the respective client (depending on the corresponding configuration of the client), different information can be found in the array "AdditionalFields". This article shows the information that is returned as a response within the framework of fiscalisation in Lithuania (according to the ordinance VA-40).
Note: Depending on the type of document transmitted ("documentType"), the "fiskalResponse" object contains different properties!
FiscalResponseLithuania - [0] = Receipt
additionalFields in fiscalResponse for Lithuania when submitting a receipt document ("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="
}The following additional fields are used (transmitted) within the framework of fiscalisation in Lithuania
| Element | Type | Description | |
| cashRegisterId | The cash register ID assigned by iEKA | ||
| signature | The complete signature of the document. This must be entered in full in the EKJ (electronic journal). | ||
| printingFields | Return of the information to be printed on the respective document. For more information, see the article “printingFields - Lithuania”. | ||
| additionalFields | Country-specific information | ||
| SecurityModuleNr | ID of the security module used | ||
| DocumentCode | Document code - Return value from security module (ReceiptCode) | ||
| ReceiptCode | Document code - Return value from security module (ReceiptCode) in the format specified in the QR code (XXXX-XXXX-XXXX-XXXX) | ||
| ClosingReportNumber | Number of the current daily closing report (Report (Z)) | ||
| SlipSignature | Document signature converted into readable form (without “-” separators) | ||
| DocumentHash | HASH value of the document | ||
FiscalResponseLithuania - [11] = PayIn / [10] = PayOut
additionalFields in fiscalResponse for Lithuania when transmitting PayIn and PayOut documents ("documentType": "[11] = PayIn" and "[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
}The following additional fields are used (transmitted) in the context of fiscalisation in Lithuania.
| Element | Type | Description | |
| cashRegisterId | The cash register ID assigned by iEKA | ||
| signature | The complete signature of the document. This must be entered in full in the EKJ (electronic journal). | ||
| printingFields | Return of the information to be printed on the respective document. For more information, see the article “printingFields - Lithuania”. | ||
| additionalFields | Country-specific information | ||
| SecurityModuleNr | ID of the security module used | ||
| ClosingReportNumber | Number of the current daily closing report (Report (Z)) | ||
| DocumentHash | HASH value of the document | ||
| DayFiscalDocNr | Number of fiscal documents for the current day (since the last daily closing) | ||
| DayNonFiscalDocNr | Number of non-fiscal documents for the current day (since the last daily closing) | ||
FiscalResponseLithuania - [98] = CashCheck / [99] = EndOfDay
additionalFields in fiscalResponse for Lithuania when submitting an interim report "Report (X)" or a daily closing report "Report (Z)" ("documentType": "[98] = CashCheck" and "[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
}
}The following additional fields are used (transmitted) in the context of fiscalisation in Lithuania.
| Element | Type | Description | |
| cashRegisterId | The cash register ID assigned by iEKA | ||
| signature | The complete signature of the document. This must be entered in full in the EKJ (electronic journal). | ||
| printingFields | Return of the information to be printed on the respective document. For more information, see the article “printingFields - Lithuania”. | ||
| additionalFields | Country-specific information | ||
| SecurityModuleNr | ID of the security module used | ||
| ClosingReportNumber | Number of the current daily closing report (Report (Z)) | ||
| DocumentHash | HASH value of the document | ||
| DayFiscalDocNr | Number of fiscal documents for the current day (since the last daily closing) | ||
| DayNonFiscalDocNr | Number of non-fiscal documents for the current day (since the last daily closing) | ||
| DayCashDrawerOpenings |
Number of cash register (cash drawer) openings on the current day (since the last daily closing) Attention: The value of this property is only non-zero if cash drawer openings are recorded as an event entry (DrawerOpen, code: 200)! |
||
TaxChangeNumber |
Number of changes to VAT rates. | ||
LastTaxChangeDateTime |
Date and time of the last change to VAT rates. Note: Only the date, not the time, should be printed on receipts (Report X and Report Z). |
||
| DayTotalSalesAmount | Daily sales counter (total sales for the current day) | ||
| DayTotalSalesTaxAmount | Daily tax counter (total value added tax for the current day) | ||
| DayCanceledReceiptsDocumentsQuantity |
Number of document abandonments for the current day Attention: Document abandonment must be recorded in Lithuania using the POST /api/v1/transactions/cancelDocument function. This property indicates how often the function was called. |
||
| DayCanceledReceiptsDocumentsAmount |
Total of the individual items on abandoned receipts. Attention: Document abandonment must be recorded in Lithuania using the POST /api/v1/transactions/cancelDocument function. This property specifies the total of the individual items contained in the respective requests. |
||
| GrandTotalOfSales | Sales counter from security module (grand total counter) | ||
| GrandTotalOfSalesTax | Tax counter from security module (Grand Total Tax counter) | ||
Comments
0 comments
Please sign in to leave a comment.