This article describes the mapping between the RetailForce Document Object Model (DOM) and the Lithuanian iEKA model.
DocumentType Mapping
In Lithuania, a basic distinction is made between the following document types (referred to as "document kind"):
- FiscalReceipt - sales transactions
- NonFiscalReceipt - documents for different purposes
- FiscalDay - daily closing report
Within NonFiscalReceipts, there are further types that serve to make further distinctions.
All types (fiscalReceipt, nonFiscalReceipt, FiscalDay) must be sent to the iEKA system and are therefore "fiscalDocuments" according to the RetailForce definition, i.e. documents that must be fiscalised. The only difference is that nonFiscalReceipts, unlike fiscalReceipts and FiscalDay documents, are not signed using a security module.
| Lithuania | RetailForce documentType | ||||
| Kind | Type | Description | No. | Description | Notes |
| fiscalReceipt | receipt | Cash register receipt - sale of goods/services | 0 | Receipt | - |
| fiscalReceipt | receipt | Null receipt | 1000 | NullReceipt | - |
| nonFiscalReceipt | nonFiscalReturnDocument | Cash register receipt for recording returns/exchanges and refunds | 0 | Receipt |
Same document type as a normal cash register receipt. Mapping: IF
|
| nonFiscalReceipt | nonFiscalCancelationDocument | Abbruch einer Transaktion vor Fertigstellung, unvollständige Transaktion | 0 | Receipt | is generated when the endpoint POST /api/v1/transactions/cancelDocument is called. |
| - | - | - | 1 | Invoice | Currently not supported |
| - | - | - | 2 | DeliveryNote | Currently not supported |
| nonFiscalReceipt | nonFiscalCollectionDocument |
Auszahlungsoperation, Entnahme von Geld aus der Kasse | 10 | PayOut | PayOut Operationen müssen mit NEGATIVEN Werten übergeben werden (GrossValue, Amount, etc.) |
| nonFiscalReceipt | nonFiscalFinancialDocument |
Spezielle Operationen in Zusammenhang mit Apotheken | 10 | PayOut | Currently not supported |
| nonFiscalReceipt | nonFiscalCollectionDocument | Einzahlungsoperationen, z.B. Wechselgeldeinzahlung | 11 | PayIn | PayIn Operationen müssen mit POSITIVEN Werten übergeben werden (GrossValue, Amount, etc.) |
| nonFiscalReceipt | nonFiscalFinancialDocument | Spezielle Operationen in Zusammenhang mit Apotheken | 11 | PayIn | Currently not supported |
| - | - | - | 12 | ProformaInvoice | Currently not supported |
| - | - | - | 13 | CustomerOrder | Currently not supported |
| nonFiscalReceipt | preOrderDocument | - | 14 | PreliminaryReceipt | - |
| - | - | - | 15 | PaymentReceipt | Currently not supported |
| - | - | - | 80 | LongTermOrder | SupportedDocumentType |
| nonFiscalReceipt | nonFiscalCollectionDocument | Deposit operations, e.g. deposit of change | 90 | OpeningBalance | is treated as a PayIn |
| nonFiscalReceipt | nonFiscalDocument | "Report (X)" - interim report | 98 | CashCheck | A CashCheck can be generated via the endpoint GET /api/v1/closing/{clientId}/endofdayDocument. However, before a /storeDocument, documentType and documentCaption must be adjusted accordingly |
| fiscalDay | fiscalDay | "Report (Z)" - daily closing report | 99 | EndOfDay | An EndOfDay document can be generated via the endpoint GET /api/v1/closing/{clientId}/endofdayDocument, and stored via storeDocument. |
| - | - | - | 100 | Inventory | Currently not supported |
| nonFiscalReceipt | nonFiscalFinancialDocument | OtherCashCollectionOperations structure (collectionType: 3 – purchase) | 101 | Purchase | Currently not supported |
| - | - | - | 1001 | PrintingReceipt | Currently not supported |
| - | - | - | 1100 | MiscellaneousNonFiscal | Currently not supported |
PaymentType Mapping
The following table shows payment methods described in the technical documentation of the Lithuanian iEKA system and their mapping to RetailForce DOM.
| <paymentType> iEKA Lithuania | "paymentType" RetailForce | Notes | |
| 1 - Cash | Cash | 0 | Cash payment |
| 2 - Debit/credit card payment | EcCard | 1 | payment by debit card |
| 2 - Debit/credit card payment | CreditCard | 2 | payment by credit card |
| 3 - Other payment card (e.g. loyalty card) | Loyalty | 13 | |
| 4 - Vouchers | MultiPurposeVoucher | 4 | SinglePurposeVouchers (3) are currently not supported as PaymentType, but must be transferred in the ‘positions’ element. |
| 5 - Money order | BankAccount | 11 | Payment by bank transfer |
| 6 - Reimbursed by the Compulsory Health Insurance Fund budget | not supported | ||
| 7 - Reimbursed by the state budget | not supported | ||
| 8 - Cryptocurrency | Crypto | 9 | |
| 9 - Other | not supported | ||
| OtherCashCollectionOperations structure (collectionType 1 – deposit) | Deposit | 6 | Not supported in Lithuania as a specific payment method, but as cashCollectionOperation |
| 10 - Rounding | is not a separate payment method in RetailForce but is represented by the ‘rounding’ element (document.positions.rounding). | ||
| NoCash | 7 | Currently not supported | |
| None | 8 | Currently not supported | |
| MobilePhoneApps | 10 | Currently not supported | |
| CustomerCard | 12 | Currently not supported | |
| Cheque | 14 | Currently not supported | |
| CreditNote | 15 | Currently not supported | |
BusinessTransactionType Mapping
RetailForce BusinessTransactionTypes are essentially mapped to so-called ‘operations’ in Lithuania.
| Lithuania | RetailForce | |
| Operation | No. | BusinessTransactionType |
| SalesOperation | 0 | Revenue |
| DiscountsAdditions | 1 | Discount |
| Payout operation (collectionType 1 – deposit) | 2 | DepositOnEmpties |
|
paymentType 4 – vouchers payoutType 4 – vouchers |
3 | SinglePurposeVoucher |
|
paymentType 4 – vouchers payoutType 4 – vouchers |
4 | MultiPurposeVoucher |
|
Not recorded Tips are not described as a business transaction in the retail/hospitality sector in Lithuanian legislation. They are treated as personal income. |
5 | Tip |
| Not recorded. | 6 | CompanyTip |
| Payin Operatation (collection Type 1 – deposit) | 7 | Deposit |
| OtherCashCollectionOperations (collectionDirection OUT) | 10 | PayOut |
| OtherCashCollectionOperations (collectionDirection IN) | 11 | PayIn |
| OtherCashCollectionOperations (collectionDirection IN oder OUT) | 90 | MoneyTransfer |
| Currently not supported | 91 | CashDifference |
| Not supported | 92 | |
| Not supported | 93 | |
collectionTypes
Other payment transactions are represented by collectionTypes.
| Lithuania | RetailForce | |
| collectionType | No. | Mapping |
| Deposit | 1 |
PaymentType: [6] = Deposit BusinessTransactionType: [7] = Deposit |
| Other | 2 | not mapped |
| Purchase | 3 | Currently not supported |
| Refund | 4 |
IF:
|
The RetailForce system records communication with the iEKA system. This debug data is stored in the folder C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}\lithuaniaFiscalFiles.
For details, see the article iEKA communication.
Comments
0 comments
Please sign in to leave a comment.