Fiskalizacja

Podłączanie kas fiskalnych i bram w chmurze w celu zgodności z przepisami podatkowymi.

1. Przegląd#

Fiskalizacja — wymóg prawny w wielu krajach: każda rozliczona transakcja z klientem musi być zarejestrowana w systemie podatkowym i potwierdzona paragonem fiskalnym.

Cenaly podchodzi do tego na dwa sposoby:

Co jest obsługiwane dzisiaj:

Pokrewny, ale inny obszar — elektroniczny obieg dokumentów z państwem (nie paragon dla klienta):

Kasa fiskalna ≠ KSeF: pierwsze — paragon dla osoby fizycznej, drugie — faktura dla osoby prawnej. Jedno nie zastępuje drugiego.

2. Jak to działa#

Gość płaci za zamówienie
       ↓
Kasa Cenaly zbiera przedmioty, stawki podatku i metody płatności
       ↓
Paragon trafia do kasy fiskalnej (przez Bridge) lub do chmurowej bramy
       ↓
Urządzenie/serwis rejestruje rozliczenie w systemie podatkowym
       ↓
Gość otrzymuje paragon fiskalny

Ważny szczegół: kasa fiskalna należy do Ciebie i jest zarejestrowana na Twoje dane. Cenaly to transport i kolejka, a nie operator danych fiskalnych.

3. Podłączanie kasy fiskalnej przez Bridge#

Obsługiwane rodziny#

Zwykłe (niefiskalne) drukarki paragonowe zgodne z ESC/POS podłącza się tym samym Bridge jako osobne urządzenie i drukują pre-paragony, bony kuchenne i paragony towarowe.

Jeśli na placówce nie ma drukarki paragonowej, rachunek gościa (pre-paragon) drukuje sama kasa fiskalna — szerokość wiersza jest pobierana z urządzenia, aby kolumna z kwotami nie została obcięta. Potrafią to Daisy, ATOL i SHTRIH-M; polskie Thermal nie drukują dowolnego tekstu i uczciwie odmawiają. Kasa fiskalna pozostaje przy tym kasą fiskalną: nasze zwykłe dokumenty (bony kuchenne, kopie paragonów) na nią nie trafiają — tylko wydruk testowy i pre-paragon.

Podłączanie krok po kroku#

Krok 1. Zainstaluj Bridge#

Otwórz Sprzęt w panelu: jeśli Bridge nie jest jeszcze zainstalowany, strona sama zaproponuje pobranie dla Twojego systemu — instalator dla Windows lub archiwum portable, dla Linux x64/ARM — jednolinijkowiec instalacji usługi. Bridge działa na tym samym komputerze, do którego podłączona jest kasa fiskalna.

Krok 2. Podłącz kasę fiskalną do komputera#

Obsługiwane są port szeregowy (COM/USB-COM), połączenie sieciowe i systemowy bufor wydruku — zależy od modelu. Bridge potrafi sam znajdować sprzęt: przycisk autoskanowania proponuje znalezione urządzenia, które można dodać do konfiguracji jednym kliknięciem.

Krok 3. Sprawdź#

Na karcie kasy fiskalnej widać model, numer seryjny, stawki podatkowe, status papieru i numer ostatniego raportu Z. Tutaj też — przyciski wydruku testowego, otwarcia szuflady na pieniądze i wykonania raportu X.

Dla kas Daisy w panel wbudowano osobne przewodniki: jak przełączyć kasę w tryb drukarki fiskalnej i co robić z typowymi błędami.

Krok 4. Skonfiguruj nagłówek i stawki#

Przycisk „Ustawienia kasy fiskalnej” otwiera edytor wierszowy nagłówka i stopki paragonu, flagi (puste wiersze, separator, logo, paragon szczegółowy), tryb odcinania, stawki podatkowe i dane operatora (numer, hasło, imię).

4. Konfiguracja według krajów#

🇬🇪 Gruzja — Revenue Service#

Wymagania:

