wskazuje odpowiedni kraj.

W przypadku wysłania zapytania o właściwości fiscalCountryProperties za pomocą metody GET /api/v1/information/client/{clientId}/countryProperties podawany jest kraj przypisany do danego klienta.

Określa, czy w danym kraju wymagana jest certyfikacja komponentu fiskalnego, lub co podlega certyfikacji.

„mandatory” – Certyfikacja systemu nadrzędnego (np. kasy fiskalnej) jest obowiązkowa. W tym przypadku kasa fiskalna musi przejść proces certyfikacji lub zatwierdzenia.

„miniPOS” – Certyfikacja jest obowiązkowa, ale wymóg ten spełnia już certyfikowany komponent, który można zintegrować z RetailForce Middleware.

„notNecessary” – Certyfikacja systemu nadrzędnego nie jest wymagana.

„true” – w danym kraju dane muszą być przesyłane wiersz po wierszu, np. do drukarki fiskalnej.

• obecnie nieobsługiwane

„false” – interfejs oparty na dokumentach (brak drukowania wiersz po wierszu).

• Wdrożenie między systemem nadrzędnym a usługą fiskalizacji opiera się na standardowych punktach końcowych api.

Określa rodzaj fiskalizacji.

„fiscalPrinter” – Fiskalizacja opiera się na certyfikowanej drukarce fiskalnej lub certyfikowanym systemie kas fiskalnych.

• Oznacza to, że oprócz RetailForce systemu wymagana jest drukarka fiskalna. Konieczne może być jej zakupienie u lokalnego dostawcy.

„online” – Rejestracja fiskalna odbywa się za pośrednictwem systemów internetowych lokalnych organów podatkowych.

• Nie są wymagane żadne dodatkowe elementy sprzętowe.

„signature” – Rejestracja fiskalna poprzez podpisywanie danych paragonów przy użyciu certyfikatu cyfrowego przechowywanego w usłudze rejestracji fiskalnej.

• W niektórych krajach konieczne może być uzyskanie kwalifikowanego certyfikatu cyfrowego wydanego przez urząd certyfikacji (CA).

„signatureWithOnline” – fiskalizacja poprzez tworzenie podpisów i przesyłanie danych online do organów podatkowych.

• Połączenie dwóch wyżej wymienionych metod.

Określa, które środowisko jest obsługiwane:

„local” – lokalna instalacja middleware do celów fiskalnych (lokalnie w systemie POS, na serwerze sklepu itp.)

• Możliwe jest wysyłanie wywołań api do lokalnie zainstalowanej usługi fiskalnej:
  • http://localhost:7678/ w przypadku implementacji REST lub
  • wywołanie metody w przypadku implementacji nuget.

„cloud” – middleware do celów fiskalnych jest dostępne jako usługa w chmurze pod adresem https://fiscalisation.retailforce.cloud/.

• Możliwe jest wysyłanie wywołań API do usługi fiskalizacji w chmurze.

Określa, które systemy operacyjne/platformy są obsługiwane.

„linux”

• za pośrednictwem kontenera Docker (implementacja REST)

„windows”

• za pośrednictwem usługi Windows (implementacja REST) lub
• poprzez implementacii nuget

„ios”

• poprzez implementacii nuget

„android”

• poprzez implementacię nuget lub
• usługa dla systemu Android (implementacja REST)

Określa, które wymogi prawne są obsługiwane oraz ich wersje.

Np. w przypadku Grecji: „myDATA v1.x.x”

Typy dokumentów, które mają zostać poddane „fiskalizacji” w danym kraju. Muszą one na przykład zostać przetworzone przez wymagany komponent sprzętowy, podpisane itp.

„documentTypes” wymienione w sekcji „fiscalDocumentTypes” są automatycznie przetwarzane (np. podpisywane) w danym kraju przez serwis fiskalizacji zgodnie z przepisami dotyczącymi fiskalizacji.

Typy tych dokumentów MUSZĄ zostać przekazane do serwisu fiskalizacji w danym kraju, pod warunkiem że system źródłowy („kasa fiskalna”) je obsługuje.

