Plik konfiguracyjny znajduje się w katalogu C:\PosnetServer\config.js (/opt/posnetserver/config.js). Plik może być modyfikowany w dowolnym edytorze tekstowym (np. notatnik pod Windows, lub vim w Unix) RemoteConfig W przypadku dużej ilości stanowisk, utrzymywanie i zmiany w pliku config.js mogą być kłopotliwe i czasochłonne, stad Posnet server może pobierać konfigurację z zewnętrznego serwera. Zdalna konfiguracja opisana jest bardziej szczegółowo w jednym z kolejnych…
Dla wygody użytkowników drukowanie paragonu zostało wydzielone jako osobny moduł. Nie ogranicza to jednak możliwości serwisu. Używając /command , możemy wysłać dowolne polecenie lub sekwencję poleceń (przykład znajduje się w pliku docs/customcommand.html) Przykładowa odpowiedź serwisu: Podobnie jak w przypadku paragonów, polecenia można wykonać asynchronicznie: Przykładowa odpowiedź serwisu: Aby sprawdzić status polecenia: Przykładowa odpowiedź:
Paczka dystrybucyjna zawiera katalog docs/ a w nim pliki HTML z przykładowymi requestami do serwisu. Dowolny przykład może być uruchomiony z poziomu przeglądarki WWW:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
<body> <script> var http = new XMLHttpRequest(); var url = 'http://127.0.0.1:3050/paragon'; var params = { lines : [ { na: "Towar 1", il: 1.0, vt: 0,pr: 2350}, { na: "Towar 2", il: 1.0, vt: 0,pr: 1150} ], summary : { to: 3500 } }; http.open('POST', url, true); //Send the proper header information along with the request http.setRequestHeader('Content-type', 'application/json'); http.onreadystatechange = function() {//Call a function when the state changes. //alert(http.responseText); if(http.readyState == 4 && http.status == 200) { alert(http.responseText); } } http.send(JSON.stringify(params)); </script> </body> |
Należy pamiętać że czasem ustawienia przeglądarki mogą blokować tego typu requesty: Dostosuj poziom zabezpieczeń w ustawieniach przeglądarki WWW, Upewnij się że strona działająca po https:// wysyła requesty do serwisu po https:// (standardowo na porcie 3051)…
PosnetServer obsługuje większość popularnych drukarek nowej homologacji, jednak może się zdarzyć że posiadana drukarka nie jest wspierana. W takiej sytuacji zachęcamy do kontaktu mailowego, telefonicznego lub skorzystania z formularza na dole tej strony. System może również obsługiwać również drukarki starej homologacji, lub drukarki innych firm. Pragniemy rozwijać nasze produkty, więc zachęcamy do kontaktu z nami, przesłania modelu drukarki i (jeśli…
Posnet Server domyślnie wystawia usługi na porcie 3050 (HTTP) oraz 3051 (HTTPS). Numery portów oraz ścieżki do certyfikatów SSL można zmienić w pliku config.js
Warto dodać PosnetServer do autostartu systemu. Najwygodnieszym sposobem dodania serwisu działającego w oparciu o framework Node.js jast PM2, czyli “Advanced, production process manager for Node.js”. WINDOWS – instalacja Uruchamiany konsole w trybie Administratora i przechodzimy do katalogu gdzie rozpakowany jest Posnet Server Instalujemy globalnie (-g) process managera “npm install pm2 –g” (pm2 uruchamia Posnet Server i podnosi go automatycznie w…
Do serwisu można wysyłać dowolne polecenia sterujące, jednak dla wygody użytkowania najczęściej używane funkcje (jak np. wydruk paragonów) mają dedykowane restpointy. Pojedynczy Paragon Aby wydrukować paragon, wystarczy wysłać poniższy request z konsoli (lub z dowolnego programu do wysyłania requestów HTTP, np Fiddler lub Postman).
1 2 3 4 5 6 7 8 9 |
curl -XPOST "http://localhost:3050/paragon" -H 'Content-Type: application/json' -d'{ "lines" : [ { "na": "Towar 1", "il": 1.0, "vt": 0,"pr": 2350}, { "na": "Towar 2", "il": 1.0, "vt": 0,"pr": 1150} ], "summary" : { "to": 3500 } }' |
Polecenie wydrukuje poniższy paragon na drukarce: A w odpowiedzi zwróci przykładowy response:
1 |
{"ok":true,"code":-1,"bn":"10","hn":"120","took":2957,"message":"","ts":1685975291660,"tsend":1685975294617} |
Opis poszczególnych…
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 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” WERSJA 4.3 Największą zmianą tej wersji jest możliwość skanowania…
Posnet Server jest warstwą HTTP (RESTful) dla drukarek Posnet . System wspiera wszystkie dostępne na rynku drukarki nowej homologacji. Posnet Server może działać zarówno pod systemem Windows x86/x64 jak i Unix x86/x64 (Debian, Linux, Ubuntu itp.) oraz arm7, czyli na urządzeniach takich jak RaspberryPI czy QNAP. System pozwala wygodnie współdzielić jedną drukarkę fiskalną pomiędzy wiele aplikacji. Dodatkowo, integracja Strony WWW…