• kasa fiskalna zarejestrowana w rs.ge, z modułem fiskalnym (sprawdzono na Daisy eXpert SX);
• numer identyfikacyjny (საიდენტიფიკაციო ნომერი).

Konfiguracja:

1. Przełącz kasę fiskalną w tryb serial „Fiscal printer” (w panelu jest przewodnik z dokładną sekwencją na klawiaturze).
2. Dodaj ją w sekcji Sprzęt jako rejestrator fiskalny.
3. Wystaw testowy paragon i zamknij zmianę kasową Z — kwoty muszą się zgadzać.

Oddzielnie od paragonów w Gruzji działa sekcja rs.ge: przychodzące elektroniczne faktury towarowe od dostawców, ich potwierdzanie i odrzucanie, słowniki, sprawdzanie numeru identyfikacyjnego i statusu podatnika VAT.

🇵🇱 Polska — kasa fiskalna online#

Od 2021 roku restauracje, bary i kawiarnie muszą mieć kasę online przesyłającą dane do CRK (Centralne Repozytorium Kas). Napisanie własnej wirtualnej kasy bez certyfikatu GUM jest niemożliwe, dlatego są dwie drogi:

1. Własna drukarka fiskalna według protokołu POSNET Thermal — podłączana przez bridge (patrz sekcja 3). Jeden sterownik obsługuje większość parku urządzeń: Posnet, Emar, Innova, Torell, Elzab Mera. Dziś w Polsce działa tylko ta droga.
2. API cudzej certyfikowanej kasy — 🛠 w opracowaniu. Bramka jest napisana, ale jej część serwerowa nie jest wdrożona, a adaptera pod konkretną certyfikowaną kasę na razie nie ma: polskie wirtualne kasy nie mają publicznej specyfikacji, a adaptery (XKasa, WKF, Aclas) są dodawane w miarę otrzymywania ich dokumentacji. Karty integracji w placówce nie ma.

Stawki VAT bramka nie wymyśla: macierz stawek (jedzenie 8 %, na wynos 5 %, kawa i alkohol 23 %) oblicza sama platforma, a bramka jedynie tłumaczy procent na literę PTU konkretnej kasy.

KSeF (faktury B2B) — osobny obieg w sekcji Kontrahenci: XML formatu FA(3) jest budowany z wystawionego dokumentu, szyfrowany i wysyłany do systemu Ministerstwa Finansów, a status i numer UPO wracają do karty.

🇰🇿 Kazachstan — KKM#

Od 01.01.2026 art. 110–111 Kodeksu podatkowego Republiki Kazachstanu wymagają paragonu KKM w dniu zakupu przy każdej płatności pieniężnej — w tym kartą na stronie, Kaspi Pay/QR i Apple/Google Pay.

🛠 Podłączenie na razie niedostępne. Bramka do operatora KKM (pierwszy sterownik — Webkassa) jest napisana, ale jej część serwerowa nie jest wdrożona: karty integracji w placówce nie ma i nie można dziś wprowadzić danych operatora. Gdy bramka zostanie otwarta, będzie działać tak: dane operatora KKM → sprawdzenie połączenia → paragon wychodzi automatycznie, a VAT jest obliczany według reżimu podatkowego placówki. Potrzebujesz Kazachstanu — napisz do wsparcia, priorytety są ustalane według popytu.

🇷🇺 Rosja — 54-FZ#

Dwa sposoby, można je łączyć:

• Własna KKT przez bridge — ATOL, Mercury, SHTRIH-M, Pirit/Viki Print. Obsługiwane FFD 1.05 i 1.2, paragony korekty, oznaczanie Chestny ZNAK, EGAIS UTM.
• Kasa w chmurze — sekcja API kasy (Rosja): HTTP API zgodne z protokołem ATOL Online (v5 = FFD 1.2, v4 = FFD 1.05). Twoja strona lub CMS wysyła paragon JSON, serwis stawia go w kolejce, paragon jest wystawiany na twojej własnej KKT. Kasa pozostaje twoja i jest zarejestrowana na twój INN — platforma to tylko transport i kolejka.

