DRiWP 18.04.2019 r.

Zmiany w protokole POSNET „ONLINE” wersja: 1

Zmiany w protokole POSNET

Drukarki fiskalne “ONLINE”

WSTĘP
Kasy online pod wieloma względami różnią się od obecnych urządzeń fiskalnych. Ze względu na
specyficzne wymogi dla tych urządzeń zostały dodane nowe funkcjonalności, a część dotychczasowych
funkcjonalności musiało ulec zmianie.
Postaraliśmy się, aby w miarę możliwości zachować kompatybilność na poziomie protokołu
komunikacyjnego, żeby zminimalizować konieczność dostosowania funkcjonujących na rynku
systemów sprzedażowych i magazynowych.
W niniejszym dokumencie stwierdzenie „rozporządzenie” odnosi się do „Rozporządzenia Ministra
Przedsiębiorczości i Technologii z dnia 28 maja 2018 r. w sprawie kryteriów i warunków technicznych,
którym muszą odpowiadać kasy rejestrujące”, czyli aktu prawnego określającego wymagania dla tzw.
urządzeń fiskalnych online.
Kolorem fioletowym zostały oznaczone polecenia i parametry, które zostały zmodyfikowane,
natomiast kolorem niebieskim te, które dodano. Usunięte polecenia lub parametry, które zostały
zostały wspomniane w niniejszym dokumencie, są oznaczone kolorem czerwonym (nie są to wszystkie
usunięte elementy protokołu).

ZMIANY
Numery paragonów
Nowe rozporządzenie narzuca wspólną numerację paragonów (poprawnie zakończonych) oraz
paragonów anulowanych. W praktyce oznacza to, że teraz zwiększenie numeru paragonu o 1 nie jest
równoznaczne z pozytywnym zakończenie danego paragonu. W celu zachowania kompatybilności w
miejsce dotychczasowego „numer ostatnio wydrukowanego paragonu” będzie zwracana „licznik
paragonów poprawnie zakończonych” - czyli wartość o tym samym znaczeniu.
Dodano również nowe parametry zwrotne dla jasności informacji.

[scnt] Status liczników

bn - Liczba poprawnie zakończonych paragonów – wcześniej numer ostatniego paragonu
bc - Liczba paragonów anulowanych
bt - Numer ostatniego paragonu (wg wspólnej numeracji paragonów poprawnych i anulowanych)
fn - Liczba poprawnie zakończonych faktur
fc - Liczba faktur anulowanych – wcześniej w ogóle nie było rejestracji faktur anulowanych

1/8
DRiWP 18.04.2019 r. Zmiany w protokole POSNET „ONLINE” wersja: 1

[stot] Status totalizerów

W odpowiedzi drukarki pojawiły się nowe parametry określające: datę rozpoczęcia i zakończenia
sprzedaży, ilość i wartość anulowanych faktur oraz ilość wydruków niefiskalnych.

Opakowania
Rozporządzenie przenosi umiejscowienie rozliczenia opakowań zwrotnych do części fiskalnej
paragonu. Oznacza to, że należy przesłać wszystkie niezbędne informacje przed zakończenie transakcji
poleceniem [trend].
W przeciwieństwie do dotychczasowego działania wszystkie dane przesłane w transakcji przez [trpack]
determinują wydruk informacji o opakowaniach zwrotnych. Dane przesyłane w poleceniach
[trpackprnend] po zakończeniu transakcji [trend] są ignorowane.
[trpack] Linia opakowań
na – numeryczna nazwa opakowania (utrzymana dla kompatybilności drukowana w nawiasach)
de – alfanumeryczny opis opakowania (domyślnie „Opakowanie zwr.”)
il - ilość może przyjmować teraz tylko wartości całkowite – można przesyłać z przecinkiem, ale
wartość po przecinku musi być równa zero (np. 2,000)

Na wydruku oznaczenie opakowania składa się z opisu oraz numerycznej nazwy w nawiasach.
Całkowite oznaczenie (opis+nazwa) może zawierać do 40 znaków – w przypadku dłuższych ciągów
będzie on przycięty do 40. Dla kompatybilności z wcześniejszym działaniem wprowadziliśmy
opcjonalność tych dwóch parametrów przez co:
- przesłanie samej nazwy będzie skutkowało domyślnym opisem np.: „Opakowanie zwr. (123456)”
- przesłanie samej nazwy będzie skutkowało brakiem nazwy w nawiasach np.: „Butelka zwrotna”
- przesłanie opisu i nazwy będzie wyglądało np.: „Butelka zwrotna (123456)”

