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).

Polecenie wydrukuje poniższy paragon na drukarce:

Paczka dystrybucyjna zawiera katalog docs/ a w nim pliki HTML z przykładowymi requestami do serwisu.

W przypadku wydruku paragonów nie zawsze wiadomo który indeks stawki odpowiada jakiej stawce VAT. Aby nie odpytywać za każdym razem drukarki lub tym bardziej nie trzymać konfiguracji w kodzie, PosnetServer pozwala wygodnie przekazać stawkę VAT w formacie “23,00”, “8,00” lub “A”, “B” itd. Przykład:

Wiele paragonów

Często chcemy wydrukować wiele paragonów na raz. W takiej sytuacji możemy skorzystać z requestu /paragony.

Powyższy request wydrukuje 2 paragony na drukarce.

Drukowanie asynchroniczne

Drukarki fiskalne nie należą do najszybszych, stąd pojedynczy request do serwisu może trwać od kilku do nawet kilkunastu sekund, blokując tym samym proces requestujący. Aby otrzymać szybko zwrot i nie czekać na zakończenie drukowania, należy dodać w URL “?async=true“. Dzięki temu PostnetServer przyjmie request i doda go do kolejki, zwracając niezwłocznie 200OK do procesu requetsującego. Drukowanie paragonu rozpocznie się jak tylko drukarka będzie gotowa. Status requestu asynchronicznego można sprawdzić odpytując restpoint /paragon podając identyfikator transakcji asynchronicznej.

Sprawdzenie statusu (gdzie 5f1c29d0-3284-4bb7-878c-4cf6f992591b to identyfikator transakcji asynchronicznej zwrócony w odpowiedzi na poprzedni request):

dodatkowe linie

Aby wstawić dodatkowe linie pod paragonem, wyślij następujący request:

Gdzie ID linii może być jedną z poniższych wartości:

IDOpisTyp
0Nr transakcjialfanumeryczny
1Punktyalfanumeryczny
2Suma punktówalfanumeryczny
3Nr rejestracyjnyalfanumeryczny
4Nazwiskoalfanumeryczny
5Kartaalfanumeryczny
6Numer kartyalfanumeryczny
7Ważna doalfanumeryczny
8Kasjeralfanumeryczny
9Nazw. kasjeraalfanumeryczny
10Zaliczkaalfanumeryczny
11Walutaalfanumeryczny
12Przelicznikalfanumeryczny
13Nr zamówieniaalfanumeryczny
14Nr Pracownikaalfanumeryczny
15Nazw. Pracownikaalfanumeryczny
16Konto przed tr.alfanumeryczny
17Przyznanoalfanumeryczny
18Wykorzystanoalfanumeryczny
19Konto po trans.alfanumeryczny
20Klienta stałyalfanumeryczny
21Voucheralfanumeryczny
22Wartość Voucheralfanumeryczny
23Zapłata Voucheralfanumeryczny
24napis predefiniowanybez parametru
25linia bez słowa kluczowego (15 spacji)alfanumeryczny
26Ilość sprzedanych towarówalfanumeryczny
27Numer pracownikaalfanumeryczny
28Numer klientaalfanumeryczny
29Udzielono łącznie rabatówalfanumeryczny
30Numeralfanumeryczny
31Kodalfanumeryczny
32Nazwaalfanumeryczny
33Opisalfanumeryczny
34Liczbaalfanumeryczny
35Klientalfanumeryczny
36Kwotaalfanumeryczny
37Promocjaalfanumeryczny
38Infoalfanumeryczny
39Do fakturyalfanumeryczny
40Ad.alfanumeryczny
41napis predefiniowany z uwzględnieniem znaków formatującychbez parametru
42napis predefiniowany z małą czcionkąalfanumeryczny

Share This

What's your reaction?
0Smile0Lol0Wow0Love0Sad0Angry

Leave a comment