Informacje na temat plikowego interfejsu komunikacyjnego do kas ECR

Archiwum 2010

Info nr 48 01.07.2010

Na serwerze ftp dostępna jest wersja 9.10.2010 plikowego interfejsu komunikacyjnego
. W celu pobrania tej wersji zapraszamy na stronę http://www.elzab.com.pl/programy.

Dodano obsługę kasy Delta Max.
Podstawową przyczyną powstania tej wersji interfejsu było dostosowanie go do obsługi kasy Delta Max.
Dodatkowo, jak w każdej kolejnej wersji, usunięto drobne błędy zauważone od czasu wydania poprzedniej wersji oraz wprowadzono zmiany optymalizujące pracę interfejsu.

Całkowite zakończenie rozwijania interfejsu w wersji DOS.
Podjęto decyzję o całkowitym zakończeniu rozwijania interfejsu w wersji DOS, zarówno w postaci bibliotek jak i programów EXE.
W związku z tym z naszego serwera ftp usunięto plik sysexe.zip.

Pliki interfejsu dostępne aktualnie na naszym serwerze ftp:
ftp://ftp.elzab.com.pl/kody/ecrinst.zip
ftp://ftp.elzab.com.pl/kody/winexe.zip
ftp://ftp.elzab.com.pl/kody/linuxip.tar.gz

Zmodyfikowano funkcje do obsługi bazy towarowej.
Zmodyfikowano funkcje OTowar/TowarMax/ZTowar/ZBPTowar/ZCTowar; dla kas Delta Max dodano 5 nowych pól opisujących towar:
- towar wyłączony z rabatu i narzutu (domyślnie: nie),
- zawsze można wprowadzić cenę dla towaru (domyślnie: nie),
- towar jest na liście podręcznej (domyślnie: nie),
- numer wagi przypisanej do towaru (domyślnie: 1),
- licznik starzenia towaru.
Funkcje operujące na bazie towarowej dopuszczają teraz dwa formaty danych:
- format nr 1, w którym definicja towaru składa się z 10 pól,
- format nr 2, w którym definicja towaru składa się z 15 pól.
Nie dopuszcza się mieszania formatów w ramach pojedynczego pliku z towarami; plik musi mieć jednolity format, tzn. albo wszystkie linie danych są w formacie 1, albo wszystkie są w formacie 2.
Nic natomiast nie stoi na przeszkodzie, aby plik w formacie 2 został użyty do programowania np. kasy Delta Lux; w takiej sytuacji funkcja sprawdzi poprawność składni wszystkich 15 pól definicji towaru, ale do kasy pośle tylko 10 pól.
Możliwe jest także użycie pliku w formacie 1 do programowania kasy Delta Max; w takiej sytuacji brakujące pola od 11 do 14 zostaną ustawione w kasie na wartości domyślne.
Pole nr 15, czyli licznik starzenia towaru, nie jest nigdy zapisywane do kasy.

Dodano funkcję do odczytu bufora pozycji paragonowych metodą 4:
- funkcja OPSpRoz4,
- dotyczy kasy Delta Max,
- odczytuje dane z bufora pozycji sprzedaży metodą 4,
- zwraca normalne pozycje paragonowe (identyfikator w pliku = 1),
- zwraca pozycje korekcyjne (identyfikator w pliku = 10); pozycje korekcyjne mają numerację niezależną od normalnych pozycji paragonowych,
- zwraca normalne pozycje paragonowe z anulowanego paragonu (identyfikator w pliku = 11),
- zwraca pozycje korekcyjne z anulowanego paragonu (identyfikator w pliku = 12), pozycje korekcyjne z anulowanego paragonu mają numerację niezależną od normalnych pozycji paragonowych z anulowanego paragonu,
- dla identyfikatorów 11 i 12 (normalne/korekcyjne pozycje z anulowanego paragonu) pole nr_par oznacza numer kolejny anulowanego paragonu w obrębie raportu dobowego,
- dla identyfikatorów 1, 10, 11 i 12 dodano 8 pól bitowych opisujących typy użytych rabatów/narzutów,
- zwraca informacje o rabatach na paragon udzielonych za pomocą karty rabatowej,
- zwraca informacje o płatnościach w paragonie w 2 formatach: w formacie Delta i w formacie ECO,
- zwraca informacje o wydaniu prezentu z karty Bonus (identyfikator w pliku = 9); musi być włączony bit 16 funkcją ZDKBajty; informacja ta występuje w funkcjach OPSpRoz, OPSpRozN, OPSpRozX i OPSpRoz4,
- zwraca informacje o wpłatach/wypłatach/wpłacie początkowej (identyfikator w pliku = 5); dla wpłat/wypłat musi być włączony bit 20 funkcją ZDKBajty; dla wpłaty początkowej musi być włączony bit 138 funkcją ZBajtMax,
- zwraca informacje o zamknięciu zmiany kasjera (identyfikatory w pliku = 6,7,8,17); musi być włączony bit 21 funkcją ZDKBajty,
- zwraca informacje o logowaniu/wylogowaniu kasjera (identyfikatory w pliku = 13,14); musi być włączony 19 bit funkcją ZDNBajty,
- zwraca informacje o wiadomościach kasjerskich (identyfikatory w pliku = 15,16); musi być włączony bit 139 funkcją ZBajtMax.