Powiązane rosyjskie obiegi: sprawdzanie statusu kodów oznaczania Chestny ZNAK i wygaszanie przychodzących VSD w FGIS „Mercury” (zakładka „Przychodzące VSD” w magazynie).

5. Wystawianie paragonów i raporty#

Na kasie (POS)#

Paragon jest wystawiany przy płatności w sekcji Kasa. Tam też: ponowny wydruk (pod PIN menedżera), zwrot — pełny lub częściowy, wymiana z odsprzedażą, wyszukiwanie w historii paragonów i prekalkulacja („rachunek gościa” przed płatnością).

Prekalkulacja jest drukowana na drukarce paragonowej, a jeśli nie ma jej w placówce — na samej kasie fiskalnej (patrz sekcja 3). Zadanie nie trafia przy tym do kolejki drukarki offline: gość czeka na rachunek teraz, a nie „gdy drukarka wróci”.

Z sekcji „Zamówienia”#

Dla zamówienia online paragon można wystawić bezpośrednio z karty zamówienia — polecenie wychodzi kanałem chmurowym do bridge’a właściwej placówki, nawet jeśli jesteś teraz przy innym komputerze.

Raporty X i Z#

• Raport X — pośredni, bez zamykania zmiany kasowej. Przycisk jest zarówno w sekcji Sprzęt, jak i w kasie.
• Raport Z — zamknięcie zmiany kasowej z potwierdzeniem; w kasie jest połączone z zamknięciem zmiany kasowej i uzgodnieniem stanu faktycznego z oczekiwanym (niedobory i nadwyżki widać od razu).

Dziennik zamkniętych zmian kasowych — kasjer, fundusz na wydawanie reszty, sprzedaż gotówką i kartą, gotówka oczekiwana i faktyczna, rozbieżności — znajduje się w sekcji Finanse, zakładka „Kasa”.

Jeśli paragon nie został wystawiony#

Kasa to sprzęt i zawodzi: skończył się papier, zmiana kasowa nie jest zamknięta, na urządzeniu wisi niezamknięty paragon, minęła ponad doba bez raportu Z. Wcześniej w takim przypadku pojawiała się znikająca podpowiedź z tekstem sterownika — nie można było z niej zrozumieć ani przyczyny, ani co zrobić.

Teraz zamiast niej otwiera się okno „Paragon nie został wystawiony”: jest tam napisane, co dokładnie się stało, i krok po kroku — co zrobić. Kasie wierzy się po jej własnym kodzie błędu, a nie po sformułowaniu sterownika: ten nierzadko radzi nie to (u niektórych modeli podpowiedź „przełącz tryb” przychodzi razem z kodem „doba bez raportu Z”, choć tryb jest w porządku).

• Jeśli przyczynę widać z chmury — okno daje przyciski „Zamknij raport Z” i „Powtórz paragon”.
• Jeśli naprawa musi odbyć się przy samym urządzeniu (brak papieru, niezamknięty paragon, błąd trzeba zresetować klawiszem na kasie), okno tak mówi i prowadzi krok po kroku.
• Jeśli to awaria dla serwisanta (modem, SIM, pamięć), powtórzenie nie jest proponowane — nic nie da.
• Szczegóły techniczne są ukryte w wierszu „szczegóły” — wygodnie dołączyć je do zgłoszenia do wsparcia.

Okno można zamknąć w każdej chwili: sprzedaż jest już zapisana w historii paragonów i płatność została przeprowadzona, a paragon fiskalny można wystawić ponownie z tego samego miejsca, gdy kasa będzie gotowa. Kolejka nie powinna czekać.

6. Co jest drukowane na paragonie#

Skład paragonu fiskalnego określa prawo danego kraju, a wszystkim, czym można zarządzać, zajmujemy się w „Ustawieniach rejestratora” w sekcji Sprzęt:

• wiersze nagłówka i stopki (edytor wierszowy);
• logo, separator, puste wiersze;
• paragon szczegółowy lub skrócony;
• tryb odcinania;
• stawki podatkowe i ich przypisanie do grup;
• dane operatora.