[trpackprnend] Wydruk linii opakowań w zakończeniu transakcji

Dane przesyłane w tym poleceniu są ignorowane – znaczenie mają tylko dane przesłane w [trpack].

Zaliczki
[tradvance]
Kwota od której jest udzielana zaliczka [wa] staje się parametrem wymaganym.

Faktury
Rozporządzenie narzuca nowe wymagania na wydruk faktur na urządzeniach fiskalnych. Ilość zmian
uniemożliwia zachowanie kompatybilności z dotychczasowymi poleceniami. Została usunięta faktura
otwarta [trfvfreeinit], ale faktura w nowym wydaniu jest oparta o rozwiązania z faktury otwartej.
Zachowaliśmy podziała na 3 sekcje danych niefiskalnych oraz działanie polecenia [trfvfreedata].

2/8
DRiWP 18.04.2019 r. Zmiany w protokole POSNET „ONLINE” wersja: 1

Podobnie jak w przypadku nagłówka muszą być wyodrębnione pola, które są wysyłane do
repozytorium MF. W związku z tym dodaliśmy polecenia, które służą do wstawiania poszczególnych
pól, z czego część jest obligatoryjna do poprawnego wystawienia faktury.

[trfvinit] Rozpoczęcie faktury

Ograniczono ilość parametrów do następujących:
nm – nazwa faktury do 23 znaków
cc – ilość dodatkowych kopii (jak do tej pory)
co – drukowanie oznaczenia ORYGINAŁ/KOPIA (jak do tej pory)
cm – drukowanie kopii, czy tylko zapis w pamięci (jak do tej pory)
ln – długość linii danych fiskalnych (jak do tej pory w fakturze otwartej)
fn – długość linii danych niefiskalnych (jak do tej pory w fakturze otwartej)

Nowe polecenia do wydruku faktury (szczegóły w specyfikacji):

[trfvbuyer] Dane nabywcy
[trfvnumber] Numer faktury
[trfvcashmet] Metoda kasowa
[trfvselfbill] Samofakturowanie
[trfvreverse] Odwrócone obciążenie
[trfvfree] Zwolnienie
[trfvexecution] Egzekucja
[trfvrep] Przedstawiciel
[trfvtransport] Środek transportu
[trfvthreeway] Transakcja trójstronna
[trfvtoursrv] Usługa turystyczna
[trfvothergoods] Towary inne
[trfvsep] Separator

Rabaty
Nowe rozporządzenie narzuca oznaczenie „Opust” zamiast „Rabat” na wszystkich wydrukach
transakcji. W dokumentacji pozostawiono oznaczenia „rabat” dla opisu tej funkcjonalności, ze względu
na wieloletnie przyzwyczajenie do tego terminu,

3/8
DRiWP 18.04.2019 r. Zmiany w protokole POSNET „ONLINE” wersja: 1

Nagłówek
Zgodnie z nowym rozporządzeniem nagłówek wydruków musi zawierać dane podatnika ale
z wydzieleniem poszczególnych pól. W przypadku zmiany adresu punktu sprzedaży następuje
rejestracja zdarzenia i przesłanie nowych danych do repozytorium MF. W związku z tym podczas
programowania nagłówka należy oznaczyć, które jego części zawierają poszczególne dane takie jak:
- Nazwa firmy
- Kod pocztowy
- Miejscowość
- Poczta
- Ulica
- Numer domu
- Numer lokalu

[hdrset] Programowanie nagłówka

tx – treść nagłówka zawierające znaczniki występowania poszczególnych pól (jak wyżej).
pr – czy wykonać zapis nowych danych, czy tylko wykonać wydruk poglądowy.

[hdrget] Odczyt nagłówka

tx – treść nagłówka ze znacznikami pól wg powyższego opisu.

Fiskalizacja
Fiskalizacja musi być przeprowadzona na urządzeniu z dostępem do internetu i możliwością połączenia
z serwerami MF. NIP podatnika ma być przesyłany w postaci 10 cyfr - wcześniej 20
alfanumerycznych. W przypadku fiskalizacji pierwotnej numer ewidencyjny otrzymywany jest z
repozytorium (CRK). Przesłanie numeru ewidencyjnego jest jednoznaczne z ponowną fiskalizacją
drukarki (po wymianie pamięci fiskalnej).
Do przeprowadzenia fiskalizacji należy uprzednio zaprogramować odpowiednie dane za pomocą
instrukcji [hdrset], [vatset], [servicedataset], [servicemandataset], [taxofficedataset].