Lista typów dokumentów obsługiwanych w poszczególnych krajach.

Oprócz „fiscalDocumentTypes” typy dokumentów wymienione w sekcji „supportedDocumentTypes” MOGĄ być przekazywane do serwisu fiskalizacyjnego.

Typy tych dokumentów to tzw. dokumenty „niefiskalne”, tj. takie, które nie są „poddane fiskalizacji” (np. podpisane).

Lista typów dokumentów nieobsługiwanych w danym kraju.

DocumentTypes wymienione w sekcji „notSupportedDocumentTypes” nie mogą być przekazywane do serwisu fiskalizacji w danym kraju.

Przyczyną tego może być niemożliwość techniczna lub przepisy/ustawy obowiązujące w danym kraju.

W przypadku przesłania „notSupportedDocumentType” do serwisu fiskalizacji otrzyma Pan/Pani komunikat o błędzie („documentType not supported!”).

System źródłowy nie powinien dopuszczać tych typów dokumentów w danym kraju.

Lista metod płatności obsługiwanych (akceptowanych) w danym kraju.

Metody te mogą być stosowane w danym kraju.

System nadrzędny powinien oferować użytkownikowi kasy wyłącznie metody płatności obsługiwane w danym kraju.

Lista metod płatności, które nie są obsługiwane (lub nie są dozwolone) w danym kraju.

System nadrzędny powinien wyłączyć metody płatności, które nie są obsługiwane w danym kraju.

Lista metod płatności (PaymentTypes), w przypadku których w danym kraju niedopuszczalne jest dokonanie płatności w kwocie wyższej niż należna.

Przykłady:

Suma na paragonie = 38,50 EUR

• Klient płaci kartą debetową kwotę 50 EUR, ponieważ chce otrzymać resztę w gotówce.
• Klient płaci 50 EUR gotówką i otrzymuje 11,50 EUR reszty (wydana reszta).

Transakcje tego typu są niedozwolone w niektórych krajach (co oznacza, że nie mogą zostać przesłane do systemu fiskalizacji).

Oznacza to, że kwoty płatności („payment.amount”) muszą zawsze odpowiadać sumie brutto pozycji („GrossValue” wszystkich „pozycji”), a nie wolno przekazywać ujemnych kwot płatności.

Lista typów transakcji biznesowych obsługiwanych w poszczególnych krajach.

W odróżnieniu od notSupportedBusinessTransactionTypes, te przypadki biznesowe mogą być wykorzystywane w danym kraju.

Lista typów przypadków biznesowych, które nie są obsługiwane (lub nie są dozwolone) w danym kraju.

Wymienione przypadki biznesowe nie mogą być stosowane w danym kraju i powinny zostać pominięte przez system źródłowy oraz nie powinny być przekazywane do serwisu fiskalnego.

Szczegółowe informacje na temat stawek Vat obsługiwanych w poszczególnych krajach.

Ta tablica zawiera następujące informacje:

• Stawka VAT: „VatPercent” / „VatPercent2”
• Wewnętrzny ID służący do przyporządkowania danej stawki VAT: „VatIdentification”
• Nazwa stawki Vat: „caption” / „Caption_EN”
• Historyczne stawki Vat wraz ze szczegółami dotyczącymi okresu ważności („ValidFrom” – „ValidTo”)

„nieobowiązkowe” – wyświetlanie danych klienta nie jest wymagane (brak obowiązku).

„obowiązkowe (bez RF)” – Wyświetlanie danych klienta jest obowiązkowe, ale nie jest kontrolowane za pośrednictwem RetailForce Middleware. Kontrola odbywa się automatycznie przez odpowiedni system fiskalny (np. automatycznie przez drukarkę fiskalną).

„obowiązkowe (RF)” – Wykorzystanie wyświetlacza klienta jest obowiązkowe i jest kontrolowane za pośrednictwem RetailForce Middleware.

