Paragon fiskalny a KSeF – jak zautomatyzować wystawianie paragonów i e-paragonów przez API
Wprowadzenie obowiązkowego KSeF skupiło uwagę przedsiębiorców na fakturach elektronicznych — ale sprzedaż detaliczna (sklepy stacjonarne, punkty usługowe, e-commerce z odbiorem osobistym) nadal działa na paragonach fiskalnych. Te dwa światy — faktura KSeF i paragon fiskalny — rządzą się innymi przepisami i innymi urządzeniami, a mimo to często muszą współistnieć w jednym procesie sprzedaży.
Dlaczego to w ogóle problem
W typowym sklepie czy punkcie usługowym transakcja detaliczna wymaga wydania paragonu z kasy/drukarki fiskalnej — niezależnie od tego, czy klient poprosi o fakturę do tego paragonu. Jeśli sprzedaż odbywa się też online (marketplace, sklep internetowy), dochodzi temat e-paragonu — czyli paragonu w formie elektronicznej, bez konieczności drukowania papierowego dokumentu przy każdej transakcji.
Problem pojawia się, gdy firma chce to zautomatyzować: zamówienie w systemie sprzedażowym powinno automatycznie wygenerować paragon na drukarce fiskalnej, z poprawnym przypisaniem stawek VAT do pozycji — a to wymaga integracji z protokołem konkretnego producenta kas.
Jak działa integracja z Posnet
Drukarki fiskalne Posnet komunikują się przez własny protokół transmisji, w którym część parametrów przekazywana jest bez standardowego znaku = — to jedna z pierwszych pułapek, na którą trafia każdy, kto próbuje zintegrować się "od zera" bez dokumentacji producenta. W ksefservice.pl ten protokół obsługuje dedykowany komponent (Windows Service), który pośredniczy między systemem sprzedażowym a fizyczną drukarką.
Proces wygląda tak:
- System sprzedażowy (sklep, POS, panel zamówień) wysyła żądanie wystawienia paragonu z listą pozycji.
- Usługa pośrednicząca mapuje pozycje na odpowiednie stawki VAT (A, B, C, D, E) zgodnie z konfiguracją kasy.
- Paragon zostaje wydrukowany fizycznie (w sklepie stacjonarnym) lub wystawiony jako e-paragon (przy sprzedaży zdalnej).
- Dokument trafia do rejestru sprzedaży — spójnego z resztą procesu księgowego.
Mapowanie stawek VAT — najczęstszy błąd
Kasy fiskalne (w tym Posnet) przypisują stawki VAT do liter (A, B, C, D, E), a nie bezpośrednio do wartości procentowych — i to przypisanie jest konfigurowane indywidualnie na etapie fiskalizacji urządzenia. Automatyzacja musi więc znać mapowanie liter na stawki obowiązujące w danej kasie, inaczej system wystawi paragon z błędną stawką VAT mimo poprawnych danych wejściowych. To jeden z powodów, dla których integracja "uniwersalna" bez uwzględnienia konfiguracji konkretnego urządzenia bywa zawodna.
A co z fakturą do paragonu?
Gdy klient detaliczny poprosi o fakturę do paragonu, dokument trzeba powiązać z numerem i danymi paragonu zgodnie z przepisami, a docelowo — jeśli nabywca jest podatnikiem VAT — przesłać jako fakturę ustrukturyzowaną do KSeF. W ksefservice.pl ten krok jest częścią tego samego procesu co generowanie faktur FA(3): dane z paragonu mogą zasilić generator faktury bez ręcznego przepisywania pozycji.
Dla kogo ma to sens
- sklepy stacjonarne i punkty usługowe wystawiające dużo paragonów dziennie,
- sprzedawcy internetowi (np. z Allegro), którzy oprócz faktur muszą też obsłużyć klientów detalicznych paragonem,
- firmy chcące mieć jeden spójny rejestr sprzedaży — paragony i faktury w jednym miejscu, bez ręcznego uzgadniania dwóch systemów.
Podsumowanie
KSeF nie zastępuje paragonu fiskalnego — te dwa obowiązki trzeba obsługiwać równolegle. Automatyzacja tego procesu (integracja z drukarką, poprawne mapowanie stawek VAT, spójność z rejestrem faktur) eliminuje ręczne przepisywanie danych i redukuje ryzyko błędów przy rozliczeniu VAT.
Chcesz sprawdzić integrację z Posnet w swojej firmie? Załóż konto testowe lub zapoznaj się z dokumentacją API.
