W dniu 1 września 2019 r. weszła w życie Ustawa z dnia 4 lipca 2019 r. o zmianie ustawy o podatku od towarów i usług oraz niektórych innych ustaw (Dz.U. 2019 poz. 1520). Pośród wielu zmian jakie wprowadzono w ustawie nowelizowanej znalazł zapis dotyczący wystawiania faktur do paragonów fiskalnych. W takim przypadku będzie to możliwe wyłącznie wtedy gdy podatnik wystawi…
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, itp.) WERSJA 4.1 WERSJA 4.0-RC WERSJA 3.12 WERSJA 3.11 Wersja 3.11 zawiera część funkcjonalności z przygotowywanej aktualnie wersji 4.0. Między innymi API zostało rozszerzone ułatwiając zarządzanie lub drukowanie niestandardowych formatek. Podczas wysyłania requestu do wydruku…
Do serwisu można wysyłać dowolne polecenia sterujące, jednak dla wygody użytkowania najczęściej używane funkcje jak wydruk paragonów czy wydruk faktur (od wersji 2.3) mają dedykowane restpointy. Pojedyncza faktura Aby wydrukować fakturę, 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 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
curl -XPOST "http://localhost:3050/faktura" -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} ], "header" : { "nb": "56/2020", "ni": "584-222-98-89", "na": ["Nazwa firmy", "ul. Miejska 56", "88-888 Miasto"], "pd": "2020-02-15", "pt": "przelew" }, "headerex" : { "nr": "WX 12345", "zs": "45/25/2000358", "oz": "Jan Kowalski", "zk": "789/75CGX", "nk": "DX12", "wd": "Warunki dostawy", "sd": "Sposób dostawy" }, "summary" : { "to": 3500 } }' |
Polecenie wydrukuje poniższą fakturę na drukarce: Paczka dystrybucyjna zawiera katalog…
Plik konfiguracyjny znajduje się w katalogu C:\PosnetServer\config.json (/opt/posnetserver/config.json). 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.json mogą być kłopotliwe i czasochłonne, stad PosnetServer może pobierać konfigurację z zewnętrznego serwera. Zdalna konfiguracja opisana jest bardziej szczegółowo w jednym z kolejnych artykułów.…
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…