• Wyświetlacz klienta jest kontrolowany za pomocą funkcji: POST /api/v1/transactions/display/{clientId}

„niedozwolone” – Korzystanie z wyświetlacza klienta jest zabronione w tym kraju.

Określa, czy urządzenia wejściowe muszą być zarejestrowane w danym kraju („true” / „false”).

Urządzenia wejściowe nie są samodzielnymi systemami rejestrującymi. Więcej informacji można znaleźć w sekcji: Architektury elektronicznych systemów rejestrujących (EAS)

„true” – w danym kraju obowiązuje wymóg prowadzenia dziennika technicznego (dziennika audytowego) (w tym przypadku uwzględnionego w licencji RF).

• W takim przypadku wpisy dotyczące zdarzeń technicznych należy przesłać do serwisu fiskalizacji za pomocą metody
  • POST /api/v1/transactions/AuditLog , lub
  • POST /api/v1/transactions/storeDocument („documentType”: „[1002] = AuditLog”)

„false” – nie ma wymogu prowadzenia dziennika technicznego (nie jest on uwzględniony w licencji).

• Zdarzenia techniczne MOGĄ być rejestrowane, ale nie jest to obowiązkowe.

„true” – w danym kraju ponowne wydrukowanie dokumentu musi być obowiązkowo rejestrowane.

• Należy wywołać jedno z poniższych:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, lub

  • PUT /api/v1/transactions/reprintDocument

    jest obowiązkowe.

„false” – Ponowne wydrukowanie dokumentu nie musi być rejestrowane jako obowiązkowe.

„terminal” – Dokument może zostać ponownie wydrukowany wyłącznie na tej samej kasie, na której wystawiono dokument oryginalny.

„store” – Ponowne wydrukowanie dokumentu może nastąpić wyłącznie w tym samym oddziale/sklepie, w którym wystawiono dokument oryginalny.

• Funkcja ponownego wydruku w wielu oddziałach musi zostać zaimplementowana przez system nadrzędny.

„wszystkie” – Ponowne wydrukowanie dokumentu może nastąpić zarówno na innej kasie, jak i w innym oddziale/sklepie tej samej firmy.

• Funkcja ponownego wydruku w wielu oddziałach musi zostać zaimplementowana przez system nadrzędny.

„true” – raz dziennie musi być generowane zamknięcie dzienne (raport Z).

• dzienne zamknięcie
  • POST /api/v1/transactions/storeDocument
  • „documentType”: „[99] = EndOfDay”

„false” – nie ma wymogu sporządzania dziennego zamknięcia.

Wskazuje okres czasu od momentu dziennego otwarcia kasy, w którym musi nastąpić dzienne zamknięcie (np. w ciągu 24 godzin).

„-1” – nieustalone.

Określ, czy na jednym paragonie (dokumencie) można jednocześnie rejestrować sprzedaż i zwroty.

„oneReceiptAllowed” – dozwolone (sprzedaż i zwroty mogą być wykazane łącznie na jednym paragonie).

• Sprzedaż:
  • „positions” (typ 0 lub 1) o wartościach dodatnich,
• Zwroty:
  • „positions” (typ 0 lub 1) z wartościami ujemnymi oraz
  • ustawione pole „documentReference”.

„oneReceiptAllowedVat” – o ile kwota podatku Vat pozostaje dodatnia, sprzedaż i zwroty mogą być rejestrowane na jednym (tym samym) paragonie.

„multiReceipt” – sprzedaż i zwroty muszą być rejestrowane na różnych paragonach.

• Przed przesłaniem danych do serwisu fiskalizacyjnego system źródłowy musi automatycznie rozdzielić sprzedaż i zwroty na odrębne transakcje.

„NoReturnAllowed” – w danym kraju przetwarzanie zwrotów za pośrednictwem systemu fiskalizacji nie jest możliwe. W krajach tych zwroty są często obsługiwane za pomocą specjalnych formularzy lub podobnych dokumentów w dziale księgowości.

Gdzie można zwrócić zakupione towary?

