Posnet Server oparty jest o multiplatformowy framework Node.js, dzięki czemu może być uruchomiony zarówno pod systemem Windows, MacOS jak i dowolnymi dystrybucjami Unix’a (Linux, Ubuntu, Debian, Raspbian itp.)
WERSJA 5.4
W tej wersji dodaliśmy
- Funkcjonalność “Optimistic Locking” dla wydruku paragonów. Dzięki tej funkcjonalności można uniknąć przypadkowego, ponownego wydruku tego samego paragonu. Feature jest używany gdy w request /paragon podamy jeden z parametrów: “previousBn” lub “previousHn“. Zmiana jest kompatybilna wstecz, czyli jeśli parametry nie są podane funkcjonalność “Optimistic Locking” nie jest używana.
- weryfikację długości nazwy towaru w request. W zależności od szerokości używanego papieru (57mm lub 80mm) długość fiskalizowanej nazyw towaru może wyności odpowiednio 56 znaków lub 80 znaków. Informację o używanej szerokości rolki papieru nalezy podać w pliku “config.json” w parametrze “posnet.paper.width“
- poprawiliśmy kilka błędów poprawiając tym samym stabilność produktu i jakość loggera,
- uaktualnione zostały biblioteki node.js, stąd w przypadku jakichkolwiek zaobserwowanych problemów prosimy o przesyłanie informacji i ewentualny downgrade do wersji 5.3 lub 5.2.
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.5.4.1122.zip | 29MB | edc3e131fb468e714c844d547bac1737 |
| Windows | x64 | posnetserver.win64.5.4.1122.zip | 30MB | 3868c1d6198ddb25ba19b305fbf6f3ef |
| Unix / Ubuntu 20.04 | x64 | posnetserver.x64.5.4-GLIBC-2.31.1122.tar.gz | 2.1MB | 41d36e6b469707af377a141afca1abf6 |
| Unix / Ubuntu >=22.04 | x64 | posnetserver.x64.5.4.1122.tar.gz | 2.1MB | 8c198705e38e6c6389bf84006bd92b1b |
| Unix / Ubuntu >=20.04 | arm | posnetserver-ubuntu-2004.arm32.5.4.1122.tar.gz | 1.9MB | 763c862783b9fde3499d08c17a6e96b9 |
| MacOS | arm64 | posnetserver.darwin-arm64.5.4.1122.tar.gz | 4.1MB | a075251ba7ca699ebbc1cf9e15bcab19 |
WERSJA 5.3
W tej wersji nie dodaliśmy nowych funkcjonalności, a jedynie kilka drobnych poprawek w stosunku do wersji 5.2. Z góry dziękujemy za przesyłanie informacji o problemach z instalacją lub uruchomieniem wersji 5.x i jako krótkoterminowe rozwiązanie, sugerujemy instalację wersji 4.4.
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.5.3.1084.zip | 29MB | 82fceac95c8dbbf2e584e2f97aafb1c3 |
| Windows | x64 | posnetserver.win64.5.3.1084.zip | 30MB | 820a9aecb73ffd90f5d03ea414954fc8 |
| Unix | x64 | posnetserver.x64.5.3.1084.tar.gz | 2.1MB | 940e5973d1017b75234384370dac4510 |
| Ubuntu 20.04 | x64 | posnetserver.x64.5.3-GLIBC-2.31.1084.tar.gz | 2.1MB | ab9c5205f39c36648f75fb2fe4d3ff27 |
| Ubuntu 20.04 | arm | posnetserver-ubuntu-2004.arm32.5.3.1084.tar.gz | 1.9MB | 9824de81f9d086fbd76a07307c6d485b |
| MacOS | arm64 | posnetserver.darwin-arm64.5.3.1084.tar.gz | 4.1MB | 4669442b2221cd133c0998e0666cfcc5 |
Wersja 5.2
W porównaniu do poprzedniej wersji 5.1, rozszerzone zostały jedynie możliwości wydruków niefiskalnych.
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.5.2.1082.zip | 29MB | b5cbe2b5e4f4647602d962f25fdd34ee |
| Windows | x64 | posnetserver.win64.5.2.1082.zip | 30MB | 3dfa1539d8d77754950ff0176434f788 |
| Unix | x64 | posnetserver.x64.5.2.1082.tar.gz | 2.1MB | d44a74ac864128e0afdd99e18e897b3a |
| Ubuntu 20.04 | arm | posnetserver-ubuntu-2004.arm32.5.2.1082.tar.gz | 1.9MB | c6f25e3622710d632f519914654a5780 |
| MacOS | arm64 | posnetserver.darwin-arm64.5.2.1082.tar.gz | 4.1MB | f1f368d7b7718439e2ad4f4a1ecfbd52 |
WERSJA 5.1
Jest to poprawiona, stabilna wersja piątej edycji PosnetServer’a. Poza poprawieniem kilku problemów, które pojawiły się w wersji 5.0-beta, usunęliśmy również kilka starych bibliotek o statusie “deprecated” zamieniając je nowszymi wersjami. Dodaliśmy też kilka nowych feature:
- Moduł umożliwiający autoryzację i autentykację użytkowników,
- Dedykowane metody do obsługi szuflady
- Feature symulujący upgrade licencji (w /licencja/upgrade) służący do przetestowania środowiska produkcyjnego pod kątem automatycznej aktualizacji
W przypadku jakichkolwiek problemów z instalacją lub uruchomieniem wersji 5.1 sugerujemy instalację wersji 4.4 i z góry dziękujmy za przesyłanie uwag.
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.5.1.1081.zip | 29MB | 70a34e2bc53125221add3394df3681c6 |
| Windows | x64 | posnetserver.win64.5.1.1081.zip | 30MB | c55d8dbbb7b555ffb4dc962352cd326b |
| Unix/Linux | x64 | posnetserver.x64.5.1.1081.tar.gz | 2.1MB | 7ea709a7794af071019e25d695a1ab81 |
| Ubuntu 20.04 | arm | posnetserver-ubuntu-2004.arm32.5.1.1081.tar.gz | 1.9MB | 39c19935c134b4086c7b1a88264a653f |
| MacOS | arm64 | posnetserver.darwin-arm64.5.1.1081.tar.gz | 4.1MB | e37ad69f53418c4a02210339a4a2c8bb |
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
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.5.0.1068.zip | 29MB | b8f4c8a52b406530050f2567837312a2 |
| Windows | x64 | posnetserver.win64.5.0.1068.zip | 30MB | 9474956a31c6cfe21257968e8bf40a69 |
| Unix | x64 | posnetserver.x64.5.0.1068.tar.gz | 2.1MB | 18be5b3504c0713c774be9762b043acc |
| Ubuntu 20.04 | arm | posnetserver-ubuntu-2004.arm32.5.0.1068.tar.gz | 1.9MB | 97437871f2ef1b4aca5f047dc31c800d |
| MacOS | arm64 | posnetserver.darwin-arm64.5.0.1068.tar.gz | 4.1MB | f7693034e4e883e2cf82ef22398a9611 |
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”
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.4.4.1052.zip | 28MB | 5c32e6ad4f15584fa7fe1d3eb82b29d4 |
| Windows | x64 | posnetserver.win64.4.4.1052.zip | 29MB | 3ca37b565e86b9832f1874bd7208e1c9 |
| Unix | x32 | posnetserver.x32.4.4.1052.tar.gz | 2MB | a1a083a5794ab10fc2569c928cdb19d4 |
| Unix | x64 | posnetserver.x64.4.4.1052.tar.gz | 2MB | f0b93cf22ab5459ee03ba3a6adf7d9c1 |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.4.4.1052.tar.gz | 1.7MB | 290ac355b4ec94aa4f97c97b7fdb2702 |
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
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.4.3.1045.zip | 28MB | 40ac18c7eea43f9429f78d5a186a89bf |
| Windows | x64 | posnetserver.win64.4.3.1045.zip | 29MB | 7db27cfd6cb662fcac40558dc2c66aee |
| Unix | x32 | posnetserver.x32.4.3.1045.tar.gz | 2MB | 7879aebda18bf08fed71745825b8f6d8 |
| Unix | x64 | posnetserver.x64.4.3.1045.tar.gz | 2MB | 3e7de0763c72f25859069057e37d62f9 |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.4.3.1045.tar.gz | 1.5MB | 5f23a055a86c230b00653990538a2150 |
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)
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.4.2.1015.zip | 23MB | c1d6957ba6bd2bdf143e4582736e5293 |
| Windows | x64 | posnetserver.win64.4.2.1015.zip | 23MB | 9ee9dc2a81f097e9e0e77be60de2a2fa |
| Unix | x32 | posnetserver.x32.4.2.1015.tar.gz | 1MB | fd38942ccd5b3c893c3f3b876eee2a3c |
| Unix | x64 | posnetserver.x64.4.2.1015.tar.gz | 1MB | aa461bedac1babd2bb6a3416ae193f2a |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.4.2.1015.tar.gz | 0.7MB | 665277b67d72e756af986c0ce4cb18e4 |
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
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.4.1.982.zip | 23MB | cf36638b506ca33c41b02590965ec4f6 |
| Windows | x64 | posnetserver.win64.4.1.982.zip | 23MB | 90ec729d6c731c5a9b9c3ddfd1281679 |
| Unix | x32 | posnetserver.x32.4.1.982.tar.gz | 1MB | 52f53cf949ba8307660e13c80de19797 |
| Unix | x64 | posnetserver.x64.4.1.982.tar.gz | 1MB | ff3266bb2807999f72d5bc81e1bd97aa |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.4.1.982.tar.gz | 0.7MB | 2725f690b94877c77879941730aa0b00 |
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)
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.4.0.956-rc.zip | 23MB | 2b8054246f7fea862bafb4461e858631 |
| Windows | x64 | posnetserver.win64.4.0.956-rc.zip | 23MB | 0249b7ba4fa1ee9ca132626cb1ca4277 |
| Unix | x32 | posnetserver.x32.4.0.956-rc.tar.gz | 1MB | b609547a2e7d7af6a6d7a243cb817b2b |
| Unix | x64 | posnetserver.x64.4.0.956-rc.tar.gz | 1MB | 6c623ff7b54f0504c3a3c053c3e4dab5 |
| Raspberry Pi OS (Raspbian) | deprecated | n/a | deprecated | |
| Ubuntu 18.04 i nowsze | ARM/ARM64 | 0MB | wkrótce |
WERSJA 3.13
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.3.13.883.zip | 23MB | baca3d41a41437e24fc5f8f8d69fe869 |
| Windows | x64 | posnetserver.win64.3.13.883.zip | 23MB | 73074981125be8add80433f56899377f |
| Unix | x32 | posnetserver.x32.3.13.883.tar.gz | 1MB | d234e78fefd005f644bc72500d677277 |
| Unix | x64 | posnetserver.x64.3.13.883.tar.gz | 1MB | d3aab79c8338ee4e372fecb52f437788 |
| Raspberry Pi OS (Raspbian) | arm | posnetserver-raspbian.arm32.3.13.883.tar.gz | 0.7MB | d4a912bed84b1cf3278d9af4ef2c7e72 |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.3.13.883.tar.gz | 0.7MB | 7eb42617344b24ebd138b288ca97b4b1 |
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.
WERSJA 3.12
| System | Platforma | Download | Rozmiar | MD5 |
|---|---|---|---|---|
| Windows | x32 | posnetserver.win32.3.12.797.zip | 23MB | b3d136cb3ceceba4a0ea22c58426d6c1 |
| Windows | x64 | posnetserver.win64.3.12.797.zip | 23MB | 956e3382e6da1dd366ecf691e79816c0 |
| Unix | x32 | posnetserver.x32.3.12.797.tar.gz | 1MB | d20e6feb43c50f8f38b20918a91462f8 |
| Unix | x64 | posnetserver.x64.3.12.797.tar.gz | 1MB | 3f67fc9ab6a672a9281d726bfdfbd347 |
| Raspberry Pi OS (Raspbian) | arm | posnetserver-raspbian.arm32.3.12.797.tar.gz | 0.7MB | 6d32f1ab6a1625f0883a7098a63a1ebe |
| Ubuntu 18.04 | arm | posnetserver-ubuntu-1804.arm32.3.12.797.tar.gz | 0.7MB | 59c66aad32257e484dc0580a71bbd851 |
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.
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.
- Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64 (lista znajduje się wyżej)
- Rozpakuj paczkę do katalogu C:\PosnetServer
- Zainstaluj Microsoft Redistributable Libraries znajdujące się w katalogu c:\PosnetServer\vcredist\
- Pobierz i zainstaluj framework Node.js (strona)
- Sprawdź czy node.js został poprawnie zainstalowany
- 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)
- Pobierz paczkę odpowiednią dla Twojego systemu operacyjnego x86/x64/arm (lista znajduje się na górze)
- 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.
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:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
Ubuntu Debian 20.04 focal bullseye/ sid - 11 19.10 eoan buster / sid - 10 19.04 disco buster / sid 18.10 cosmic buster / sid 18.04 bionic buster / sid 17.10 artful stretch / sid - 9 17.04 zesty stretch / sid 16.10 yakkety stretch / sid 16.04 xenial stretch / sid 15.10 wily jessie / sid - 8 15.04 vivid jessie / sid 14.10 utopic jessie / sid 14.04 trusty jessie / sid 13.10 saucy wheezy / sid - 7 13.04 raring wheezy / sid 12.10 quantal wheezy / sid 12.04 precise wheezy / sid 11.10 oneiric wheezy / sid 11.04 natty squeeze / sid - 6 10.10 maverick squeeze / sid 10.04 lucid squeeze / sid |
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:
|
1 |
ldd native.node |
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.
- 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
- Jeśli używany Python jest w wersji >= 3.12, należy koniecznie doinstalować pakiet setuptools poleceniem “pip install setuptools“
- Na końcu należy zainstalować Microsoft Visual Studio, ale wystarczy wybrać jedynie pakiety do kompilacji C++ (MSVC i Windows SDK)