Dodano funkcje do obsługi wiadomości kasjerskich:
- funkcje OWiad/ZWiad/KWiad/KWiadMax,
- dotyczą kasy Delta Max,
- służą odpowiednio do odczytu/zapisu/kasowania/kasowania wszystkich wiadomości kasjerskich.

Dodano funkcje do obsługi rabatów automatycznych:
- funkcje ORabAuto/ZRabAuto/KRabAuto,
- dotyczą kasy Delta Max,
- służą odpowiednio do odczytu/zapisu/kasowania definicji rabatów/narzutów automatycznych.

Przywrócono możliwość edytowania danych i uprawnień kasjerów z poziomu komputera:
- funkcje ZKasjer/KKasjer/ZUprKas,
- przywrócono możliwość zapisu/modyfikacji/kasowania danych i uprawnień kasjerów z poziomu komputera.

Dodano funkcje do obsługi rodzajów kasjerów:
- funkcje ORodzKas/ZRodzKas,
- dotyczą kasy Delta Max,
- służą odpowiednio do odczytu/zapisu definicji rodzajów kasjerów.

Dodano funkcje do obsługi danych kasjerów:
- funkcje ORKasjer/ZRKasjer,
- dotyczą kasy Delta Max,
- służą odpowiednio do odczytu/zapisu danych kasjerów dla kas obsługujących rodzaje kasjerów (w chwili obecnej tylko Delta Max).

Dodano funkcję wyłączającą kasę:
- funkcja WylKasy,
- dotyczy kasy Delta Max,
- wyłącza kasę.

Uaktualniono w instrukcji programisty opis bajtów konfiguracji:
- zmiany dotyczą funkcji OBajty/ZBajty/ODBajty/ZDBajty/ODNBajty/ZDNBajty/ODKBajty/ZDKBajty/OBajtMax/ZBajtMax,
- uzupełniono informacje specyficzne dla kasy Delta Max,
- uporządkowano i zweryfikowano informacje dotyczące pozostałych kas.

Zmodyfikowano funkcje odczytu rekordów z pamięci fiskalnej:
- funkcje RekorMax/ODaneRek,
- dodano obsługę rekordu zmiany waluty (w chwili obecnej tylko Delta Max),

Dodano obsługę błędów rozszerzonych:
- funkcje komunikacyjne zwracają błędy w postaci liczby jednobajtowej, a pula wolnych numerów błędów zbliża się do wyczerpania; błędy rozszerzone stanowią rozwiązanie tego problemu,
- w przypadku wystąpienia dowolnego błędu rozszerzonego funkcje komunikacyjne zwracają numer błędu 234 i taką wartość zapisują do pliku RAPORT.TXT,
- numery błędów rozszerzonych są dwubajtowe i są zapisywane w postaci szesnastkowej jako 4 znaki ASCII np. C601,
- w 8 linii danych pliku RAPORT.TXT zapisywany jest numer błędu rozszerzonego w formacie jak opisano powyżej,
- w pliku RAPORT.TXT może występować słowny opis błędu rozszerzonego, w tym celu należy korzystać z aktualnej wersji pliku KOMENT.TXT,
- opis słowny występuje w dotychczasowym miejscu, w drugiej linii nagłówka pliku RAPORT.TXT.