Posnet Server oparty jest o multiplatformowy framework Node.js, dzięki czemu może być uruchomiony zarówno pod systemem Windows jak i dowolnymi dystrybucjami Unix’a (Linux, Ubuntu, Debian, Raspbian itp.)

WERSJA 5.0-beta

Jest to najnowsza wersja, gruntownie przebudowana wersja PosnetServer. W przypadku jakichkolwiek problemów z instalacją lub uruchomieniem, z góry dziękujmy za ich zgłaszanie.

  • W tej wersji wprowadzony został symulator drukarki fiskalnej,
  • Wspierane są build’y pod MacOS,
  • Możliwość sprzedaży w innej walucie niż waluta ewidencyjna,
  • Możliwość aktywowania automatycznego przelicznika walut pod paragonem
  • Usprawniony system pluginów,
  • Nie wspieramy już build’ów pod Unix x32
SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.5.0.1068.zip29MBb8f4c8a52b406530050f2567837312a2
Windowsx64posnetserver.win64.5.0.1068.zip30MB9474956a31c6cfe21257968e8bf40a69
Unixx64posnetserver.x64.5.0.1068.tar.gz2.1MB18be5b3504c0713c774be9762b043acc
Ubuntu 20.04armposnetserver-ubuntu-2004.arm32.5.0.1068.tar.gz1.9MB97437871f2ef1b4aca5f047dc31c800d
MacOSarm64posnetserver.darwin-arm64.5.0.1068.tar.gz4.1MBf7693034e4e883e2cf82ef22398a9611

WERSJA 4.4

  • nowa metoda /deviceid zwracająca unikalny numer drukarki i wersje firmware
  • Poprawiono format response zwracany przez funkcję /raporty/events/dobowy w przypadku gdy parametr “mergeSection=true”
SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.4.4.1052.zip28MB5c32e6ad4f15584fa7fe1d3eb82b29d4
Windowsx64posnetserver.win64.4.4.1052.zip29MB3ca37b565e86b9832f1874bd7208e1c9
Unixx32posnetserver.x32.4.4.1052.tar.gz2MBa1a083a5794ab10fc2569c928cdb19d4
Unixx64posnetserver.x64.4.4.1052.tar.gz2MBf0b93cf22ab5459ee03ba3a6adf7d9c1
Ubuntu 18.04armposnetserver-ubuntu-1804.arm32.4.4.1052.tar.gz1.7MB290ac355b4ec94aa4f97c97b7fdb2702

WERSJA 4.3

Największą zmianą tej wersji jest możliwość skanowania pamięci fiskalnej, więcej informacji o nowym feature znajduje się na naszym blogu: https://blog.bigdotsoftware.pl/posnet-server-odczyt-pamieci-fiskalnej/

  • pobieranie zdarzeń drukarki (daty raportów dobowych, awarii zasilania, zmiany daty/czasu itp)
  • pobieranie historii fiskalnych dokumentów w zadanym przedziale czasowym z dokładnością co do szczegółów każdej pozycji
  • export tych danych do zewnętrznego pliku w formacie JSON
SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.4.3.1045.zip28MB40ac18c7eea43f9429f78d5a186a89bf
Windowsx64posnetserver.win64.4.3.1045.zip29MB7db27cfd6cb662fcac40558dc2c66aee
Unixx32posnetserver.x32.4.3.1045.tar.gz2MB7879aebda18bf08fed71745825b8f6d8
Unixx64posnetserver.x64.4.3.1045.tar.gz2MB3e7de0763c72f25859069057e37d62f9
Ubuntu 18.04armposnetserver-ubuntu-1804.arm32.4.3.1045.tar.gz1.5MB5f23a055a86c230b00653990538a2150

WERSJA 4.2

  • Nowy atrybut dla restpoint /command breakOnFirstError=true/false
  • Obsluga retry logic w restpoint /command, analogicznie jak w pozostalych restpointach (Sekcja “retry” w pliku konfiguracyjnym)
SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.4.2.1015.zip23MBc1d6957ba6bd2bdf143e4582736e5293
Windowsx64posnetserver.win64.4.2.1015.zip23MB9ee9dc2a81f097e9e0e77be60de2a2fa
Unixx32posnetserver.x32.4.2.1015.tar.gz1MBfd38942ccd5b3c893c3f3b876eee2a3c
Unixx64posnetserver.x64.4.2.1015.tar.gz1MBaa461bedac1babd2bb6a3416ae193f2a
Ubuntu 18.04armposnetserver-ubuntu-1804.arm32.4.2.1015.tar.gz0.7MB665277b67d72e756af986c0ce4cb18e4

WERSJA 4.1

Pierwszy kompletny release wersji 4.x.

  • Pełne wsparcie dla eParagon i eFaktury. Jeśli chcesz zrezygnować z papierowej wersji paragonów i faktur, to dzięki rozwiązaniom w wersji 4.1 przejście na eParagon i eFakturę jest banalnie proste – więcej,
  • Dodatkowy typ rabatu: basic,
  • Kody kreskowe pod pozycjami oraz PKWiU na fakturach i eFakturach,
  • Dodatkowy opis pod pozycją oraz możliwość zmiany jednostki na paragonach/eParagonach i fakturach/eFakturach,
  • Możliwość przesłania innej grafiki w nagłówku lub stopce niż tej która jest domyślnie zaprogramowana w drukarce,
  • Dodatkowe RESTpointy do testowania i konfiguracji eParagon/eFaktura,
  • Poprawki techniczne i nowsze wersje bibliotek poprawiające wydajność i stabilność serwisu,
  • Koniec wsparcia dla dedykowanych wersji pod Raspbian. Wersja oznaczona “ubuntu” działa na każdej dystrybucji na urządzeniach RaspberryPi
SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.4.1.982.zip23MBcf36638b506ca33c41b02590965ec4f6
Windowsx64posnetserver.win64.4.1.982.zip23MB90ec729d6c731c5a9b9c3ddfd1281679
Unixx32posnetserver.x32.4.1.982.tar.gz1MB52f53cf949ba8307660e13c80de19797
Unixx64posnetserver.x64.4.1.982.tar.gz1MBff3266bb2807999f72d5bc81e1bd97aa
Ubuntu 18.04armposnetserver-ubuntu-1804.arm32.4.1.982.tar.gz0.7MB2725f690b94877c77879941730aa0b00

WERSJA 4.0 – RC1

Z dumą prezentujemy pierwszy RC wersji 4.0. Kod serwisu został znacząco poprawiony, został zmieniony i rozszerzony interfejs API (w miarę możliwości staraliśmy się aby był kompatybilny wstecz) ale jedną z ciekawszych zmian są pluginy oraz esparcie dla eParogon. Poniżej znajduje się bardziej dokładna lista zmian:

  • Wsparcie dla eParagon
  • Pluginy pozwalające na integracje z RabbitMQ (AMQP), Azure Service Bus czy lokalnego DLQ
  • Heartbeat’y wysyłane do drukarki mogą sprawdzać czas lub status mechanizmu drukarki
  • Poprawiono rotację i severity logów. Od teraz ogromne pliki logów, szczególnie w trybie fulldebug nie powinne już stanowić problemu. dodatkowo severity bardziej odpowiada sytuacji , stad monitoring aplikacji jest bardziej intuicyjny
  • Lokalne DLQ. Wszystkie paragony których nie udało się wydrukować zapisywane są w lokalnym katalogu i w dowolnym momencie można ręcznie ponowić ich wydruk
  • Lepsza obsługa błędów i czytelniejsze komunikaty o błędach
  • Walidacja konfiguracji. Jeśli zostanie wprowadzony błędny parametr, serwis nie uruchomi się informując o tym która część jest błędna
  • Refactoring kodu oraz upgrade do najnowszych wersji bibliotek
  • Zaprzestaliśmy wspierania dedykowanych buildów na RaspberryPI, o teraz wersja oznaczona symbolem “ubuntu” będzie mogła być używana naprzemiennie. Buildy będą dostępne w pierwszej wersji nie oznaczonej RC
  • Dodaliśmy nowy RESTpoint /devicestatus aby szybciej określać czy jest problem z drukarką a jeśli tak to jaki i czy błąd wymaga wezwania serwisu lub czy jedynie akcji kasjera jak np naciśnięcia klawisza czy wymiany papieru (odpowiednio wcześniej można określić czy papier się kończy)
SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.4.0.956-rc.zip23MB2b8054246f7fea862bafb4461e858631
Windowsx64posnetserver.win64.4.0.956-rc.zip23MB0249b7ba4fa1ee9ca132626cb1ca4277
Unixx32posnetserver.x32.4.0.956-rc.tar.gz1MBb609547a2e7d7af6a6d7a243cb817b2b
Unixx64posnetserver.x64.4.0.956-rc.tar.gz1MB6c623ff7b54f0504c3a3c053c3e4dab5
Raspberry Pi OS (Raspbian)deprecatedn/adeprecated
Ubuntu 18.04 i nowszeARM/ARM640MBwkrótce

POBIERZ OSTATNIą STABILNĄ WERSJĘ 3.13

SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.3.13.883.zip23MBbaca3d41a41437e24fc5f8f8d69fe869
Windowsx64posnetserver.win64.3.13.883.zip23MB73074981125be8add80433f56899377f
Unixx32posnetserver.x32.3.13.883.tar.gz1MBd234e78fefd005f644bc72500d677277
Unixx64posnetserver.x64.3.13.883.tar.gz1MBd3aab79c8338ee4e372fecb52f437788
Raspberry Pi OS (Raspbian)armposnetserver-raspbian.arm32.3.13.883.tar.gz0.7MBd4a912bed84b1cf3278d9af4ef2c7e72
Ubuntu 18.04armposnetserver-ubuntu-1804.arm32.3.13.883.tar.gz0.7MB7eb42617344b24ebd138b288ca97b4b1

Wersja 3.13 zawiera pełne wsparcie dla narzutów i rabatów. W katalogu /docs paczki dystrybucyjnej znajdują się przykłady użycia 5 typów rabatów/narzutów: bill, line, vat, promo i subtotal. Dodatkowo poprawiono walidacje schemy. W przypadku problemów z kompatybilnością wsteczną prosimy o informację, a jako workaround należy wykonać downgrade do wersji 3.12.

POBIERZ POPRZEDNIĄ WERSJĘ WERSJĘ 3.12

SystemPlatformaDownloadRozmiarMD5
Windowsx32posnetserver.win32.3.12.797.zip23MBb3d136cb3ceceba4a0ea22c58426d6c1
Windowsx64posnetserver.win64.3.12.797.zip23MB956e3382e6da1dd366ecf691e79816c0
Unixx32posnetserver.x32.3.12.797.tar.gz1MBd20e6feb43c50f8f38b20918a91462f8
Unixx64posnetserver.x64.3.12.797.tar.gz1MB3f67fc9ab6a672a9281d726bfdfbd347
Raspberry Pi OS (Raspbian)armposnetserver-raspbian.arm32.3.12.797.tar.gz0.7MB6d32f1ab6a1625f0883a7098a63a1ebe
Ubuntu 18.04armposnetserver-ubuntu-1804.arm32.3.12.797.tar.gz0.7MB59c66aad32257e484dc0580a71bbd851

Wersja 3.12 zawiera wsparcie dla wydruków kodów kreskowych czy niestandardowych formatek. Dodatkowo od wersji 3.12 można włączyć “pingowanie” urządzenia, jak również ustawić niestandardową logikę ponawiania prób w przypadku błędów komunikacji.

Poprzednie wersje

automatyczna Instalacja Windows

Dla systemów Windows dostępna jest paczka zip do samodzielnej instalacji. Ręczna instalacja pozwala na pełną kontrolę procesu instalacji oraz aktualizacji naszego oprogramowania.

Ręczna instalacja windows

Poniższe punkty opisują krok po kroku jak zainstalować i uruchomić PosnetServer bez używania instalatora.

  1. Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64 (lista znajduje się wyżej)
  2. Rozpakuj paczkę do katalogu C:\PosnetServer
  3. Zainstaluj Microsoft Redistributable Libraries znajdujące się w katalogu c:\PosnetServer\vcredist\
  4. Pobierz i zainstaluj framework Node.js (strona)
  5. Sprawdź czy node.js został poprawnie zainstalowany
  1. Przejdź do katalogu C:\PosnetServer i zainstaluj pakiety (node_modules) wpisując polecenie “npm install”

