API Wysokiego Poziomu
Zestaw funkcji wysokiego poziomu obsługujących rozkazy kasy.
Więcej...
Opis szczegółowy
Zestaw funkcji wysokiego poziomu obsługujących rozkazy kasy.
Zestaw funkcji wysokiego poziomu składa się z dwóch rodzajów funkcji. Pierwsza grupa o nazwach POSS_XXX służy do tworzenia i wysyłania do kasy rozkazów. Druga grupa funkcji o nazwach POSG_XXX służy do odbioru i analizy danych zwracanych w wyniku wysłania odpowiedniego rozkazu do kasy.
Dokumentacje poszczególnych parametrów funcji znajdują się w dokumentacji programisty kasy COMBO. Większość parametrów literalnie odpowiada zarówno typami danych jak i przyjmowanymi wartościami. Jednakże dla zmiejszenia ilości parametrów wywołań w sytuacja, gdy w parametrach funkcji występują wartości i bloki powtarzające się, zostały one zastąpione listami wartości (znakowymi) oddzielanymi separatorami - znakiem \n (nowej linii). Oprócz tego, we wszystkich miejscach, gdzie występują pojęcia daty i czasu są one przekazywane i zwracane w formacie zgodnym z ISO-8601 w postaci ciągu znaków o formacie: "RRRR-MM-DDTHH:MM:SS".
Każda funkcja POSS_XXX przyjmuje 3 standardowe parametry
- hDevice - uchwyt urządzenia,
- phRequest - wskaźnik do POSNET_HANDLE w którym umieszczony zostanie uchwyt stworzonego i wysłanego zapytania. Jeśłi informacja ta nie jest pottrzebna można przekazać wartość NULL,
- tryb - tryb wysyłania rozkazu por. Tryby wysyłania rozkazów
Pozostałe parametry są zależne od rozkazu.
- Ostrzeżenie:
- Funkcje POSS_ w przypadku błędu NIE USUWAJĄ stworzonego obiektu rozkazowego. Należy go usunąć poprzez przekazanie do funkcji POSG_Default lub użycie POS_DestroyRequest.
Każda funcja POSG_XXX przyjmuje jeden standardowy parametr:
- hRequest - uchwyt odebranej odpowiedzi do rozkodowania.
W przypadku, gdy wynik operacji nas nie interesuje możemy użyć funcji
POSG_Default, która automatycznie zniszczy wynik, zwracając jedynie status operacji (bez danych). W ten sposób wszystkie operacje POSS_XXX mają swó odpowiednik w postaci POSG_XXX lub POSG_Default.