Dieser Artikel beschreibt das Mapping zwischen dem RetailForce Document Object Model (DOM) und dem litauischen iEKA Modell.
DocumentType Mapping
In Litauen wird grundsätzlich zwischen den folgenden Dokumententypen (bezeichnet als "document kind" - "Art des Dokuments") unterschieden:
- FiscalReceipt - Verkaufstransaktionen
- NonFiscalReceipt - Dokumente für unterschiedliche Zwecke
- FiscalDay - Tagesabschlussbericht
Innerhalb der NonFiscalReceipts gibt es eine weitere Typen, welche zur weitere Unterscheidung dienen.
Alle Arten (fiscalReceipt, nonFiscalReceipt, FiscalDay) müssen an das iEKA System geschickt werden und sind somit nach RetailForce-Definition "fiscalDocuments", also zu fiskalisierende Dokumente. Der Unterschied liegt lediglich darin, dass nonFiscalReceipts, im Gegensatz zu fiscalReceipts und FiscalDay Dokumenten nicht mittels Sicherheitsmoduls signiert werden.
| Litauen | RetailForce documentType | ||||
| Art | Typ | Beschreibung | Nr. | Bezeichnung | Anmerkungen |
| fiscalReceipt | receipt | Kassenbeleg - Verkauf von Waren / Dienstleistungen | 0 | Receipt | - |
| fiscalReceipt | receipt | Nullbeleg | 1000 | NullReceipt | - |
| nonFiscalReceipt | nonFiscalReturnDocument | Kassenbeleg zur Aufzeichnung von Retouren / Warenumtausch, -rückgaben | 0 | Receipt |
gleicher documentType wie normaler Kassenbeleg. Mapping: WENN
|
| nonFiscalReceipt | nonFiscalCancelationDocument | Abbruch einer Transaktion vor Fertigstellung, unvollständige Transaktion | 0 | Receipt | wird bei Aufruf des Endpunktes POST /api/v1/transactions/cancelDocument erzeugt. |
| - | - | - | 1 | Invoice | Derzeit nicht unterstützt |
| - | - | - | 2 | DeliveryNote | Derzeit nicht unterstützt |
| 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 | Derzeit nicht unterstützt |
| 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 | Derzeit nicht unterstützt |
| - | - | - | 12 | ProformaInvoice | Derzeit nicht unterstützt |
| - | - | - | 13 | CustomerOrder | Derzeit nicht unterstützt |
| nonFiscalReceipt | preOrderDocument | - | 14 | PreliminaryReceipt | - |
| - | - | - | 15 | PaymentReceipt | Derzeit nicht unterstützt |
| - | - | - | 80 | LongTermOrder | SupportedDocumentType |
| nonFiscalReceipt | nonFiscalCollectionDocument | Einzahlungsoperationen, z.B. Wechselgeldeinzahlung | 90 | OpeningBalance | wird wie ein PayIn behandelt |
| nonFiscalReceipt | nonFiscalDocument | "Report (X)" - Zwischenbericht | 98 | CashCheck | Ein CashCheck kann über den Endpunkt GET /api/v1/closing/{clientId}/endofdayDocument generiert werden. Allerdings muss vor einem /storeDocument documentType und documentCaption entsprechend angepasst werden. |
| fiscalDay | fiscalDay | "Report (Z)" - Tagesabschlussbericht | 99 | EndOfDay | Ein EndOfDay kann über den Endpunkt GET /api/v1/closing/{clientId}/endofdayDocument generiert und anschließend mittels /storeDocument gebucht werden. |
| - | - | - | 100 | Inventory | Derzeit nicht unterstützt |
| nonFiscalReceipt | nonFiscalFinancialDocument | OtherCashCollectionOperations structure (collectionType: 3 – purchase) | 101 | Purchase | Derzeit nicht unterstützt |
| - | - | - | 1001 | PrintingReceipt | Derzeit nicht unterstützt |
| - | - | - | 1100 | MiscellaneousNonFiscal | Derzeit nicht unterstützt |
PaymentType Mapping
Die nachfolgende Tabelle zeigt Zahlungsmethoden, welche in der technischen Dokumentation des litauischen iEKA Systems beschrieben werden und deren Mapping zum RetailForce DOM.
| <paymentType> iEKA Litauen | "paymentType" RetailForce | Anmerkungen | |
| 1 - Cash | Cash | 0 | Barzahlung |
| 2 - Debit/credit card payment | EcCard | 1 | Zahlung mit Debitkarte |
| 2 - Debit/credit card payment | CreditCard | 2 | Zahlung mit Kreditkarte |
| 3 - Other payment card (e.g. loyalty card) | Loyalty | 13 | |
| 4 - Vouchers | MultiPurposeVoucher | 4 | SinglePurposeVouchers (3) werden derzeit nicht als PaymentType untersützt, sondern müssen im "positions" Element übergeben werden. |
| 5 - Money order | BankAccount | 11 | Zahlung mit Banküberweisung |
| 6 - Reimbursed by the Compulsory Health Insurance Fund budget | nicht unterstützt | ||
| 7 - Reimbursed by the state budget | nicht unterstützt | ||
| 8 - Cryptocurrency | Crypto | 9 | |
| 9 - Other | nicht unterstützt | ||
| OtherCashCollectionOperations structure (collectionType 1 – deposit) | Deposit | 6 | Wird in Litauen nicht als spezifische Zahlungsmethode unterstützt, sondern als cashCollectionOperation |
| 10 - Rounding | ist in RetailForce keine eigene Zahlungsmethode sondern, wird über das "rounding"-Element abgebildet (document.positions.rounding) | ||
| NoCash | 7 | derzeit nicht unterstützt | |
| None | 8 | derzeit nicht unterstützt | |
| MobilePhoneApps | 10 | derzeit nicht unterstützt | |
| CustomerCard | 12 | derzeit nicht unterstützt | |
| Cheque | 14 | derzeit nicht unterstützt | |
| CreditNote | 15 | derzeit nicht unterstützt | |
BusinessTransactionType Mapping
RetailForce BusinessTransactionTypes sind im Wesentlichen auf s.g. "Operations" in Litauen gemappt.
| Litauen | RetailForce | |
| Operation | Nr. | 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 |
|
Nicht erfasst Trinkgelder werden in der litauischen Gesetzgebung nicht als Geschäftsvorgang im Einzelhandel/Gastgewerbe beschrieben. Sie werden als persönliches Einkommen behandelt. |
5 | Tip |
| Werden nicht erfasst. | 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 |
| derzeit nicht unterstützt | 91 | CashDifference |
| nicht unterstützt | 92 | |
| nicht unterstützt | 93 | |
collectionTypes
Durch collectionTypes werden sonstige Zahlungsvorgänge abgebildet.
| Litauen | RetailForce | |
| collectionType | Nr. | Mapping |
| Deposit | 1 |
PaymentType: [6] = Deposit BusinessTransactionType: [7] = Deposit |
| Other | 2 | nicht gemappt |
| Purchase | 3 | derzeit nicht unterstützt |
| Refund | 4 |
WENN:
|
Das RetailForce System zeichnet die Kommunikation mit dem iEKA-System auf. Diese Debug-Daten werden im Ordner C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}\lithuaniaFiscalFiles gespeichert.
Details dazu finden Sie im Artikel iEKA-Kommunikation.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.