Uruchom serwer poleceniem serverstart.cmd

ręczna instalacja Unix (Debian) oraz Raspberry Pi OS (RASPBIAN)

  1. Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64/arm (lista znajduje się na górze)
  2. Rozpakuj paczkę do katalogu /opt/posnetserver

Pobierz i zainstaluj framework Node.js. W zależności od dystrybucji sposób instalacji może być różny. Przykładowo dla dystrybucji Debian, bardzo pomocny opis znajduje się tutaj. Minimalna, wspierana wersja Node.js to 9.x. Sprawdź czy node.js został poprawnie zainstalowany:

Przejdź do katalogu /opt/posnetserver i zainstaluj pakiety (node_modules) wpisując polecenie “npm install”

Uruchom serwer poleceniem ./serverstart.sh

Raspberry Pi OS (RASPBIAN)

Od wersji 3.0 wprowadziliśmy wsparcie dla architektury ARM. Wersja 3.0-alpha jest aktualnie testowana na Rasbian bazującym na Debian buster.

Od wersji 3.0 jesteśmy w stanie wspierać również inne architektury jak również inne systemy operacyjne. Zachęcamy do kontaktu.

PosnetServer uruchomiony na RaspberryPI
PosnetServer uruchomiony na RaspberryPI (RASPBIAN)

Typowe problemy i ich rozwiązywanie

Jeśli PosnetServer wyłącza się zaraz po uruchomieniu

Sprawdź czy pobrana wersja odpowiada Twojemu systemowi operacyjnemu (arm,x32,x64). Dla architektury arm publikujemy 2 paczki: osobną dla Raspbian i osobną dla Ubuntu. Wspieramy Ubuntu od wersji 18.04 oraz Debiana od wersji buster. Poniżej kompletne zestawienie wersji:

Może być to również problem starej wersji node.js (node -v). Minimalna wersja node.js to 8.x (zalecana 10.x) – w przykładzie powyżej na serwerze była zainstalowana wersja 4.2.6

Drugą przyczyną takiego zachowania może być brak zainstalowanych modułów (moduły przechowywane są w katalogu node_modules). Aby zainstalować moduły, należy wydać polecenie npm install

cd /opt/posnetserver
npm install

Jeśli posnetserver dalej wyłącza się zaraz po uruchomieniu, ale dochodzi do miejsca widocznego poniżej (Loading napi….):

Wówczas problemem może być brak odpowiednich bibliotek systemowych. Aby to zweryfikować należy przejść do katalogu /opt/posnetserver/build/Release i wykonać polecenie:

Wynik może różnić się od dystrybucji oraz wersji Posnet Server, ważne aby wszystkie zależności były rozwiązane. Poniższy przykład pokazuje brak biblioteki libnode.so:

JEŚLI NIE DZIAŁA SYMULATOR DRUKARKI FISKALNEJ

Zazwyczaj problemy z używaniem symulatora drukarki fiskalnej pojawiają się dla wdrożeń pod Windows, gdyż Windows domyślnie nie posiada kompilatora i bibliotek niezbędnych dla polecenia “npm install”. Należy pamiętać, że symulator jest komponentem opcjonalnym i błędy podczas uruchomiania informujące że symulator nie może zostać załadowany nie wpływają na stabilność PosnetServera, jedynie funkcje symulacji nie będą dostępne.

  1. Na początku należy zainstalować Pythona w wersji 3, szczegóły tego procesu można znaleźć tutaj: https://github.com/nodejs/node-gyp#on-windows
  2. Jeśli używany Python jest w wersji >= 3.12, należy koniecznie doinstalować pakiet setuptools poleceniem “pip install setuptools
  3. Na końcu należy zainstalować Microsoft Visual Studio, ale wystarczy wybrać jedynie pakiety do kompilacji C++ (MSVC i Windows SDK)

Share This

What's your reaction?
2Smile0Lol0Wow0Love0Sad0Angry

Leave a comment