[fiscalize] Fiskalizacja
ni – NIP składający się z 10 cyfr (wcześniej 20 alfanumerycznych)
rn – numer ewidencyjny (brak numeru oznacza pierwszą fiskalizację, gdzie numer jest otrzymywany z
serwerów MF)

Nowe polecenia niezbędne do wykonania fiskalizacji:

[taxofficedataset] Programowanie danych urzędu skarbowego
[taxofficedataget] Odczyt danych urzędu skarbowego
[servicedataset] Programowanie danych serwisu
[servicedataget] Odczyt danych serwisu
[servicemandataset] Programowanie danych serwisanta
[servicemandataget] Odczyt danych serwisanta

4/8
DRiWP 18.04.2019 r. Zmiany w protokole POSNET „ONLINE” wersja: 1

Odczyt pamięci fiskalnej

Ze względu na dodanie nowych rekordów, które są rejestrowane i przechowywane w pamięci fiskalnej,
dodano nowe parametry zwrotne w istniejących poleceniach oraz dodano nowe polecenia dla
nieistniejących typów rekordów.

[fmrectypeget] Odczyt rekordów pamięci fiskalnej wg numerów

ty – doszły nowe typy odczytywanych rekordów (szczegóły w specyfikacji)

[fmrecrd] Odczyt rekordu raportu dobowego o zadanym numerze

Doszły nowe parametry do odczytu: ilość i wartość faktur anulowanych od ostatniego RD,
fo – kwota anulowanych faktur
fl – ilość anulowanych faktur
nn – ilość wydruków niefiskalnych (wcześniej nr niefiskalny ostatniego wydruku)
lt – (nowy) liczba zdarzeń wykonanych przez użytkownika
ot – (nowy) liczba zdarzeń wykonanych online
ft – liczba nieudanych prób połączenia z repo
si – podpis cyfrowy

[fmrecfisc]
Doszły nowe parametry (szczegóły w specyfikacji).

[fmrecend]
Doszły nowe parametry (szczegóły w specyfikacji).

[fmreccurrency]
Doszły nowe parametry (szczegóły w specyfikacji).

Nowe polecenia (szczegóły w specyfikacji):

[fmrecconnectionconfig] Odczyt rekordu zmiany adresu serwera CPD
[fmrecfirmwareupdate] Odczyt rekordu aktualizacji firmware
[fmrecfirmwareupdatefail] Odczyt rekordu niepowodzenia aktualizacji firmware
[fmrecservicemode] Odczyt rekordu wejścia/wyjścia z trybu serwisowego
[fmrecmemorychange] Odczyt rekordu wymiany pamięci chronionej
[fmrecalgorithmerase] Odczyt rekordu kasowania algorytmu weryfikującego
[fmrecupdatesourcechange] Odczyt rekordu zmiany źródła aktualizacji programu urządzenia
[fmrecdatetime] Odczyt rekordu zmiany daty i czasu
[fmreckeychange] Odczyt rekordu wymiany klucza publicznego
[fmrecservice] Odczyt rekordu zdarzenia przeglądu technicznego
[fmrecmemoryverification] Odczyt rekordu zdarzenia błędu weryfikacji pamięci chronionej
[fmrecpowerfail] Odczyt rekordu zdarzenia awarii zasilania
[fmrecenumfail] Odczyt rekordu zdarzenia utraty ciągłości dokumentów
[fmrecdataverification] Odczyt rekordu zdarzenia błędu weryfikacji danych

5/8
DRiWP 18.04.2019 r. Zmiany w protokole POSNET „ONLINE” wersja: 1

[fmrecprotmemoryfull] rekordu zdarzenia zapełnienia pamięci chronionej

[fmrecfmmemoryfull] Odczyt rekordu zdarzenia zapełnienia pamięci fiskalnej
[fmrecprinterdisconnected] Odczyt rekordu zdarzenia odłączenia mechanizmu drukującego
[fmreclcddisconnected] Odczyt rekordu zdarzenia odłączenia wyświetlacza klienta
[fmreckeysend] Odczyt rekordu zdarzenia braku przekazu klucza publicznego
[fmrecaddress] Odczyt rekordu zdarzenia zmiany adresu podatnika

