W niniejszym artykule opisano mapowanie między modelem obiektowym dokumentów (DOM) RetailForce a litewskim modelem iEKA.
Mapowanie dokumentType
Na Litwie rozróżnia się zasadniczo następujące typy dokumentów (określane jako „rodzaj dokumentu”):
- FiscalReceipt – transakcje sprzedaży
- nonFiscalReceipt – dokumenty o różnym przeznaczeniu
- FiscalDay – raport zamknięcia dziennego
W ramach kategorii „nonFiscalReceipt” istnieją dalsze typy, które służą do dokonywania bardziej szczegółowych rozróżnień.
Wszystkie typy (fiscalReceipt, nonFiscalReceipt, FiscalDay) muszą zostać przesłane do systemu iEKA i w związku z tym stanowią „dokumenty fiskalne” zgodnie z definicją RetailForce, tj. dokumenty, które muszą zostać poddane fiskalizacji. Jedyną różnicą jest to, że dokumenty typu nonFiscalReceipt, w przeciwieństwie do dokumentów typu fiscalReceipt i FiscalDay, nie są podpisywane za pomocą modułu zabezpieczającego.
| Litwa | DocumentType RetailForce | ||||
| Rodzaj | Typ | Opis | Nr | Opis | Uwagi |
| paragon podatkowy | paragon | Paragon kasowy – sprzedaż towarów/usług | 0 | Paragon | - |
| paragon fiskalny | paragon | Paragon null | 1000 | Paragon zerowy | - |
| nonFiscalReceipt | dokument zwrotu niepodlegający opodatkowaniu | Paragon kasowy służący do rejestrowania zwrotów/wymian i refundacji | 0 | Paragon |
Ten sam typ dokumentu co zwykły paragon kasowy. Mapowanie: IF
|
| nonFiscalReceipt | dokument anulowania niebędący dokumentem fiskalnym | Przerwanie transakcji przed jej zakończeniem, transakcja niekompletna | 0 | Potwierdzenie | jest generowany po wywołaniu punktu końcowego POST /api/v1/transactions/cancelDocument. |
| - | - | - | 1 | Faktura | Obecnie nie jest obsługiwana |
| - | - | - | 2 | Dokument dostawy | Obecnie nie jest obsługiwane |
| nonFiscalReceipt | dokument pobrania niebędący dokumentem fiskalnym |
Operacja wypłaty, pobranie gotówki z kasy | 10 | Wypłata | Operacje wypłaty muszą być przekazywane z wartościami UJEMNYMI (GrossValue, Amount itp.) |
| nonFiscalReceipt | dokument finansowy o charakterze niefiskalnym |
Operacje specjalne związane z aptekami | 10 | Wypłata | Obecnie nie jest obsługiwane |
| nonFiscalReceipt | dokument pobrania niebędący dokumentem fiskalnym | Operacje wpłat, np. wpłata reszty z wymiany | 11 | PayIn | PayIn Operacje muszą być przekazywane z wartościami DODATNIMI (GrossValue, Amount itp.) |
| nonFiscalReceipt | dokument finansowy o charakterze niefiskalnym | Operacje specjalne związane z aptekami | 11 | PayIn | Obecnie nie jest obsługiwane |
| - | - | - | 12 | Faktura proforma | Obecnie nie jest obsługiwane |
| - | - | - | 13 | Zamówienie klienta | Obecnie nie jest obsługiwane |
| nonFiscalReceipt | preOrderDocument | - | 14 | PreliminaryReceipt | - |
| - | - | - | 15 | Potwierdzenie płatności | Obecnie nie jest obsługiwane |
| - | - | - | 80 | LongTermOrder | Obsługiwany typ dokumentu |
| nonFiscalReceipt | dokument pobrania niefiskalnego | Operacje związane z wpłatami, np. wpłata reszty | 90 | OpeningBalance | jest traktowany jako PayIn |
| nonFiscalReceipt | dokument niefiskalny | „Raport (X)” – raport okresowy | 98 | CashCheck | Czek CashCheck można wygenerować za pośrednictwem punktu końcowego GET /api/v1/closing/{clientId}/endofdayDocument. Jednak przed wykonaniem operacji storeDocument należy odpowiednio dostosować parametry documentType i documentCaption |
| fiscalDay | fiscalDay | „Raport (Z)” – dzienny raport zamknięcia | 99 | EndOfDay | Dokument EndOfDay można wygenerować za pośrednictwem punktu końcowego GET /api/v1/closing/{clientId}/endofdayDocument, a następnie zapisać za pomocą funkcji storeDocument. |
| - | - | - | 100 | Zapasy | Obecnie nie jest to obsługiwane |
| nonFiscalReceipt | Dokument finansowy niebędący dokumentem fiskalnym | Struktura „Inne operacje pobrania środków” (collectionType: 3 – zakup) | 101 | Zakup | Obecnie nieobsługiwane |
| - | - | - | 1001 | Drukowanie pokwitowania | Obecnie funkcja ta nie jest obsługiwana |
| - | - | - | 1100 | Różne operacje niefiskalne | Obecnie nie jest obsługiwane |
Mapowanie PaymentType
Poniższa tabela przedstawia metody płatności opisane w dokumentacji technicznej litewskiego systemu iEKA oraz ich przyporządkowanie do RetailForce DOM.
| <PAYMENTTYPE> iEKA Litwa | „PaymentType” RetailForce | Uwagi | |
| 1 – Gotówka | Gotówka | 0 | Płatność gotówką |
| 2 – Płatność kartą debetową/kredytową | EcCard | 1 | płatność kartą debetową |
| 2 – Płatność kartą debetową/kredytową | CreditCard | 2 | płatność kartą kredytową |
| 3 – Inna karta płatnicza (np. karta lojalnościowa) | Karta lojalnościowa | 13 | |
| 4 – Kupony | MultiPurposeVoucher | 4 | Kupony jednofunkcyjne (3) nie są obecnie obsługiwane jako PaymentType, ale należy je przekazać w elemencie „positions”. |
| 5 – Przekaz pieniężny | BankAccount | 11 | Płatność przelewem bankowym |
| 6 – Zwrot kosztów z budżetu Funduszu Obowiązkowego Ubezpieczenia Zdrowotnego | nieobsługiwane | ||
| 7 – Refundacja z budżetu państwa | nieobsługiwane | ||
| 8 – Kryptowaluta | Kryptowaluta | 9 | |
| 9 – Inne | nieobsługiwane | ||
| Struktura „OtherCashCollectionOperations” (collectionType 1 – wpłata) | Wpłata | 6 | Nie jest obsługiwana na Litwie jako konkretna metoda płatności, ale jako operacja pobrania gotówki |
| 10 – Zaokrąglenie | nie stanowi w systemie RetailForce odrębnej metody płatności, lecz jest reprezentowane przez element „zaokrąglenie” (document.positions.rounding). | ||
| NoCash | 7 | Obecnie nie jest obsługiwane | |
| Brak | 8 | Obecnie nie jest obsługiwane | |
| Aplikacje na telefony komórkowe | 10 | Obecnie nie jest obsługiwane | |
| Karta klienta | 12 | Obecnie nie jest obsługiwane | |
| Czek | 14 | Obecnie nie jest obsługiwane | |
| CreditNote | 15 | Obecnie nie jest obsługiwane | |
Mapowanie BusinessTransactionType
BusinessTransactionTypes of RetailForce are essentially mapped to what are called “operations” in Lithuania.
| Litwa | RetailForce | |
| Operacja | Nr | BusinessTransactionType |
| Operacja sprzedaży | 0 | Revenue |
| Dodatki z tytułu rabatów | 1 | Rabaty |
| Operacja wypłaty (collectionType 1 – wpłata) | 2 | Depozyt za puste opakowania |
|
PaymentType 4 – bony PayOutType 4 – bony |
3 | KuponJednorazowy |
|
PaymentType 4 – bony PayOutType 4 – bony |
4 | MultiPurposeVoucher |
|
Brak danych W litewskim ustawodawstwie napiwki nie są określone jako transakcje gospodarcze w sektorze handlu detalicznego i hotelarstwa. Traktowane są one jako dochód osobisty. |
5 | Napiwek |
| Nie ujęto. | 6 | Napiwek firmowy |
| PayIn Operacja płatnicza (rodzaj pobrania 1 – wpłata) | 7 | Wpłata |
| Inne operacje pobrania gotówki (kierunek pobrania OUT) | 10 | Wypłata |
| Inne operacje związane z pobraniem gotówki (kierunek pobrania IN) | 11 | PayIn |
| Inne operacje pobierania gotówki (kierunek pobierania: IN lub OUT) | 90 | MoneyTransfer |
| Obecnie nieobsługiwane | 91 | Różnica gotówkowa |
| Nie jest obsługiwane | 92 | |
| Nie jest obsługiwane | 93 | |
collectionTypes
Pozostałe transakcje płatnicze są reprezentowane przez collectionTypes.
| Litwa | RetailForce | |
| collectionType | Nr | Mapowanie |
| Wpłata | 1 |
PaymentType: [6] = Wpłata BusinessTransactionType: [7] = Wpłata |
| Inne | 2 | brak przyporządkowania |
| Zakup | 3 | Obecnie nie jest to obsługiwane |
| Zwrot | 4 |
JEŚLI:
|
The RetailForce system records communication with the iEKA system. Debug data is stored in the folder C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}\lithuaniaFiscalFiles.
Szczegółowe informacje można znaleźć w artykule „Komunikacja z iEKA”.
Niniejszy artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.