7. Paragony elektroniczne#

• W Rosji paragon elektroniczny wysyła klientowi OFD — na numer telefonu lub e-mail podane przy rozliczeniu; to część 54-FZ, a nie osobna funkcja panelu.
• Niezależnie od fiskalizacji Cenaly sam wysyła gościowi potwierdzenie zamówienia i powiadomienie o płatności na e-mail, a link do ekranu zamówienia gość może zapisać w zakładkach.
• E-mail gościa jest zbierany przy finalizacji zamówienia, jeśli włączyliście to pole w ustawieniach witryny.

8. Sprawozdawczość dla księgowości#

Rejestr paragonów prowadzony jest dla każdej placówki i na jego podstawie powstają:

• Finanse → Kasa — dziennik zmian kasowych, gotówka, rozbieżności;
• Finanse → Przegląd / Sprzedaż — przychody, podatki, metody płatności, kanały;
• Finanse → P&L — uproszczony rachunek zysków i strat z ręcznymi wydatkami;
• Ustawienia → Eksport danych — archiwum ZIP ze wszystkimi danymi konta, zamówieniami i katalogiem, m.in. w formacie CSV (otwiera się w Excelu i „Arkuszach Google”) — zob. Eksport danych.

Platforma nie generuje eksportów w formatach DSFinV-K i SAF-T — to część niemieckiego i ogólnoeuropejskiego obiegu, których na razie nie ma.

9. Częste pytania#

Czy fiskalizacja jest obowiązkowa?#

Zależy od kraju i rodzaju działalności: w Polsce i Rosji kasa online dla gastronomii jest obowiązkowa, w Kazachstanie od 2026 roku paragon z kasy fiskalnej jest wymagany przy każdej transakcji pieniężnej. Dokładne wymagania dla waszej firmy potwierdźcie u księgowego lub w urzędzie skarbowym.

Czy można pracować bez fizycznej drukarki?#

Dziś — nie: bramy chmurowe Kazachstanu (Webkassa) i Polski (kasa online przez API) nie są jeszcze otwarte na podłączenie, dlatego we wszystkich obsługiwanych krajach potrzebne jest własne urządzenie. W Rosji fizyczna kasa fiskalna jest potrzebna w każdym przypadku, ale można nią zarządzać z chmury przez sekcję „API kasy” — komputer z kasą stoi w jednym miejscu, a paragony wysyła do niego zarówno strona, jak i 1C.

Co robić w razie awarii kasy?#

Bridge uczciwie pokazuje status urządzenia i treść błędu, a nie po cichu „połyka” awarię. Dopóki kasa jest niedostępna, zamówienia i płatności nadal funkcjonują w systemie — ale dokument fiskalny bez sprawnej kasy fiskalnej nie powstanie, a w większości krajów jest to powód do wstrzymania rozliczeń i powiadomienia urzędu skarbowego.

Jak podłączyć kilka kas?#

Sprzęt prowadzony jest według placówek: w każdej lokalizacji działa własny bridge (lub kilka — uniwersalny, dla sprzętu, dla kamer, dla telefonii), a w rejestrze sprzętu konta widoczne są od razu wszystkie bridge’e i wszystkie urządzenia wszystkich placówek, z przypisaniem bridge’a do dodatkowych lokalizacji.

Czym różni się kasa fiskalna od KSeF?#

Kasa fiskalna — to paragon dla osoby fizycznej, regulator GUM i KAS, repozytorium CRK. KSeF — faktura elektroniczna dla osoby prawnej, system Ministerstwa Finansów. Różne dokumenty i różne obowiązki; posiadanie jednego nie znosi drugiego.

10. Wsparcie#

• Cenaly: support@cenaly.com → temat „Fiskalizacja”
• W sprawach rejestracji kas — do urzędu skarbowego w waszym kraju
• Powiązane sekcje: Sprzęt, Kasa (POS), Paragony, rs.ge