Inne zmiany

[trnipset] NIP nabywcy

ni – NIP numeryczny do 30 znaków alfanumerycznych (wcześniej do 20 znaków alfanumerycznych)

[maintenance]
Wcześniej polecenie służyło do programowania przypomnienia wykonania przeglądu serwisowego.
Obecnie polecenie służy do zarejestrowania przeglądu serwisowego (wymaga użycia zwory
serwisowej).

[ecprndoc]
Brak rodzaju nośnika sd bo w online będzie po prostu pamięć chroniona (bez bufora i właściwej kopii
elektronicznej). Dla zachowania kompatybilności przesłanie tego parametru nie będzie skutkowało
błędem, bo nieistniejący parametr sd będzie teraz ignorowany.

[tcpipcfgset]
Dodanie konfiguracji DNS oraz możliwość ustawienia TCP/IP na USB(NET), WiFi, Bluetooth.

[tcpipcfgget]
Analogicznie do opisu powyżej.

Konfiguracja i sterownie aktualizacjami oprogramowania

Urządzenia online posiadają możliwość aktualizacji oprogramowania, na nowszą wersję, która
otrzymała pozytywną decyzję z GUM. Poniższe polecenia służą do zarządzania tym procesem przez
system komputerowy. Nie jest to funkcjonalność obowiązkowa z punktu widzenia sterowania
drukarkami fiskalnymi online. Szczegóły poleceń opisane w specyfikacji.
[firmwareupdatesourceget] Odczyt adresu serwera aktualizacji programowania
[firmwareupdaterequest] Wywołanie sprawdzania aktualizacji
[firmwareupdatestateget] Odczyt statusu dostępnej aktualizacji
[firmwareupdatedownload] Wywołanie pobierania aktualizacji
[firmwareupdateinstall] Wywołanie instalacji aktualizacji

6/8
DRiWP 18.04.2019 r. Zmiany w protokole POSNET „ONLINE” wersja: 1

Konfiguracja sterownika karty sieciowej na USB

[usbdrvtypeset] Ustawienie typu sterownika USB
[usbdrvtypeget] Odczyt typu sterownika USB

KONFIGURACJA WIFI
[wifinetworkstat] Odczyt statusu sieci WiFi
[wifilistnetworks] Odczyt listy skonfigurowanych połączeń WiFi
[wifinetworkadd] Konfiguracja połączenia z siecią WiFi
[wifinetworkdel] Usunięcie konfiguracji wybranej sieci WiFi

Raporty
[reponline] Raport online
[eventsrepbynumbers] Raport zdarzeń wg numerów
[eventsrepbydates] Raport zdarzeń wg dat

INNE DODANE POLECENIA

[rtcsync] Synchronizacja czasu na żądanie
Wywołuje uruchomienie synchronizacji czasu z serwerami czasu.

[nextmaintenanceset] Wprowadzenie danych kolejnego przeglądu serwisowego

Programowanie przypomnienia o kolejnym przeglądzie serwisowym (analogicznie jak dawniej w
poleceniu [maintenance]).

[signatureprintcfgset] Ustawienie konfiguracji drukowania kodu 2d podpisu dokumentów

Wg rozporządzenia można drukować podpis cyfrowy dokumentu w formie graficznej (QRCode).
Polecenie służy do ustawienia tego parametru.

[signatureprintcfgget] Odczyt konfiguracji drukowania kodu 2d podpisu dokumentów

Odczyt ustawień analogicznie do opisu powyżej.

[dayreportprintcfgset] Konfiguracja wydruku raportu dobowego

Wg rozporządzenia można ustawić, czy raport dobowy ma być drukowany (w postaci papierowej).

[dayreportprintcfgget] Odczyt konfiguracji drukowania raportu dobowego

Odczyt ustawień analogicznie do opisu powyżej.

7/8
DRiWP 18.04.2019 r. Zmiany w protokole POSNET „ONLINE” wersja: 1

KODY BŁĘDÓW
Ze względu na zmiany i dodanie nowych funkcjonalność pojawiły się nowe kody błędów, które zostały
uwzględnione w tabelce na końcu specyfikacji protokołu komunikacyjnego.

KONTAKT
W razie pytań lub uwag do niniejszej dokumentacji prosimy o kontakt na adres: driwp@posnet.com.pl

8/8