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 podlegają fiskalizacji. W przypadku kas fiskalnych wyposażonych w moduł zabezpieczający moduł ten podpisuje dane paragonów fiskalnych, paragonów niefiskalnych oraz raportów dziennego zamknięcia (Z), zgodnie z wytycznymi Litewskiej Państwowej Inspekcji Podatkowej (VMI).
| 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 niebędący dokumentem fiskalnym | 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, niekompletna transakcja | 0 |
Dokument | 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 środków 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 niefiskalnego | Operacje wpłat, np. wpłata reszty z transakcji | 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 |
| - | - | - | 14 |
PreliminaryReceipt | Obecnie nie jest obsługiwane |
| - | - | - | 15 |
Potwierdzenie płatności | Obecnie nie jest obsługiwane |
| - | - | - | 80 |
LongTermOrder | Obsługiwany typ dokumentu |
| nonFiscalReceipt | dokument pobrania niebędący dokumentem fiskalnym | 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 obsługiwane |
| nonFiscalReceipt | dokument finansowy niebędący dokumentem fiskalnym | Struktura „Inne operacje pobrania środków” (collectionType: 3 – zakup) | 101 |
Zakup | - |
| - | - | - | 1001 |
Drukowanie pokwitowania | Obecnie nie jest obsługiwane |
| - | - | - | 1100 |
Różne (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 | nie jest obsługiwane |
|
|
| 7 – Zwrot kosztów 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 nieobsł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 do rabatów – funkcja nieobsługiwana Pozycje o tym BusinessTransactionType są odrzucane. Rabaty są przekazywane jako „Dodatki do rabatów” za pośrednictwem rabatów przypisanych do danej pozycji. |
1 |
Rabaty |
| Operacja wypłaty (collectionType 1 – wpłata) | 2 |
DepositOnEmpties |
|
PaymentType 4 – bony PayOutType 4 – bony |
3 |
KuponJednorazowy |
Inne operacje związane z odbiorem gotówki (collectionType 2 – inne) |
4 |
MultiPurposeVoucher |
|
Nie rejestrowane W litewskim ustawodawstwie napiwki nie są określone jako transakcje gospodarcze w sektorze handlu detalicznego i hotelarstwa. Traktuje się je jako dochód osobisty. |
5 |
Napiwek |
| Nie są rejestrowane. | 6 |
Napiwek firmowy |
| PayIn (collectionType 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 |
|
Dokument pobrania niefiskalnego (kierunek operacji OUT) Powoduje to błąd wyłącznie w przypadku dokumentów o typie [10] = „Wypłata”; w dokumentach typu „PayIn” [11] oraz „OpeningBalance” [90] nie występuje błąd. Płatność wymaga UniqueReadablePaymentIdentifier „CashMovement”. |
91 |
Różnica gotówkowa |
| Nieobsługiwane | 92 |
|
| Nieobsł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 |
BusinessTransactionType: [4] = MultiPurposeVoucher BusinessTransactionType: [3] = Kupon jednofunkcyjny o wartościach ujemnych |
| Zakup | 3 |
DocumentType: [101] = Zakup |
| Zwrot | 4 |
JEŻELI:
|
RetailForce system rejestruje komunikację z systemem iEKA. Dane debugowania są przechowywane w folderze 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.