„terminal” – Towary można przyjąć z powrotem wyłącznie w tej samej kasie (wystawienie paragonu), w której dokonano pierwotnej sprzedaży.

„store” – Towary można zwrócić wyłącznie w tym samym oddziale/sklepie (miejscu wystawienia paragonu), w którym dokonano pierwotnej sprzedaży.

„wszystkie” – Towary można również zwrócić do innych oddziałów tej samej firmy.

Odniesienie do dokumentu w przypadku zwrotów

„single” – w przypadku zwrotów można odwołać się wyłącznie do JEDNEGO poprzedniego dokumentu (dokumentu sprzedaży zwracanych usług lub towarów).

• „documentReference” – dozwolone wyłącznie w odniesieniu do pojedynczego dokumentu wstępnego lub
• odniesienie na poziomie pozycji („positionReference”) jest dozwolone wyłącznie w odniesieniu do jednego dokumentu źródłowego.

„multiple” – w przypadku zwrotów dopuszczalne jest odwołanie się do wielu poprzednich dokumentów (wielu paragonów sprzedaży, jeśli zwracanych jest wiele usług lub towarów pochodzących z wielu zakupów). 

• „documentReference” do wielu poprzednich dokumentów lub
• odniesienie do odpowiedniego dokumentu poprzedzającego za pośrednictwem „positionReference” w poszczególnych pozycjach zwrotu.

Określa, czy element „fiscalDocumentNumber” z „fiscalResponse” odpowiedniego kraju musi zostać wydrukowany na dokumentach.

• Numery dokumentów przekazane z systemu nadrzędnego są ignorowane. System fiskalny (np. drukarka) samodzielnie przypisuje odpowiedni numer dokumentu/ID dokumentu.

„true” – w danym kraju dopuszczalne jest naliczanie opłat dodatkowych od towarów lub usług.

• surcharges:
  • „positions.discounts” o wartościach UJEMNYCH

„false” – naliczanie dopłat do cen jest niedozwolone.

Wskazuje, czy w danym kraju dozwolony jest tryb szkoleniowy/demonstracyjny kasy fiskalnej

„true” – dozwolone.

• Tryb szkoleniowy:
  • „IsTraining”: true

„false” – kasa nie może posiadać trybu szkoleniowego ani demonstracyjnego.

„true” – Suma poszczególnych pozycji jest obliczana na podstawie kwoty netto (NetValue) (np. w prowincji Québec w Kanadzie).

„false” – Suma poszczególnych pozycji jest obliczana na podstawie kwoty brutto (GrossValue) (ustawienie domyślne).

„true” – Pozycje, które zostały wprowadzone, ale nie zostały następnie uwzględnione w dokumencie, muszą zostać przesłane w payload (JSON).

„false” – Pozycje, które zostały wprowadzone, ale nie zostały następnie uwzględnione w dokumencie, nie muszą być przesyłane.

Określa typ dokumentu początkowego w danym kraju.

Ma to znaczenie tylko wtedy, gdy system nadrzędny NIE korzysta z funkcji GET /api/v1/transactions/document/{clientId}/start podczas inicjalizacji i sam generuje odpowiedni dokument początkowy.

Lista typów wypłat obsługiwanych w danym kraju.

Pozycje wymienione w sekcji „supportedPayOutTypes” mogą/muszą być określone dla wypłat („documentType”: „[10] = PayOut” oraz „BusinessTransactionType”: „[10] = PayOut”).

Wskazuje, czy stawki Vat są obliczane przez odpowiedni moduł fiskalny danego kraju.

„true” – moduł fiskalny oblicza stawki Vat.

„false” – stawki Vat musi obliczać kasa fiskalna.

Określa, czy oraz ile miejsc po przecinku należy uwzględnić w dokumencie JSON przesyłanym do oprogramowania middleware (Fiscal Middleware) podczas przekazywania kwot / sum.

Dotyczy wszystkich specyfikacji wartości w payload („GrossValue”, „NetValue”, „TaxValue”, „Amount” itp.)